# Function: defcon_download_and_resize_logo
# Input: None (uses global variables)
# Output: Downloads DEFCON logo, resizes it to various dimensions, and generates a manifest
defcon_download_and_resize_logo()

# Function: defcon_download_and_extract_program
# Input: None (uses global variables)
# Output: Downloads DEFCON program, extracts relevant information, and generates a manifest
defcon_download_and_extract_program()

# Function: defcon_mirror_media_server
# Input: None (uses global variables)
# Output: Downloads and processes PDF files, storing them in OUTPUT_DIR
#         Generates a manifest file with source URL, output dir, and filter rules
defcon_mirror_media_server()

# Dockerfile for DEF CON 32 Summary Environment
#
# Purpose: Set up a containerized environment for processing and analyzing DEF CON 32 data
#
# Key components:
# - Base image: Ubuntu 20.04 (or appropriate alternative)
# - User: Non-root user 'defcon_user' for improved security
# - Installed tools: curl, wget, imagemagick, jq (add others as needed)
# - Scripts: Custom scripts for data processing and analysis
# - Services: Web server (e.g., Nginx) for serving content (if needed)
# - Ports: 80 exposed for web service (modify as needed)
# - Volumes: /home/defcon_user/data for persistent storage
# - Entrypoint: Default to bash, with option for custom script
#
# Build with: docker build -t defcon32-summary .
# Run with: docker run -it -p 8080:80 -v /path/to/data:/home/defcon_user/data defcon32-summary

def defcon_read_template(file_path: str) -> str:
    """
    Read the content of a template file.

    Args:
        file_path (str): Path to the template file.

    Returns:
        str: Content of the template file.
    """

def defcon_read_pdf(file_path: str) -> TalkContent:
    """
    Extract text content from a PDF file with error handling.

    Args:
        file_path (str): Path to the PDF file.

    Returns:
        TalkContent: Extracted text content and metadata from the PDF.
    """

def defcon_get_ollama_summary(content: TalkContent, prompt_template: str) -> Summary:
    """
    Generate a summary using the Ollama API with type validation.

    Args:
        content (TalkContent): The content to summarize.
        prompt_template (str): The template for the summarization prompt.

    Returns:
        Summary: A validated summary of the content.
    """

def defcon_process_talk_pdfs(pdf_dir: str, output_dir: str, prompt_template: str) -> None:
    """
    Process all PDF files in a directory, generate summaries, and save them.

    Args:
        pdf_dir (str): Directory containing the PDF files to process.
        output_dir (str): Directory to save the generated summaries.
        prompt_template (str): Template for the summarization prompt.
    """

def main(pdf_dir: str, template_path: str, output_dir: str):
    """
    Main function to process DEF CON 32 talk PDFs and generate summaries.

    Args:
        pdf_dir (str): Directory containing mirrored DEF CON 32 talk PDFs.
        template_path (str): Path to the prompt template file.
        output_dir (str): Directory to save the summaries (defaults to a temporary directory).
    """

def defcon_process_summaries(pdf_dir: str, output_dir: str, template_path: str):
    """
    Process summaries for DEF CON 32 talks.

    Args:
        pdf_dir (str): Directory containing the PDF files to process.
        output_dir (str): Directory to save the generated summaries.
        template_path (str): Path to the prompt template file.
    """

graph TD
    A[Start] --> B[main]
    B --> C[defcon_process_summaries]
    C --> D[defcon_read_template]
    C --> E[defcon_process_talk_pdfs]
    E --> F[defcon_read_pdf]
    E --> G[defcon_get_ollama_summary]
    G --> H[End]

  *** Taming the beast: Inside the LLAMA 3 red team process
  :PROPERTIES:
  :ID: taming-llama3-red-team
  :SPEAKERS: Aaron Grattafiori, Ivan Evtimov, Joanna Bitton, Maya Pavlova
  :TRACK: Track 3 (Hall 1 - Aisle 11-03)
  :TIME: 15:30
  :DURATION: 45 minutes
  :END:

(defun defcon/extract-schedule-to-json (&optional max-talks-per-day)
  "Extract schedule from the current Org file and save it as JSON.
Optionally limit the number of talks per day to MAX-TALKS-PER-DAY.
If MAX-TALKS-PER-DAY is provided and greater than 0, the function will
limit the number of talks extracted for each day to this value.
The extracted schedule is saved to a JSON file with a name based on
the current buffer's filename. If MAX-TALKS-PER-DAY is used, it's
reflected in the output filename.
Returns nil and displays a message if no schedule is found in the
current file.")

(defun defcon/extract-schedule (max-talks-per-day)
  "Extract the schedule from the current Org buffer.
MAX-TALKS-PER-DAY is an optional limit on the number of talks
extracted per day. If nil or 0, all talks are extracted.
Returns a list of cons cells, where each cell contains a day
and its associated talks. The list is sorted chronologically by day.
Each talk is represented as a property list containing information
such as title, ID, speakers, track, time, and duration.
This function is typically called by `defcon/extract-schedule-to-json'
to process the Org buffer contents.")

(defun defcon/extract-talks-for-day (max-talks)
  "Extract talks for the current day, optionally limiting to MAX-TALKS.
MAX-TALKS is an optional limit on the number of talks to extract.
If nil or 0, all talks for the day are extracted.
Returns a list of property lists, each representing a talk with
properties such as title, ID, speakers, track, time, and duration.
This function is called by `defcon/extract-schedule' for each day
in the schedule. It processes talk entries under the current day's
heading in the Org file.")

graph TD
    A[Start] --> B[defcon/extract-schedule-to-json]
    B --> C[defcon/extract-schedule]
    C --> D[defcon/extract-talks-for-day]
    D --> E[End]

(defun defcon/set-scheduled-and-update-children ()
  "Set SCHEDULED property for current heading and update child schedules.
Interactively prompts for a new date, sets the SCHEDULED property
for the current heading, and then updates all child schedules to
match the new date while preserving their individual times.")

(defun defcon/update-child-schedules ()
  "Update SCHEDULED timestamps of child nodes based on the parent's SCHEDULED date.
Traverses all child nodes of the current heading, updating their
SCHEDULED timestamps to match the parent's date while preserving
their individual times. Requires TIME and DURATION properties on child nodes.")

graph TD
    A[Start] --> B[defcon/set-scheduled-and-update-children]
    B --> C{New date entered?}
    C -->|Yes| D[Set SCHEDULED property]
    D --> E[Set DATE property]
    E --> F[defcon/update-child-schedules]
    F --> G[org-back-to-heading]
    G --> H{Parent SCHEDULED exists?}
    H -->|Yes| I[Parse parent date]
    I --> J[org-map-entries]
    J --> K{Is child node?}
    K -->|Yes| L{Has TIME and DURATION?}
    L -->|Yes| M[Calculate new SCHEDULED]
    M --> N[Set child SCHEDULED]
    N --> J
    L -->|No| J
    K -->|No| J
    J --> O{All entries processed?}
    O -->|No| J
    O -->|Yes| P[End]
    H -->|No| P
    C -->|No| P

graph TD
    A[Start] --> B[Download DEF CON 32 program PDF]
    B --> C[Extract schedule from p28-30]
    C --> D[Scaffold initial data structure]
    D --> E[Generate unique IDs for each talk]
    E --> F[Set initial talk times]
    F --> G{All times set?}
    G -->|No| F
    G -->|Yes| H[Assign talks to specific days]
    H --> I{All days assigned?}
    I -->|No| H
    I -->|Yes| J[Organize talks into tracks]
    J --> K{All tracks organized?}
    K -->|No| J
    K -->|Yes| L[Generate initial schedule table]
    L --> M[Review schedule]
    M --> N{Any conflicts or issues?}
    N -->|Yes| O[Adjust talk times or tracks]
    O --> M
    N -->|No| P[Set SCHEDULED property for each talk]
    P --> Q[Update child nodes' schedules]
    Q --> R[Regenerate final schedule table]
    R --> S[Export schedule to desired format]
    S --> T[End]

    subgraph "Initial Data Preparation"
    B
    C
    D
    end

    subgraph "Manual Data Entry"
    F
    H
    J
    end

    subgraph "Schedule Generation"
    L
    R
    end

    subgraph "Schedule Refinement"
    M
    N
    O
    P
    Q
    end