patchloom 0.11.0

// ── md module tests ───────────────────────────────────────────────
use crate::ops::md::*;

mod basic {
    use super::*;

    #[test]
    fn parse_headings_basic() {
        let content = "# H1\ntext\n## H2\nmore\n# H1b\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 3);
        assert_eq!(headings[0].level, 1);
        assert_eq!(headings[0].text, "H1");
        assert_eq!(headings[1].level, 2);
        assert_eq!(headings[1].text, "H2");
        assert_eq!(headings[2].level, 1);
        assert_eq!(headings[2].text, "H1b");
    }

    #[test]
    fn parse_headings_section_boundaries() {
        // ## B (level 2) does NOT end # A (level 1); only same-or-higher level ends it
        let content = "# A\nline1\nline2\n## B\nline3\n";
        let headings = parse_headings(content);
        assert_eq!(headings[0].line_start, 0);
        assert_eq!(headings[0].line_end, 5); // # A owns everything (no same-level heading)
        assert_eq!(headings[1].line_start, 3);
        assert_eq!(headings[1].line_end, 5); // ## B to end of content

        // Two same-level headings: second ends first
        let content2 = "# A\nbody\n# B\nmore\n";
        let h2 = parse_headings(content2);
        assert_eq!(h2[0].line_end, 2); // # A ends at # B
        assert_eq!(h2[1].line_end, 4); // # B to end
    }

    #[test]
    fn parse_headings_setext_h1() {
        let content = "Title\n=====\n\nSome content\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1);
        assert_eq!(headings[0].level, 1);
        assert_eq!(headings[0].text, "Title");
        assert_eq!(headings[0].line_start, 0);
    }

    #[test]
    fn parse_headings_setext_h2() {
        let content = "Subtitle\n--------\n\nMore content\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1);
        assert_eq!(headings[0].level, 2);
        assert_eq!(headings[0].text, "Subtitle");
        assert_eq!(headings[0].line_start, 0);
    }

    #[test]
    fn parse_headings_setext_mixed_with_atx() {
        let content = "Title\n=====\n\nSome content\n\n## ATX Heading\n\nMore text\n\nSubtitle\n--------\n\nEnd\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 3);
        assert_eq!(headings[0].text, "Title");
        assert_eq!(headings[0].level, 1);
        assert_eq!(headings[1].text, "ATX Heading");
        assert_eq!(headings[1].level, 2);
        assert_eq!(headings[2].text, "Subtitle");
        assert_eq!(headings[2].level, 2);
    }

    #[test]
    fn parse_headings_setext_section_operations() {
        // Verify that section-based operations work with setext headings.
        // Body must NOT include the underline.
        // Use two h1 setext headings so the first section is bounded.
        let content = "Title\n=====\n\nBody of title\n\nSubtitle\n=====\n\nBody of subtitle\n";
        let (start, end) = find_section(content, "Title").unwrap();
        let body = &content[start..end];
        assert_eq!(body, "\nBody of title\n\n", "Title body: {:?}", body);

        let (start2, end2) = find_section(content, "Subtitle").unwrap();
        let body2 = &content[start2..end2];
        assert_eq!(body2, "\nBody of subtitle\n", "Subtitle body: {:?}", body2);
    }

    #[test]
    fn find_section_returns_body_bytes() {
        // ## Next is deeper than # Title, so it's part of the section body
        let content = "# Title\nBody line 1\nBody line 2\n## Next\n";
        let (start, end) = find_section(content, "Title").unwrap();
        let body = &content[start..end];
        assert_eq!(body, "Body line 1\nBody line 2\n## Next\n");

        // Same-level heading ends the section
        let content2 = "# Title\nBody\n# Other\nKeep\n";
        let (s2, e2) = find_section(content2, "Title").unwrap();
        assert_eq!(&content2[s2..e2], "Body\n");
    }

    #[test]
    fn replace_section_basic() {
        // Use same-level heading so section boundary is clear
        let content = "# Title\nOld body\n# Next\nKeep\n";
        let result = replace_section_in(content, "Title", "New body").unwrap();
        assert_eq!(result, "# Title\nNew body\n# Next\nKeep\n");
    }

    #[test]
    fn replace_section_strips_duplicate_heading() {
        // When replacement starts with the same heading, strip it to avoid duplication.
        let content = "# Title\nOld body\n# Next\nKeep\n";
        let result = replace_section_in(content, "# Title", "# Title\n\nNew body").unwrap();
        assert_eq!(result, "# Title\n\nNew body\n# Next\nKeep\n");
        // No double heading
        assert_eq!(result.matches("# Title").count(), 1);
    }

    #[test]
    fn replace_section_strips_duplicate_heading_level2() {
        let content = "# Doc\n\n## Usage\n\nOld usage.\n\n## Contributing\n\nPRs welcome.\n";
        let result = replace_section_in(content, "## Usage", "## Usage\n\nNew usage.").unwrap();
        assert_eq!(result.matches("## Usage").count(), 1);
        assert!(result.contains("New usage."));
    }

    #[test]
    fn replace_section_no_strip_when_heading_differs() {
        // If the replacement heading is different, do NOT strip it.
        let content = "# Title\nOld body\n# Next\nKeep\n";
        let result = replace_section_in(content, "# Title", "# Different\nStuff").unwrap();
        assert!(result.contains("# Title\n# Different"));
    }

    #[test]
    fn replace_section_preserves_blank_line_before_next_heading() {
        let content =
            "# Project\n\nIntro.\n\n## Section A\n\nContent A.\n\n## Section B\n\nContent B.\n";
        let result = replace_section_in(content, "## Section A", "New A.").unwrap();
        assert_eq!(
            result,
            "# Project\n\nIntro.\n\n## Section A\nNew A.\n\n## Section B\n\nContent B.\n"
        );
    }

    #[test]
    fn replace_section_no_extra_blank_when_original_had_none() {
        // When the original had no blank line before the next heading, don't add one.
        let content = "# Title\nOld body\n# Next\nKeep\n";
        let result = replace_section_in(content, "# Title", "New body").unwrap();
        assert_eq!(result, "# Title\nNew body\n# Next\nKeep\n");
    }

    #[test]
    fn insert_after_heading() {
        let content = "# Title\nExisting\n";
        let result = insert_after_heading_in(content, "Title", "Inserted\n").unwrap();
        assert_eq!(result, "# Title\nInserted\nExisting\n");
    }

    #[test]
    fn insert_before_heading() {
        let content = "# First\nBody\n## Second\nMore\n";
        let result = insert_before_heading_in(content, "Second", "Inserted").unwrap();
        assert!(result.contains("Inserted\n\n## Second"));
    }

    #[test]
    fn upsert_bullet_adds_new() {
        let content = "# List\n- item1\n";
        let result = upsert_bullet_in(content, "List", "- item2").unwrap();
        assert!(result.contains("- item1\n- item2\n"));
    }

    #[test]
    fn upsert_bullet_dedup_existing() {
        let content = "# List\n- item1\n";
        let result = upsert_bullet_in(content, "List", "- item1").unwrap();
        // Should return content unchanged (no duplicate)
        assert_eq!(result, content);
    }

    #[test]
    fn upsert_bullet_auto_prefix() {
        let content = "# List\n- a\n";
        let result = upsert_bullet_in(content, "List", "new item").unwrap();
        assert!(result.contains("- new item\n"));
    }

    #[test]
    fn dedupe_headings_removes_duplicate() {
        let content = "# Title\nFirst\n# Title\nSecond\n";
        let (result, removed) = dedupe_headings_in(content);
        assert_eq!(removed, vec!["# Title"]);
        // First occurrence kept, second removed
        assert!(result.contains("First"));
        assert!(!result.contains("Second"));
    }

    #[test]
    fn table_append_basic() {
        let content = "# API\n| Name | Value |\n|---|---|\n| a | 1 |\n## Next\n";
        let (start, end) = find_section(content, "API").unwrap();
        let result = table_append_in(content, start, end, "| b | 2 |").unwrap();
        assert!(result.contains("| a | 1 |\n| b | 2 |\n## Next"));
    }

    #[test]
    fn table_append_for_tx_basic() {
        let content = "# API\n| Name | Value |\n|---|---|\n| a | 1 |\n";
        let result = table_append_for_tx(content, "API", "| b | 2 |")
            .unwrap()
            .expect("heading exists");
        assert!(result.contains("| a | 1 |\n| b | 2 |\n"));
    }

    #[test]
    fn section_range_includes_heading() {
        let content = "# A\nbody a\n# B\nbody b\n";
        let (start, end) = section_range(content, "A").unwrap();
        assert_eq!(&content[start..end], "# A\nbody a\n");
    }

    #[test]
    fn section_range_last_section() {
        let content = "# A\nbody a\n# B\nbody b\n";
        let (start, end) = section_range(content, "B").unwrap();
        assert_eq!(&content[start..end], "# B\nbody b\n");
    }

    #[test]
    fn move_section_same_file_before() {
        let content = "# A\na body\n# B\nb body\n# C\nc body\n";
        let (result, _) = move_section_in(content, "C", content, ("before", "B"), true).unwrap();
        let a_pos = result.find("# A").unwrap();
        let c_pos = result.find("# C").unwrap();
        let b_pos = result.find("# B").unwrap();
        assert!(a_pos < c_pos);
        assert!(c_pos < b_pos);
        assert!(result.contains("a body"));
        assert!(result.contains("b body"));
        assert!(result.contains("c body"));
    }

    #[test]
    fn move_section_same_file_after() {
        let content = "# A\na body\n# B\nb body\n# C\nc body\n";
        let (result, _) = move_section_in(content, "A", content, ("after", "B"), true).unwrap();
        let b_pos = result.find("# B").unwrap();
        let a_pos = result.find("# A").unwrap();
        let c_pos = result.find("# C").unwrap();
        assert!(b_pos < a_pos);
        assert!(a_pos < c_pos);
    }

    #[test]
    fn move_section_cross_file() {
        let source = "# Keep\nkept\n# Move\nmoved\n# Stay\nstayed\n";
        let dest = "# Intro\nintro\n# End\nend\n";
        let (new_src, new_dst) =
            move_section_in(source, "Move", dest, ("before", "End"), false).unwrap();
        assert!(!new_src.contains("# Move"));
        assert!(!new_src.contains("moved"));
        assert!(new_src.contains("# Keep"));
        assert!(new_src.contains("# Stay"));
        assert!(new_dst.contains("# Move\nmoved"));
        let move_pos = new_dst.find("# Move").unwrap();
        let end_pos = new_dst.find("# End").unwrap();
        assert!(move_pos < end_pos);
    }

    #[test]
    fn move_section_preserves_sub_headings() {
        let content = "# A\n## A1\na1 content\n## A2\na2 content\n# B\nb content\n";
        let (result, _) = move_section_in(content, "A", content, ("after", "B"), true).unwrap();
        // A should now come after B, with both sub-headings preserved.
        let b_pos = result.find("# B").unwrap();
        let a_pos = result.find("# A").unwrap();
        assert!(b_pos < a_pos, "A should be after B");
        assert!(
            result.contains("## A1\na1 content"),
            "sub-heading A1 should be preserved: {result}"
        );
        assert!(
            result.contains("## A2\na2 content"),
            "sub-heading A2 should be preserved: {result}"
        );
        assert!(
            result.contains("b content"),
            "B body should be preserved: {result}"
        );
    }

    #[test]
    fn move_section_cross_file_preserves_sub_headings() {
        let source = "# A\n## A1\na1 content\n## A2\na2 content\n# B\nb content\n";
        let dest = "# X\nx content\n# Y\ny content\n";
        let (new_src, new_dst) =
            move_section_in(source, "A", dest, ("before", "Y"), false).unwrap();
        // Source should no longer have A or its sub-headings.
        assert!(!new_src.contains("# A"));
        assert!(!new_src.contains("## A1"));
        assert!(!new_src.contains("## A2"));
        assert!(new_src.contains("# B\nb content"));
        // Dest should have A with its sub-headings before Y.
        let a_pos = new_dst.find("# A").unwrap();
        let y_pos = new_dst.find("# Y").unwrap();
        assert!(a_pos < y_pos);
        assert!(new_dst.contains("## A1\na1 content"));
        assert!(new_dst.contains("## A2\na2 content"));
    }

    // ── strip_inline_code ─────────────────────────────────────────

    #[test]
    fn strip_inline_code_basic() {
        assert_eq!(strip_inline_code("use `foo` here"), "use  here");
    }

    #[test]
    fn strip_inline_code_multiple_spans() {
        assert_eq!(strip_inline_code("`a` and `b`"), " and ");
    }

    #[test]
    fn strip_inline_code_no_backticks_returns_borrowed() {
        let result = strip_inline_code("no backticks");
        assert!(matches!(result, std::borrow::Cow::Borrowed(_)));
        assert_eq!(result, "no backticks");
    }

    #[test]
    fn strip_inline_code_text_around_spans() {
        assert_eq!(strip_inline_code("start `mid` end"), "start  end");
    }

    #[test]
    fn upsert_bullet_star_dedup_same_style() {
        // Upserting "* existing item" when body already has "* existing item"
        // should dedup (same style, same text).
        let content = "# List\n\n* existing item\n";
        let result = upsert_bullet_in(content, "List", "* existing item").unwrap();
        assert_eq!(result, content, "same-style duplicate should be deduped");
    }

    #[test]
    fn upsert_bullet_dash_appends_after_star_items() {
        // "- new item" appended correctly after existing "* " items.
        let content = "# List\n\n* alpha\n* beta\n";
        let result = upsert_bullet_in(content, "List", "- new item").unwrap();
        assert!(
            result.contains("* beta\n- new item\n"),
            "new dash bullet should follow existing star bullets: {:?}",
            result
        );
    }
}

mod line_endings {
    use super::*;

    // ── CRLF handling in table_append_in ──────────────────────────

    #[test]
    fn table_append_crlf_content_finds_correct_position() {
        // CRLF content: the byte-offset tracking in table_append_in
        // must correctly advance past \r\n (2 bytes) per line.
        let content = "# T\r\n| H |\r\n|---|\r\n| v |\r\n";
        let (start, end) = find_section(content, "T").unwrap();
        let result = table_append_in(content, start, end, "| new |").unwrap();
        // The new row must appear after the last data row.
        assert!(
            result.contains("| v |\r\n| new |"),
            "row should be appended after existing data row in CRLF content: {:?}",
            result
        );
        // The content before the insertion should be preserved.
        assert!(
            result.contains("| H |\r\n|---|\r\n| v |\r\n"),
            "original CRLF table should be intact: {:?}",
            result
        );
    }

    #[test]
    fn table_append_crlf_header_only() {
        // Table with only header + separator in CRLF content.
        let content = "# T\r\n| H |\r\n|---|\r\n";
        let (start, end) = find_section(content, "T").unwrap();
        let result = table_append_in(content, start, end, "| a |").unwrap();
        assert!(
            result.contains("|---|\r\n| a |"),
            "row should be appended after separator in CRLF content: {:?}",
            result
        );
    }

    #[test]
    fn table_append_crlf_multiple_data_rows() {
        // Multiple data rows with CRLF; new row goes after the last one.
        let content = "# T\r\n| H |\r\n|---|\r\n| a |\r\n| b |\r\n";
        let (start, end) = find_section(content, "T").unwrap();
        let result = table_append_in(content, start, end, "| c |").unwrap();
        assert!(
            result.contains("| b |\r\n| c |"),
            "row should be appended after the last data row: {:?}",
            result
        );
    }

    // ── CRLF in parse_headings ────────────────────────────────────

    #[test]
    fn parse_headings_crlf_strips_carriage_return() {
        // .lines() strips \r, so heading text should not contain \r.
        let content = "## Heading One\r\n\r\nBody text.\r\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1);
        assert_eq!(headings[0].text, "Heading One");
        assert!(
            !headings[0].text.contains('\r'),
            "heading text must not contain \\r"
        );
        assert_eq!(headings[0].level, 2);
    }

    #[test]
    fn parse_headings_crlf_multiple_headings() {
        let content = "# First\r\nBody 1\r\n## Second\r\nBody 2\r\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "First");
        assert_eq!(headings[1].text, "Second");
        // Verify section boundaries are correct.
        assert_eq!(headings[0].line_start, 0);
        assert_eq!(headings[1].line_start, 2);
    }

    #[test]
    fn replace_section_crlf_preserves_endings() {
        let content = "# Title\r\nOld body\r\n# Next\r\nKeep\r\n";
        let result = replace_section_in(content, "Title", "New body").unwrap();
        // All newlines should be CRLF; no bare LF allowed.
        let bare_lf = result.replace("\r\n", "").contains('\n');
        assert!(!bare_lf, "found bare LF in CRLF output: {:?}", result);
        assert!(result.contains("New body\r\n"));
    }

    #[test]
    fn upsert_bullet_crlf_preserves_endings() {
        let content = "# List\r\n- item1\r\n";
        let result = upsert_bullet_in(content, "List", "- item2").unwrap();
        let bare_lf = result.replace("\r\n", "").contains('\n');
        assert!(!bare_lf, "found bare LF in CRLF output: {:?}", result);
        assert!(result.contains("- item2\r\n"));
    }

    #[test]
    fn insert_after_heading_crlf_preserves_endings() {
        let content = "# Title\r\nExisting\r\n";
        let result = insert_after_heading_in(content, "Title", "Inserted").unwrap();
        let bare_lf = result.replace("\r\n", "").contains('\n');
        assert!(!bare_lf, "found bare LF in CRLF output: {:?}", result);
        assert!(result.contains("Inserted\r\n"));
    }

    #[test]
    fn table_append_crlf_complete_line_endings() {
        let content = "# T\r\n| H |\r\n|---|\r\n| v |\r\n";
        let (start, end) = find_section(content, "T").unwrap();
        let result = table_append_in(content, start, end, "| new |").unwrap();
        // Count LF and CRLF occurrences; they should be equal.
        let lf_count = result.matches('\n').count();
        let crlf_count = result.matches("\r\n").count();
        assert_eq!(
            lf_count, crlf_count,
            "all newlines must be CRLF: lf={}, crlf={}, result={:?}",
            lf_count, crlf_count, result
        );
    }

    #[test]
    fn find_section_crlf_returns_correct_body() {
        let content = "## Heading One\r\n\r\nBody text.\r\n## Next\r\n";
        let (start, end) = find_section(content, "Heading One").unwrap();
        let body = &content[start..end];
        // Body should include the blank line and body text between headings.
        assert!(
            body.contains("Body text."),
            "body should contain body text: {:?}",
            body
        );
    }
}

mod edge_cases {
    use super::*;

    #[test]
    fn parse_headings_skips_fenced_code_blocks() {
        let content = "# Real\n```\n# Fake\n```\n## Also Real\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Real");
        assert_eq!(headings[1].text, "Also Real");
    }

    #[test]
    fn parse_headings_skips_indented_fenced_code_blocks() {
        // CommonMark allows up to 3 spaces of indentation before fence markers.
        let content = "# Real\n   ```\n# Fake inside indented fence\n   ```\n## Also Real\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Real");
        assert_eq!(headings[1].text, "Also Real");

        // 4 spaces is NOT a fence opener (indented code block instead)
        let content4 = "# Real\n    ```\n# Still Real\n    ```\n";
        let headings4 = parse_headings(content4);
        assert_eq!(headings4.len(), 2);
        assert_eq!(headings4[0].text, "Real");
        assert_eq!(headings4[1].text, "Still Real");

        // Indented tilde fences
        let tilde = "# Top\n  ~~~\n# Fake\n  ~~~\n# Bottom\n";
        let headings_tilde = parse_headings(tilde);
        assert_eq!(headings_tilde.len(), 2);
        assert_eq!(headings_tilde[0].text, "Top");
        assert_eq!(headings_tilde[1].text, "Bottom");
    }

    #[test]
    fn parse_headings_longer_fence_requires_matching_length() {
        // A 4-backtick fence is only closed by 4+ backticks, not 3.
        let content = "# Top\n````\n```\n# Fake\n```\n````\n# Bottom\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Top");
        assert_eq!(headings[1].text, "Bottom");

        // A 5-tilde fence requires 5+ tildes to close
        let tilde5 = "# Top\n~~~~~\n~~~\n# Fake\n~~~\n~~~~~\n# Bottom\n";
        let headings5 = parse_headings(tilde5);
        assert_eq!(headings5.len(), 2);
        assert_eq!(headings5[0].text, "Top");
        assert_eq!(headings5[1].text, "Bottom");
    }

    #[test]
    fn parse_headings_mixed_fence_markers() {
        // ~~~ inside a ``` block is content, not a closer
        let content = "# Top\n```\n~~~\n# Not Real\n~~~\n```\n# Bottom\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Top");
        assert_eq!(headings[1].text, "Bottom");
    }

    #[test]
    fn parse_headings_skips_tilde_fenced_blocks() {
        let content = "# Top\n~~~bash\n# Not a heading\n~~~\n# Bottom\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Top");
        assert_eq!(headings[1].text, "Bottom");
    }

    #[test]
    fn parse_headings_setext_inside_fenced_code_block_ignored() {
        let content = "# Real\n```\nFake\n====\n```\n## Also Real\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Real");
        assert_eq!(headings[1].text, "Also Real");
    }

    #[test]
    fn parse_headings_setext_single_char_underline() {
        // CommonMark allows a single = or - as an underline.
        let content = "H1\n=\n\nH2\n-\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].level, 1);
        assert_eq!(headings[0].text, "H1");
        assert_eq!(headings[1].level, 2);
        assert_eq!(headings[1].text, "H2");
    }

    #[test]
    fn parse_headings_setext_not_triggered_by_blank_preceding_line() {
        // A --- after a blank line is a thematic break, not a setext heading.
        let content = "Some text\n\n---\n\nMore text\n";
        let headings = parse_headings(content);
        assert!(
            headings.is_empty(),
            "thematic break should not create a heading: {:?}",
            headings
        );
    }

    #[test]
    fn parse_headings_ignores_invalid() {
        let content = "#nospace\n##also\n# Valid\n###### Six\n####### Seven\n";
        let headings = parse_headings(content);
        // Only "# Valid" and "###### Six" are valid (Seven > 6 levels)
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Valid");
        assert_eq!(headings[1].text, "Six");
    }

    #[test]
    fn parse_headings_strips_atx_closing_hashes() {
        let content = "## Heading ##\n### Another ###\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Heading");
        assert_eq!(headings[1].text, "Another");
    }

    #[test]
    fn parse_headings_closing_hashes_without_space_are_content() {
        // Per CommonMark, closing hashes must be preceded by a space.
        let content = "# foo#\n## bar##baz\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "foo#");
        assert_eq!(headings[1].text, "bar##baz");
    }

    #[test]
    fn find_section_matches_heading_with_closing_hashes() {
        let content = "## API ##\nsome text\n## Next\nother\n";
        let (start, end) = find_section(content, "API").unwrap();
        assert_eq!(&content[start..end], "some text\n");
    }

    #[test]
    fn find_section_with_hashes_in_query() {
        let content = "## API\nsome text\n";
        let (start, end) = find_section(content, "## API").unwrap();
        assert_eq!(&content[start..end], "some text\n");
    }

    #[test]
    fn replace_section_empty_replacement() {
        let content = "# Title\nOld body\n# Next\nKeep\n";
        let result = replace_section_in(content, "Title", "").unwrap();
        assert_eq!(result, "# Title\n# Next\nKeep\n");
    }

    #[test]
    fn insert_after_heading_places_content_under_heading_not_after_body() {
        // Explicit test + documentation: insert_after_heading inserts
        // immediately after the heading (before any existing body content
        // such as tables). This is distinct from "move after" which uses
        // the full destination body end.
        let content =
            "## Features\n\n| Name | Status |\n|------|--------|\n| search | done |\n\n## Other\n";
        let result = insert_after_heading_in(content, "## Features", "New intro.\n").unwrap();
        let f = result.find("## Features").unwrap();
        let i = result.find("New intro").unwrap();
        let t = result.find("| Name | Status |").unwrap();
        assert!(f < i && i < t);
        assert!(result.contains("| search | done |"));
    }

    #[test]
    fn dedupe_headings_no_duplicates() {
        let content = "# A\n## B\n# C\n";
        let (result, removed) = dedupe_headings_in(content);
        assert!(removed.is_empty());
        assert_eq!(result, content);
    }

    #[test]
    fn table_append_header_only() {
        let content = "# API\n| Name | Value |\n|---|---|\n## Next\n";
        let (start, end) = find_section(content, "API").unwrap();
        let result = table_append_in(content, start, end, "| a | 1 |").unwrap();
        assert_eq!(
            result,
            "# API\n| Name | Value |\n|---|---|\n| a | 1 |\n## Next\n"
        );
    }

    #[test]
    fn move_section_self_move_before_returns_none() {
        // Moving section A to before itself: after removing A, the
        // destination heading no longer exists, so the move returns None.
        let content = "# A\na body\n# B\nb body\n";
        let result = move_section_in(content, "A", content, ("before", "A"), true);
        assert!(
            result.is_none(),
            "self-move (before self) should return None: {:?}",
            result
        );
    }

    #[test]
    fn move_section_self_move_after_returns_none() {
        // Moving section A to after itself: same issue.
        let content = "# A\na body\n# B\nb body\n";
        let result = move_section_in(content, "A", content, ("after", "A"), true);
        assert!(
            result.is_none(),
            "self-move (after self) should return None: {:?}",
            result
        );
    }

    #[test]
    fn strip_inline_code_unmatched_backtick() {
        // Unmatched backtick is kept as literal text (correct per CommonMark).
        assert_eq!(strip_inline_code("before `after"), "before `after");
    }

    #[test]
    fn strip_inline_code_empty_string() {
        let result = strip_inline_code("");
        assert!(matches!(result, std::borrow::Cow::Borrowed(_)));
        assert_eq!(result, "");
    }

    #[test]
    fn strip_inline_code_adjacent_backticks() {
        // Two backticks with no matching closing run is unmatched.
        assert_eq!(strip_inline_code("``"), "``");
    }

    #[test]
    fn strip_inline_code_only_backtick_content() {
        assert_eq!(strip_inline_code("`code`"), "");
    }

    // Regression: double-backtick code spans should strip their content.
    #[test]
    fn strip_inline_code_double_backtick_span() {
        assert_eq!(strip_inline_code("Use ``git add .`` safely"), "Use  safely");
    }

    #[test]
    fn strip_inline_code_triple_backtick_span() {
        assert_eq!(strip_inline_code("Run ```git add .``` here"), "Run  here");
    }

    #[test]
    fn strip_inline_code_preserves_non_ascii_utf8() {
        // Multi-byte UTF-8 characters (é, ñ, 日) outside code spans must
        // not be corrupted by byte-to-char casting.
        assert_eq!(strip_inline_code("café `code` résumé"), "café  résumé");
        assert_eq!(strip_inline_code("日本語テスト"), "日本語テスト");
        assert_eq!(strip_inline_code("`hidden` naïve"), " naïve");
    }

    #[test]
    fn git_add_dot_empty_string() {
        assert!(!has_dangerous_git_add_dot(""));
    }

    #[test]
    fn upsert_bullet_cross_style_dash_into_star_dedup() {
        // Upserting "- existing item" when body has "* existing item":
        // cross-style dedup should recognize them as the same item.
        let content = "# List\n\n* existing item\n";
        let result = upsert_bullet_in(content, "List", "- existing item").unwrap();
        assert_eq!(result, content, "cross-style bullets should dedup");
    }

    #[test]
    fn upsert_bullet_no_prefix_into_star_content_dedup() {
        // Upserting "existing item" (no prefix) normalizes to "- existing item"
        // which should dedup against body's "* existing item".
        let content = "# List\n\n* existing item\n";
        let result = upsert_bullet_in(content, "List", "existing item").unwrap();
        assert_eq!(
            result, content,
            "auto-prefixed dash should dedup against star bullet"
        );
    }

    #[test]
    fn upsert_bullet_plus_prefix_dedup_against_dash() {
        let content = "# List\n\n- existing item\n";
        let result = upsert_bullet_in(content, "List", "+ existing item").unwrap();
        assert_eq!(
            result, content,
            "plus-prefixed bullet should dedup against dash"
        );
    }

    #[test]
    fn heading_inside_html_comment_ignored() {
        let content = "# Real One\nbody\n<!--\n## Hidden\n-->\n# Real Two\nmore\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Real One");
        assert_eq!(headings[1].text, "Real Two");
    }

    #[test]
    fn single_line_html_comment_with_heading_ignored() {
        let content = "# Before\n<!-- ## Not a heading -->\n# After\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Before");
        assert_eq!(headings[1].text, "After");
    }

    #[test]
    fn find_section_empty_body() {
        // Heading immediately followed by another heading => empty body
        let content = "# A\n# B\n";
        let (start, end) = find_section(content, "A").unwrap();
        assert_eq!(
            start, end,
            "empty section should have body_start == body_end"
        );
        // The body slice should be empty
        assert_eq!(&content[start..end], "");
    }

    #[test]
    fn find_section_empty_body_with_subsection() {
        // ## level heading immediately after # level => # A body includes ## B
        // but if both are same level, body is empty
        let content = "## A\n## B\nB body\n";
        let (start, end) = find_section(content, "A").unwrap();
        assert_eq!(&content[start..end], "");
    }

    #[test]
    fn replace_section_empty_body_inserts_content() {
        let content = "# A\n# B\n";
        let result = replace_section_in(content, "A", "new content").unwrap();
        assert_eq!(result, "# A\nnew content\n# B\n");
    }

    #[test]
    fn replace_section_empty_body_with_empty_replacement() {
        let content = "# A\n# B\n";
        let result = replace_section_in(content, "A", "").unwrap();
        assert_eq!(result, "# A\n# B\n");
    }

    #[test]
    fn insert_after_heading_empty_section() {
        let content = "# A\n# B\n";
        let result = insert_after_heading_in(content, "A", "inserted\n").unwrap();
        assert_eq!(result, "# A\ninserted\n# B\n");
    }

    #[test]
    fn insert_after_heading_empty_section_no_trailing_newline() {
        let content = "# A\n# B\n";
        let result = insert_after_heading_in(content, "A", "inserted").unwrap();
        // Function appends \n when insertion doesn't end with one
        assert!(result.contains("# A\ninserted\n# B\n"));
    }

    #[test]
    fn upsert_bullet_empty_section() {
        let content = "# A\n# B\n";
        let result = upsert_bullet_in(content, "A", "- new bullet").unwrap();
        assert!(
            result.contains("- new bullet"),
            "bullet should appear in result: {result}"
        );
        assert!(
            result.contains("# B"),
            "next heading should be preserved: {result}"
        );
    }

    #[test]
    fn upsert_bullet_empty_section_auto_prefix() {
        let content = "# A\n# B\n";
        let result = upsert_bullet_in(content, "A", "item without dash").unwrap();
        assert!(
            result.contains("- item without dash"),
            "auto-prefix should be added: {result}"
        );
    }

    #[test]
    fn find_section_duplicate_headings_returns_first() {
        let content = "# A\nfirst body\n# B\nmiddle\n# A\nsecond body\n";
        let (start, end) = find_section(content, "A").unwrap();
        let body = &content[start..end];
        assert_eq!(body, "first body\n");
    }

    #[test]
    fn find_section_eof_without_trailing_newline() {
        let content = "# A\ncontent";
        let (start, end) = find_section(content, "A").unwrap();
        let body = &content[start..end];
        assert_eq!(body, "content");
    }

    #[test]
    fn find_section_single_heading_no_body_no_newline() {
        let content = "# A";
        let (start, end) = find_section(content, "A").unwrap();
        assert_eq!(start, end);
        assert_eq!(&content[start..end], "");
    }

    #[test]
    fn replace_section_eof_without_trailing_newline() {
        let content = "# A\nold content";
        let result = replace_section_in(content, "A", "new content").unwrap();
        assert_eq!(result, "# A\nnew content\n");
    }

    #[test]
    fn insert_after_heading_at_eof() {
        let content = "# A\nexisting";
        let result = insert_after_heading_in(content, "A", "inserted\n").unwrap();
        assert_eq!(result, "# A\ninserted\nexisting");
    }

    #[test]
    fn empty_section_three_consecutive_headings() {
        // Both A and B are empty; C has body
        let content = "# A\n# B\n# C\nbody\n";
        let (a_start, a_end) = find_section(content, "A").unwrap();
        assert_eq!(&content[a_start..a_end], "");

        let (b_start, b_end) = find_section(content, "B").unwrap();
        assert_eq!(&content[b_start..b_end], "");

        let (c_start, c_end) = find_section(content, "C").unwrap();
        assert_eq!(&content[c_start..c_end], "body\n");
    }

    #[test]
    fn html_comment_inside_fenced_block_not_treated_as_comment() {
        // A <!-- inside a fenced code block must NOT activate the HTML
        // comment filter. If it did, lines after the fence close would
        // be silently swallowed until a --> appeared.
        let content = "# Before\n```html\n<!-- this is code -->\n# Fake\n```\n# After\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Before");
        assert_eq!(headings[1].text, "After");
    }

    #[test]
    fn html_comment_spanning_lines_hides_heading() {
        // A multi-line HTML comment should hide any heading inside it.
        let content = "# Real\n<!--\n# Hidden\n-->\n# Also Real\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Real");
        assert_eq!(headings[1].text, "Also Real");
    }

    #[test]
    fn single_line_html_comment_heading_skipped() {
        // A single-line <!-- ... --> that looks like a heading marker
        // should be filtered out entirely.
        let content = "# Top\n<!-- # Not a heading -->\n# Bottom\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(headings[0].text, "Top");
        assert_eq!(headings[1].text, "Bottom");
    }
}

mod error_handling {
    use super::*;

    #[test]
    fn find_section_missing() {
        let content = "# Title\nBody\n";
        assert!(find_section(content, "Nonexistent").is_none());
    }

    #[test]
    fn replace_section_missing_heading() {
        let content = "# Title\nBody\n";
        assert!(replace_section_in(content, "Missing", "x").is_none());
    }

    #[test]
    fn table_append_no_trailing_newline() {
        // Regression: when the file ends without a trailing newline,
        // the new row must not be fused onto the last existing row.
        let content = "# API\n| H |\n|---|\n| v |";
        let result = table_append_in(content, 6, content.len(), "| new |").unwrap();
        assert!(
            result.contains("| v |\n| new |"),
            "rows should be on separate lines: {result}"
        );
        assert!(
            !result.contains("| v || new |"),
            "rows must not be fused: {result}"
        );
    }

    #[test]
    fn table_append_no_table() {
        let content = "# API\nJust text\n";
        let (start, end) = find_section(content, "API").unwrap();
        let err = table_append_in(content, start, end, "| b | 2 |").unwrap_err();
        assert!(matches!(err, TableAppendError::NoTable));
    }

    #[test]
    fn is_separator_row_rejects_dashless_cells() {
        // A row like "| |" or "| : |" has no dashes and is not a valid
        // CommonMark table separator. Each cell must contain at least one dash.
        use super::is_separator_row;
        assert!(!is_separator_row("|  |"), "spaces only");
        assert!(!is_separator_row("| : |"), "colon only");
        assert!(!is_separator_row("| : : |"), "colons and spaces");
        // Valid separators should still pass.
        assert!(is_separator_row("| --- |"));
        assert!(is_separator_row("| :--: | --- |"));
        assert!(is_separator_row("|---|"));
    }

    #[test]
    fn section_range_missing() {
        let content = "# A\nbody\n";
        assert!(section_range(content, "Missing").is_none());
    }

    #[test]
    fn move_section_missing_source_heading() {
        let content = "# A\nbody\n";
        assert!(move_section_in(content, "Missing", content, ("before", "A"), true).is_none());
    }

    #[test]
    fn move_section_missing_target_heading() {
        let content = "# A\nbody\n# B\nbody\n";
        assert!(move_section_in(content, "A", content, ("before", "Missing"), true).is_none());
    }
}

mod security {
    use super::*;

    // ── has_dangerous_git_add_dot ─────────────────────────────────

    #[test]
    fn git_add_dot_at_eol() {
        assert!(has_dangerous_git_add_dot("git add ."));
    }

    #[test]
    fn git_add_dot_followed_by_space() {
        assert!(has_dangerous_git_add_dot("git add . && git commit"));
    }

    #[test]
    fn git_add_dot_followed_by_tab() {
        assert!(has_dangerous_git_add_dot("git add .\tnext"));
    }

    #[test]
    fn git_add_dotgitignore_is_safe() {
        assert!(!has_dangerous_git_add_dot("git add .gitignore"));
    }

    #[test]
    fn git_add_dot_slash_is_safe() {
        assert!(!has_dangerous_git_add_dot("git add ./file"));
    }

    #[test]
    fn git_add_dot_mid_line() {
        assert!(has_dangerous_git_add_dot("run git add . now"));
    }

    #[test]
    fn git_add_dot_no_match() {
        assert!(!has_dangerous_git_add_dot("no match here"));
    }

    #[test]
    fn git_add_dot_multiple_occurrences_first_safe() {
        // First "git add .gitignore" is safe, second "git add ." is dangerous
        assert!(has_dangerous_git_add_dot("git add .gitignore && git add ."));
    }

    #[test]
    fn git_add_dot_multiple_occurrences_all_safe() {
        assert!(!has_dangerous_git_add_dot(
            "git add .gitignore && git add .env"
        ));
    }
}

mod format_preservation {
    use super::*;

    #[test]
    fn replace_section_setext_preserves_underline() {
        // Use same-level headings so the section is bounded.
        let content = "Title\n=====\n\nOld body\n\nNext\n=====\nKeep\n";
        let result = replace_section_in(content, "Title", "New body").unwrap();
        assert_eq!(
            result, "Title\n=====\nNew body\n\nNext\n=====\nKeep\n",
            "underline must be preserved and blank line before next heading kept: {result}"
        );
    }

    #[test]
    fn upsert_bullet_setext_heading() {
        let content = "List\n----\n\n- item1\n";
        let result = upsert_bullet_in(content, "List", "- item2").unwrap();
        assert!(
            result.contains("----\n"),
            "underline must be preserved: {result}"
        );
        assert!(
            result.contains("- item1\n- item2\n"),
            "bullet should be appended: {result}"
        );
        // Underline must NOT appear in the body match
        assert!(
            !result.contains("- ----"),
            "underline must not be treated as bullet content: {result}"
        );
    }

    #[test]
    fn section_range_setext_includes_text_and_underline() {
        // Use same-level heading to bound the section.
        let content = "Title\n=====\nbody\nNext\n=====\nmore\n";
        let (start, end) = section_range(content, "Title").unwrap();
        // section_range should include the text line + underline + body
        assert_eq!(
            &content[start..end],
            "Title\n=====\nbody\n",
            "setext section_range should include text line and underline"
        );
    }

    // ── Mixed bullet styles in upsert_bullet_in ──────────────────

    #[test]
    fn upsert_bullet_star_prefix_kept_as_is() {
        // When input starts with "* ", it is kept as-is (not converted to "- ").
        let content = "# List\n\n* existing item\n";
        let result = upsert_bullet_in(content, "List", "* new item").unwrap();
        assert!(
            result.contains("* new item"),
            "star-prefixed bullet should be preserved: {:?}",
            result
        );
    }

    #[test]
    fn upsert_bullet_plus_prefix_preserved() {
        // When inserting a new bullet with +, the prefix is kept.
        let content = "# List\n\n- other item\n";
        let result = upsert_bullet_in(content, "List", "+ brand new").unwrap();
        assert!(
            result.contains("+ brand new"),
            "plus-prefixed bullet should be preserved: {:?}",
            result
        );
    }
}

mod regression {
    use super::*;

    #[test]
    fn upsert_bullet_preserves_blank_line_before_next_heading() {
        // Regression test for #973: upsert_bullet consumed the blank line
        // separating the section body from the next heading.
        let content = "## Section A\n\n- Bullet one\n- Bullet two\n\n## Section B\n\nContent B.\n";
        let result = upsert_bullet_in(content, "Section A", "- Bullet three").unwrap();
        assert!(
            result.contains("- Bullet three\n\n## Section B"),
            "blank line before next heading must be preserved: {result}"
        );
    }

    #[test]
    fn upsert_bullet_inserts_before_trailing_blank_lines() {
        // Regression: the new bullet should be grouped with existing
        // bullets, not placed after trailing blank lines.
        let content = "# A\n- item1\n- item2\n\n# B\n";
        let result = upsert_bullet_in(content, "A", "- item3").unwrap();
        // The new bullet must appear immediately after item2, before the blank line.
        assert!(
            result.contains("- item2\n- item3\n"),
            "new bullet should be adjacent to existing bullets: {result}"
        );
        // The blank line separator before # B must be preserved.
        assert!(
            result.contains("item3\n\n# B"),
            "blank line before next heading must be preserved: {result}"
        );
    }

    #[test]
    fn upsert_bullet_preserves_blank_before_sub_heading() {
        // #973 variant: subsection headings (###) also need blank line preservation.
        let content = "### Bug Fixes\n\n- Fix one\n\n### Dependencies\n\nDep content.\n";
        let result = upsert_bullet_in(content, "Bug Fixes", "- Fix two").unwrap();
        assert!(
            result.contains("- Fix two\n\n### Dependencies"),
            "blank line before sub-heading must be preserved: {result}"
        );
    }

    #[test]
    fn move_section_after_preserves_dest_table_body() {
        // Regression for #825: moving a section "after" a dest that owns a
        // table must keep the table under the dest heading.
        let content = "# T\n\n## Commands\n\ncmd body\n\n## Rules\n\n- rule1\n\n## Features\n\n| Name | Status |\n|------|--------|\n| search | done |\n";
        let (result, _) =
            move_section_in(content, "## Rules", content, ("after", "## Features"), true).unwrap();
        // Features heading should still be followed (eventually) by its table,
        // and Rules after the table.
        let features_pos = result.find("## Features").unwrap();
        let rules_pos = result.find("## Rules").unwrap();
        let table_pos = result.find("| search | done |").unwrap();
        assert!(
            features_pos < table_pos,
            "table should still be after Features"
        );
        assert!(table_pos < rules_pos, "Rules should be after the table");
        assert!(result.contains("- rule1"));
    }

    // Regression: backtick closing fence with trailing non-whitespace
    // must NOT close the code block (CommonMark spec 4.5). A line like
    // "```javascript" inside a backtick block is not a valid closer.
    #[test]
    fn backtick_fence_closer_rejects_trailing_content() {
        let content = "\
````
```javascript
# Not a real heading
```
````
# Real heading
body text
";
        let headings = parse_headings(content);
        assert_eq!(
            headings.len(),
            1,
            "only the heading outside the code block should be parsed"
        );
        assert_eq!(headings[0].text, "Real heading");
    }

    // CommonMark 4.5: closing fences (both backtick and tilde) may only be
    // followed by spaces/tabs. Trailing non-whitespace means the line is NOT
    // a valid closer, so the block stays open.
    #[test]
    fn tilde_fence_closer_rejects_trailing_content() {
        let content = "\
~~~
# Inside tilde block
~~~ some trailing text
# Also inside (fence not closed)
";
        let headings = parse_headings(content);
        assert_eq!(
            headings.len(),
            0,
            "tilde fence with trailing text is not closed; all headings are inside"
        );
    }

    // Tilde fence closes normally when only whitespace follows.
    #[test]
    fn tilde_fence_closer_allows_trailing_whitespace() {
        let content = "\
~~~
# Inside tilde block
~~~   \t
# Outside heading
";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1);
        assert_eq!(headings[0].text, "Outside heading");
    }

    // CommonMark 4.5: backtick opening fence info string must not contain
    // backtick characters. A line like ```foo`bar is NOT a fence opener.
    #[test]
    fn backtick_fence_info_string_with_backtick_not_opened() {
        let content = "\
```foo`bar
# Real heading (not inside a fence because opener was invalid)
```foo`bar again
# Also real
";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 2);
        assert_eq!(
            headings[0].text,
            "Real heading (not inside a fence because opener was invalid)"
        );
        assert_eq!(headings[1].text, "Also real");
    }

    // Verify that a clean backtick closing fence (no trailing content) still works.
    #[test]
    fn backtick_fence_closer_allows_trailing_whitespace() {
        let content = "\
```
# Inside code block
```   \t
# Real heading
";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1);
        assert_eq!(headings[0].text, "Real heading");
    }

    #[test]
    fn parse_headings_empty_atx_heading() {
        // CommonMark 4.2: "###" with no trailing text/space is a valid empty heading
        let content = "###\nsome body\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1, "bare ### should be a level-3 heading");
        assert_eq!(headings[0].level, 3);
        assert_eq!(headings[0].text, "");
    }

    #[test]
    fn parse_headings_tab_after_hashes() {
        // CommonMark 4.2: opening # can be followed by spaces OR tabs
        let content = "#\tTitle\nbody\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1, "tab after # should be accepted");
        assert_eq!(headings[0].level, 1);
        assert_eq!(headings[0].text, "Title");
    }

    #[test]
    fn parse_headings_indented_up_to_3_spaces() {
        // CommonMark 4.2: up to 3 spaces of leading indentation allowed
        let content = "  ## Indented\nbody\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1, "2-space indent should be accepted");
        assert_eq!(headings[0].level, 2);
        assert_eq!(headings[0].text, "Indented");
    }

    #[test]
    fn parse_headings_4_space_indent_rejected() {
        // CommonMark 4.2: 4+ spaces is an indented code block, not a heading
        let content = "    ## Not a heading\nbody\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 0, "4-space indent should NOT be a heading");
    }

    #[test]
    fn upsert_bullet_trailing_spaces_on_content_line() {
        // Regression: trim_end_matches included ' ' which would strip trailing
        // spaces from the last content line, corrupting the insertion point.
        let content = "# List\n- item with trailing spaces   \n";
        let result = upsert_bullet_in(content, "List", "- new item").unwrap();
        assert!(
            result.contains("- item with trailing spaces   \n- new item\n"),
            "trailing spaces must be preserved: {result}"
        );
    }

    // -----------------------------------------------------------------------
    // YAML frontmatter (#1102)
    // -----------------------------------------------------------------------

    #[test]
    fn yaml_frontmatter_not_misinterpreted_as_setext_heading() {
        // The closing `---` of YAML frontmatter was being interpreted as
        // a setext underline, creating a phantom heading from the last
        // frontmatter field (#1102).
        let content = "---\ntitle: Hello\n---\n\n# Real Heading\n\nBody text.\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1, "only the ATX heading should be parsed");
        assert_eq!(headings[0].text, "Real Heading");
    }

    #[test]
    fn yaml_frontmatter_with_dots_closing_delimiter() {
        // YAML spec allows `...` as an alternative closing delimiter.
        let content = "---\ntitle: Hello\n...\n\n# Heading\n\nBody.\n";
        let headings = parse_headings(content);
        assert_eq!(headings.len(), 1);
        assert_eq!(headings[0].text, "Heading");
    }

    #[test]
    fn replace_section_with_frontmatter() {
        // Section operations should work correctly even with frontmatter.
        let content = "---\ntitle: Doc\n---\n\n# Section A\n\nOld body.\n\n# Section B\n\nKeep.\n";
        let result = replace_section_in(content, "Section A", "New body.\n").unwrap();
        assert!(
            result.contains("# Section A\nNew body.\n"),
            "section A should be replaced: {result}"
        );
        assert!(
            result.contains("# Section B"),
            "section B should be preserved: {result}"
        );
        // Frontmatter must remain intact
        assert!(
            result.starts_with("---\ntitle: Doc\n---"),
            "frontmatter should be preserved: {result}"
        );
    }

    /// Nested sub-bullets must not falsely dedup against top-level bullets (#1157).
    #[test]
    fn upsert_bullet_nested_subbullet_no_false_dedup() {
        let content = "# Tasks\n- parent\n  - deploy\n";
        let result = upsert_bullet_in(content, "Tasks", "- deploy").unwrap();
        // The indented "  - deploy" is a sub-bullet; a new top-level
        // "- deploy" should still be inserted.
        assert!(
            result.contains("\n- deploy\n"),
            "top-level bullet should be added: {result}"
        );
        let deploy_count = result.matches("\n- deploy").count();
        assert_eq!(
            deploy_count, 1,
            "exactly one top-level '- deploy' expected: {result}"
        );
    }

    /// When the heading query includes `#` markers, find_section must
    /// respect the heading level, not just the text (#1158).
    #[test]
    fn find_section_with_level_filter() {
        let content = "# API\nGeneral overview\n## API\nDetailed reference\n";
        // Query with "## API" should match the h2, not the h1.
        let (start, end) = find_section(content, "## API").unwrap();
        let body = &content[start..end];
        assert_eq!(body, "Detailed reference\n");
    }

    /// A plain text query (no `#` prefix) should match any heading level.
    #[test]
    fn find_section_plain_text_matches_any_level() {
        let content = "## Intro\nSome text\n# Intro\nOther text\n";
        // Plain "Intro" matches the first occurrence regardless of level.
        let (start, end) = find_section(content, "Intro").unwrap();
        let body = &content[start..end];
        assert_eq!(body, "Some text\n");
    }

    #[test]
    fn table_append_wrong_column_count_returns_column_mismatch() {
        let content = "# T\n| A | B | C |\n|---|---|---|\n| 1 | 2 | 3 |\n";
        let (start, end) = find_section(content, "T").unwrap();
        // Row with only 1 column should be rejected with ColumnMismatch.
        let err = table_append_in(content, start, end, "| x |").unwrap_err();
        assert!(
            matches!(
                err,
                TableAppendError::ColumnMismatch {
                    expected: 3,
                    actual: 1
                }
            ),
            "expected ColumnMismatch, got: {err:?}"
        );
    }

    #[test]
    fn table_append_correct_column_count_succeeds() {
        let content = "# T\n| A | B |\n|---|---|\n| 1 | 2 |\n";
        let (start, end) = find_section(content, "T").unwrap();
        let result = table_append_in(content, start, end, "| 3 | 4 |");
        let out = result.expect("table_append_in should return Ok");
        assert!(out.contains("| 3 | 4 |"));
    }

    #[test]
    fn table_append_not_table_row_returns_column_mismatch() {
        // Row without pipe wrapping should fail with ColumnMismatch,
        // not with NoTable (there IS a table, the row is just malformed).
        let content = "# T\n| A | B |\n|---|---|\n| 1 | 2 |\n";
        let (start, end) = find_section(content, "T").unwrap();
        let err = table_append_in(content, start, end, "x | y").unwrap_err();
        assert!(
            matches!(err, TableAppendError::ColumnMismatch { .. }),
            "expected ColumnMismatch for unwrapped row, got: {err:?}"
        );
    }

    #[test]
    fn upsert_bullet_does_not_dedup_against_paragraph() {
        let content = "# Rules\nRun make check\n";
        let out = upsert_bullet_in(content, "Rules", "- Run make check")
            .expect("upsert_bullet_in should return Some for non-bullet paragraph");
        assert!(
            out.contains("- Run make check"),
            "bullet should be inserted"
        );
    }

    #[test]
    fn upsert_bullet_still_dedups_against_actual_bullet() {
        let content = "# Rules\n- Run make check\n";
        let out = upsert_bullet_in(content, "Rules", "- Run make check")
            .expect("upsert_bullet_in should return Some for dedup case");
        // Should return unchanged content (dedup).
        assert_eq!(out, content);
    }
}