From 8ebb53dccdafc629dd201a4c06843f1c42b670b3 Mon Sep 17 00:00:00 2001 From: Hal Eisen Date: Wed, 18 Nov 2026 23:51:43 -0800 Subject: [PATCH 1/2] CLAUDE.md: increment a plugin's version, per SemVer, whenever it changes Neither ADFA-7213 (Get AI Models catalog) nor ADFA-7214 (AI Agent Local fix) bumped the version, so both published as the same 1.1.0 they replaced. --- CLAUDE.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 3ed0ca666..25a3a7402 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -55,6 +55,10 @@ Each kind has its own script. Each script builds only its own kind and ignores a `update-libs.sh` is plugin-only and builds nothing by itself. Both scripts take their lists from `addons discover --kind plugin|template`, which is the single definition of each kind and matches a NAME by directory name or slug, in any case. Every workflow (**Build addon artifacts**, **Publish addons**, **Update libs from CodeOnTheGo**, **Check toolchain**) calls these scripts, so a local build and a CI build run the same code. +## Versioning + +**Any change to a plugin increments its version**, following [Semantic Versioning](https://semver.org/): MAJOR for an incompatible change (removed features or settings, a raised `plugin.min_ide_version`), MINOR for a backwards-compatible feature, PATCH for a backwards-compatible fix. The version is `versionName` in the plugin's `build.gradle.kts`, which the builder substitutes for `${pluginVersion}` in the manifest; increment `versionCode` by one in the same change. Bump once per pull request, not once per commit. + ## Verification **A successful build is not verification.** It only proves the addon compiles or packages. Real verification is device-level: install on a connected emulator or device, exercise the feature end to end, and observe the expected behaviour (UI element appears, file written, build hook fires, DB row replaced, template generates a project that opens). From 5d8707cefb73b5825c8f0778ba880148b30448b2 Mon Sep 17 00:00:00 2001 From: Hal Eisen Date: Thu, 19 Nov 2026 00:00:19 -0800 Subject: [PATCH 2/2] CLAUDE.md: exempt community-contributed addons from the version-bump rule An addon with "origin": "community" keeps the version its contributor gives it, as it keeps its naming (PRD R38). --- CLAUDE.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 25a3a7402..829ae1ba6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -59,6 +59,8 @@ Each kind has its own script. Each script builds only its own kind and ignores a **Any change to a plugin increments its version**, following [Semantic Versioning](https://semver.org/): MAJOR for an incompatible change (removed features or settings, a raised `plugin.min_ide_version`), MINOR for a backwards-compatible feature, PATCH for a backwards-compatible fix. The version is `versionName` in the plugin's `build.gradle.kts`, which the builder substitutes for `${pluginVersion}` in the manifest; increment `versionCode` by one in the same change. Bump once per pull request, not once per commit. +**Exception: community-contributed addons** — `"origin": "community"` in `addon.json` — keep the version their contributor gives them. Do not bump it for them; their versioning is theirs, as their naming is (R38 in `docs/superpowers/specs/2026-08-27-addon-distribution-prd.md`). + ## Verification **A successful build is not verification.** It only proves the addon compiles or packages. Real verification is device-level: install on a connected emulator or device, exercise the feature end to end, and observe the expected behaviour (UI element appears, file written, build hook fires, DB row replaced, template generates a project that opens).