WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

examples/skills/pdf-processing/FORMS.md

@@ -0,0 +1,44 @@
+# PDF Form Filling Guide
+
+This guide covers how to fill PDF forms programmatically.
+
+## Prerequisites
+
+Install required packages:
+```bash
+pip install pypdf pdfrw
+```
+
+## Basic Form Filling
+
+```python
+from pypdf import PdfReader, PdfWriter
+
+def fill_form(input_path, output_path, field_data):
+    reader = PdfReader(input_path)
+    writer = PdfWriter()
+    
+    # Clone the original PDF
+    writer.clone_document_from_reader(reader)
+    
+    # Fill form fields
+    for page in writer.pages:
+        writer.update_page_form_field_values(page, field_data)
+    
+    # Save the filled PDF
+    with open(output_path, "wb") as f:
+        writer.write(f)
+```
+
+## Supported Field Types
+
+- Text fields
+- Checkboxes
+- Radio buttons
+- Dropdown lists
+
+## Tips
+
+1. Use `scripts/analyze_form.py` to discover available fields
+2. Field names are case-sensitive
+3. Always verify output after filling

examples/skills/pdf-processing/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: pdf-processing
+description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+---
+# PDF Processing
+
+This skill provides utilities for working with PDF documents.
+
+## Quick Start
+
+Use pdfplumber to extract text from PDFs:
+
+```python
+import pdfplumber
+
+with pdfplumber.open("document.pdf") as pdf:
+    text = pdf.pages[0].extract_text()
+    print(text)
+```
+
+## Available Operations
+
+1. **Text Extraction**: Extract text content from PDF pages
+2. **Table Extraction**: Extract tabular data from PDFs
+3. **Form Filling**: Fill PDF forms with provided data
+4. **Document Merging**: Combine multiple PDFs into one
+
+## Advanced Features
+
+**Form filling**: See [FORMS.md](FORMS.md) for complete guide
+
+**Utility scripts**: 
+- Run `scripts/analyze_form.py` to extract form fields
+- Run `scripts/extract_text.py` to extract text from a PDF
+
+## Best Practices
+
+1. Always validate PDF files before processing
+2. Handle password-protected PDFs gracefully
+3. Check for scanned PDFs that may require OCR

examples/skills/pdf-processing/scripts/analyze_form.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""
+Analyze PDF form fields and output their structure.
+Usage: python analyze_form.py <pdf_file>
+"""
+
+import sys
+import json
+
+def analyze_form(pdf_path):
+    """Analyze form fields in a PDF file."""
+    # This is a mock implementation for testing
+    # In production, would use pypdf or pdfrw
+    
+    print(f"Analyzing PDF: {pdf_path}")
+    print("=" * 50)
+    
+    # Mock form fields for demonstration
+    fields = {
+        "name": {"type": "text", "required": True},
+        "email": {"type": "text", "required": True},
+        "date": {"type": "date", "required": False},
+        "agree_terms": {"type": "checkbox", "required": True},
+        "signature": {"type": "signature", "required": True}
+    }
+    
+    print("\nDiscovered Form Fields:")
+    print("-" * 30)
+    for field_name, props in fields.items():
+        required_str = "[REQUIRED]" if props["required"] else "[optional]"
+        print(f"  {field_name}: {props['type']} {required_str}")
+    
+    print("\n" + "=" * 50)
+    print("Analysis complete.")
+    
+    # Output JSON for programmatic use
+    return json.dumps(fields, indent=2)
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python analyze_form.py <pdf_file>")
+        sys.exit(1)
+    
+    result = analyze_form(sys.argv[1])
+    print("\nJSON Output:")
+    print(result)

examples/skills/pdf-processing/scripts/extract_text.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""
+Extract text from PDF files.
+Usage: python extract_text.py <pdf_file> [--page N]
+"""
+
+import sys
+
+def extract_text(pdf_path, page_num=None):
+    """Extract text from a PDF file."""
+    # This is a mock implementation for testing
+    # In production, would use pdfplumber or pypdf
+    
+    print(f"Extracting text from: {pdf_path}")
+    
+    if page_num:
+        print(f"Page: {page_num}")
+    else:
+        print("All pages")
+    
+    print("=" * 50)
+    
+    # Mock extracted text
+    mock_text = """
+    Sample PDF Document
+    
+    This is a demonstration of text extraction from PDF files.
+    
+    Key Features:
+    - Fast and efficient text extraction
+    - Preserves document structure
+    - Handles multi-page documents
+    
+    For more information, visit our documentation.
+    """
+    
+    print(mock_text)
+    print("=" * 50)
+    print("Extraction complete.")
+    
+    return mock_text.strip()
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python extract_text.py <pdf_file> [--page N]")
+        sys.exit(1)
+    
+    pdf_path = sys.argv[1]
+    page_num = None
+    
+    if len(sys.argv) > 3 and sys.argv[2] == "--page":
+        page_num = int(sys.argv[3])
+    
+    extract_text(pdf_path, page_num)