Function inspect_note_plan

scripts/lint_note.py:227–262

(plan_path: Path)

def inspect_note_plan(plan_path: Path) -> tuple[bool, list[str]]:
    if not plan_path.exists():
        return False, ["planning_artifact_missing"]

    try:
        plan = json.loads(plan_path.read_text(encoding="utf-8"))
    except (OSError, UnicodeDecodeError, json.JSONDecodeError):
        return True, ["planning_artifact_invalid_json"]

    if not isinstance(plan, dict):
        return True, ["planning_required_fields_invalid"]

    issues: list[str] = []
    missing_fields = [field for field in NOTE_PLAN_REQUIRED_FIELDS if field not in plan]
    if missing_fields:
        issues.append("planning_required_fields_missing")

    has_invalid_fields = False
    for field in NOTE_PLAN_STRING_FIELDS:
        if field in plan and not isinstance(plan[field], str):
            has_invalid_fields = True
        elif field in plan and not plan[field].strip():
            issues.append(f"planning_{field}_empty")
    if isinstance(plan.get("paper_type"), str) and plan["paper_type"].strip():
        if plan["paper_type"].strip() not in PAPER_TYPE_VALUES:
            issues.append("planning_paper_type_invalid")
    for field in NOTE_PLAN_LIST_FIELDS:
        if field in plan and not isinstance(plan[field], list):
            has_invalid_fields = True
        elif field in plan and not plan[field]:
            issues.append(f"planning_{field}_empty")
    if has_invalid_fields:
        issues.append("planning_required_fields_invalid")
    issues.extend(inspect_central_claims_plan(plan.get("central_claims")))

    return True, issues


def inspect_central_claims_plan(value: object) -> list[str]: