Skip to content

docs: point CLI compatibility manifest to CLI repo #333

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pkosiec wants to merge 9 commits into
base: main
Choose a base branch
from
+8 −0
Open

docs: point CLI compatibility manifest to CLI repo #333

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
e092353
feat: add CLI compatibility manifest for template version pinning
pkosiec Apr 29, 2026
e03d892
fix: add next>=max validation and document check-cli-compat tool
pkosiec Apr 29, 2026
cccb778
fix: tighten cli-compat.json validation
pkosiec Apr 30, 2026
0443a62
docs: document CLI compat manifest and simplify initial entries
pkosiec Apr 30, 2026
f45d86f
fix: tighten cli-compat validator and add unit tests
pkosiec Apr 30, 2026
5afbe63
docs: align CLI compat update docs with design doc and add bump skill
pkosiec Apr 30, 2026
9b43085
docs: document CLI resolution fallback for older versions
pkosiec Apr 30, 2026
f42b850
refactor: move cli-compat manifest to CLI repo
pkosiec May 5, 2026
dc4ef4f
docs: document CLI version resolution in CONTRIBUTING.md
pkosiec May 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,14 @@ pnpm docs:serve # Serve built docs

See [docs/README.md](./docs/README.md) for more details.

## Version resolution in Databricks CLI

The Databricks CLI uses [`cli-compat.json`](https://github.com/databricks/cli/blob/main/internal/build/cli-compat.json)
to determine which AppKit template version to use for `apps init`. The manifest maps
CLI versions to compatible AppKit versions. It lives in the
[CLI repository](https://github.com/databricks/cli) — see the
[README](https://github.com/databricks/cli/blob/main/internal/build/README.md) for details.

## Adding or changing a resource type

Resource types and their permissions are defined once in the plugin-manifest schema; the CLI (create, add-resource, validate) and the appkit registry types are derived from it.
Expand Down
Loading