{
 "_README": "Curated display annotations for the FY26 checkbook. vendor_aliases maps raw ledger vendor strings to a canonical raw string (merging spelling variants and repairing names the portal export doubled or truncated at 50 characters); the underlying CSV is unchanged and remains the source of record. vendor_notes are one-line identifications shown in the Top vendors card; each is verifiable from the funds the vendor is paid from in the CSV or from the page's Notes section. fund_labels and division_overrides re-format the ledger's own Town Meeting article codes (A11 2022 = Article 11, 2022 Annual Town Meeting); they add no information beyond expanding the code, except where marked. description_patterns rewrites cryptic AP-side invoice strings into human-readable labels at render time (regex with $1/$2/... capture group refs); the raw ledger string stays in the CSV and on row hover. label_notes adds a short explanation shown on hover for opaque budget-portal labels (Other Expense, Other Governmental, Districtwide, OFU, etc.). fund_families assigns each of the 105 funds to a family by name pattern, hand reviewed.",
 "as_of": "2026-06-10",
 "families": [
  {
   "key": "general",
   "label": "General fund"
  },
  {
   "key": "enterprise",
   "label": "Enterprise funds"
  },
  {
   "key": "capital",
   "label": "Capital & Town Meeting articles"
  },
  {
   "key": "revolving",
   "label": "Revolving & fee funds"
  },
  {
   "key": "grants",
   "label": "Grants & outside funding"
  },
  {
   "key": "student",
   "label": "Student & school activity"
  },
  {
   "key": "trusts",
   "label": "Trusts, gifts & donations"
  },
  {
   "key": "passthrough",
   "label": "Pass-throughs (held for others)"
  },
  {
   "key": "other",
   "label": "Other"
  }
 ],
 "vendor_aliases": {
  "NATIONAL GRID COMPANY": "NATIONAL GRID",
  "AMAZON CAPITAL SERVICES INC": "AMAZON CAPITAL SERVICES",
  "INGRAM LIBRARY SERVICES LLC": "INGRAM LIBRARY SERVICES",
  "STERICYCLE INC": "STERICYCLE",
  "HOMER CONTRACTING IN": "HOMER CONTRACTING INC",
  "FISCHBACH & MOORE ELECTRIC GROUP LCC": "FISCHBACH & MOORE ELECTRIC GROUP LLC",
  "MA MUNICIPAL AUDITORS & ACCOUNTANTS ASSOCIATION IN": "MA MUNICIPAL AUDITORS & ACCOUNTANTS ASSOCIATION INC",
  "PUBLIC UTILITY MUTUAL INSURANCE COMPANY (PUMIC RRG": "PUBLIC UTILITY MUTUAL INSURANCE COMPANY (PUMIC RRG)",
  "FITCHBURG, LEOMINSTER, LANCASTER, & CLINTON ED COL": "FITCHBURG, LEOMINSTER, LANCASTER & CLINTON ED COLLABORATIVE",
  "STACIE GLADDEN  DBA STITCHES & STACIE GLADDEN  DBA": "STACIE GLADDEN DBA STITCHES",
  "VIRTUAL DESIGN & CONSTRUCTION VIRTUAL DESIGN & CON": "VIRTUAL DESIGN & CONSTRUCTION",
  "LANES COVEN THEATER COMPANY INCLANES COVEN THEATER": "LANES COVEN THEATER COMPANY INC"
 },
 "vendor_notes": {
  "COMMONWEALTH OF MA": "Mostly GIC health insurance premiums, plus state assessments and pass-through fees",
  "BERKSHIRE WIND POWER COOPERATIVE CORP": "Light Department wholesale power purchases, all paid from the Electric Enterprise fund",
  "MARBLEHEAD CONTRIBUTORY RETIREMENT SYSTEM": "The town's annual pension appropriation, plus the enterprise funds' shares",
  "MASSACHUSETTS WATER RESOURCES AUTHORITY": "Regional wholesale water supplier and sewer-project lender",
  "SOUTH ESSEX SEWERAGE DISTRICT": "Regional sewage-treatment district assessment",
  "MARBLEHEAD LIGHT DEPT": "Town and school departments paying the municipal Light Department for electricity",
  "ONE TIME PAY": "The ledger's bucket for one-off payees, not a company",
  "MIIA HEALTH BENEFITS TRUST": "Insurance through the Massachusetts Municipal Association's joint-purchase trust",
  "NICKS LUXURY TRANSPORTATION INC": "Student transportation, paid from school and special-education funds"
 },
 "fund_labels": {
  "A11 2022 CAPITAL IMPROVEMENT": "2022 ATM Art. 11: Capital Improvements",
  "A33 2025-ALLEY BLDG IMPROV": "2025 ATM Art. 33: Alley Building Improvements",
  "A34 2015 NEW TRANSF STATION": "2015 ATM Art. 34: New Transfer Station",
  "A35 2021 ABBOT LIBRARY RENOV": "2021 ATM Art. 35: Abbot Library Renovation",
  "A36 2019 MWRA LOAN": "2019 ATM Art. 36: MWRA Loan"
 },
 "label_notes": {
  "OTHER EXPENSE": "Munis catch-all for spending that doesn't fit the named categories (Professional Salary, Contracted Services, etc.). Often the second-largest category in any fund.",
  "OTHER SALARIES": "Compensation lines that aren't Professional or Clerical - usually part-time, overtime, stipends, and seasonal staff.",
  "OFU": "Other Financing Uses - inter-fund transfers and other financing transactions, not operating spend.",
  "GOVERNMENTAL": "Generic municipal-budget label for general-government spending that isn't broken out by department.",
  "OTHER GOVERNMENTAL": "Catch-all department for general-government spending not assigned to a named department (Town Manager, Selectmen, Town Clerk, etc.).",
  "DISTRICTWIDE": "School-side catch-all for spending that isn't tied to one school building (health insurance, district administration, special education).",
  "STATE ASSESSMENTS": "Annual charges Marblehead owes the Commonwealth (MBTA, school choice tuition, charter school assessments, etc.).",
  "UNKNOWN": "The town's accounting system did not classify these rows. Usually a data-entry gap, not a real budget category.",
  "INTERFUND TRANSFERS": "Money moved from one town fund to another (e.g. general fund to OPEB trust), not new spending.",
  "DEBT SERVICE": "Annual payments on the town's outstanding bonds (principal plus interest)."
 },
 "display_aliases": {
  "OFU": "Inter-fund transfers (OFU)",
  "OTHER GOVERNMENTAL": "Other governmental",
  "OTHER EXPENSE": "Other expenses",
  "OTHER SALARIES": "Other salaries",
  "OTHER SALARIES - STIPENDS": "Other salaries (stipends)",
  "STATE ASSESSMENTS": "State assessments",
  "DISTRICTWIDE": "Districtwide (school)",
  "GOVERNMENTAL": "General-government spending",
  "UNKNOWN": "Unclassified",
  "INTERFUND TRANSFERS": "Inter-fund transfers",
  "DEBT SERVICE": "Debt service",
  "PROFESSIONAL SALARY": "Professional salaries",
  "CONTRACTED SERVICES": "Contracted services",
  "SUPPLIES AND MATERIALS": "Supplies & materials",
  "CAPITAL": "Capital outlay",
  "SUPPLIES AND MATL": "Supplies & materials",
  "CLERICAL SALARIES": "Clerical salaries"
 },
 "division_overrides": {
  "ART 26 2022 ESSEX NS AGGIE & T": "2022 ATM Art. 26: Essex North Shore Agricultural & Technical School",
  "ATM25A11A-WATER CONSTRCUTION": "2025 ATM Art. 11A: Water Construction",
  "ATM25A42,43-CEM-CEMETERY IMPRO": "2025 ATM Arts. 42 & 43: Cemetery Improvements",
  "A15 20 DRAIN CONSTRUCTION": "ATM Art. 15: Drain Construction",
  "ARTICLE WALLS & FENCES": "Town Meeting Article: Walls & Fences",
  "PW MAINTAIN STREETS & SIDEWALK": "Public Works: Maintain Streets & Sidewalks",
  "SELECT BD EXP FY18": "Select Board Expenses FY18",
  "SELECT BD EXP FY19": "Select Board Expenses FY19"
 },
 "description_patterns": [
  {
   "match": "^666[-]?0168[-]?(\\d{4})[-]?(\\d{2})[-]?(\\d{2})\\s?MB$",
   "replace": "GIC monthly health-benefits invoice ($1-$2-$3 batch)",
   "note": "Commonwealth GIC bills the town once a month for the employer share of state-pool health insurance, split across General Fund and each enterprise fund (sewer/water/electric/harbor) by employee assignment. Captures both the dashed (666-0168-2025-0709MB) and packed (666016820250903MB) AP-entry formats."
  }
 ],
 "fund_families": {
  "A11 2022 CAPITAL IMPROVEMENT": "capital",
  "A33 2025-ALLEY BLDG IMPROV": "capital",
  "A34 2015 NEW TRANSF STATION": "capital",
  "A35 2021 ABBOT LIBRARY RENOV": "capital",
  "A36 2019 MWRA LOAN": "capital",
  "ABBOT FUND - HALL INCOME": "trusts",
  "ABBOT LIBRARY DONATION FUND": "trusts",
  "ALL DAY KINDERGARTEN": "student",
  "APLF FUND": "trusts",
  "ARPA COSTAL RESILIENCY (FED)": "grants",
  "ARTS LOTTERY GRANT": "grants",
  "ATHLETIC FUND": "student",
  "BOH DONATION FUND": "trusts",
  "BROWN DONATION FUND": "trusts",
  "BROWN STUDENT ACTIVITY FUND": "student",
  "CHAPTER 90": "grants",
  "CHUN FAMILY FUND/APLF": "trusts",
  "CIRCUIT BREAKER": "grants",
  "COA FORMULA SPENDING PLAN": "grants",
  "COA REVOLVING": "revolving",
  "COA TRANSPORTATION GRANT": "grants",
  "COMMERCIAL WASTE COLL REVOLV": "revolving",
  "CONSERVATION WETLANDS": "revolving",
  "COUNCIL ON AGING DONATION FUND": "trusts",
  "COVID 19 ARPA (FED)": "grants",
  "CP GRANT-COMPREHENSIVE PLAN": "grants",
  "DOG PARK DONATION": "trusts",
  "DUE TO COMMONWEALTH-FIREARMS": "passthrough",
  "DUE TO HOUSING-GAS DEPOSITS": "passthrough",
  "EARL N REYNOLDS HISTORICAL FD": "trusts",
  "ELAINE HOFF SORENSON LIBRARY": "trusts",
  "ELECTRIC ENTERPRISE": "enterprise",
  "FIRE SAFE GRANT": "grants",
  "FIREWORKS DONATION FUND": "trusts",
  "FIVE CORNERS GRANT": "grants",
  "FORT SEWALL DONATION": "trusts",
  "GENERAL FUND - SCHOOL": "general",
  "GENERAL FUND - TAX ARTICLES": "general",
  "GENERAL FUND - TOWN": "general",
  "GERRY PLAYGROUND DONATION": "trusts",
  "GLOVER SCHOOL DONATION": "trusts",
  "GLOVER STUDENT ACTIVITY": "student",
  "GREEN ST BIKE PARK DONATION": "trusts",
  "GUDIANCE SERVICES FUND": "student",
  "HARBOR CAPITAL ARTICLES": "capital",
  "HARBOR ENTERPRISE OPERATING": "enterprise",
  "HIGH SCHOOL DONATION FUND": "trusts",
  "HIGH SCHOOL STUDENT ACTIVITY": "student",
  "HISTORCIAL COMM GIFT SHOP": "revolving",
  "HISTORIC DONATION FUND": "trusts",
  "HOBBS MEM BLDG REVOLVING": "revolving",
  "INOVATIONS PATHWAYS (419)": "grants",
  "INSURANCE REIMBURS <$150,000": "other",
  "JAIL DIVERSION GRANT (FED)": "grants",
  "JAIL DIVERSION GRANT (STATE)": "grants",
  "LARZ ANDERSON FUND": "trusts",
  "LIBRARY MUNICIPAL EQUAL GRANT": "grants",
  "LIBRARY PROGRAM FUND": "trusts",
  "MARBLEHEAD FAMILY DONATION": "trusts",
  "MASS REVOLUTION GRANT": "grants",
  "METCO (317)": "grants",
  "MIDDLE SCHOOL STUDENT ACTIVITY": "student",
  "MOSES A PICKETT CHARITY": "trusts",
  "MWRA PROJECT LWSAP26-3021": "capital",
  "OLD BURIAL HILL DONATION": "trusts",
  "OPIOID SETTLEMENT FUND": "grants",
  "OPK MACALLISTER FUND/APLF": "trusts",
  "PARK REVOLVING FUND": "revolving",
  "PERPETUAL CARE DONATIONS": "trusts",
  "PUBLIC IMPROVEMENT DONATION": "trusts",
  "REC AND PARK DONATION FUND": "trusts",
  "ROAD SAFETY GRANT": "grants",
  "RYAN WALTER FADER DONATION": "trusts",
  "SAFE DONATION FUND": "trusts",
  "SALE OF CEMETERY LOTS": "revolving",
  "SCHOOL BUILDING RENTAL": "revolving",
  "SCHOOL LUNCH": "revolving",
  "SCHOOL TUITION REVOLVING": "revolving",
  "SCHOOL USER FEES": "revolving",
  "SEWER CAPITAL ARTICLES": "capital",
  "SEWER ENTERPRISE OPERATING": "enterprise",
  "SHATTUCK MEM FUND-COA": "trusts",
  "SHATTUCK MEM FUND-HISTORIC": "trusts",
  "SHATTUCK MEM FUND-LIBRARY": "trusts",
  "SHATTUCK MEM FUND-PARK": "trusts",
  "SPED EC (262)": "grants",
  "SPED IDEA 94-142 (240)": "grants",
  "SPED PROGRAM IMPROVEMENT (274)": "grants",
  "STATE 911 TRAINING GRANT": "grants",
  "STATE E-911 TERT": "grants",
  "STREET OPENNING REVOLVING": "revolving",
  "TITLE I, PART A  (305)": "grants",
  "TITLE III EL (180)": "grants",
  "TITLE IV (309)": "grants",
  "TREASURERS CASH FUND": "other",
  "TREE DONATION FUND": "trusts",
  "VACCINE REVOLVING FUND": "revolving",
  "VETERANS SCHOOL DONATION": "trusts",
  "VILLAGE SCHOOL DONATION": "trusts",
  "VILLAGE STUDENT ACTIVITY FUND": "student",
  "VIRGINIA CARTEN LIBRARY FUND": "trusts",
  "WATER CAPITAL ARTICLES": "capital",
  "WATER ENTERPRISE OPERATING": "enterprise",
  "WATER LEAD SERVICE GRANT": "grants",
  "YOUTH BASEBALL DONATION FUND": "trusts"
 }
}