trove
The trove: specs as a database, with its settings schema.
In the namespace octomy.
Detailed description
Function documentation
troveSchema
const config::Schema &trove::troveSchema()
The trove schema: the global knobs and their per-project overrides as data.
Before the schema, the knobs had two editors, the global Settings tab of the projects wall and the Settings tab of each board, and each one read and wrote its own fields. The schema declares each knob one time, with its key, its default and its range. The settings page shows it with the levels App and Project, and TroveKnobs reads the resolver (config-ui §CFGC-8, parity CFG-105 and CFG-106).
libtrove links libconfig and not libconfigui, because libconfigui reaches libnode and libnode depends on libtrove. So the window that shows the schema lives in libhub.
Classes
| Class | What it is |
|---|---|
| LaneGitWrite | — |
| LaneSetup | — |
| ManagedProjectStore | Project level bound to one project of a TroveProjectManager |
| NewTroveLaneActivity | Name-and-create a lane on a project (mirrors the new-project flow) |
| NewTroveProjectActivity | Create-project flow: browse a local repo or clone a git URL (§PR-5.5) |
| ProjectOverridesStore | Project level of the trove schema over one ProjectOverrides value |
| ProjectRemoval | — |
| SessionManager | Lane bookkeeping of one Trove engine, on top of the door host's session runner (§OR-1, trove-parts §TPA-4) |
| SettingsKnobStore | App level of the trove schema over the node's settings |
| TroveAuthActivity | Embedded login surface for a session waiting on auth (§UI-5) |
| TroveLaneActivity | Session lane page on the shared chat stream (§UI-3) |
| TroveLaneCard | Reusable per-lane card shown on the project page and in the lane page (§UI-3.5) |
| TroveProjectActivity | Operator status board + minimal drive surface for the Trove engine (§UI) |
| TroveProjectCard | Card of one project on Trove home (§PR-6.1, trove-navigation §TNV-D-3) |
| TroveProjectManager | Multi-project engine root — one isolated engine per project (§PR-2) |
| TroveProjectsActivity | Trove home: the cards of the projects, and the global settings (§PR-5.1, trove-navigation §TNV-D-3) |
| TroveRemoteSessionWorker | Sends a portable session job to the node that the placement solver chose (trove-parts §TPL-2) |
| TroveSupervisor | Assembles one project's Trove engine into a single running unit (§OR-1) |
| TroveSupervisorService | Always-on Node service hosting the multi-project Trove engine (§PR-2.1) |
Namespaces
| Namespace | What it is |
|---|---|
| door | Host of the trove: the one door of a user and host, its sessions and its tasks |
| driver | Claude Code side of a session: the files in its working folder and the models it can use |
| fleet | Trove side of the fleet: node capabilities and fleet tasks |
| git | Named worktrees of one git checkout, and the lease of each one to one holder |
| lane | Lanes of a trove project: the lane manager, and the notifier that tells each view when a lane or a job changes |
| opal | OPAL tasks of the trove |
| recurring | Recurring specs: their probes, the engine of their runs, and the host and lander of the HUB (trove-recurring) |
| specdb | Spec database of the trove |
| ui | Widgets of the trove board: the project and lane cards, and the views of a session |
| workspace | Tabs of the trove board: the spec workspace, the files workspace and the trove chat |