Maieutic ships with a demo script that seeds the database with realistic student sessions, exercises, and cohort data so you can explore the instructor dashboard without running a real class. The fixtures were produced by running actual Opus sessions and saving the results to JSON — they are not synthesized.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/bcanata/maieutic/llms.txt
Use this file to discover all available pages before exploring further.
Seeding demo data
What the script seeds
npm run reset-demo calls scripts/replay-fixtures.ts --wipe, which does the following:
- Drops all existing data — sessions, events, and exercises are deleted before anything is inserted.
- Seeds published exercises — all exercise fixtures from
tests/fixtures/exercises/are loaded. The fixture set includes exercises across all four units and all three student levels, includingvowels-demo,fibonacci-demo,password-demo, and many more. - Creates demo student identities — Ana (
ana_student), Beto (beto_student), and Carmen (carmen_student), plus four anonymous cohort students (cohort_student_0throughcohort_student_3). - Seeds sessions with realistic phase data — each session’s
phase1Data,phase2Data, andphase3Datafields contain real Opus exchanges, spec iterations, divergences, and student responses captured from live API calls. - Seeds live summaries and session events — the
liveSummariesarray and theSessionEventaudit log are populated so the dashboard has data to display. - Rebases all timestamps — start times, completion times, and per-event timestamps are rewritten relative to the current clock so the live dashboard appears active.
| Student | Exercise | Status |
|---|---|---|
| Ana | Count vowels | Completed — closed session with one case-sensitivity divergence |
| Beto | Validate a password | Completed — closed session, explained all divergences correctly |
| Carmen | Nth Fibonacci number | Active — stuck in phase 1, has an open help request |
| Cohort students 0–3 | Count vowels | Completed — varied case-drift patterns for cohort analytics |
When to use it
- After initial setup — explore the instructor dashboard, session reasoning view, and cohort analytics without needing real students.
- To reset to a known-good state — if you have been testing and want to restore the demo, run the script again.
- Before a demo or presentation — the rebased timestamps make the dashboard look live each time you run it.
The capture-fixtures script
The JSON fixtures that npm run reset-demo replays were originally produced by npm run capture-fixtures. You do not need to run this script during normal setup.
tests/fixtures/exercises/ and tests/fixtures/sessions/.
Only run capture-fixtures when Opus prompt templates change and you need fresh fixtures that reflect the updated prompts. The script takes around ten minutes and requires a valid ANTHROPIC_API_KEY.
Test data coverage
The demo fixtures are designed so every instructor view has populated data:- Live dashboard — Carmen’s active session shows a live summary and an open help request flag; Ana and Beto appear as recently completed.
- Session reasoning view — all three named students have full phase data, including Opus exchanges and divergence responses, so the two-column reasoning view is fully populated.
- Cohort analytics — the four cohort students all worked the same vowels exercise with systematic case-drift, giving the cohort narrative something concrete to analyze.
- Exercise library — all three exercises are published and have aggregate session data attached.