How abdulla-aldosari/mindstream works
MindStream is a VS Code sidebar extension for capturing and organizing notes and ideas. Users create or edit a note in the webview, choose its type and category, and manage status, priority, tasks, archiving, and code links; the host validates and persists the result in workspace JSON. The product also supports custom types and categories, filtering and sorting, import/export, weekly reports, and a work-pause note. The graph follows documented behavior and indexed module references; some subsystem details were not sampled.
Main entry points: sidebarController.ts Message controller · extension.ts Extension setup · main.js Sidebar app · storage.ts Workspace JSON storage
Components 21
Extension host
- Extension setup
src/extension.ts - Sidebar provider
src/sidebarProvider.ts - Message controller
src/sidebarController.ts
Sidebar interface
- Sidebar app
media/sidebar/main.js - Note editor
media/sidebar/noteEditor.js - Note list
media/sidebar/list.js - Task editor
media/sidebar/taskEditor.js - Pause panel
media/sidebar/workPausePanel.js
Notes and organization
- Note operations
src/itemsStore.ts - Note data model
src/models.ts - Workspace JSON storage
src/storage.ts - Type registry
src/typesRegistry.ts - Category registry
src/categoriesRegistry.ts - Task validation
src/tasks.ts - Priority rules
src/priority.ts
Product features
- Code link tracking
src/linkTracker.ts - Link resolution
src/linkResolver.ts - Import and export
src/export.ts - Weekly reports
src/report.ts - Work pause
src/workPauseStore.ts
Other components
- VS Code user
Connections 26
- VS Code user → Sidebar app: uses sidebar
- Extension setup → Sidebar provider: sets up
src/extension.ts - Sidebar provider → Message controller: routes messages
src/sidebarProvider.ts - Sidebar app → Sidebar provider: exchanges state
src/sidebarProvider.ts - Sidebar app → Note editor: opens editor
media/sidebar/main.js - Sidebar app → Note list: initializes list
media/sidebar/main.js - Note editor → Task editor: uses task editor
media/sidebar/noteEditor.js - Message controller → Note operations: handles note actions
src/sidebarController.ts - Message controller → Type registry: validates type
src/sidebarController.ts - Message controller → Category registry: validates category
src/sidebarController.ts - Message controller → Work pause: checks pause state
src/sidebarController.ts - Note operations → Workspace JSON storage: reads and saves
src/itemsStore.ts - Workspace JSON storage → Note data model: parses data
src/storage.ts - Workspace JSON storage → Priority rules: validates priority
src/storage.ts - Workspace JSON storage → Link resolution: sanitizes links
src/storage.ts - Note operations → Note data model: uses item types
src/itemsStore.ts - Message controller → Task validation: sanitizes tasks
src/sidebarController.ts - Extension setup → Code link tracking: initializes tracking
src/extension.ts - Code link tracking → Note operations: tracks note links
src/linkTracker.ts - Code link tracking → Link resolution: resolves locations
src/linkTracker.ts - Extension setup → Import and export: registers commands
- Extension setup → Weekly reports: registers reports
src/extension.ts - Message controller → Weekly reports: serves report actions
- Extension setup → Work pause: sets up pause
src/extension.ts - Sidebar app → Pause panel: initializes panel
media/sidebar/main.js - Message controller → Work pause: handles pause messages
src/sidebarController.ts