Skip to content

Add HL7 message comparison (field-level diff) #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
klauseduard merged 3 commits into from
Feb 25, 2026
Merged

Add HL7 message comparison (field-level diff) #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bbbfbbb
Add HL7 message comparison feature (field-level diff)
Feb 25, 2026
e232a90
Add Reset button to compare summary bar
Feb 25, 2026
956e7ab
Add character-level diff highlighting to compare view
Feb 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,8 @@ HL7 v2.x message toolkit: web viewer, terminal TUI, Python parsing library, and
Single self-contained HTML/CSS/JS file. Open directly in Firefox (`file://` works, no server needed).

**Features:**
- Three-panel layout: Input (paste/drag-drop/Open button) | Parsed table | Field detail
- Three-panel layout: Input (paste/drag-drop/Open button) | Parsed table | Field detail | Compare (field-level diff)
- **Compare tab**: paste/open a second message, get a field-by-field diff with summary bar, filter toggle, and side-by-side component breakdown in detail panel
- Embedded HL7 v2.3 and v2.5 segment/field definitions (~23 segments each) with data type component breakdowns (~30 composite types)
- Auto-detects HL7 version from MSH-12 (v2.3.1 maps to v2.3 definitions)
- Correct MSH field numbering: MSH-1 = `|` (field separator), MSH-2 = encoding characters
Expand Down Expand Up @@ -44,13 +45,14 @@ venv/bin/pip install -r requirements-mcp.txt

**Run:** Registered in `~/.claude.json` under `mcpServers.hl7` — starts automatically with Claude Code.

**Tools (7):**
**Tools (8):**
- `hl7_parse` — Parse raw HL7 into structured JSON with definitions and profile overlays
- `hl7_get_field` — Extract a specific field by address (e.g. "PID-5", "MSH-9.1")
- `hl7_validate` — Check message for structural issues (missing required fields, length violations, unknown segments); with a profile: enforces `required` fields and `valueMap` value checks
- `hl7_anonymize` — Strip PHI from PID/NK1 segments
- `hl7_transform` — Modify field values by address (e.g. `{"PID-5": "DOE^JOHN"}`)
- `hl7_send` — Send message via MLLP with optional TLS/mTLS
- `hl7_diff` — Compare two messages field-by-field, returns structured JSON diff with per-field status and values
- `hl7_explain` — Look up HL7 definitions (segments, fields, data types) without a message

**Resources (3):**
Expand All @@ -71,7 +73,7 @@ venv/bin/pip install -r requirements-mcp.txt
venv/bin/pytest tests/ -v
```

42 tests covering core modules (parser, encoding, profile, anonymize, definitions). Uses all 3 sample messages as fixtures. No browser/UI tests — the Python core logic mirrors the web viewer's JS implementation, so these tests serve as a shared specification.
63 tests covering core modules (parser, encoding, profile, anonymize, definitions, diff). Uses all 3 sample messages as fixtures. No browser/UI tests — the Python core logic mirrors the web viewer's JS implementation, so these tests serve as a shared specification.

- `pytest.ini` sets `pythonpath = .` so no install step needed
- `tests/conftest.py` — shared fixtures (parsed messages, sample profile)
Expand Down
8 changes: 8 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ Switch between Input/Parsed/Raw using the tabs above the left panel.
- **Anonymization** — toggle PID field anonymization with ASCII or Estonian (non-ASCII) name pools
- **Live search** — filter fields by address, name, type, or value
- **Click-to-highlight** — click a parsed row to highlight the corresponding position in raw view
- **Message comparison** — Compare tab for field-level diff of two messages with summary bar, filter toggle (differences only / all), and side-by-side component breakdown in detail panel
- **Keyboard navigation** — arrow keys, Enter to expand, Esc to clear search

### Keyboard Shortcuts (Web)
Expand Down Expand Up @@ -147,6 +148,12 @@ python3 -m hl7view file1.hl7 file2.hl7

# Disable colors (for piping)
python3 -m hl7view --no-color message.hl7

# Compare two messages (field-level diff)
python3 -m hl7view file1.hl7 file2.hl7 --diff

# Include identical fields in diff output
python3 -m hl7view file1.hl7 file2.hl7 --diff -e
```

### Anonymization
Expand Down Expand Up @@ -250,6 +257,7 @@ Add to `~/.claude.json` under `mcpServers`:
| `hl7_anonymize` | Strip PHI from PID/NK1 segments with random replacements |
| `hl7_transform` | Modify field values by address (e.g. `{"PID-5": "DOE^JOHN"}`) |
| `hl7_send` | Send message via MLLP with optional TLS/mTLS, return ACK |
| `hl7_diff` | Compare two messages field-by-field, return structured JSON diff |
| `hl7_explain` | Look up HL7 definitions (segments, fields, data types) without a message |

### Resources
Expand Down
Loading