Initial wiki structure

docs/schema/state-schema.md

@@ -0,0 +1,83 @@
+# LangGraph State Schema Definition
+
+This document defines the shared state object used by the LangGraph orchestration layer.
+
+## 1. Shared State Object (`WikiState`)
+
+```python
+from typing import List, Optional, Dict, Annotated
+from pydantic import BaseModel, Field
+from datetime import datetime
+
+class ContentSource(BaseModel):
+    name: str  # e.g., "eve-university", "wckg", "esi"
+    url: str
+    content_hash: str
+    extracted_at: datetime
+
+class ValidationResult(BaseModel):
+    category: str  # "structural", "content", "numerical", "cross-reference"
+    passed: bool
+    score: float  # 0.0 to 1.0
+    feedback: Optional[str] = None
+    details: Dict = {}
+
+class PageMetadata(BaseModel):
+    page_type: str  # "ship", "module", "mechanic", "guide"
+    source: str
+    source_url: str
+    imported_date: datetime
+    last_updated: datetime
+    last_validated: datetime
+    update_frequency: str
+    validation_score: float
+    categories: List[str]
+
+class WikiPage(BaseModel):
+    path: str  # e.g., "ships/frigates/condor"
+    title: str
+    content_markdown: str
+    metadata: PageMetadata
+    frontmatter: Dict
+    assets: List[str]  # List of local asset paths
+
+class WikiState(BaseModel):
+    # Core processing data
+    current_page: Optional[WikiPage] = None
+    proposed_changes: List[WikiPage] = []
+    
+    # Pipeline tracking
+    sources: List[ContentSource] = []
+    validation_pipeline_results: List[ValidationResult] = []
+    
+    # Control flow
+    retry_count: int = 0
+    max_retries: int = 3
+    is_approved: bool = False
+    error: Optional[str] = None
+    
+    # Checkpointing metadata
+    thread_id: str
+    checkpoint_id: Optional[str] = None
+```
+
+## 2. Page Type Schemas
+
+### Ship Schema Overlay
+Extends the numerical validation requirements.
+
+```python
+class ShipData(BaseModel):
+    type_id: int
+    group: str
+    race: str
+    hull_stats: Dict[str, int]
+    fitting_stats: Dict[str, int]
+    velocity: int
+    skill_requirements: List[Dict[str, int]]
+```
+
+## 3. Storage Strategy
+- **State Persistence:** Redis (via `RedisSaver` for LangGraph)
+- **Content Persistence:** Git (Markdown + YAML Frontmatter)
+- **Asset Persistence:** Local filesystem / S3-compatible storage