guitar_score/.planning/codebase/STRUCTURE.md

STRUCTURE

Root Directory (/)

• youtube_tab_to_pdf.py: The massive core application runner (1k+ lines). Handles downloading, cv2 matrix manipulation, OCR, stitching, and PDF rendering.
• video_cv_tracker.py: Extracted Temporal/Motion tracker logic responsible for analyzing page flips based on median column mutations instead of simplistic frame diffs.
• sim_stitch.py / simulate_ocr_pipeline.py: Legacy or simulation variations used to mock or prototype OCR/stitching behaviors without redownloading heavy videos.
• test_pipeline.py / diag_v2.py: Pipeline integration testers and diagnostic tools for manual CV metric validation.
• bootstrap.bat / bootstrap.sh: Lifecycle and setup scripts for CI or new user initialization.

/scripts

• Contains focused debugging scripts (debug/test_full_ocr.py, debug/rigorous_validator.py) utilized to isolate OCR misfires or to rigidly assert measure numbers.

/docs

• devlog/: Contains markdown logs of development insights (e.g., 2026-03-29_postmortem_duplicate_row_bug.md).

/.planning

• Contains project requirements, roadmaps, and this codebase mapping.