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
In this section