build(release): stamp the osw version into the plugin manifest too

- register .claude-plugin/plugin.json:version with python-semantic-release
- set the plugin and skill versions to the current 2.7.0 after the rebase
- parametrize the three version guard tests over skill and plugin

Author: LukasGold

.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "osl-tasks",
   "displayName": "OSL task management",
   "description": "Task and project management for OpenSemanticLab, driven by the osw CLI and MCP server.",
-  "version": "0.1.0",
+  "version": "2.7.0",
   "author": {
     "name": "OpenSemanticLab"
   },

pyproject.toml

@@ -303,10 +303,11 @@ preview = true
 
 [tool.semantic_release]
 # python-semantic-release owns the version: it reads the conventional commits
-# on main, bumps the static version below, in CITATION.cff and in the
-# osl-tasks skill's frontmatter, updates the changelog, relocks uv.lock,
-# commits, tags (vX.Y.Z) and creates the GitHub release. Publishing to PyPI
-# happens in the same workflow run (on-release-main.yml).
+# on main, bumps the static version below, in CITATION.cff, in the osl-tasks
+# skill's frontmatter and in the Claude Code plugin manifest, updates the
+# changelog, relocks uv.lock, commits, tags (vX.Y.Z) and creates the GitHub
+# release. Publishing to PyPI happens in the same workflow run
+# (on-release-main.yml).
 commit_parser = "conventional"
 tag_format = "v{version}"
 commit_message = "chore(release): v{version} [skip ci]"
@@ -318,6 +319,10 @@ version_toml = ["pyproject.toml:project.version"]
 version_variables = [
     "CITATION.cff:version",
     "src/osw/skills/osl-tasks/SKILL.md:version",
+    # Claude Code caches an installed plugin under its version string, so a
+    # version that never changes keeps plugin users on the skill they first
+    # installed.
+    ".claude-plugin/plugin.json:version",
 ]
 # relock so uv.lock's own pin of osw's version stays consistent, and include
 # the relocked file in the release commit

src/osw/skills/osl-tasks/SKILL.md

@@ -2,7 +2,7 @@
 name: osl-tasks
 description: Use when importing local todo or note files into an OpenSemanticLab (OSL) wiki as Task entities, or when listing, filtering and updating tasks that already live in OSL. Drives the generic entity, schema and search operations of the `osw` CLI and MCP server; there are no task-specific commands. Covers the Task, Person and Project category page names, how to read the status and priority vocabularies from the schema, the update-by-uuid rule, the duplicate rule and the link marker written back into the local file.
 metadata:
-  version: "2.6.0"
+  version: "2.7.0"
 ---
 
 # OSL task management

tests/test_cli_ops_skill.py

@@ -6,6 +6,7 @@
 
 from __future__ import annotations
 
+import json
 import sys
 from pathlib import Path
 from unittest.mock import MagicMock
@@ -26,14 +27,21 @@
 SKILL_MD_PATH = (
     Path(ops.__file__).resolve().parent.parent / "skills" / "osl-tasks" / "SKILL.md"
 )
-PYPROJECT_PATH = Path(__file__).resolve().parent.parent / "pyproject.toml"
+REPO_ROOT = Path(__file__).resolve().parent.parent
+PYPROJECT_PATH = REPO_ROOT / "pyproject.toml"
+PLUGIN_JSON_PATH = REPO_ROOT / ".claude-plugin" / "plugin.json"
 SKILL_VERSION_ENTRY = "src/osw/skills/osl-tasks/SKILL.md:version"
+PLUGIN_VERSION_ENTRY = ".claude-plugin/plugin.json:version"
 
 
-def _skill_frontmatter() -> dict:
+def _skill_version() -> str:
     # The frontmatter is the YAML between the two leading '---' lines.
     _, frontmatter, _ = SKILL_MD_PATH.read_text(encoding="utf-8").split("---", 2)
-    return yaml.safe_load(frontmatter)
+    return yaml.safe_load(frontmatter)["metadata"]["version"]
+
+
+def _plugin_version() -> str:
+    return json.loads(PLUGIN_JSON_PATH.read_text(encoding="utf-8"))["version"]
 
 
 def _pyproject() -> dict:
@@ -95,32 +103,44 @@ def test_install_skill_is_registered_on_the_cli_surface_only():
     assert registry.REGISTRY["install_skill"].surfaces == frozenset({"cli"})
 
 
-def test_skill_version_matches_the_package_version():
-    """The skill carries the osw version it ships with.
+@pytest.mark.parametrize(
+    "read_version", [_skill_version, _plugin_version], ids=["skill", "plugin"]
+)
+def test_stamped_version_matches_the_package_version(read_version):
+    """The skill and the plugin manifest carry the osw version they ship with.
 
-    python-semantic-release rewrites both in the release commit, so they can
-    only differ when one of them was edited by hand.
+    python-semantic-release rewrites all three in the release commit, so they
+    can only differ when one of them was edited by hand.
     """
-    skill_version = _skill_frontmatter()["metadata"]["version"]
+    assert read_version() == _pyproject()["project"]["version"]
 
-    assert skill_version == _pyproject()["project"]["version"]
 
-
-def test_skill_is_registered_for_the_release_version_bump():
-    """Without this entry a release bumps pyproject.toml but not the skill.
+def test_stamped_files_are_registered_for_the_release_version_bump():
+    """Without these entries a release bumps pyproject.toml but neither file.
 
     The version check above would only fail after that release, so this
     catches a removed entry at once.
     """
     variables = _pyproject()["tool"]["semantic_release"]["version_variables"]
 
     assert SKILL_VERSION_ENTRY in variables
+    assert PLUGIN_VERSION_ENTRY in variables
 
 
-def test_release_bump_rewrites_only_the_frontmatter_version(monkeypatch):
+@pytest.mark.parametrize(
+    ("entry", "path", "changed_line"),
+    [
+        (SKILL_VERSION_ENTRY, SKILL_MD_PATH, '  version: "99.99.99"'),
+        (PLUGIN_VERSION_ENTRY, PLUGIN_JSON_PATH, '  "version": "99.99.99",'),
+    ],
+    ids=["skill", "plugin"],
+)
+def test_release_bump_rewrites_only_the_version_line(
+    entry, path, changed_line, monkeypatch
+):
     """python-semantic-release rewrites every match of its pattern in the file.
 
-    A body line such as 'version: 1.2.3' or 'osw version 1.2.3' would be
+    A second line such as 'version: 1.2.3' or 'osw version 1.2.3' would be
     rewritten on every release without any test failing, so run the release
     tool's own replacement and check that it changes exactly one line.
     """
@@ -131,13 +151,11 @@ def test_release_bump_rewrites_only_the_frontmatter_version(monkeypatch):
 
     # The entry's path is relative to the repository root, where the release
     # tool runs.
-    monkeypatch.chdir(PYPROJECT_PATH.parent)
-    declaration = PatternVersionDeclaration.from_string_definition(
-        SKILL_VERSION_ENTRY, "v{version}"
-    )
-    before = SKILL_MD_PATH.read_text(encoding="utf-8").splitlines()
+    monkeypatch.chdir(REPO_ROOT)
+    declaration = PatternVersionDeclaration.from_string_definition(entry, "v{version}")
+    before = path.read_text(encoding="utf-8").splitlines()
     after = declaration.replace(Version.parse("99.99.99")).splitlines()
 
     assert len(after) == len(before)
     changed = [new for old, new in zip(before, after) if old != new]
-    assert changed == ['  version: "99.99.99"']
+    assert changed == [changed_line]