Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 58 additions & 35 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**
:-------:|:----------:|:----------:|:--------:
![Rhea](static/icon.png) | ![Themis](static/themis/icon.png) | ![Tethys](static/tethys/icon.png) | ![Metis](static/metis/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>

Expand All @@ -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>

Expand Down Expand Up @@ -87,18 +97,18 @@ Open **http://localhost:5173** to start using Rhea.

<details><summary>📝 Change Tracking & Provenance</summary>
Every generated module includes comprehensive change tracking to support the **cascade pattern** - where AI-generated modules are updated iteratively whilst maintaining human oversight:

- **Automatic Changelog**: Documents what changed, why, and with what confidence level
- **Confidence Scoring**: High/medium/low confidence flags help reviewers prioritize
- **Research Citations**: Web research sources automatically cited
- **Provenance Tracking**: Shows when generated, by which model, flags sections needing review

This enables curriculum councils to:
- Quickly identify what's been updated since last version
- Focus review time on low-confidence changes
- Understand rationale behind AI-proposed updates
- Track sections needing human review

See [Changelog Schema Design](/docs/dev/work-records/changelog-schema-design.md) for technical details.
</details>

Expand All @@ -108,7 +118,7 @@ Open **http://localhost:5173** to start using Rhea.
- Update recommendations based on industry trends
- Search trusted domains: vendor docs, GitHub, Stack Overflow, academic sources
- Cite sources for transparency

**This is the core value** - without research, you're just reformatting existing content.
</details>

Expand All @@ -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

Export at any stage - preview course structures before module generation, or export individual modules after completion.
- **Drag-and-drop interface**: Easy file upload with validation

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>
Expand All @@ -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
Expand Down Expand Up @@ -205,7 +228,7 @@ Metis accepts XML files for module inputs. Each file must have a specific root e
</Projects>
</pre>
<p>
<strong>Minimal valid:</strong>
<strong>Minimal valid:</strong>
<pre><Projects></Projects></pre>
</p>
</details>
Expand All @@ -224,9 +247,9 @@ Metis accepts XML files for module inputs. Each file must have a specific root e
</AdditionalSkills>
</pre>
<p>
<strong>Minimal valid:</strong>
<pre><Skills></Skills></pre>
or
<strong>Minimal valid:</strong>
<pre><Skills></Skills></pre>
or
<pre><AdditionalSkills></AdditionalSkills></pre>
</p>
</details>
Expand All @@ -243,7 +266,7 @@ Metis accepts XML files for module inputs. Each file must have a specific root e
</ResearchTopics>
</pre>
<p>
<strong>Minimal valid:</strong>
<strong>Minimal valid:</strong>
<pre><ResearchTopics></ResearchTopics></pre>
</p>
</details>details>
Expand Down
10 changes: 8 additions & 2 deletions docs/About-Rhea.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
26 changes: 19 additions & 7 deletions docs/dev/Technical-Overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand Down
Loading