Repository navigation
Proposal: Add a Courses section for organizing sessions, folders, and scoped knowledge graphs #837
manyakaistha
started this conversation in
Ideas
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Motivation
Right now, LearnHarness organizes all chat sessions, imported notes/PDFs, and knowledge-graph nodes in a single flat workspace. That works great when studying one topic at a time, but once you use LearnHarness across multiple subjects (e.g., Linear Algebra, Operating Systems, Organic Chemistry), everything mixes together:
Proposed Design: A "Courses" Section
Instead of splitting LearnHarness into isolated workspaces or separate databases, Courses can be implemented as a lightweight read-time projection over the existing global knowledge graph.
1. One Global Graph, Scoped by Course
data/graph/courses.json), storing:id,name,createdAt)sourceId/chatId→courseId)2. Attached Folders & Managed Course Files
queued,extracting,extracted,excluded,failed).<data>/course-files/<courseId>/as a managed folder, scanned automatically, and cleaned up if the user deletes the course with its sources.3. UI & Workflow Changes
Working Reference Implementation
I built a working implementation of this in my fork so you can see how the UX and architecture fit together:
Key files to skim for the architecture:
src/core/contracts/courses.ts&src/core/courses.ts— Course state schema, transitive include resolution, and pure state transitionssrc/server/courses.ts&src/server/course-sources.ts— Folder attachment, managed uploads, background scanning, SHA-256 change detection, and extraction statusapp/api/courses/route.ts&app/api/courses/files/route.ts— REST endpoints for course mutations and file uploadsOpen Questions
All reactions