Product terms
Project
A workspace that links database connections and optional source code to one analysis schedule, activity thread, and set of auto-mode permissions.
Host
A machine used by a connection: either one running the dbtempo CLI daemon or an SSH bastion used by a managed connection. A host is not the database itself.
Connection
A saved logical database target with its engine, endpoint, database or schema scope, credentials, and direct, SSH, or CLI transport.
Thread
The conversation and activity record that holds submitted artifacts, analysis progress, results, and context requests. Project runs can create or update a linked thread.
Query digest
A stable identity derived from normalized SQL. It groups equivalent query shapes whose literal values differ and links workload observations to recommendations and source locations.
Readiness
The current per-connection result of connectivity, schema-access, and query-source checks. Required failures block analysis; recommended or optional failures reduce coverage.
Recommendation
A durable finding with a diagnosis, confidence, evidence, proposed fix, status, and any available risk, rollback, source, or plan context.
Managed collection
A scan dbtempo runs over a direct or SSH database connection. The managed runner performs the collection without a customer-hosted CLI daemon.
Source analysis
Use of an indexed GitHub repository or host path to find query call sites and add code-level evidence or proposed code changes. Availability is controlled by deployment rollout flags.