统一版本来源并修正发布校验

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: oceanusXXD

.github/workflows/publish-pypi.yml

@@ -44,9 +44,12 @@ jobs:
 
           expected = "${{ inputs.expected_version }}"
           pyproject = tomllib.loads((root / "pyproject.toml").read_text(encoding="utf-8"))
-          declared = pyproject["project"]["version"]
-          if declared != expected:
-              raise SystemExit(f"Expected version {expected}, but pyproject version is {declared}.")
+          dynamic = pyproject["project"].get("dynamic", [])
+          version_attr = pyproject["tool"]["setuptools"]["dynamic"]["version"]["attr"]
+          if dynamic != ["version"]:
+              raise SystemExit(f"Expected dynamic version metadata, got {dynamic!r}.")
+          if version_attr != "code2skill.version.__version__":
+              raise SystemExit(f"Unexpected dynamic version source: {version_attr}.")
           if __version__ != expected:
               raise SystemExit(f"Expected version {expected}, but runtime version is {__version__}.")
           PY

.github/workflows/release.yml

@@ -47,9 +47,12 @@ jobs:
           tag = "${{ github.ref_name }}"
           version = tag.removeprefix("v")
           pyproject = tomllib.loads((root / "pyproject.toml").read_text(encoding="utf-8"))
-          declared = pyproject["project"]["version"]
-          if declared != version:
-              raise SystemExit(f"Tag {tag} does not match pyproject version {declared}.")
+          dynamic = pyproject["project"].get("dynamic", [])
+          version_attr = pyproject["tool"]["setuptools"]["dynamic"]["version"]["attr"]
+          if dynamic != ["version"]:
+              raise SystemExit(f"Expected dynamic version metadata, got {dynamic!r}.")
+          if version_attr != "code2skill.version.__version__":
+              raise SystemExit(f"Unexpected dynamic version source: {version_attr}.")
           if __version__ != version:
               raise SystemExit(f"Tag {tag} does not match runtime version {__version__}.")
           release_note = root / "docs" / "releases" / f"v{version}.md"

docs/release.md

@@ -41,7 +41,7 @@ python -m code2skill --version
 When cutting a new release:
 
 1. Update `version` in `pyproject.toml`
-2. Update `__version__` in `src/code2skill/__init__.py`
+2. Update `__version__` in `src/code2skill/version.py`
 3. Add a new note in `docs/releases/`
 4. Update `CHANGELOG.md`
 
@@ -65,7 +65,7 @@ Use `.github/workflows/publish-pypi.yml` only when you explicitly want to publis
 Recommended flow:
 
 1. prepare and push the final release commit
-2. make sure the version in `pyproject.toml` and `src/code2skill/__init__.py` is final
+2. make sure `src/code2skill/version.py` has the final version and `pyproject.toml` still points to the dynamic version source
 3. run the `Release` workflow via a version tag so GitHub Release creation succeeds
 4. manually run `Publish PyPI` from the same ref and provide the exact version string
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2skill"
-version = "0.1.6"
+dynamic = ["version"]
 description = "Generate repository-aware Skills, blueprints, and AI rule files from real Python codebases."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -60,6 +60,9 @@ code2skill = "code2skill.cli:main"
 package-dir = {"" = "src"}
 include-package-data = false
 
+[tool.setuptools.dynamic]
+version = {attr = "code2skill.version.__version__"}
+
 [tool.setuptools.package-data]
 code2skill = ["py.typed"]
 

tests/test_import_surfaces.py

@@ -111,4 +111,9 @@ def test_package_includes_py_typed_marker() -> None:
 def test_runtime_version_matches_pyproject_metadata() -> None:
     pyproject = tomllib.loads((ROOT / "pyproject.toml").read_text(encoding="utf-8"))
 
-    assert pyproject["project"]["version"] == __version__
+    assert pyproject["project"]["dynamic"] == ["version"]
+    assert (
+        pyproject["tool"]["setuptools"]["dynamic"]["version"]["attr"]
+        == "code2skill.version.__version__"
+    )
+    assert __version__ == "0.1.7"