How cubiculum-ai/tractanda works
Tractanda is a local, shared knowledge-base service: people and agents submit item edits or queries through clients; the service enforces current permissions, manages versioned revisions, and returns results. Its domain includes category hierarchies and saved or transient views, with lexical and optional semantic retrieval. The graph also shows the documented CLI, terminal, MCP, daemon, and browser surfaces. Some subsystem wiring is inferred only from README-level capability descriptions; optional embedding integration is shown separately.
Main entry points: Service.swift Item service · Query.swift Views and queries · SemanticService.swift Semantic retrieval · ItemClient.swift Typed item client
Components 19
User clients
- CLI
Sources/TractandaCLI/main.swift - Terminal UI
Sources/TractandaTUI/TerminalApplication.swift - Typed item client
Packages/TractandaClient/Sources/TractandaClient/ItemClient.swift - Kanban repository
Sources/TractandaKanban/KanbanRepository.swift - Browser Kanban
Sources/TractandaWeb/KanbanPage.swift
Core service
- Item service
Sources/TractandaCore/Service.swift - Access control
Sources/TractandaCore/AccessControl.swift - Revision store
Sources/TractandaCore/Store.swift - Category hierarchy
Sources/TractandaCore/CategoryHierarchy.swift
Query and semantics
- Views and queries
Sources/TractandaCore/Query.swift - Semantic retrieval
Sources/TractandaCore/SemanticService.swift - Vector index bridge
Sources/TractandaCore/SemanticVec1Storage.swift
Service interfaces
- Native transport
Sources/TractandaCore/LocalItemTransport.swift - Shared daemon
Sources/TractandaServer/DaemonApplication.swift - Stdio MCP
Sources/TractandaMCP/StandardIOTransport.swift - HTTP MCP
Sources/TractandaMCP/MCPHTTPService.swift
Optional integrations
- Embedding host
Packages/TractandaEmbeddings/Sources/TractandaEmbeddingsHost/main.swift - Embedding engine
Packages/TractandaEmbeddings/Sources/TractandaEmbeddingsHost/EmbeddingEngine.swift
Other components
- People and agents
Connections 21
- People and agents → CLI: use
- People and agents → Terminal UI: use
- People and agents → Browser Kanban: use
- CLI → Native transport: send requests
- Terminal UI → Typed item client: edit and query
- Browser Kanban → Kanban repository: present board
- Kanban repository → Typed item client: query items
- Typed item client → Native transport: send requests
- Native transport → Item service: dispatch
- Shared daemon → Item service: serve requests
- Stdio MCP → Item service: dispatch tools
- HTTP MCP → Item service: dispatch tools
- Item service → Access control: authorize requests
- Item service → Revision store: read and write revisions
- Item service → Views and queries: run queries
- Views and queries → Revision store: read revisions
- Views and queries → Category hierarchy: resolve categories
- Item service → Semantic retrieval: provide semantic retrieval
- Semantic retrieval → Vector index bridge: search and maintain index
- Embedding host → Embedding engine: serve embeddings
- Semantic retrieval → Embedding host: request embeddings