from __future__ import annotations

# ruff: noqa: E501

REQUIRED_SECTIONS = ("Cel", "Kontekst", "Kluczowe punkty", "Następne kroki")


# @intract.v1 id:md.normalize_topic scope:function intent:transform:topic priority:2 domain:documentation input:topic output:normalized_topic effect:none forbid:network,write validate:input_presence,output_presence,return_value,no_forbidden_effect meaning:"Normalize the requested topic before document generation"
def normalize_topic(topic: str) -> str:
    normalized_topic = " ".join(topic.strip().split())
    if not normalized_topic:
        raise ValueError("topic is required")
    return normalized_topic


# @intract.v1 id:md.build_outline scope:function intent:build:markdown_outline priority:2 domain:documentation input:normalized_topic,required_sections output:markdown_outline effect:none forbid:network,write validate:input_presence,output_presence,return_value,no_forbidden_effect meaning:"Build the Markdown section plan from topic and required headings"
def build_markdown_outline(
    normalized_topic: str,
    required_sections: tuple[str, ...] = REQUIRED_SECTIONS,
) -> list[tuple[str, str]]:
    markdown_outline = [
        ("Cel", f"Wyjaśnij, po co czytelnik potrzebuje tematu: {normalized_topic}."),
        ("Kontekst", f"Umieść temat {normalized_topic} w praktycznym kontekście."),
        ("Kluczowe punkty", f"Wypunktuj najważniejsze decyzje dotyczące: {normalized_topic}."),
        ("Następne kroki", f"Zaproponuj działania po przeczytaniu dokumentu o: {normalized_topic}."),
    ]
    expected = set(required_sections)
    return [item for item in markdown_outline if item[0] in expected]


# @intract.v1 id:md.render_sections scope:function intent:render:markdown_section priority:2 domain:documentation input:markdown_outline,normalized_topic output:markdown_document effect:none forbid:network,write validate:input_presence,output_presence,return_value,no_forbidden_effect meaning:"Render a pure Markdown document with H1, H2 headings and bullets"
def render_markdown_sections(
    markdown_outline: list[tuple[str, str]],
    normalized_topic: str,
    audience: str = "zespół techniczny",
) -> str:
    markdown_document = f"# {normalized_topic}\n\n"
    markdown_document += f"Adresaci: {audience}.\n\n"
    for heading, body in markdown_outline:
        markdown_document += f"## {heading}\n\n"
        markdown_document += f"- {body}\n"
        markdown_document += "- Zachowaj temat dokumentu w tej sekcji.\n\n"
    return markdown_document


# @intract.v1 id:md.guard_contract scope:function intent:validate:markdown_contract priority:1 domain:documentation input:markdown_document,required_sections,normalized_topic output:format_report effect:none forbid:network,write validate:input_presence,output_presence,return_value,no_forbidden_effect meaning:"Check topic retention, required Markdown headings and HTML-free format"
def guard_markdown_contract(
    markdown_document: str,
    required_sections: tuple[str, ...],
    normalized_topic: str,
) -> dict[str, bool]:
    first_line = markdown_document.splitlines()[0] if markdown_document else ""
    format_report = {
        "has_h1": first_line.startswith("# "),
        "keeps_topic": normalized_topic.lower() in first_line.lower(),
        "has_required_sections": all(
            f"## {section}" in markdown_document for section in required_sections
        ),
        "no_html": "<" not in markdown_document and ">" not in markdown_document,
    }
    format_report["ok"] = all(format_report.values())
    return format_report


# @intract.v1 id:md.generate_document scope:function intent:build:markdown_document priority:1 domain:documentation input:topic,required_sections output:markdown_document effect:none forbid:network,write require:transform.topic,build.markdown_outline,render.markdown_section,validate.markdown_contract validate:input_presence,output_presence,return_value,no_forbidden_effect meaning:"Generate a Markdown document that keeps the requested topic and required format"
def generate_markdown_document(topic: str, audience: str = "zespół techniczny") -> str:
    required_sections = REQUIRED_SECTIONS
    normalized_topic = normalize_topic(topic)
    markdown_outline = build_markdown_outline(normalized_topic, required_sections)
    markdown_document = render_markdown_sections(markdown_outline, normalized_topic, audience)
    format_report = guard_markdown_contract(
        markdown_document,
        required_sections,
        normalized_topic,
    )
    if not format_report["ok"]:
        raise ValueError(f"Markdown contract failed: {format_report}")
    return markdown_document


if __name__ == "__main__":
    print(generate_markdown_document("Bezpieczne wdrażanie modeli LLM"))