docs: update all documentation for Theia course upload feature

Updates user and developer documentation to reflect the completed Theia
course structure upload implementation (PR #21). Changes emphasize Theia's
new role as content manager, not just exporter, and highlight round-trip
workflow capabilities.

Documentation updates:
- README.md: Reorder workflows (Theia first), expand features section,
  add Theia workflow steps with upload/export process
- About-Rhea.md: Add "Recently Completed" section, update current state
  to reflect Theia capabilities
- Technical-Overview.md: Rename Theia section to "Content Manager & Exporter",
  detail upload implementation components
- docs/dev/status/README.md: Update Theia status with JSON upload features,
  add course upload to Recent Wins (#1 position)
- docs/dev/status/Theia-MVP.md: Add completed milestone 4.1.2 for course
  upload, update milestone 2.1 status to IN PROGRESS
- docs/dev/status/Rhea-MVP.md: Document Theia palette completion with
  magenta/cyan colour scheme

All documentation now accurately represents:
- Round-trip capability (export JSON → upload → continue)
- Five workflow modules (Theia now functional, not planned)
- JSON as the resumable format
- Theia's dual role: content management + export

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: JasonWarrenUK

README.md

@@ -6,19 +6,28 @@ An AI-powered curriculum generation tool for peer-led learning cohorts. Rhea use
 
 ## What Rhea Does
 
-Rhea contains three flows for generating curriculum materials
+Rhea contains five workflows for curriculum generation and management:
 
-**Rhea** | **Themis** | **Tethys** | **Metis** | **Theia**
-:-------:|:----------:|:----------:|:---------:|:---------:
-![Rhea](static/icon.png) | ![Themis](static/themis/icon.png) | ![Tethys](static/tethys/icon.png) | ![Metis](static/metis/icon.png) | ![Theia](static/theia/icon.png)
+**Rhea** | **Theia** | **Themis** | **Tethys** | **Metis**
+:-------:|:---------:|:----------:|:----------:|:---------:
+![Rhea](static/icon.png) | ![Theia](static/theia/icon.png) | ![Themis](static/themis/icon.png) | ![Tethys](static/tethys/icon.png) | ![Metis](static/metis/icon.png)
 
-<details><summary><strong>Metis:</strong> standalone module specifications</summary>
+<details><summary><strong>Theia:</strong> content management and export</summary>
   <ul>
-    - Learning objectives and module overview
-    - Detailed project briefs with examples and success criteria
-    - Research topics with guidance for learners
-    - Additional skills categorized by importance
-  - Project "twists" to add interesting challenges
+    - Upload previously generated course JSON files
+    - Resume workflows from where you left off
+    - Export to Markdown, HTML, or JSON formats
+    - Configurable detail levels and section selection
+    - Round-trip capability: export → upload → continue
+  </ul>
+</details>
+
+<details><summary><strong>Themis:</strong> complete multi-week courses</summary>
+  <ul>
+    - Thematic arcs organizing related modules
+    - Learning progression across modules
+    - Course-level narratives and structure
+    - Individual module generation (coming soon)
   </ul>
 </details>
 
@@ -30,12 +39,13 @@ Rhea contains three flows for generating curriculum materials
   </ul>
 </details>
 
-<details><summary><strong>Themis:</strong> complete multi-week courses</summary>
+<details><summary><strong>Metis:</strong> standalone module specifications</summary>
   <ul>
-    - Thematic arcs organizing related modules
-    - Learning progression across modules
-    - Course-level narratives and structure
-    - Individual module generation (coming soon)
+    - Learning objectives and module overview
+    - Detailed project briefs with examples and success criteria
+    - Research topics with guidance for learners
+    - Additional skills categorized by importance
+    - Project "twists" to add interesting challenges
   </ul>
 </details>
 
@@ -120,24 +130,30 @@ Open **http://localhost:5173** to start using Rhea.
   - Automatic retry (up to 3 attempts) if validation fails
 </details>
 
-<details><summary><strong>📤 Theia:</strong> Export & Preview</summary>
-  Export generated content in human-readable formats:
-  - **Multiple formats**: Markdown, HTML (PDF planned)
+<details><summary><strong>📤 Theia:</strong> Content Management & Export</summary>
+  Manage previously generated content and export in human-readable formats:
+  - **Upload & Resume**: Upload JSON course files to continue workflows in Themis
+  - **Round-trip capability**: Export → upload → continue working seamlessly
+  - **Multiple formats**: Markdown, HTML, JSON (PDF planned)
   - **Flexible detail levels**: Minimal, summary, detailed, or complete
   - **Selective exports**: Choose specific sections to export
   - **Course or module exports**: Works with both Metis and Themis outputs
   - **Table of contents**: Optional navigation for longer exports
+  - **Drag-and-drop interface**: Easy file upload with validation
 
-  Export at any stage - preview course structures before module generation, or export individual modules after completion.
+  Export at any stage, then re-upload to continue work later. Upload existing course structures to review, refine, or generate additional modules.
 </details>
 
 ### 🎨 Workflows
 
-<details><summary><strong>Metis:</strong> Quick standalone modules</summary>
-  1. Upload XML inputs (projects, skills, research)
-  2. Provide structured context
-  3. Generate with optional research
-  4. Export preview or download XML specification
+<details><summary><strong>Theia:</strong> Manage and export content</summary>
+  1. Upload previously generated course JSON files
+  2. View uploaded course structure
+  3. Choose action:
+     - Continue in Themis to refine or generate modules
+     - Export to human-readable formats (Markdown, HTML)
+  4. Configure export settings (detail level, sections, format)
+  5. Download formatted content
 </details>
 
 <details><summary><strong>Themis:</strong> Complete multi-week courses</summary>
@@ -146,10 +162,17 @@ Open **http://localhost:5173** to start using Rhea.
   3. Organize modules within arcs
   4. AI generates detailed structure
   5. Review and refine
-  6. Export course overview or structure
+  6. Export course overview or structure (JSON for re-upload)
   7. Generate individual modules (coming soon)
 </details>
 
+<details><summary><strong>Metis:</strong> Quick standalone modules</summary>
+  1. Upload XML inputs (projects, skills, research)
+  2. Provide structured context
+  3. Generate with optional research
+  4. Export preview or download XML specification
+</details>
+
 ---
 
 ## Documentation

docs/About-Rhea.md

@@ -77,9 +77,15 @@ Both workflows enforce rigour through structured inputs. No rambling chat – cl
 - **Tethys arc management**: Standalone arc creation and editing between course and module levels
 - **Diff views**: Side-by-side comparison for reviewing AI-proposed updates
 - **Provenance tracking UI**: Visual representation of change history and confidence levels
-- **Export/preview (Theia)**: Human-readable formats (Markdown, HTML, PDF) at various detail levels
+- **Module XML upload in Theia**: Currently supports JSON course upload; module XML upload planned for Q1 2026
 
-The core intelligence is working. Research, generation, validation – all functional. The gap is workflow completeness and review tooling.
+**Recently Completed:**
+
+- **Theia content management** (Oct 2025): Upload/resume workflows, JSON export, round-trip capability
+- **Themis arc-based structure** (Oct 2025): Six-step workflow with thematic organizational layer
+- **Architectural refactoring** (Oct 2025): Factories, utilities, centralized configurations
+
+The core intelligence is working. Research, generation, validation – all functional. Theia provides content management and export. The gap is completing Themis module generation and review tooling.
 
 ## Why This Approach Is Actually Clever
 

docs/dev/Technical-Overview.md

@@ -77,20 +77,32 @@ pedagogue/
 - Prompt: `src/lib/factories/prompts/themisPromptFactory.ts`
 - Components: `src/lib/components/themis/`
 
-### Content Exporter (Theia)
+### Content Manager & Exporter (Theia)
 
-**Purpose:** Export generated content in human-readable formats
+**Purpose:** Upload, manage, and export generated content
 
 **Features:**
-- Export modules or courses at any generation stage
-- Multiple format support: Markdown, HTML (PDF planned)
-- Detail level control: minimal, summary, detailed, complete
-- Selective section exports
-- Automatic table of contents generation
+- **Upload & Resume:**
+  - Upload JSON course files to continue Themis workflows
+  - Comprehensive validation with clear error messages
+  - Drag-and-drop interface with manual file selection
+  - Auto-redirect to Themis on successful upload
+- **Export:**
+  - Export modules or courses at any generation stage
+  - Multiple formats: Markdown, HTML, JSON (PDF planned)
+  - Detail level control: minimal, summary, detailed, complete
+  - Selective section exports
+  - Automatic table of contents generation
+- **Round-trip capability:** Export JSON → upload → continue working
 
 **Implementation:**
+- Route: `src/routes/theia/+page.svelte`
 - Components: `src/lib/components/theia/`
+  - `CourseStructureUpload.svelte` - Upload interface with validation
+  - `ExportConfigModal.svelte` - Export configuration and preview
+  - `ExportButton.svelte` - Export trigger with variants
 - Service: `src/lib/services/theiaService.ts`
+- Validation: `src/lib/utils/theia/courseValidator.ts`
 - Types: `src/lib/types/theia.ts`
 - Formatters: `src/lib/utils/theia/formatters/`
 - Content mapping: `src/lib/utils/theia/contentMapper.ts`

docs/dev/status/README.md

@@ -7,17 +7,17 @@
 ## 1. Submodule Roadmaps
 
 ### 1.1. Core Modules
-- 1.1.1. [**Rhea:**](docs/dev/roadmaps/Rhea-MVP.md) _Platform_
+- 1.1.1. [**Rhea:**](Rhea-MVP.md) _Platform_
 
 ### 1.2. Workflow Modules
-- 1.2.1. [**Themis:**](docs/dev/roadmaps/Themis-MVP.md) _Course Builder_
-- 1.2.2. [**Tethys:**](docs/dev/roadmaps/Tethys-MVP.md) _Arc Designer_
-- 1.2.3. [**Metis:**](docs/dev/roadmaps/Metis-MVP.md) _Module Generator_
+- 1.2.1. [**Themis:**](Themis-MVP.md) _Course Builder_
+- 1.2.2. [**Tethys:**](Tethys-MVP.md) _Arc Designer_
+- 1.2.3. [**Metis:**](Metis-MVP.md) _Module Generator_
 
 ### 1.3. Utility Modules
-- 1.3.1. [**Theia:**](docs/dev/roadmaps/Theia-MVP.md) _Content Preview & Export_
-- 1.3.2. [**Atlas:**](docs/dev/roadmaps/Atlas-MVP.md) _Atomic Learning Assembler_
-- 1.3.3. [**Mnemosyne:**](docs/dev/roadmaps/Mnemosyne-MVP.md) _Storage & Retrieval_
+- 1.3.1. [**Theia:**](Theia-MVP.md) _Content Preview & Export_
+- 1.3.2. [**Atlas:**](Atlas-MVP.md) _Atomic Learning Assembler_
+- 1.3.3. [**Mnemosyne:**](Mnemosyne-MVP.md) _Storage & Retrieval_
 
 ---
 
@@ -118,7 +118,7 @@
 
 #### 2.3.1. Theia: Content Preview & Export
 <details><summary>Status: ~100% MVP ✅</summary>
-  <p>Initial implementation complete and production-ready</p>
+  <p>Core functionality complete and production-ready</p>
 </details>
 
 <details><summary>Implemented</summary>
@@ -127,21 +127,26 @@
     <li>✅ Supports both Themis and Metis output</li>
     <li>✅ Configurable detail levels (minimal, summary, detailed, complete)</li>
     <li>✅ Selective export (specific arcs, modules, or sections)</li>
-    <li>✅ Multiple formats (Markdown, HTML; PDF planned)</li>
+    <li>✅ Multiple formats (Markdown, HTML, JSON; PDF planned)</li>
     <li>✅ Live preview before export</li>
     <li>✅ Client-side processing (no server storage)</li>
     <li>✅ Integrated into Metis and Themis workflows</li>
+    <li>✅ <strong>NEW:</strong> Standalone <code>/theia</code> route with course upload interface</li>
+    <li>✅ <strong>NEW:</strong> JSON course upload with drag-and-drop</li>
+    <li>✅ <strong>NEW:</strong> Comprehensive validation for course structure</li>
+    <li>✅ <strong>NEW:</strong> Round-trip workflow (Themis → export JSON → upload → continue)</li>
+    <li>✅ <strong>NEW:</strong> Theia branding with magenta/cyan palette</li>
   </ul>
-  <p>Implemented October 2025-10-23 via PR #14 (2,813 lines across 10 files)</p>
+  <p>Initial export implementation: October 2025-10-23 via PR #14 (2,813 lines)</p>
+  <p><strong>Course upload implementation: October 2025-10-24 via PR #21 (2,417 lines)</strong></p>
 </details>
 
 <details><summary>Next Up</summary>
-  <h5>XML Upload & Workflow Resume (Q1 2026)</h5>
+  <h5>Module XML Upload & Workflow Resume (Q1 2026)</h5>
   <ul>
-    <li>Standalone <code>/theia</code> route with upload interface</li>
     <li>Upload module XML → continue in Metis or preview/export</li>
     <li>Upload course XML → continue in Themis (after course XML schema exists)</li>
-    <li>XML validation and error handling</li>
+    <li>XML validation and type detection</li>
   </ul>
   <h5>Polish</h5>
   <ul>
@@ -202,9 +207,9 @@
 > [!NOTE]
 > 6 most recent achievements in this codebase
 
-1. **[Theia: Content Preview & Export complete](Theia-MVP.md#21-core-export-functionality--completed-2025-10-23)** (2025-10-23) - Production-ready export system with Markdown/HTML formats, configurable detail levels, and selective section export (2,813 lines)
-2. **[Workflow colour palettes](Rhea-MVP.md#422-record-of-other-completed-tasks)** (2025-10-23) - Dynamic palette system with CSS custom properties for Rhea, Themis, Tethys, and Metis
-3. **[Themis arc-based structure complete](Themis-MVP.md#47-reimplement-the-module-overview-generation-based-on-thematic-arcs--completed)** - Six-step workflow with thematic organizational layer between courses and modules
-4. **[Architectural refactoring complete](Rhea-MVP.md#411-architectural-refactoring-2025-10-20--completed)** (2025-10-20) - 670+ lines eliminated via factories, utilities, and centralized configurations
-5. **[Themis `localStorage` persistence](Themis-MVP.md#48-add-localstorage-persistence--completed)** - Auto-save course progress via `persistedStore()` utility
-6. **[Centralized error handling infrastructure](Rhea-MVP.md#4114-quality-improvements)** - `ErrorBoundary` component, typed error classes, and error stores
+1. **[Theia: Course Structure Upload (JSON)](Theia-MVP.md#412-course-structure-upload-json--completed-2025-10-24)** (2025-10-24) - Complete JSON upload workflow with validation, drag-and-drop interface, and round-trip capability (Themis → export → upload → continue). Theia branding with magenta/cyan palette integrated across platform (2,417 lines)
+2. **[Theia: Content Preview & Export complete](Theia-MVP.md#411-core-export-functionality--completed-2025-10-23)** (2025-10-23) - Production-ready export system with Markdown/HTML/JSON formats, configurable detail levels, and selective section export (2,813 lines)
+3. **[Workflow colour palettes complete](Rhea-MVP.md#422-record-of-other-completed-tasks)** (2025-10-23/24) - Dynamic palette system with CSS custom properties for all five workflows: Rhea, Themis, Tethys, Metis, and Theia
+4. **[Themis arc-based structure complete](Themis-MVP.md#47-reimplement-the-module-overview-generation-based-on-thematic-arcs--completed)** - Six-step workflow with thematic organizational layer between courses and modules
+5. **[Architectural refactoring complete](Rhea-MVP.md#411-architectural-refactoring-2025-10-20--completed)** (2025-10-20) - 670+ lines eliminated via factories, utilities, and centralized configurations
+6. **[Themis `localStorage` persistence](Themis-MVP.md#48-add-localstorage-persistence--completed)** - Auto-save course progress via `persistedStore()` utility

docs/dev/status/Rhea-MVP.md

@@ -56,9 +56,14 @@
 #### 4.2.2. Record of Other Completed Tasks
 - [x] Create an xml output sanitiser
   - Completed via xmlCleaner.ts and responseParser.ts
-- [x] Create colour palettes for Rhea, Themis, Tethys and Metis based on their icons
-  - Completed via `src/lib/styles/palettes.css` (2025-10-23)
+- [x] Create colour palettes for Rhea, Themis, Tethys, Metis, and Theia based on their icons
+  - Initial implementation: `src/lib/styles/palettes.css` (2025-10-23)
   - Branch: `ui/module-palettes` (merged via PR #15)
   - Implemented dynamic palette system with CSS custom properties
-  - Palettes defined for all four modules: Rhea (default), Themis, Tethys, Metis
+  - Palettes initially defined for four modules: Rhea (default), Themis, Tethys, Metis
   - Applied via `data-palette` attribute on root element
+  - **Theia palette added:** (2025-10-24)
+    - Branch: `theia/feat/continue-session-from-xml` (PR #21)
+    - Magenta/cyan colour scheme (--palette-foreground: #B0127A, --palette-foreground-alt: #11B5C6)
+    - Integrated in `paletteLoader.ts` and `paletteTypes.ts`
+    - All five workflow palettes now complete

docs/dev/status/Theia-MVP.md

@@ -12,21 +12,21 @@
 #### 1.1.2. Other Tasks
 - [ ] Add PDF export format (currently marked "coming soon" in UI)
 - [ ] Add export analytics/usage tracking
-- [ ] Implement XML upload & workflow resume functionality (see section 2)
+- [ ] Implement Module XML upload & workflow resume functionality (see section 2.1.1)
 
 ### 1.2. Blocked Tasks
 
 ---
 
 ## 2. MVP Milestones
 
-### 2.1. XML Upload & Workflow Resume — PENDING
+### 2.1. JSON/XML Upload & Workflow Resume — IN PROGRESS
 **Target:** Q1 2026
 **Priority:** Medium
-**Dependencies:** Themis course XML schema (for Phase 2)
-**Objective:** Enable users to upload previously generated XML files and either continue work in the original workflow or preview/export them standalone.
+**Dependencies:** None for JSON upload (✅ complete), Themis course XML schema for XML upload
+**Objective:** Enable users to upload previously generated files and either continue work in the original workflow or preview/export them standalone.
 
-#### 2.1.1. Module Upload (Immediate)
+#### 2.1.1. Module Upload (Deferred to XML Phase)
 **Components:**
 - `/theia` route with upload interface
   - File upload component (drag-drop + file picker)
@@ -104,6 +104,54 @@
 
 ## 4. Work Record
 ### 4.1. Completed Milestones
+
+#### 4.1.2. Course Structure Upload (JSON) ✅ COMPLETED (2025-10-24)
+**Branch:** `theia/feat/continue-session-from-xml`
+**PR:** #21
+**Commits:** `8e75209` through `0363410`
+
+Implemented complete JSON course upload and validation system:
+
+##### Components
+- `/theia` route - Main Theia page with course upload interface
+- `CourseStructureUpload.svelte` - Comprehensive upload component with:
+  - Drag-and-drop file upload
+  - Manual file selection
+  - Real-time JSON validation
+  - Clear error messaging
+  - Auto-redirect to Themis on successful upload
+
+##### Services & Utilities
+- `courseValidator.ts` (225 lines) - Zod-based validation for:
+  - Complete course structure validation
+  - Arc and module hierarchy validation
+  - Logistics and learner data validation
+  - Partial course support (for incomplete workflows)
+
+##### Test Data
+- `partial-course.json` - Incomplete course for testing partial uploads
+- `valid-complete-course.json` - Full course structure for testing complete uploads
+
+##### Integration
+- **JSON Export** - Added JSON format to `ExportConfigModal.svelte`
+- **Round-trip workflow** - Export from Themis → upload to Theia → continue in Themis
+- **Home page** - Theia workflow card added and promoted to primary position
+- **Theming** - Theia palette (magenta/cyan) integrated across platform
+
+##### Key Features
+- ✅ JSON course file upload with validation
+- ✅ Drag-and-drop interface
+- ✅ Comprehensive error handling
+- ✅ Support for partial/incomplete courses
+- ✅ Auto-population of Themis store on success
+- ✅ Seamless workflow continuation
+- ✅ JSON export format for round-trip capability
+- ✅ Theia branding and palette integration
+
+**Files Added:** 3 files (CourseStructureUpload.svelte, courseValidator.ts, test data)
+**Files Modified:** 18 files
+**Total Changes:** 2,417 insertions
+
 #### 4.1.1. Core Export Functionality ✅ COMPLETED (2025-10-23)
 **Branch:** `feat/theia`
 **PR:** #14