Skip to content

Add bump-sdk skill - #5991

Merged
janniklasrose merged 4 commits into
mainfrom
bump-sdk-skill
Aug 11, 2026
Merged

Add bump-sdk skill#5991
janniklasrose merged 4 commits into
mainfrom
bump-sdk-skill

Conversation

@pietern

Copy link
Copy Markdown
Contributor

Changes

Add a user-invocable bump-sdk skill that codifies the databricks-sdk-go bump workflow: resolve the SDK version (optionally from a Terraform provider's go.mod) and its paired .codegen/_openapi_sha, apply the bump, regenerate cli.json via genkit and all downstream artifacts, handle SDK breaking-change and acceptance-test fallout, verify, and add a changelog fragment.

Why

The bump has non-obvious steps that are easy to get wrong. The SDK version and the OpenAPI spec SHA must move as a pair, and the -update acceptance run can silently mask a real failure when a schema change makes the Terraform and direct engines diverge, so the skill requires a non-update verify pass to catch it. Capturing the workflow makes future bumps repeatable and keeps it consistent with the sibling bump-tf skill.

Tests

Validated by running the skill hands-off in a fresh worktree on origin/main (Terraform provider already at v1.122.0, SDK not yet bumped) to bump to v0.160.0. Its result matched the manually authored #5982 on every substantive point (resolved versions and the source-code edits), differing only where the skill correctly defers a destructive test deletion to the user.

This pull request and its description were written by Isaac.

Add a user-invocable bump-sdk skill that codifies the databricks-sdk-go bump
workflow: resolve the SDK version (optionally from a Terraform provider's
go.mod) and its paired .codegen/_openapi_sha, apply the bump, regenerate
cli.json via genkit and all downstream artifacts, handle SDK breaking-change
and acceptance-test fallout, verify, and add a changelog fragment.
Consistent with the sibling bump-tf skill.
Co-authored-by: Isaac
@eng-dev-ecosystem-bot

eng-dev-ecosystem-bot commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Integration test report

Commit: 416c7fc

Run: 31501769748

Env🔄​flaky💚​RECOVERED🙈​SKIP✅​pass🙈​skipTime
💚​aws linux44290113111:24
💚​aws windows4429211298:36
💚​azure linux44289113110:59
🔄​azure windows144290112911:24
🔄​gcp linux115289113110:41
🔄​gcp windows215290112910:03
11 interesting tests: 4 RECOVERED, 4 SKIP, 3 flaky
Test Nameaws linuxaws windowsazure linuxazure windowsgcp linuxgcp windows
💚​TestAccept💚​R💚​R💚​R💚​R💚​R💚​R
🙈​TestAccept/bundle/invariant/no_drift🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🙈​TestAccept/ssh/connection🙈​S🙈​S🙈​S🙈​S🙈​S🙈​S
🔄​TestSyncFullFileSync✅​p✅​p✅​p✅​p🔄​f🔄​f
🔄​TestSyncIncrementalFileOverwritesFolder✅​p✅​p✅​p🔄​f✅​p✅​p
🔄​TestSyncIncrementalSyncPythonNotebookDelete✅​p✅​p✅​p✅​p✅​p🔄​f
💚​TestFetchRepositoryInfoAPI_FromRepo💚​R💚​R💚​R💚​R🙈​S🙈​S
💚​TestFetchRepositoryInfoAPI_FromRepo/root💚​R💚​R💚​R💚​R
💚​TestFetchRepositoryInfoAPI_FromRepo/subdir💚​R💚​R💚​R💚​R
Top 18 slowest tests (at least 2 minutes):
durationenvtestname
7:04aws windowsTestAccept
6:34azure windowsTestAccept
6:13gcp windowsTestAccept
3:44azure windowsTestImportDirDoesNotOverwrite
3:29aws windowsTestFilerRecursiveDelete/workspace_files_extensions
3:07azure linuxTestAccept
3:06azure windowsTestFilerWorkspaceFilesExtensionsRead
3:03gcp linuxTestAccept
3:03aws linuxTestAccept
2:38azure windowsTestFilerRecursiveDelete/workspace_files
2:33aws linuxTestFilerWorkspaceNotebook/rNb.r
2:28gcp windowsTestImportDirDoesNotOverwrite
2:26gcp windowsTestFilerReadWrite/workspace_files_extensions
2:09aws windowsTestImportDirWithOverwriteFlag
2:07gcp windowsTestLock
2:02aws windowsTestFilerWorkspaceFilesExtensionsDelete
2:01azure windowsTestImportDirWithOverwriteFlag
2:00gcp windowsTestFilerWorkspaceFilesExtensionsRead

Comment thread.agent/skills/bump-sdk/SKILL.md Outdated
Comment thread.agent/skills/bump-sdk/SKILL.md Outdated
Comment thread.agent/skills/bump-sdk/SKILL.md Outdated
Comment thread.agent/skills/bump-sdk/SKILL.md
Comment thread.agent/skills/bump-sdk/SKILL.md Outdated
Comment thread.agent/skills/bump-sdk/SKILL.md Outdated
Two fixes from a rubric evaluation against the authoring skill:
- Use `./task generate-schema-map` for the DABs<->TF field map instead of a
raw `go test ... -update`, and drop the incorrect "the tasks don't cover it"
claim (the task wraps exactly that test), matching the bump-tf skill.
- Genericize the push-auth line: a shared skill should not hardcode an
individual maintainer's gh handle.
Co-authored-by: Isaac

@janniklasrosejanniklasrose 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.

tested this skill on #6098

The agent kept getting hung up on python 3.9 issues and uv not being installed, so some local tests were failing. We should improve the test harness or give it instructions to the agents here how to unblock itself

Comment thread.agent/skills/bump-sdk/SKILL.md Outdated
- Resolve the latest SDK version when the user gives none, instead of prompting.
- Write the spec SHA with `echo`, since `generate` reformats the file.
- Run `./task lint` for the exhaustruct fallout, and `./task test-unit-root` for the unit suite.
- Point at pr-checklist for the PR template, keeping only the bump-specific line.
- Loosen the too-specific stacking example.
Co-authored-by: Isaac
Add guidance so the agent installs `uv` (which provisions the pinned
interpreter) instead of fighting an old system python3 when a pydabs task
fails, per review feedback from testing on #6098.
Co-authored-by: Isaac
@janniklasrose
janniklasrose added this pull request to the merge queueAug 11, 2026
Merged via the queue into main with commit 92decddAug 11, 2026
25 checks passed
@janniklasrose
janniklasrose deleted the bump-sdk-skill branch August 11, 2026 16:06
Sign up for freeto 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

@pietern@eng-dev-ecosystem-bot@janniklasrose