🤖 sync'ing generated docs

buildkite-at-sourcegraph · buildkite-at-sourcegraph · commit 6aa1191f4979 · 2026-04-10T22:24:47.000Z
diff --git a/docs/admin/code-hosts/aws-codecommit.mdx b/docs/admin/code-hosts/aws-codecommit.mdx
@@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// REQUIRED:
diff --git a/docs/admin/code-hosts/azuredevops.mdx b/docs/admin/code-hosts/azuredevops.mdx
@@ -69,7 +69,7 @@ Azure DevOps connections support the following configuration options, which are
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/azuredevops.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 	// Authentication alternatives: token OR windowsPassword
 
@@ -131,19 +131,23 @@ Azure DevOps connections support the following configuration options, which are
 	//   ]
 	"projects": null,
 
-	// An array of "org/project/repo" strings specifying which Azure DevOps repositories within a project should be mirrored in Sourcegraph.
-	"repos": [
-	    "myorg/my-project/myrepo",        // Format: <organization>/<project>/<repository>
-	    "myorg/myproject/myproject",     // Format: repository where project and repo share the same name
-	    "myorg/my project/my project"    // Format: spaces in project or repository names
-  	]
-
 	// Rate limit applied when making background API requests.
 	"rateLimit": {
 		"enabled": false,
 		"requestsPerHour": 0
 	},
 
+	// An array of repository "org/project/repo" strings specifying which Azure DevOps repositories to mirror on Sourcegraph. If both 'repos' and 'projects' or 'orgs' are specified, the union of both sets will be synced.
+	// Other example values:
+	// - [
+	//     "myorg/myproject/myrepo"
+	//   ]
+	// - [
+	//     "myorg/my project/myrepo",
+	//     "myorg/anotherproject/anotherrepo"
+	//   ]
+	"repos": null,
+
 	// The pattern used to generate the corresponding Sourcegraph repository name for a Azure DevOps repository.
 	// - "{host}" is replaced with the Azure DevOps URL's host (such as dev.azure.com)
 	// - "{orgName}" is replaced with the repository's parent projects owning organization (or collection on DevOps server)
diff --git a/docs/admin/code-hosts/bitbucket-cloud.mdx b/docs/admin/code-hosts/bitbucket-cloud.mdx
@@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// The workspace access token to use when authenticating with Bitbucket Cloud.
diff --git a/docs/admin/code-hosts/bitbucket-server.mdx b/docs/admin/code-hosts/bitbucket-server.mdx
@@ -202,7 +202,7 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_server.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 	// Authentication alternatives: token OR password
 
diff --git a/docs/admin/code-hosts/gerrit.mdx b/docs/admin/code-hosts/gerrit.mdx
@@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`.
diff --git a/docs/admin/code-hosts/github.mdx b/docs/admin/code-hosts/github.mdx
@@ -454,7 +454,7 @@ GitHub connections support the following configuration options, which are specif
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/github.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 	// Authentication alternatives: token OR gitHubAppDetails OR externalAccount OR useRandomExternalAccount
 
diff --git a/docs/admin/code-hosts/gitlab.mdx b/docs/admin/code-hosts/gitlab.mdx
@@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits).
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`.
diff --git a/docs/admin/code-hosts/gitolite.mdx b/docs/admin/code-hosts/gitolite.mdx
@@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph:
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}).
diff --git a/docs/admin/code-hosts/other.mdx b/docs/admin/code-hosts/other.mdx
@@ -68,7 +68,7 @@ Repositories must be listed individually:
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".*secret.*"}).
diff --git a/docs/admin/code-hosts/phabricator.mdx b/docs/admin/code-hosts/phabricator.mdx
@@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
diff --git a/docs/admin/config/settings.mdx b/docs/admin/config/settings.mdx
@@ -27,7 +27,7 @@ Settings options and their default values are shown below.
 
 {/* SCHEMA_SYNC_START: admin/config/settings.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 
diff --git a/docs/admin/config/site-config.mdx b/docs/admin/config/site-config.mdx
@@ -21,7 +21,7 @@ All site configuration options and their default values are shown below.
 
 {/* SCHEMA_SYNC_START: admin/config/site.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 
diff --git a/docs/admin/repo/perforce.mdx b/docs/admin/repo/perforce.mdx
@@ -228,7 +228,7 @@ With this setting, Sourcegraph will ignore any rules with a host other than `*`,
 
 {/* SCHEMA_SYNC_START: admin/code_hosts/perforce.schema.json */}
 {/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
-{/* Last updated: 2026-03-30T11:57:12Z */}
+{/* Last updated: 2026-04-10T22:24:46Z */}
 ```json
 {
 	// If non-null, enforces Perforce depot permissions.
diff --git a/docs/cli/references/auth.mdx b/docs/cli/references/auth.mdx
@@ -0,0 +1,22 @@
+# `src auth`
+
+
+
+## Usage
+
+```
+'src auth' provides authentication-related helper commands.
+
+Usage:
+
+	src auth command [command options]
+
+The commands are:
+
+	token   prints the current authentication token
+
+Use "src auth [command] -h" for more information about a command.
+
+
+```
+	
diff --git a/docs/cli/references/index.mdx b/docs/cli/references/index.mdx
@@ -5,6 +5,7 @@
 
 * [`admin`](references/admin)
 * [`api`](references/api)
+* [`auth`](references/auth)
 * [`batch`](references/batch)
 * [`code-intel`](references/code-intel)
 * [`codeowners`](references/codeowners)
diff --git a/docs/cli/references/login.mdx b/docs/cli/references/login.mdx
@@ -19,7 +19,7 @@
 
 Usage:
 
-    src login SOURCEGRAPH_URL
+    src login [flags] SOURCEGRAPH_URL
 
 Examples:
 
@@ -31,6 +31,10 @@ Examples:
 
     $ src login https://sourcegraph.com
 
+  If no access token is configured, 'src login' uses OAuth device flow automatically:
+
+    $ src login https://sourcegraph.com
+
   -dump-requests
     	Log GraphQL requests and responses to stdout
   -get-curl
diff --git a/docs/self-hosted/observability/alerts.mdx b/docs/self-hosted/observability/alerts.mdx
@@ -6815,7 +6815,6 @@ Generated query for critical alert: `max((max(deriv(src_deepsearch_questions_in_
 **Next steps**
 
 - Check frontend logs for `Worker failed to process question` errors.
-- Review LLM stream errors in the `LLM streaming` panel below.
 - Check for upstream LLM provider issues.
 - More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_question_processing_error_rate).
 - **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:
@@ -6840,23 +6839,27 @@ Generated query for critical alert: `max((sum(rate(src_deepsearch_question_proce
 
 <br />
 
-## deepsearch: deepsearch_llm_stream_fatal_errors
+## deepsearch: deepsearch_slow_questions
 
-<p class="subtitle">fatal LLM stream errors over 5m</p>
+<p class="subtitle">questions taking longer than 5 minutes over 15m</p>
 
 **Descriptions**
 
-- <span class="badge badge-warning">warning</span> deepsearch: 20+ fatal LLM stream errors over 5m
+- <span class="badge badge-warning">warning</span> deepsearch: 3+ questions taking longer than 5 minutes over 15m
+- <span class="badge badge-critical">critical</span> deepsearch: 10+ questions taking longer than 5 minutes over 15m
 
 **Next steps**
 
-- Check frontend logs for `fatal error in LLM stream`.
-- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_llm_stream_fatal_errors).
+- Search frontend logs for questionIDs with long processing times.
+- Check `deepsearch_turn_p95_duration` to see if individual turns are slow.
+- Check `deepsearch_question_outcome_by_reason` for elevated truncation or error rates.
+- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_slow_questions).
 - **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:
 
 ```json
 "observability.silenceAlerts": [
-  "warning_deepsearch_deepsearch_llm_stream_fatal_errors"
+  "warning_deepsearch_deepsearch_slow_questions",
+  "critical_deepsearch_deepsearch_slow_questions"
 ]
 ```
 
@@ -6865,7 +6868,46 @@ Generated query for critical alert: `max((sum(rate(src_deepsearch_question_proce
 <details>
 <summary>Technical details</summary>
 
-Generated query for warning alert: `max((sum(increase(src_deepsearch_question_processing_errors_total{operation="llm_stream_fatal"}[5m]))) &gt; 20)`
+Generated query for warning alert: `max((sum(increase(src_deepsearch_question_processing_duration_seconds_count{operation="question"\}[15m])) - sum(increase(src_deepsearch_question_processing_duration_seconds_bucket\{le="300",operation="question"}[15m]))) &gt; 3)`
+
+Generated query for critical alert: `max((sum(increase(src_deepsearch_question_processing_duration_seconds_count{operation="question"\}[15m])) - sum(increase(src_deepsearch_question_processing_duration_seconds_bucket\{le="300",operation="question"}[15m]))) &gt; 10)`
+
+</details>
+
+<br />
+
+## deepsearch: deepsearch_response_truncated
+
+<p class="subtitle">response truncated questions over 15m</p>
+
+**Descriptions**
+
+- <span class="badge badge-warning">warning</span> deepsearch: 3+ response truncated questions over 15m
+- <span class="badge badge-critical">critical</span> deepsearch: 10+ response truncated questions over 15m
+
+**Next steps**
+
+- Search frontend logs for: "answer truncated due to output token limit" to find affected questionIDs.
+- This usually indicates model overthinking and spending all output tokens on thinking with no useful answer, or the user requested an extremely large output.
+- Check if a recent model change may have caused increased thinking token usage.
+- More help interpreting this metric is available in the [dashboards reference](dashboards#deepsearch-deepsearch_response_truncated).
+- **Silence this alert:** If you are aware of this alert and want to silence notifications for it, add the following to your site configuration and set a reminder to re-evaluate the alert:
+
+```json
+"observability.silenceAlerts": [
+  "warning_deepsearch_deepsearch_response_truncated",
+  "critical_deepsearch_deepsearch_response_truncated"
+]
+```
+
+<sub>*Managed by the Sourcegraph Code Understanding team.*</sub>
+
+<details>
+<summary>Technical details</summary>
+
+Generated query for warning alert: `max((sum(increase(src_deepsearch_question_outcome_total{outcome="response_truncated"}[15m]))) &gt; 3)`
+
+Generated query for critical alert: `max((sum(increase(src_deepsearch_question_outcome_total{outcome="response_truncated"}[15m]))) &gt; 10)`
 
 </details>
 
diff --git a/docs/self-hosted/observability/dashboards.mdx b/docs/self-hosted/observability/dashboards.mdx

Original file line number	Diff line number	Diff line change
`@@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar`
`37`	`37`
`38`	`38`	`{/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}`
`39`	`39`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`40`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`40`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`41`	`41`	```json
`42`	`42`	`{`
`43`	`43`	`// REQUIRED:`
Original file line number	Diff line number	Diff line change
`@@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a`
`116`	`116`
`117`	`117`	`{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}`
`118`	`118`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`119`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`119`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`120`	`120`	```json
`121`	`121`	`{`
`122`	`122`	`// The workspace access token to use when authenticating with Bitbucket Cloud.`
Original file line number	Diff line number	Diff line change
`@@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif`
`113`	`113`
`114`	`114`	`{/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */}`
`115`	`115`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`116`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`116`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`117`	`117`	```json
`118`	`118`	`{`
`119`	`119`	// If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`.
Original file line number	Diff line number	Diff line change
`@@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits).`
`189`	`189`
`190`	`190`	`{/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */}`
`191`	`191`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`192`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`192`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`193`	`193`	```json
`194`	`194`	`{`
`195`	`195`	// If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`.
Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph:`
`25`	`25`
`26`	`26`	`{/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */}`
`27`	`27`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`28`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`28`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`29`	`29`	```json
`30`	`30`	`{`
`31`	`31`	`// A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}).`
Original file line number	Diff line number	Diff line change
`@@ -68,7 +68,7 @@ Repositories must be listed individually:`
`68`	`68`
`69`	`69`	`{/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */}`
`70`	`70`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`71`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`71`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`72`	`72`	```json
`73`	`73`	`{`
`74`	`74`	`// A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".secret."}).`
Original file line number	Diff line number	Diff line change
@@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config
`76`	`76`
`77`	`77`	`{/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */}`
`78`	`78`	`{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}`
`79`		`-{/* Last updated: 2026-03-30T11:57:12Z */}`
	`79`	`+{/* Last updated: 2026-04-10T22:24:46Z */}`
`80`	`80`	```json
`81`	`81`	`{`
`82`	`82`	// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.