From 6bd11f0903d2de8004c4752bea39685869a28ccb Mon Sep 17 00:00:00 2001 From: Petr Date: Tue, 25 Aug 2026 18:22:26 +0200 Subject: [PATCH 1/2] chore(release): cover #625 in the 0.91.0 changelog PR #625 (/kbagent:setup) merged to main after the release PR branched but before it merged, so the 0.91.0 entry did not cover it. Tagging as-is would have shipped it undocumented. No version change -- 0.91.0 is not yet tagged. --- src/keboola_agent_cli/changelog.py | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/keboola_agent_cli/changelog.py b/src/keboola_agent_cli/changelog.py index b585aca3..2adde9b0 100644 --- a/src/keboola_agent_cli/changelog.py +++ b/src/keboola_agent_cli/changelog.py @@ -89,6 +89,15 @@ "which beats `KBAGENT_CONFIG_DIR` / the `.kbagent` walk-up / global. Only an " "explicit root flag propagates; an env-var or walk-up resolution is left to the " "server, which reaches the identical directory on its own.", + "New (#625): the plugin gained `/kbagent:setup`, one command that runs first-time " + "setup end to end. The documented flow is now `/plugin marketplace add keboola/ai-kit` " + "then `/plugin install kbagent@keboola-claude-kit` then `/kbagent:setup`, replacing " + "five manual steps spread across a browser, a terminal and Claude Code. It installs " + "the CLI when missing (respecting a standalone `install_channel` rather than layering " + "a second kbagent over it), connects a project, and verifies with `kbagent doctor`. " + "Every step is conditional on a check, so it is idempotent and safe to re-run on a " + "half-finished setup, and it never overwrites an existing project or alias. No new " + "CLI surface -- it orchestrates existing verbs.", "Change (#627): the kbagent Claude Code plugin is now published through the " "`keboola-claude-kit` marketplace in `keboola/ai-kit`. Keboola had two competing " "marketplaces and no way for a user to tell which was real; this leaves one. Install " From a68e915a63397b31c18a1295846c0bdfc571a052 Mon Sep 17 00:00:00 2001 From: Petr Date: Tue, 25 Aug 2026 18:27:54 +0200 Subject: [PATCH 2/2] docs(plugin): move resolved 0.91.0 version tags out of markdown headings CONTRIBUTING.md release step 4 keeps version tags off headings: resolving the placeholder changes the generated anchor slug and breaks inbound links. PR #697 did this pass, but #694 and #696 landed their headings around the same time and fell outside its grep. - gotchas.md: two headings, tag moved to the section's first body line - sync-workflow.md: heading reworded to 'Migrating a legacy sync tree', with the version stated on a body line No inbound links reference the affected anchors (verified by grep). --- plugins/kbagent/skills/kbagent/references/gotchas.md | 8 ++++++-- .../kbagent/skills/kbagent/references/sync-workflow.md | 4 +++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/plugins/kbagent/skills/kbagent/references/gotchas.md b/plugins/kbagent/skills/kbagent/references/gotchas.md index 4c5177dc..96820b5c 100644 --- a/plugins/kbagent/skills/kbagent/references/gotchas.md +++ b/plugins/kbagent/skills/kbagent/references/gotchas.md @@ -458,7 +458,9 @@ Versioning convention: `--allow-plaintext-on-encrypt-failure`, which would write the PAT in plaintext into Storage. -## `sync push` no longer leaves phantom `REMOTE MODIFIED` drift; `transform.sql` carries statement boundaries (since 0.91.0, #686) +## `sync push` no longer leaves phantom `REMOTE MODIFIED` drift; `transform.sql` carries statement boundaries + +*(since 0.91.0, #686)* `pull_config_hash` in `.keboola/manifest.json` is the 3-way diff's base, and it means "the hash of this config **as the API returns it**". `sync pull` and the @@ -527,7 +529,9 @@ it, and the next deploy re-created it (field report: 18 phantom configs hiding statements into one. Run `sync pull` for that project, then push again. Genuine SQL edits are never blocked by this guard. -## `sync push` runs the same script-shape guard as `config update` (since 0.91.0) +## `sync push` runs the same script-shape guard as `config update` + +*(since 0.91.0)* `sync push` now runs `normalize_blocks_codes_script` -- the runtime-safety guard `config update` and `transformation edit/create` have always run -- on every diff --git a/plugins/kbagent/skills/kbagent/references/sync-workflow.md b/plugins/kbagent/skills/kbagent/references/sync-workflow.md index b7903010..e8836426 100644 --- a/plugins/kbagent/skills/kbagent/references/sync-workflow.md +++ b/plugins/kbagent/skills/kbagent/references/sync-workflow.md @@ -489,7 +489,9 @@ the 3-way diff state per config (and per row): > stops you loudly instead of losing work. To intentionally drop a local edit, > delete the file (or the config directory) and pull. -## Migrating a tree pulled before 0.91.0 (#686) +## Migrating a legacy sync tree (#686) + +*Applies to any tree last pulled before 0.91.0.* `sync push` used to stamp the manifest baseline from the files on disk while `sync pull` / `sync diff` computed it from the API. Any config the two