pdftract/notes/bf-1wczm.md

Unmapped Glyph Test Module Isolation Results

Task: Run each unmapped glyph assertion test module individually to isolate failures/hangs.

Run Date: 2026-07-06

Summary

All 4 test modules completed without hanging. No test modules froze or timed out.

Module Results

Module 1: unmapped_glyph_names_config

Status: ✅ PASS Tests: 4/4 passed Duration: ~0.00s Tests:

• test_unmapped_glyph_names_defaults_to_empty - PASS
• test_unmapped_glyph_names_specified - PASS
• test_unmapped_glyph_names_empty_array - PASS
• test_unmapped_glyph_names_minimal_config - PASS

Module 2: encoding_recovery

Status: ❌ FAIL Tests: 1/6 passed, 5/6 failed Duration: ~0.00s Tests:

• test_all_encoding_fixtures_exist - PASS
• test_agl_only_fixture - FAIL: "No /Root reference in trailer"
• test_fingerprint_match_fixture - FAIL: "No /Root reference in trailer"
• test_corpus_recovery_rate - FAIL: "Page index 0 out of bounds (document has 0 pages)"
• test_shape_match_fixture - FAIL: "No /Root reference in trailer"
• test_no_mapping_fixture - FAIL: "Page index 0 out of bounds (document has 0 pages)"

Issue: Test fixtures appear to be corrupted or improperly generated (missing /Root reference, 0 pages).

Module 3: cjk_encoding

Status: ❌ FAIL Tests: 0/5 passed, 5/5 failed Duration: ~0.00s Tests:

• test_all_cjk_fixtures_exist - FAIL: Fixture file does not exist (../../../tests/fixtures/cjk/cjk-chinese-gb18030.pdf)
• test_cjk_big5_traditional_chinese - FAIL: "Failed to open PDF: Failed to open PDF file"
• test_cjk_euckr_korean - FAIL: "Failed to open PDF: Failed to open PDF file"
• test_cjk_gb18030_chinese - FAIL: "Failed to open PDF: Failed to open PDF file"
• test_cjk_shiftjis_japanese - FAIL: "Failed to open PDF: Failed to open PDF file"

Issue: CJK fixture files are missing from the test fixtures directory.

Module 4: cmap_unmapped_glyphs

Status: ✅ PASS Tests: 7/7 passed Duration: ~0.00s Tests:

• test_cmap_multiple_mappings_with_unmapped_check - PASS
• test_cmap_range_mapping_with_unmapped_awareness - PASS
• test_differences_overlay_consecutive_with_unmapped_filtering - PASS
• test_differences_overlay_filters_all_g_series_unmapped - PASS
• test_cmap_unmapped_glyph_skip - PASS
• test_differences_overlay_filters_null_glyph - PASS
• test_differences_overlay_filters_unmapped_glyphs - PASS

Conclusion

No test hangs detected. All 4 modules completed quickly (all under 1 second). The failures in encoding_recovery and cjk_encoding are due to missing or corrupted test fixtures, not test logic hangs.

Next Steps

The parent bead bf-60vlq should focus on:

1. Fixing the test fixtures for encoding_recovery (regenerate fixtures with proper /Root trailers)
2. Ensuring CJK fixture files exist in tests/fixtures/cjk/ directory
3. The actual test logic (unmapped glyph assertions) is working correctly in modules 1 and 4

Test Output Logs

• notes/bf-1wczm-unmapped_config-run.log - Module 1 output
• notes/bf-1wczm-encoding_recovery-run.log - Module 2 output
• notes/bf-1wczm-cjk_encoding-run.log - Module 3 output
• notes/bf-1wczm-cmap_unmapped-run.log - Module 4 output