Skip to content

Bump cli-compat: CLI 1.23.0+ to skills 0.2.47 - #7576

Open
dimk0 wants to merge 1 commit into
mainfrom
bump-cli-compat-skills-0.2.47
Open

dimk0 wants to merge 1 commit into
mainfrom
bump-cli-compat-skills-0.2.47

Conversation

@dimk0

@dimk0 dimk0 commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

Changes

Add a 1.23.0 range to cli-compat.json pinned to skills 0.2.47. CLI 1.22.x stays on 0.2.32.

Why

CLI 1.23.0 and newer still resolve to the 1.22.0 range, which is pinned to skills 0.2.32 (2026-10-19). databricks aitools install therefore ships skills that are 15 releases old, and databricks aitools update --check reports "Already up to date".

For example, CLI 1.25.0 and 1.26.0 install databricks-ai-runtime v0.2.1, which tells agents to run databricks air logs --lines (fails with unknown flag: --lines) and lists only GPU_1xA10 and GPU_8xH100 as accelerator types. Both are fixed in v0.3.0, which ships in skills 0.2.46 and later.

The newest range stays on a fixed pin, as the manifest test requires after #7159.

This is a new range rather than an in-place bump of 1.22.0 because some newer skills describe CLI 1.23.0 behavior (databricks air pools list output, onedrive_options in Lakeflow Connect). No skill in 0.2.47 sets min_cli_version, and every databricks air subcommand the AIR skill uses exists in 1.22.0, so an in-place bump would also work if you prefer to cover 1.22.x.

Known gap: databricks-serverless-migration-api (new in 0.2.47) needs the databricks compute-migrations command group, which first shipped in CLI 1.24.0. CLI 1.23.x therefore installs a skill it can't run. The skill states the 1.24.0 requirement, checks for the command, and tells the agent to upgrade, so this is not blocking. An in-place bump of 1.22.0 would have the same gap on 1.22.x. The skill does not set min_cli_version.

Tests

  • go test ./libs/clicompat/... ./libs/aitools/... ./cmd/aitools/... ./internal/build/...
  • go test ./acceptance -run 'TestAccept/cmd/aitools'
  • Built the CLI and ran DATABRICKS_FORCE_EMBEDDED_COMPAT=true databricks aitools install --skills databricks-ai-runtime --path <dir>: prints "Using skills version 0.2.47" and writes SKILL.md with metadata.version 0.3.0.
  • Tag v0.2.47 exists in databricks/databricks-agent-skills. Skills evals for 0.2.47 were confirmed as passed by the author.

This pull request and its description were written by Isaac.

@dimk0
dimk0 marked this pull request as ready for review November 12, 2026 21:38
@dimk0
dimk0 requested review from a team as code owners November 12, 2026 21:38
@eng-dev-ecosystem-bot

eng-dev-ecosystem-bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Collaborator

✅ Integration test report

Commit: 77aa3cb

Run: 43319287738

Env 🔄​flaky 💚​RECOVERED ✅​pass 🙈​skip Time
🔄​ aws linux-2core-8gb 1 1 269 15 17:38
🔄​ aws-windows-latest-4core-16gb 1 1 271 13 10:14
💚​ azure linux-2core-8gb 1 269 15 14:47
💚​ azure-windows-latest-4core-16gb 1 271 13 10:13
💚​ gcp linux-2core-8gb 1 270 15 15:17
💚​ gcp-windows-latest-4core-16gb 1 272 13 9:27
Test Name aws linux-2core-8gb aws-windows-latest-4core-16gb azure linux-2core-8gb azure-windows-latest-4core-16gb gcp linux-2core-8gb gcp-windows-latest-4core-16gb
💚​ TestAccept 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R
🔄​ TestSyncIncrementalFileSync 🔄​f ✅​p ✅​p ✅​p ✅​p ✅​p
🔄​ TestSyncIncrementalSyncFileToPythonNotebook ✅​p 🔄​f ✅​p ✅​p ✅​p ✅​p
Top 33 slowest tests (at least 2 minutes):
duration env testname
6:40 aws linux-2core-8gb TestFilerRecursiveDelete/workspace_files_extensions
5:54 azure-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsDelete
4:59 gcp linux-2core-8gb TestFilerRecursiveDelete/workspace_files
4:34 azure linux-2core-8gb TestImportDirWithOverwriteFlag
4:03 aws linux-2core-8gb TestAccept
3:59 azure linux-2core-8gb TestAccept
3:55 gcp-windows-latest-4core-16gb TestAccept
3:53 azure-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsReadDir
3:45 gcp linux-2core-8gb TestAccept
3:34 aws-windows-latest-4core-16gb TestAccept
3:31 azure-windows-latest-4core-16gb TestAccept
3:27 azure-windows-latest-4core-16gb TestFilerRecursiveDelete/workspace_files
3:23 gcp-windows-latest-4core-16gb TestImportDirWithOverwriteFlag
3:20 aws linux-2core-8gb TestExportDir
3:08 aws linux-2core-8gb TestImportDirDoesNotOverwrite
2:58 gcp-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsReadDir
2:56 azure-windows-latest-4core-16gb TestSyncIncrementalFileSync
2:55 azure linux-2core-8gb TestFilerWorkspaceFilesExtensionsStat
2:49 aws linux-2core-8gb TestImportDirWithOverwriteFlag
2:35 azure linux-2core-8gb TestImportDirDoesNotOverwrite
2:34 aws-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsReadDir
2:31 azure linux-2core-8gb TestFilerWorkspaceFilesExtensionsReadDir
2:18 aws-windows-latest-4core-16gb TestFilerWorkspaceNotebook/pythonJupyterNb.ipynb
2:14 azure-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsStat
2:11 gcp linux-2core-8gb TestFilerWorkspaceFilesExtensionsDelete
2:11 aws-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsDelete
2:11 azure linux-2core-8gb TestFilerWorkspaceFilesExtensionsDelete
2:10 gcp-windows-latest-4core-16gb TestFilerRecursiveDelete/workspace_files
2:07 azure-windows-latest-4core-16gb TestImportDirDoesNotOverwrite
2:07 gcp linux-2core-8gb TestSyncFullFileSync
2:04 gcp-windows-latest-4core-16gb TestImportDir
2:03 aws linux-2core-8gb TestFilerRecursiveDelete/workspace_files
2:01 gcp-windows-latest-4core-16gb TestFilerReadWrite/workspace_files

CLI 1.23.0 and newer still resolve to the 1.22.0 range, pinned to skills
0.2.32 from 2026-10-19, so `aitools install` ships skills that are 15
releases old and `aitools update` reports them as up to date.

Add a 1.23.0 range pinned to 0.2.47. CLI 1.22.x stays on 0.2.32, since
some newer skills describe CLI 1.23.0 behavior.

Co-authored-by: Isaac <no-reply@databricks.com>
Signed-off-by: dimk0 <4886215+dimk0@users.noreply.github.com>
@dimk0
dimk0 force-pushed the bump-cli-compat-skills-0.2.47 branch from 728596e to 77aa3cb Compare November 12, 2026 22:21

@pardis-beikzadeh-db pardis-beikzadeh-db 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.

LGTM. One gap in the description:

  • databricks-serverless-migration-api (new in this range) needs databricks compute-migrations, which first shipped in CLI 1.24.0, so CLI 1.23.x installs a skill it can't run.
  • Not blocking: the skill checks for the command and tells the agent to upgrade.
  • The in-place 1.22.0 bump in the description would hit the same gap on 1.22.x.
  • Ideally the skills repo adds min_cli_version: 1.24.0 for it, but the skills generator doesn't emit that field yet.

@dimk0

dimk0 commented Nov 12, 2026

Copy link
Copy Markdown
Member Author

Thanks for the review. Confirmed: cmd/workspace/compute-migrations is absent at v1.23.0 and present at v1.24.0, and the skill's own prerequisites require CLI 1.24.0 and tell the agent to upgrade if the command is missing. I added this as a known gap in the PR description and kept the range at 1.23.0, since moving it to 1.24.0 would leave 1.23.x on the stale 0.2.32 skills.

This branch has not been deployed

No deployments
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.

3 participants