tools/ai_technical_doc.py

# tools/ai_technical_doc.py
import datetime
import os
import re
from fpdf import FPDF
from langdetect import detect
import gradio as gr

from tools.common import prepend_metadata_questions  # Shared metadata question helper

# === PDF Export Function ===
def export_text_to_pdf(text, answers, output_path=None, language="en"):
    if output_path is None:
        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
        output_path = f"technical_documentation_{timestamp}.pdf"

    pdf = FPDF()
    pdf.add_page()
    pdf.set_auto_page_break(auto=True, margin=15)

    pdf.set_font("Arial", 'B', 16)
    pdf.set_text_color(0, 51, 102)
    title = "Technical Documentation - AI Act (Art. 11)" if language == "en" else "Documentation Technique - AI Act"
    pdf.cell(0, 15, title, ln=True, align='C')
    pdf.ln(5)

    # Metadata under title
    pdf.set_font("Arial", 'I', 11)
    pdf.set_text_color(80, 80, 80)
    name = answers.get("user_name", "N/A")
    role = answers.get("user_role", "N/A")
    org = answers.get("organization_name", "N/A")
    timestamp = datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    pdf.multi_cell(0, 10, f"Completed by {name} ({role}) at {org} on {timestamp}", align="C")
    pdf.ln(5)

    # Main body
    pdf.set_font("Arial", '', 12)
    pdf.set_text_color(0, 0, 0)
    for line in text.strip().split('\n'):
        line = line.strip()
        if line.startswith("## "):
            section = line.replace("## ", "").strip()
            pdf.set_font("Arial", 'B', 13)
            pdf.set_text_color(30, 30, 120)
            pdf.ln(8)
            pdf.cell(0, 10, section, ln=True)
            pdf.set_font("Arial", '', 12)
            pdf.set_text_color(0, 0, 0)
        elif line.startswith("- **"):
            match = re.match(r"- \*\*(.+?)\*\*: (.+)", line)
            if match:
                label, value = match.groups()
                pdf.set_font("Arial", 'B', 12)
                pdf.cell(0, 10, f"{label}:", ln=True)
                pdf.set_font("Arial", '', 12)
                pdf.multi_cell(0, 10, value)
        elif line == "---":
            pdf.line(10, pdf.get_y(), 200, pdf.get_y())
            pdf.ln(5)
        else:
            pdf.multi_cell(0, 10, line)

    pdf.output(output_path)
    return output_path

# === Questions ===
CORE_QUESTIONS = [
    ("system_name", "What is the name of your AI system?"),
    ("provider", "Who is the provider or developer of the system?"),
    ("intended_purpose", "What is the intended purpose of the system?"),
    ("architecture", "Describe the system architecture."),
    ("training_data", "What kind of training data is used?"),
    ("testing_methodology", "How was the system tested and validated?"),
    ("performance_metrics", "What are the system's performance metrics?"),
    ("risk_management", "What risk management measures were taken?"),
    ("cybersecurity", "What cybersecurity measures are in place?"),
    ("human_oversight", "How is human oversight implemented?"),
    ("versioning", "How is version control maintained?"),
    ("recordkeeping", "How are logs and records maintained?")
]

QUESTIONS = prepend_metadata_questions(CORE_QUESTIONS)

def get_questions():
    return QUESTIONS

def run_tool():
    state = {"step": 0, "answers": {}}

    def step_by_step_agent(user_input, state):
        step = state["step"]
        answers = state["answers"]

        if step > 0:
            key, _ = QUESTIONS[step - 1]
            answers[key] = user_input

        if step < len(QUESTIONS):
            next_question = QUESTIONS[step][1]
            state["step"] += 1
            return next_question, state, None

        # Final content for PDF
        content = "\n".join([f"- **{label}**: {answers.get(key, '')}" for key, label in QUESTIONS if key not in ["user_name", "user_role", "organization_name"]])
        detected_lang = detect(content)
        pdf_path = export_text_to_pdf(content, answers, language=detected_lang)
        return "✅ Completed. Download your documentation below.", {"done": True}, pdf_path

    with gr.Blocks(title="AI Technical Documentation Tool") as demo:
        chatbot = gr.Chatbot(
            label="🧠 Technical Doc Assistant",
            value=[{"role": "assistant", "content": QUESTIONS[0][1]}],
            type="messages"
        )
        msg = gr.Textbox(label="Your answer")
        state_var = gr.State(state)
        file_output = gr.File(label="Download PDF", visible=True)
        reset_btn = gr.Button("🔁 Restart")

        def chat_logic(msg_in, state_in):
            reply, updated_state, file = step_by_step_agent(msg_in, state_in)
            messages = [{"role": "user", "content": msg_in}]
            if reply:
                messages.append({"role": "assistant", "content": reply})
            return messages, updated_state, file

        def reset():
            return [{"role": "assistant", "content": QUESTIONS[0][1]}], {"step": 0, "answers": {}}, None

        msg.submit(chat_logic, [msg, state_var], [chatbot, state_var, file_output])
        reset_btn.click(reset, outputs=[chatbot, state_var, file_output])

    demo.launch(show_api=False)