How jacobinwwey/noteconnection works
NoteConnection turns local Markdown knowledge bases into navigable knowledge graphs, learning paths, and grounded answers. Its primary workflow is to select a knowledge-base folder, load and analyze its notes, then explore the resulting graph or ask scoped questions with source evidence. The graph also shows the learning and study-session domain, export, and Markdown-processing capabilities documented or represented in the repository. The README describes the RAG stages; sampled excerpts do not expose every runtime call between server, routes, storage, and learning modules, so uncertain links are omitted.
Main entry points: KnowledgeLearningPlatform.ts Learning runtime · Graph.ts Knowledge graph · app.js Workspace interface · source_manager.js Source loading
Components 23
Knowledge workspace
- Workspace interface
src/frontend/app.js - Source loading
src/frontend/source_manager.js - Runtime storage
src/frontend/storage_provider.js - Application server
src/server.ts
Graph analysis
- Graph build entry
src/backend/controller.ts - File loading
src/backend/FileLoader.ts - Graph building
src/backend/GraphBuilder.ts - Knowledge graph
src/core/Graph.ts - Graph analysis
src/backend/GraphMetrics.ts - Graph layout
src/backend/algorithms/LayoutEngine.ts - Learning paths
src/core/PathEngine.ts
Learning and RAG
- Learning runtime
src/learning/KnowledgeLearningPlatform.ts - Knowledge retrieval
src/learning/queryBackend.ts - Evidence assembly
src/learning/graphContextAssembler.ts - Answer composition
src/learning/conversationComposer.ts - Grounding review
src/learning/answerReleaseReview.ts - Mastery and sessions
src/learning/domains/MasteryEngine.ts - Workspace export
src/export/WorkspaceExportBundle.ts
Content services
- Markdown processing
src/notemd/NotemdService.ts - Diagram generation
src/notemd/diagram/diagramGenerationService.ts - Web search providers
src/notemd/search/SearchManager.ts
Other components
- Workspace user
- Markdown knowledge base
Connections 22
- Workspace user → Workspace interface: uses
- Workspace interface → Source loading: loads notes
- Source loading → Runtime storage: reads sources
- Markdown knowledge base → Runtime storage: supplies notes
- Source loading → Application server: requests build
- Application server → Graph build entry: triggers build
- Graph build entry → File loading: builds from files
- File loading → Graph building: provides notes
- Graph building → Knowledge graph: produces graph
- Knowledge graph → Graph analysis: analyzes structure
- Knowledge graph → Graph layout: computes layout
- Knowledge graph → Learning paths: derives paths
- Workspace interface → Learning runtime: asks questions
- Learning runtime → Knowledge retrieval: retrieves evidence
- Learning runtime → Evidence assembly: assembles graph context
- Learning runtime → Answer composition: composes answer
- Learning runtime → Grounding review: reviews answer
- Learning runtime → Mastery and sessions: handles study requests
- Learning runtime → Workspace export: exports workspace
- Workspace user → Markdown processing: requests processing
- Markdown processing → Diagram generation: generates diagrams
- Markdown processing → Web search providers: selects provider