v1.95: clean column display names in table headers

Add COL_LABELS mapping + _pretty_col() fallback so all raw API field
names (underscores, trailing underscores, cryptic abbreviations) are
replaced with readable labels in the dataframe header row.
e.g. filing_representative_business_name → Applicant Firm,
owner_s_business_name → Owner Business, job_filing_number → Filing #

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

gui.py

@@ -146,6 +146,80 @@ button.primary, .gr-button.primary {{ font-weight: 700; }}
 CUSTOM_CSS = _build_font_css()
 
 
+# ---- Column display-name map ----
+COL_LABELS: dict[str, str] = {
+    # Address / location
+    "full_address":                         "Address",
+    "house_no":                             "House #",
+    "house_number":                         "House #",
+    "street_name":                          "Street",
+    "borough":                              "Borough",
+    "zip":                                  "ZIP",
+    "zip_code":                             "ZIP",
+    "postcode":                             "ZIP",
+    "bin":                                  "BIN",
+    "bbl":                                  "BBL",
+    "block":                                "Block",
+    "lot":                                  "Lot",
+    "community_board":                      "Community Board",
+    "commmunity_board":                     "Community Board",
+    "latitude":                             "Lat",
+    "longitude":                            "Lon",
+    # Filing / job
+    "filing_date":                          "Filing Date",
+    "filing_status":                        "Filing Status",
+    "job_filing_number":                    "Filing #",
+    "job_type":                             "Job Type",
+    "job_status":                           "Job Status",
+    "job_status_descrp":                    "Job Status Description",
+    "job_description":                      "Description",
+    "permit_type":                          "Permit Type",
+    "initial_cost":                         "Initial Cost",
+    "total_construction_floor_area":        "Floor Area",
+    "signoff_date":                         "Sign-off Date",
+    "first_permit_date":                    "First Permit Date",
+    # Work type flags
+    "general_construction_work_type_":      "GC Work Type",
+    "plumbing_work_type":                   "Plumbing",
+    "sprinkler_work_type":                  "Sprinkler",
+    "structural_work_type_":               "Structural",
+    "foundation_work_type_":               "Foundation",
+    "mechanical_systems_work_type_":       "Mechanical",
+    "earth_work_work_type_":               "Earthwork",
+    "boiler_equipment_work_type_":         "Boiler/Equip",
+    # Applicant / owner
+    "filing_representative_business_name":  "Applicant Firm",
+    "applicant_first_name":                 "First Name",
+    "applicant_last_name":                  "Last Name",
+    "applicant_professional_title":         "Title",
+    "applicants_middle_initial":            "MI",
+    "applicant_license":                    "License #",
+    "applicant_search":                     "Search",
+    "owner_s_business_name":               "Owner Business",
+    "owner_s_street_name":                 "Owner Street",
+    # Stalled
+    "days_stalled":                         "Days Stalled",
+    "complaint_date":                       "Complaint Date",
+    "date_complaint_received":              "Complaint Received",
+    "complaint_number":                     "Complaint #",
+    "dobrundate":                           "DOB Run Date",
+    # Distressed
+    "distress_score":                       "Score",
+    "distress_types":                       "Distress Types",
+    "distress_date":                        "Distress Date",
+    "days_since_distress":                  "Days Since",
+    "source":                               "Source",
+}
+
+
+def _pretty_col(col: str) -> str:
+    """Return a clean display label for a raw column name."""
+    if col in COL_LABELS:
+        return COL_LABELS[col]
+    # Fallback: strip trailing underscores, replace _ with space, title-case
+    return col.strip("_").replace("_", " ").title()
+
+
 # ---- helpers ----
 def _sanitize_visible(visible: list[str], cols: list[str]) -> list[str]:
     set_cols = set(cols)
@@ -255,7 +329,7 @@ def create_app():
             source_key_state = gr.State("leads_unpermitted")
 
             def _display_view(df: pd.DataFrame, vis: list, rows: int):
-                """Slice df to visible cols + rows, format applicant_search as clickable markdown."""
+                """Slice df to visible cols + rows, rename headers, format links."""
                 view = df[vis].head(int(rows)).copy()
                 datatypes = []
                 for col in vis:
@@ -266,6 +340,7 @@ def create_app():
                         datatypes.append("markdown")
                     else:
                         datatypes.append("str")
+                view.columns = [_pretty_col(c) for c in vis]
                 return gr.update(value=view, datatype=datatypes)
 
             def _dataset_key_from_label(label: str) -> str: