# 906 Feature PDF Extractor D4919e90

> Technical design for the PDF extraction module.

- Skill: `tools-only/906-feature-pdf-extractor-d4919e90` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/906-feature-pdf-extractor-d4919e90`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/906-feature-pdf-extractor-d4919e90/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/906-feature-pdf-extractor-d4919e90

---


# System Design & Architecture

## Architecture Overview
**What is the high-level system structure?**

The `pdf_extractor` acts as a data source for the validation engine. It encapsulates all PDF-specific complexity.

```mermaid
graph LR
    PDF[PDF File] --> Fitz[PyMuPDF/fitz]
    Fitz --> Extractor[pdf_extractor.py]
    Extractor --> Canonicalizer[text_canonicalizer.py]
    Canonicalizer --> Output[Clean Text]
```

## Data Models
**What data do we need to manage?**

- **PDFContent:** A simple container or string containing the extracted text.
- **ExtractionMetadata:** Page count, info (title, author).

## API Design
**How do components communicate?**

### Primary Interface
- `class PDFExtractor`:
    - `__init__(file_path: Path)`
    - `get_full_text() -> str`
    - `iter_pages() -> Iterator[str]` (Memory efficient extraction)
    - `get_page_text(page_num: int) -> str`
    - `get_metadata() -> dict`

## Component Breakdown
**What are the major building blocks?**

- **Fitz Wrapper:** Handles opening and reading the PDF.
- **Text Cleaner:** Integrates with `text_canonicalizer`.
- **Layout Manager:** Uses `page.get_text("blocks")` to respect reading order and preserve paragraph-like structures.

## Design Decisions
**Why did we choose this approach?**

- **PyMuPDF (fitz):** Chosen for its speed and superior "block-based" extraction which helps preserve paragraphs better than line-based tools.
- **Direct Canonicalization:** We canonicalize at the source to ensure no "dirty" text ever enters the system.

## Non-Functional Requirements
**How should the system perform?**

- **Robustness:** Handle encrypted PDFs (raise clear exception).
- **Speed:** Extract a 300-page book in < 5 seconds.