Didactopus/.update_readmes/20260314_132051__230-didact...

1.4 KiB

Didactopus Pack + Persistence Prototype

This update connects the learner-facing prototype to:

  • real pack-shaped data files
  • pack compliance / attribution manifests
  • persistent learner state via browser local storage
  • a small Python pack export utility that converts a Didactopus-style pack directory into a frontend-consumable JSON bundle

What is included

Frontend

  • topic/domain selection from real pack files
  • first-session onboarding from pack metadata
  • recommendation cards driven by live learner state
  • mastery-map progress from pack concepts and persisted learner records
  • milestone/reward feedback
  • transparent "why this is recommended" explanations
  • compliance/provenance display from pack manifest
  • persistent learner state across reloads via local storage

Backend-adjacent tooling

  • pack_to_frontend.py converts:
    • pack.yaml
    • concepts.yaml
    • pack_compliance_manifest.json into a bundle suitable for the learner UI

Why this matters

This gets Didactopus closer to a usable human-facing system:

  • the UI is no longer a static mock
  • packs are loadable artifacts
  • learner progress persists between sessions
  • provenance/compliance data can be shown from real manifests

Next likely step

Add a real API layer so that:

  • learner state is persisted outside the browser
  • evaluator runs produce evidence automatically
  • multiple users can work against the same pack registry