How bingomaha-creator/knowledge-agent-workspace works
Matthew’s Workspace is a Vue/Express AI-agent workbench for streaming chat with inspectable evidence, confirmed long-term memory, knowledge retrieval, deep research, and structured BugCases. The main workflow runs from the workspace through feature APIs into server-side orchestration and persistence; research adds staged retrieval and reporting, while BugCase investigation turns evidence into reviewable cases. The README documents the broad architecture and capabilities; some subsystem internals are unsampled, so links between their implementation layers are shown only where the excerpts or README support them.
Main entry points: app.js Express application · mcp-gateway.js MCP gateway and tools · research-worker.js Research worker · App.vue Workspace shell
Components 26
Workspace UI
- Workspace shell
src/App.vue - Chat workspace
src/components/ChatPanel.vue - Feature workspaces
src/features - Chat state and stream
src/features/chat/store.ts - Feature state
src/features - Chat API
src/features/chat/api.ts - Feature APIs
src/features
API and Chat
- Express application
server/app.js - Chat routes
server/routes/chat-routes.js - Chat orchestrator
server/chat/chat-orchestrator.js - MCP gateway and tools
server/infrastructure/mcp-gateway.js
Knowledge and Memory
- Knowledge indexing and RAG
server/services/knowledge-service.js - Knowledge routes
server/routes/knowledge-routes.js - Reviewable memory
server/services/memory-service.js
Deep Research
- Research routes
server/routes/research-routes.js - Research worker
server/research-worker.js - Research planning and writing
server/services/research-ai-service.js - Research task store
server/research-store.js - Research source search
server/services/research-search-service.js - Web search provider
server/web-search-provider.js
Bug Knowledge
- BugCase routes
server/routes/bug-knowledge-routes.js - Bug investigation
server/bug-investigation/bug-investigation-service.js - Bug investigation store
server/bug-investigation/bug-investigation-store.js
Other components
- Workspace user
- Qwen-compatible API
- SQLite and FTS5
Connections 34
- Workspace user → Workspace shell: uses
- Workspace shell → Chat workspace: shows
- Workspace shell → Feature workspaces: switches workspaces
- Chat workspace → Chat state and stream: dispatches actions
- Feature workspaces → Feature state: dispatches actions
- Chat state and stream → Chat API: requests and streams
- Feature state → Feature APIs: requests data
- Chat API → Express application: HTTP / SSE
- Feature APIs → Express application: HTTP
- Express application → Chat routes: dispatches
- Express application → Knowledge routes: dispatches
- Express application → Research routes: dispatches
- Express application → BugCase routes: dispatches
- Chat routes → Chat orchestrator: invokes
- Chat orchestrator → Qwen-compatible API: requests completions
- Chat orchestrator → MCP gateway and tools: dispatches tools
- Knowledge routes → MCP gateway and tools: calls tools
- MCP gateway and tools → Knowledge indexing and RAG: dispatches knowledge tools
- MCP gateway and tools → Reviewable memory: dispatches memory tools
- Knowledge indexing and RAG → SQLite and FTS5: indexes and retrieves
- Reviewable memory → SQLite and FTS5: reads and writes
- Research routes → Research task store: reads and creates tasks
- Research routes → Research worker: enqueues and cancels
- Research worker → Research task store: claims and persists stages
- Research worker → Research planning and writing: plans and writes
- Research planning and writing → Qwen-compatible API: requests completions
- Research worker → Research source search: retrieves sources
- Research source search → Knowledge indexing and RAG: searches local sources
- Research source search → Web search provider: searches web sources
- Research task store → SQLite and FTS5: persists tasks
- BugCase routes → MCP gateway and tools: calls BugCase tools
- MCP gateway and tools → Bug investigation: dispatches investigation tools
- Bug investigation → Bug investigation store: reads and updates
- Bug investigation store → SQLite and FTS5: persists investigations