Changes for CONTEXT.md: 2 added lines, 2 removed lines.
Original line number
Diff line number
Diff line
@@ -15,11 +15,11 @@ Retired engineering abbreviation for Orbit ("GitLab Knowledge Graph"). Still pre
_Avoid_: using GKG in user-facing contexts
**Orbit Remote**:
The hosted Orbit service. Indexes all GitLab.com SDLC and code data; queries are user-scoped and JWT-authenticated. The `orbit`binary reaches it with the `query`, `status`, `ontology`, `dsl`, `tools`, and `graph-status` verbs; `glab orbit remote` is `glab`'s own client for the same API.
The hosted Orbit service. Indexes all GitLab.com SDLC and code data; queries are user-scoped and JWT-authenticated. The flat `orbit`command tree reaches it with the `query`, `status`, `ontology`, `dsl`, `tools`, and `graph-status` verbs.
_Avoid_: "the server", "production GKG"
**Orbit Local**:
The local backend of the `orbit` binary: indexes a single repository into a DuckDB database for offline analysis, reached with the `index`, `grep`, `context`, `sql`, `schema`, `list`, `repo-map`, and `mcp` verbs. `glab orbit local` installs the binary and forwards commands to it.
The local backend of the `orbit` binary: indexes a single repository into a DuckDB database for offline analysis, reached in the same flat command tree with the `index`, `grep`, `context`, `sql`, `schema`, `list`, `repo-map`, and `mcp` verbs. `glab orbit` installs the binary and forwards all verbs to it.
_Avoid_: "the CLI" (ambiguous — one binary serves both backends)
Changes for docs/design-documents/README.md: 1 added line, 1 removed line.
Original line number
Diff line number
Diff line
@@ -29,7 +29,7 @@ A secure query layer on top of the graph lets developers and AI agents query tha
-**`Indexer`** (`gkg-server --mode Indexer`): Runs the shared indexing engine, consumes SDLC and code indexing requests from NATS JetStream, and writes graph data into ClickHouse.
-**`DispatchIndexing`** (`gkg-server --mode DispatchIndexing`): On a schedule, detects enabled root namespaces with recent Siphon changes and publishes deduplicated per-namespace indexing requests to the internal `GKG_INDEXER` stream. It also runs scheduled dispatchers for code indexing tasks, namespace deletion, stale-edge reconciliation, and schema-migration lifecycle, including ontology archive publication.
-**`HealthCheck`** (`gkg-server --mode HealthCheck`): Aggregates cluster health by probing Kubernetes deployments and ClickHouse instances, and exposes the result on a single `/health` endpoint.
-**Orbit Local's `orbit` CLI**, which parses a local repository, stores its code graph in DuckDB, accepts read-only DuckDB SQL, and serves local MCP tools over stdio. `glab orbit local` installs and runs this binary.
-**The `orbit` CLI**, which exposes one flat command tree. Local commands parse repositories, store code graphs in DuckDB, accept read-only DuckDB SQL, and serve MCP tools over stdio; hosted commands query Orbit Remote. `glab orbit` installs and runs this binary.
-**UI and product experiences**, which consume Orbit Remote through GitLab APIs and the GitLab Duo Agent Platform.