Skip to content

feat: add schema_url/BIFROST_SCHEMA_URL support for mirrored schema locations in isolated deployments - #4614

Merged
Pratham-Mishra04 merged 1 commit into
devfrom
06-22-feat_allow_custom_schema_url_overrides_for_config.json
Jul 9, 2026
Merged

feat: add schema_url/BIFROST_SCHEMA_URL support for mirrored schema locations in isolated deployments#4614
Pratham-Mishra04 merged 1 commit into
devfrom
06-22-feat_allow_custom_schema_url_overrides_for_config.json

Conversation

@impoiler

Copy link
Copy Markdown
Contributor

Summary

Bifrost deployments in air-gapped or isolated environments cannot reach https://www.getbifrost.ai/schema to fetch the JSON schema for config.json validation. This PR introduces a schema_url / schemaUrl override across the Go transport, Helm chart, and Terraform module so that operators can point schema resolution at a mirrored HTTP(S) URL, a file:// URL, or a local filesystem path instead of the hardcoded public URL.

Changes

  • Go transport (validator.go, config.go): Replaced the hardcoded https://www.getbifrost.ai/schema fetch with a loadSchemaFromLocation helper that handles HTTP(S), file://, and filesystem paths. Schema resolution now follows this priority: BIFROST_SCHEMA_URL env → SCHEMA_URL env (legacy) → $schema value in config.json (if not the default URL) → local source-checkout candidate → default public URL. The startup warning for a missing $schema field now checks for an empty/absent value rather than an exact URL match.
  • config.schema.json: Removed the const constraint on $schema (which would have rejected any non-default value) and replaced it with a default, allowing mirrored locations to pass schema validation.
  • Helm chart: Added bifrost.schemaUrl to values.yaml and values.schema.json. The value is written into the generated config.json $schema field via _helpers.tpl and exported as BIFROST_SCHEMA_URL in both deployment.yaml and stateful.yaml.
  • Terraform module: Added a schema_url variable (defaulting to the public URL) that is injected into the $schema field of the generated config.json. A new schema_url_override test case validates that a custom value is correctly written through.
  • Docs: Updated the schema reference page and Helm/Terraform READMEs to document the new override options.

Type of change

  • Bug fix
  • Feature
  • Refactor
  • Documentation
  • Chore/CI

Affected areas

  • Core (Go)
  • Transports (HTTP)
  • Providers/Integrations
  • Plugins
  • UI (React)
  • Docs

How to test

# Unit tests for the validator and schema loading logic
cd transports/bifrost-http
go test ./lib/... -run TestValidateConfigSchema

# Test filesystem path override via env
BIFROST_SCHEMA_URL=/path/to/config.schema.json go test ./lib/... -run TestValidateConfigSchema_CustomSchemaFilePath

# Test legacy env var
SCHEMA_URL=/path/to/config.schema.json go test ./lib/... -run TestValidateConfigSchema_LegacySchemaURLEnv

# Helm: render and inspect the generated config.json $schema field
helm template bifrost ./helm-charts/bifrost \
  --set bifrost.schemaUrl="https://schema.internal/bifrost" \
  | grep '\$schema'

# Terraform: run the config merging tests
cd terraform/modules/bifrost
terraform test -filter=config_merging.tftest.hcl

New environment variables / Helm values / Terraform variables:

Surface Name Default
Go / Docker env BIFROST_SCHEMA_URL https://www.getbifrost.ai/schema
Go / Docker env (legacy) SCHEMA_URL
Helm bifrost.schemaUrl https://www.getbifrost.ai/schema
Terraform schema_url https://www.getbifrost.ai/schema

All accept an HTTP(S) URL, file:// URL, or filesystem path.

Breaking changes

  • No

The const constraint on $schema in config.schema.json has been relaxed to a default. Existing configs using the public URL continue to validate correctly. Configs that previously set a non-default $schema value would have failed schema validation before this change, so removing the constraint is strictly additive.

Security considerations

Schema content loaded from a file:// or filesystem path is read from the local filesystem using the process's existing permissions — no new network surface is introduced for isolated deployments. Operators using HTTP(S) mirrors should ensure the mirror endpoint is trusted, as the fetched schema is used to validate the entire config.json.

Checklist

  • I read docs/contributing/README.md and followed the guidelines
  • I added/updated tests where appropriate
  • I updated documentation where needed
  • I verified builds succeed (Go and UI)
  • I verified the CI pipeline passes locally if applicable

@coderabbitai

coderabbitai Bot commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: dd1f7158-051b-49e8-9fe3-4910858336a2

📥 Commits

Reviewing files that changed from the base of the PR and between 4f5dd0d and 79ac94a.

📒 Files selected for processing (18)
  • docs/deployment-guides/config-json/schema-reference.mdx
  • helm-charts/bifrost/Chart.yaml
  • helm-charts/bifrost/README.md
  • helm-charts/bifrost/templates/_helpers.tpl
  • helm-charts/bifrost/templates/deployment.yaml
  • helm-charts/bifrost/templates/stateful.yaml
  • helm-charts/bifrost/values.schema.json
  • helm-charts/bifrost/values.yaml
  • terraform/modules/bifrost/README.md
  • terraform/modules/bifrost/main.tf
  • terraform/modules/bifrost/tests/config_merging.tftest.hcl
  • terraform/modules/bifrost/tests/setup/main.tf
  • terraform/modules/bifrost/tests/setup/variables.tf
  • terraform/modules/bifrost/variables.tf
  • transports/bifrost-http/lib/config.go
  • transports/bifrost-http/lib/validator.go
  • transports/bifrost-http/lib/validator_test.go
  • transports/config.schema.json
📝 Walkthrough

Walkthrough

Adds configurable $schema handling for config.json across Go validation, Helm, Terraform, and docs. The chart and module now accept schema-location overrides, and the runtime validation path resolves schemas from environment, config, local files, or the default URL.

Changes

Configurable schema location

Layer / File(s) Summary
Schema resolution and validation logic
transports/bifrost-http/lib/validator.go, transports/bifrost-http/lib/validator_test.go, transports/bifrost-http/lib/config.go, transports/config.schema.json
Adds schema-location constants and loaders, refactors validation to resolve schemas from env/config/local file/default URL, changes failed schema loads to return errors, relaxes startup $schema checks, updates schema metadata, and adds HTTP/file-path tests.
Helm chart schemaUrl support
helm-charts/bifrost/values.yaml, helm-charts/bifrost/values.schema.json, helm-charts/bifrost/templates/_helpers.tpl, helm-charts/bifrost/templates/deployment.yaml, helm-charts/bifrost/templates/stateful.yaml, helm-charts/bifrost/Chart.yaml, helm-charts/bifrost/README.md
Adds bifrost.schemaUrl, uses it as the generated $schema default, conditionally injects BIFROST_SCHEMA_URL into pods, bumps chart version, and updates the chart changelog.
Terraform schema_url variable and merging
terraform/modules/bifrost/variables.tf, terraform/modules/bifrost/main.tf, terraform/modules/bifrost/tests/setup/variables.tf, terraform/modules/bifrost/tests/setup/main.tf, terraform/modules/bifrost/tests/config_merging.tftest.hcl, terraform/modules/bifrost/README.md
Adds schema_url, applies it when building $schema overrides, updates test setup inputs and assertions, and documents the new option and test wording.
Schema reference documentation
docs/deployment-guides/config-json/schema-reference.mdx
Expands $schema guidance to cover IDE validation, supported location formats, and BIFROST_SCHEMA_URL precedence.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Suggested reviewers: danpiths, akshaydeo

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 28.57% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly matches the main change: adding schema_url/BIFROST_SCHEMA_URL support for mirrored schema locations.
Description check ✅ Passed The description largely follows the template with clear Summary, Changes, testing, security, and checklist sections; only non-critical items like related issues are missing.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 06-22-feat_allow_custom_schema_url_overrides_for_config.json

Comment @coderabbitai help to get the list of available commands.

@impoiler impoiler self-assigned this Jun 22, 2026
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch 2 times, most recently from 4f3f4cb to d47aca4 Compare June 23, 2026 09:12
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch 3 times, most recently from 1055b8e to 87c11b8 Compare June 25, 2026 10:18
@impoiler
impoiler changed the base branch from dev to graphite-base/4614 June 26, 2026 12:23
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch from 87c11b8 to 7653b19 Compare June 26, 2026 12:23
@impoiler
impoiler changed the base branch from graphite-base/4614 to 06-26-refactor_workspace_complexity-router_page_ui_changes June 26, 2026 12:24
@impoiler
impoiler force-pushed the 06-26-refactor_workspace_complexity-router_page_ui_changes branch from 0b20972 to 8c7f9db Compare June 26, 2026 12:24
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch from 7653b19 to f81a020 Compare June 26, 2026 12:24
@impoiler
impoiler changed the base branch from 06-26-refactor_workspace_complexity-router_page_ui_changes to graphite-base/4614 June 26, 2026 12:26
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch from f81a020 to 7c1c332 Compare June 26, 2026 12:26
@impoiler
impoiler force-pushed the graphite-base/4614 branch from 8c7f9db to 5e42852 Compare June 26, 2026 12:26
@impoiler
impoiler changed the base branch from graphite-base/4614 to dev June 26, 2026 12:26
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch 2 times, most recently from 9c8cc92 to eaea90d Compare June 29, 2026 10:27
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch from eaea90d to 2e6e974 Compare July 1, 2026 11:06
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch 2 times, most recently from f3bf8fb to 722067a Compare July 1, 2026 14:13
@impoiler
impoiler requested a review from a team as a code owner July 9, 2026 06:39
@greptile-apps

greptile-apps Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Confidence Score: 5/5

This looks safe to merge.

  • No blocking issues found in the changed code.

Important Files Changed

Filename Overview
transports/bifrost-http/lib/validator.go Adds schema resolution and loading from environment, config, local files, and the default public URL.
terraform/modules/bifrost/main.tf Adds schema_url precedence while preserving an existing base config $schema when no override is set.
helm-charts/bifrost/templates/_helpers.tpl Writes the configured schema location into the generated Helm config.json.
transports/config.schema.json Allows custom $schema values by replacing the fixed constraint with a default.

Reviews (5): Last reviewed commit: "feat: Allow custom schema URL overrides ..." | Re-trigger Greptile

Comment thread transports/bifrost-http/lib/validator.go
Comment thread terraform/modules/bifrost/main.tf Outdated
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch 2 times, most recently from ab9906f to 08f6ba2 Compare July 9, 2026 07:23
@coderabbitai
coderabbitai Bot requested a review from TejasGhatte July 9, 2026 07:24
Comment thread transports/bifrost-http/lib/validator.go
@impoiler
impoiler force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch from 08f6ba2 to 15ef1ea Compare July 9, 2026 07:50
Comment thread transports/bifrost-http/lib/validator.go

Pratham-Mishra04 commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Merge activity

  • Jul 9, 12:16 PM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Jul 9, 12:37 PM UTC: Graphite rebased this pull request as part of a merge.
  • Jul 9, 12:38 PM UTC: @Pratham-Mishra04 merged this pull request with Graphite.

@Pratham-Mishra04
Pratham-Mishra04 changed the base branch from 07-08-fix_unwated_filters_resets_on_dashboard_and_logs_pages to graphite-base/4614 July 9, 2026 12:33

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@transports/bifrost-http/lib/validator.go`:
- Around line 32-46: Cap the HTTP schema response body in loadSchemaFromLocation
before reading it. Keep the existing timeout and status checks, but wrap
resp.Body with a size limit and return an error if the schema exceeds that bound
instead of calling io.ReadAll directly. Apply this only in the http/https branch
of loadSchemaFromLocation, preserving the local file path behavior via
filePathFromSchemaLocation.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 93e497ca-f2f6-4ef4-808b-5176178a21e5

📥 Commits

Reviewing files that changed from the base of the PR and between 6ae1cc0 and 4f5dd0d.

📒 Files selected for processing (18)
  • docs/deployment-guides/config-json/schema-reference.mdx
  • helm-charts/bifrost/Chart.yaml
  • helm-charts/bifrost/README.md
  • helm-charts/bifrost/templates/_helpers.tpl
  • helm-charts/bifrost/templates/deployment.yaml
  • helm-charts/bifrost/templates/stateful.yaml
  • helm-charts/bifrost/values.schema.json
  • helm-charts/bifrost/values.yaml
  • terraform/modules/bifrost/README.md
  • terraform/modules/bifrost/main.tf
  • terraform/modules/bifrost/tests/config_merging.tftest.hcl
  • terraform/modules/bifrost/tests/setup/main.tf
  • terraform/modules/bifrost/tests/setup/variables.tf
  • terraform/modules/bifrost/variables.tf
  • transports/bifrost-http/lib/config.go
  • transports/bifrost-http/lib/validator.go
  • transports/bifrost-http/lib/validator_test.go
  • transports/config.schema.json

Comment on lines +32 to +46
func loadSchemaFromLocation(location string) ([]byte, error) {
if strings.HasPrefix(location, "http://") || strings.HasPrefix(location, "https://") {
client := http.Client{Timeout: schemaFetchTimeout}
resp, err := client.Get(location)
if err != nil {
return nil, err
}
defer resp.Body.Close()
if resp.StatusCode < http.StatusOK || resp.StatusCode >= http.StatusMultipleChoices {
return nil, fmt.Errorf("unexpected HTTP status %d fetching schema", resp.StatusCode)
}
return io.ReadAll(resp.Body)
}
return os.ReadFile(filePathFromSchemaLocation(location))
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Cap the HTTP schema response size.

loadSchemaFromLocation sets a fetch timeout but never bounds the response body size before io.ReadAll(resp.Body). A misconfigured or malicious schema location (env var, or $schema sourced from config data) can return an arbitrarily large body, exhausting memory.

🛡️ Proposed fix to cap the response size
-		defer resp.Body.Close()
-		if resp.StatusCode < http.StatusOK || resp.StatusCode >= http.StatusMultipleChoices {
-			return nil, fmt.Errorf("unexpected HTTP status %d fetching schema", resp.StatusCode)
-		}
-		return io.ReadAll(resp.Body)
+		defer resp.Body.Close()
+		if resp.StatusCode < http.StatusOK || resp.StatusCode >= http.StatusMultipleChoices {
+			return nil, fmt.Errorf("unexpected HTTP status %d fetching schema", resp.StatusCode)
+		}
+		const maxSchemaBytes = 1 << 20 // 1MB
+		return io.ReadAll(io.LimitReader(resp.Body, maxSchemaBytes+1))

As per path instructions, "enforce timeouts and size limits" for untrusted input handling in Go files.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
func loadSchemaFromLocation(location string) ([]byte, error) {
if strings.HasPrefix(location, "http://") || strings.HasPrefix(location, "https://") {
client := http.Client{Timeout: schemaFetchTimeout}
resp, err := client.Get(location)
if err != nil {
return nil, err
}
defer resp.Body.Close()
if resp.StatusCode < http.StatusOK || resp.StatusCode >= http.StatusMultipleChoices {
return nil, fmt.Errorf("unexpected HTTP status %d fetching schema", resp.StatusCode)
}
return io.ReadAll(resp.Body)
}
return os.ReadFile(filePathFromSchemaLocation(location))
}
func loadSchemaFromLocation(location string) ([]byte, error) {
if strings.HasPrefix(location, "http://") || strings.HasPrefix(location, "https://") {
client := http.Client{Timeout: schemaFetchTimeout}
resp, err := client.Get(location)
if err != nil {
return nil, err
}
defer resp.Body.Close()
if resp.StatusCode < http.StatusOK || resp.StatusCode >= http.StatusMultipleChoices {
return nil, fmt.Errorf("unexpected HTTP status %d fetching schema", resp.StatusCode)
}
const maxSchemaBytes = 1 << 20 // 1MB
return io.ReadAll(io.LimitReader(resp.Body, maxSchemaBytes+1))
}
return os.ReadFile(filePathFromSchemaLocation(location))
}
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@transports/bifrost-http/lib/validator.go` around lines 32 - 46, Cap the HTTP
schema response body in loadSchemaFromLocation before reading it. Keep the
existing timeout and status checks, but wrap resp.Body with a size limit and
return an error if the schema exceeds that bound instead of calling io.ReadAll
directly. Apply this only in the http/https branch of loadSchemaFromLocation,
preserving the local file path behavior via filePathFromSchemaLocation.

Source: Path instructions

@Pratham-Mishra04
Pratham-Mishra04 changed the base branch from graphite-base/4614 to dev July 9, 2026 12:36
@Pratham-Mishra04
Pratham-Mishra04 force-pushed the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch from 4f5dd0d to 79ac94a Compare July 9, 2026 12:36
@Pratham-Mishra04
Pratham-Mishra04 merged commit d62abd1 into dev Jul 9, 2026
12 of 13 checks passed
@Pratham-Mishra04
Pratham-Mishra04 deleted the 06-22-feat_allow_custom_schema_url_overrides_for_config.json branch July 9, 2026 12:38
akshaydeo pushed a commit that referenced this pull request Jul 14, 2026
…ma locations in isolated deployments (#4614)

## Summary

Bifrost deployments in air-gapped or isolated environments cannot reach `https://www.getbifrost.ai/schema` to fetch the JSON schema for `config.json` validation. This PR introduces a `schema_url` / `schemaUrl` override across the Go transport, Helm chart, and Terraform module so that operators can point schema resolution at a mirrored HTTP(S) URL, a `file://` URL, or a local filesystem path instead of the hardcoded public URL.

## Changes

- **Go transport (`validator.go`, `config.go`):** Replaced the hardcoded `https://www.getbifrost.ai/schema` fetch with a `loadSchemaFromLocation` helper that handles HTTP(S), `file://`, and filesystem paths. Schema resolution now follows this priority: `BIFROST_SCHEMA_URL` env → `SCHEMA_URL` env (legacy) → `$schema` value in `config.json` (if not the default URL) → local source-checkout candidate → default public URL. The startup warning for a missing `$schema` field now checks for an empty/absent value rather than an exact URL match.
- **`config.schema.json`:** Removed the `const` constraint on `$schema` (which would have rejected any non-default value) and replaced it with a `default`, allowing mirrored locations to pass schema validation.
- **Helm chart:** Added `bifrost.schemaUrl` to `values.yaml` and `values.schema.json`. The value is written into the generated `config.json` `$schema` field via `_helpers.tpl` and exported as `BIFROST_SCHEMA_URL` in both `deployment.yaml` and `stateful.yaml`.
- **Terraform module:** Added a `schema_url` variable (defaulting to the public URL) that is injected into the `$schema` field of the generated `config.json`. A new `schema_url_override` test case validates that a custom value is correctly written through.
- **Docs:** Updated the schema reference page and Helm/Terraform READMEs to document the new override options.

## Type of change

- [ ] Bug fix
- [x] Feature
- [ ] Refactor
- [ ] Documentation
- [ ] Chore/CI

## Affected areas

- [x] Core (Go)
- [x] Transports (HTTP)
- [ ] Providers/Integrations
- [ ] Plugins
- [ ] UI (React)
- [x] Docs

## How to test

```sh
# Unit tests for the validator and schema loading logic
cd transports/bifrost-http
go test ./lib/... -run TestValidateConfigSchema

# Test filesystem path override via env
BIFROST_SCHEMA_URL=/path/to/config.schema.json go test ./lib/... -run TestValidateConfigSchema_CustomSchemaFilePath

# Test legacy env var
SCHEMA_URL=/path/to/config.schema.json go test ./lib/... -run TestValidateConfigSchema_LegacySchemaURLEnv

# Helm: render and inspect the generated config.json $schema field
helm template bifrost ./helm-charts/bifrost \
  --set bifrost.schemaUrl="https://schema.internal/bifrost" \
  | grep '\$schema'

# Terraform: run the config merging tests
cd terraform/modules/bifrost
terraform test -filter=config_merging.tftest.hcl
```

**New environment variables / Helm values / Terraform variables:**

| Surface | Name | Default |
|---|---|---|
| Go / Docker env | `BIFROST_SCHEMA_URL` | `https://www.getbifrost.ai/schema` |
| Go / Docker env (legacy) | `SCHEMA_URL` | — |
| Helm | `bifrost.schemaUrl` | `https://www.getbifrost.ai/schema` |
| Terraform | `schema_url` | `https://www.getbifrost.ai/schema` |

All accept an HTTP(S) URL, `file://` URL, or filesystem path.

## Breaking changes

- [x] No

The `const` constraint on `$schema` in `config.schema.json` has been relaxed to a `default`. Existing configs using the public URL continue to validate correctly. Configs that previously set a non-default `$schema` value would have failed schema validation before this change, so removing the constraint is strictly additive.

## Security considerations

Schema content loaded from a `file://` or filesystem path is read from the local filesystem using the process's existing permissions — no new network surface is introduced for isolated deployments. Operators using HTTP(S) mirrors should ensure the mirror endpoint is trusted, as the fetched schema is used to validate the entire `config.json`.

## Checklist

- [ ] I read `docs/contributing/README.md` and followed the guidelines
- [x] I added/updated tests where appropriate
- [x] I updated documentation where needed
- [ ] I verified builds succeed (Go and UI)
- [ ] I verified the CI pipeline passes locally if applicable
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants