core/multi_program.py

from typing import Dict, List

def compare_programs(docs: List[dict]) -> Dict[str, Dict[str, int]]:
    matrix: Dict[str, Dict[str, int]] = {}

    for d in docs:
        agency = d.get("agency", "Unknown")
        year = d.get("date", "")[:4]

        if not year.isdigit():
            continue

        matrix.setdefault(agency, {})
        matrix[agency][year] = matrix[agency].get(year, 0) + 1

    return matrix