fix: escape pipe and backslash in Jira/Confluence tables (#17)

[cmeans-claude-dev]

Summary

• Add _escape_jira_cell() helper that escapes \ to \\ then | to \|
• Apply escaping in _format_jira() to all cells (header and data rows)
• Confluence routes through _format_jira, so it gets the fix automatically
• Add 6 tests covering pipe in data/header, double-pipe, backslash, leading/trailing pipe, and Confluence equivalence

Part of the escaping series (#16, #18).

Test plan

• uv run pytest tests/test_parser.py -v passes all 67 tests (6 new + 61 existing)
• Verify a cell containing | produces \| in jira output
• Verify || in a data cell does not create accidental header markup

Closes #17

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[cmeans]

QA Review — PR #45

Verdict: Zero findings. Ready for maintainer signoff.

Code review

_escape_jira_cell() (parser.py:428): Same escape order as the markdown helper — backslash first, then pipe. Correct. ✓

Header and data rows: Both header (|| delimited) and data (| delimited) rows use escaped values. The escaped array replaces normalized throughout. ✓

Confluence routing: format_table() dispatches confluence to _format_jira() (test_format_confluence_same_as_jira confirms). ✓

Double-pipe safety: A cell containing || becomes \|\|, which Jira renders as literal || in a data cell rather than interpreting it as header-row syntax. Confirmed by test_format_jira_escapes_double_pipe. This is the key Jira-specific edge case. ✓

Tests

Full suite: 232 passed, 0 failed, 0 deselected (226 base + 6 new).
Parser tests: 67 passed (61 existing + 6 new).

New tests (all PASS):

1. test_format_jira_escapes_pipe_in_data — pipe in data cell, structural check
2. test_format_jira_escapes_pipe_in_header — pipe in header cell
3. test_format_jira_escapes_double_pipe — || doesn't create accidental header markup
4. test_format_jira_escapes_backslash — lone backslash escaped
5. test_format_jira_leading_trailing_pipe — edge case: leading/trailing pipes
6. test_format_confluence_escapes_same_as_jira — Confluence equivalence confirmed

Manual verification

||Cmd||Desc||
|cat \| grep|filter|

Pipe in data cell correctly escaped. || in data cell: |a\|\|b|c| — no accidental header promotion. ✓

Other checks

• CHANGELOG: ### Fixed entry under [Unreleased]. Correct category, accurate description, Closes #17. ✓
• CI: test (3.11/3.12/3.13), codecov/patch all SUCCESS. QA Gate pending. ✓

Merge coordination note (not a finding)

This PR should merge after #44 (which carries the design spec for the series). After #44 merges, rebase this PR and move its ### Fixed CHANGELOG entry into the existing ### Fixed section (currently it's in a separate position and will create a duplicate section if auto-merged). Adding merge-order: 2 label.

Findings

None.

[cmeans]

Applying Ready for QA Signoff. 232/232 tests pass (6 new), manual verification confirms correct escaping and double-pipe safety. Zero findings. Merge AFTER #44, then rebase to consolidate the CHANGELOG Fixed section.

[cmeans]

LGTM