release: v0.36.2 [skip ci]

DEVX-121: fix: GiteaClient.set_repo_variable uses PUT instead of PATCH
chore: update badge URLs to commit d9423d85 [skip ci]
2026-07-07 15:52:35 +00:00 · 2026-07-07 15:51:45 +00:00 · 2026-07-07 12:05:28 +00:00 · 2026-07-07 12:04:41 +00:00 · 2026-07-07 12:03:51 +00:00 · 2026-07-07 11:58:00 +00:00
17 changed files with 1068 additions and 658 deletions
@@ -55,8 +55,7 @@ jobs:
          PYTHONPATH: src
        run: |
          . .venv/bin/activate 2>/dev/null || true
-          export PATH="$HOME/.local/bin:$PATH"
-          vale --minAlertLevel=error docs/ AGENTS.md README.md
+          make devx-vale
      - name: Translation completeness check
        env:
          PYTHONPATH: src
@@ -2,6 +2,48 @@

 All notable changes to this project will be documented in this file.

+## [0.36.2] - 2026-07-07
+
+### Bug Fixes
+
+- GiteaClient.set_repo_variable uses PUT instead of PATCH
+
+## [0.36.1] - 2026-07-07
+
+### Bug Fixes
+
+- Preserve .badges/ dir during git clean in push_badges
+
+## [0.36.0] - 2026-07-07
+
+### Features
+
+- Add GiteaClient repo variable methods and parallelize pytest-cov
+
+## [0.35.7] - 2026-07-06
+
+### Bug Fixes
+
+- Use Gitea wiki dash-marker filename convention
+
+## [0.35.6] - 2026-07-06
+
+### Bug Fixes
+
+- Add delay before wiki verification to avoid race condition
+
+## [0.35.5] - 2026-07-06
+
+### Bug Fixes
+
+- Embed token in wiki clone URL for push auth
+
+## [0.35.4] - 2026-07-06
+
+### Bug Fixes
+
+- Configure git identity before commit in sync_wiki
+
 ## [0.35.3] - 2026-07-06

 ### Bug Fixes
@@ -16,12 +16,12 @@ quality badges.

 [![CI](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions/workflows/ci.yml/badge.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
 [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/src/branch/master/LICENSE)
-[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
-[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
-[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/python.svg)](https://www.python.org/downloads/)
+[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
+[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
+[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/python.svg)](https://www.python.org/downloads/)

 ## Why devx?

@@ -87,7 +87,7 @@ extra index and list devx in your dependencies:
 ```toml
 [project]
 dependencies = [
-    "devx>=0.35.3",
+    "devx>=0.36.2",
 ]

 [tool.pip]
@@ -101,8 +101,8 @@ pip install -e .
 ```

 > **Note:** If your project requires a specific devx version, pin it in
-> `dependencies` (for example, `"devx==0.35.3"`) or use a version constraint
-> (for example, `"devx>=0.35.3,<0.36"`).
+> `dependencies` (for example, `"devx==0.36.2"`) or use a version constraint
+> (for example, `"devx>=0.36.2,<0.37"`).

 ### Optional extras

@@ -13,7 +13,7 @@ RUN pip install --no-cache-dir /tmp/devx[lint] \
    && rm -rf /tmp/devx

 # Install CI/CD binary tools
-RUN python3 -m devx.tools.install_tools --tool actionlint \
+RUN python3 -m devx.tools.install_tools --tool actionlint --tool vale \
    && python3 -m devx.tools.install_checkmake

 # Install hadolint (Dockerfile linter)
@@ -12,12 +12,12 @@ project to be reusable across all oblachno-oss repositories.

 [![CI](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions/workflows/ci.yml/badge.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
 [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/src/branch/master/LICENSE)
-[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
-[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
-[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/40fbd801952eefafe3876bef53a09d217267f810/python.svg)](https://www.python.org/downloads/)
+[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
+[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
+[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/d9423d85825031bee70ad816de71dad2947c8e63/python.svg)](https://www.python.org/downloads/)

 ## Overview

@@ -74,14 +74,14 @@ Add devx to your `pyproject.toml` dependencies and configure the registry:
 ```toml
 [project]
 dependencies = [
-    "devx>=0.35.3",
+    "devx>=0.36.2",
 ]

 [tool.pip]
 extra-index-url = "https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple"
 ```

-Pin a specific version if needed: `"devx==0.35.3"` or `"devx>=0.35.3,<0.36"`.
+Pin a specific version if needed: `"devx==0.36.2"` or `"devx>=0.36.2,<0.37"`.

 ### Optional extras

@@ -122,7 +122,9 @@ exponential backoff (2s, 4s, 8s).
 - Labels (list, create, add to issues)
 - Issues (create, list)
 - Pull requests (get commits, merge, create review)
- Releases (list)
+- Releases (list, create idempotent)
+- Actions (list runs, list jobs, get job logs)
+- Actions variables (get, set idempotent)
 - Wiki pages (list, fetch, create, update, delete)

 **`VikunjaClient`** — Vikunja REST API wrapper:
@@ -48,12 +48,12 @@ Add devx to your `pyproject.toml`:
 ```toml
 [project]
 dependencies = [
-    "devx>=0.35.3",
+    "devx>=0.36.2",
 ]

 [project.optional-dependencies]
 dev = [
-    "devx>=0.35.3",
+    "devx>=0.36.2",
 ]
 ```

@@ -1,3 +1,3 @@
 """devx — reusable development and CI/CD tools for oblachno-oss projects."""

-__version__ = "0.35.3"
+__version__ = "0.36.2"
@@ -372,6 +372,36 @@ class GiteaClient:
        r = self._request("GET", f"/actions/jobs/{job_id}/logs")
        return r.text

+    # -- actions variables (repo-level) --
+
+    def get_repo_variable(self, name: str) -> str | None:
+        """Read a Gitea Actions repository variable.
+
+        Returns the variable value, or ``None`` if the variable is not set.
+        Raises :class:`APIError` on other HTTP errors.
+        """
+        try:
+            r = self._request("GET", f"/actions/variables/{name}")
+            return r.json().get("value")
+        except APIError as e:
+            if e.status == 404:
+                return None
+            raise
+
+    def set_repo_variable(self, name: str, value: str) -> None:
+        """Create or update a Gitea Actions repository variable (idempotent).
+
+        Tries PUT first (update); if the variable doesn't exist (404),
+        creates it via POST. Gitea 1.26.x does not support PATCH for
+        action variables.
+        """
+        try:
+            self._request("PUT", f"/actions/variables/{name}", json={"value": value})
+        except APIError as e:
+            if e.status != 404:
+                raise
+            self._request("POST", f"/actions/variables/{name}", json={"value": value})
+

 class VikunjaClient:
    """Low-level Vikunja REST API client with connection pooling."""
@@ -185,6 +185,7 @@ def main(translations: tuple[Path, ...], source_dir: str | None) -> None:
        # Try common locations
        candidates = [
            root / "src" / "devx" / "translations.json",
+            root / "src" / "grm" / "translations.json",
        ]
        # Also search for any translations.json in src/
        for match in root.glob("src/*/translations.json"):
@@ -93,8 +93,8 @@ def push_to_badges_branch(badges_dir: str) -> str:
    _run(["git", "config", "user.email", "actions@oblachno.fyi"])  # nosec B607
    _run(["git", "checkout", "--orphan", "badges"])  # nosec B607
    _run(["git", "rm", "-rf", "."])  # nosec B607
-    # Remove untracked files/dirs left behind (e.g. .badges/ from generate_badges)
-    _run(["git", "clean", "-fdx", "-e", ".git"])  # nosec B607
+    # Remove untracked files/dirs left behind, but preserve .badges/ for copy below
+    _run(["git", "clean", "-fdx", "-e", ".git", "-e", badges_dir])  # nosec B607

    # Copy badge files to root
    for svg in Path(badges_dir).glob("*.svg"):
@@ -31,7 +31,9 @@ import os
 import re
 import subprocess  # nosec B404
 import tempfile
+import time
 from pathlib import Path
+from urllib.parse import quote, urlparse

 import click
 from dotenv import load_dotenv  # pyright: ignore[reportMissingImports,reportUnknownVariableType]
@@ -48,6 +50,23 @@ MAPPING_FILE = DOCS_DIR / "mapping.json"
 _LINK_RE = re.compile(r"\[([^\]]*)\]\(([^)]+)\)")


+def wiki_filename(page_title: str) -> str:
+    """Convert a wiki page title to its Gitea wiki filename.
+
+    Gitea uses a "dash marker" (``.-``) suffix to distinguish literal dashes
+    from space-to-dash conversions.  See Gitea's ``services/wiki/wiki_path.go``.
+
+    - "Architecture" (no dashes) → ``Architecture.md``
+    - "Getting-Started" (has dashes) → ``Getting-Started.-.md``
+    - "Home" (no dashes) → ``Home.md``
+    """
+    name = page_title.replace(" ", "-")
+    if "-" in name:
+        name += ".-"
+    name += ".md"
+    return quote(name, safe="")
+
+
 def load_mapping() -> dict[str, str]:
    """Load the file-to-wiki-page mapping from mapping.json."""
    with open(MAPPING_FILE, encoding="utf-8") as f:
@@ -102,7 +121,10 @@ def get_wiki_clone_url(owner: str, repo: str, token: str) -> str:
    # Gitea wiki repos are at {clone_url}.wiki.git
    # Extract base URL from API URL
    base = GITEA_API_URL.rsplit("/api/v1", 1)[0]
-    return f"{base}/{owner}/{repo}.wiki.git"
+    # Embed token in URL for both clone and push auth
+    # Format: https://token@host/owner/repo.wiki.git
+    parsed = urlparse(base)
+    return f"{parsed.scheme}://{token}@{parsed.hostname}/{owner}/{repo}.wiki.git"


 def clone_wiki(wiki_url: str, dest: Path) -> bool:
@@ -166,16 +188,15 @@ def sync_files(
        # Transform links
        transformed = transform_links(content)

-        # Wiki filename: use the page title with spaces → underscores
-        # Gitea wiki uses the page title as filename (spaces become dashes)
-        wiki_filename = page_title.replace(" ", "-") + ".md"
-        expected_files.add(wiki_filename)
+        # Wiki filename: Gitea uses a dash-marker convention for titles with dashes
+        fname = wiki_filename(page_title)
+        expected_files.add(fname)

        if not dry_run:
-            dest = wiki_dir / wiki_filename
+            dest = wiki_dir / fname
            dest.write_text(transformed, encoding="utf-8")
        synced += 1
-        click.echo(_("  Synced: {title} → {file}", title=page_title, file=wiki_filename))
+        click.echo(_("  Synced: {title} → {file}", title=page_title, file=fname))

    # Prune stale pages (in wiki but not in mapping)
    pruned = 0
@@ -208,7 +229,19 @@ def commit_and_push(wiki_dir: Path, wiki_url: str, dry_run: bool) -> bool:
        click.echo(_("No changes to sync — wiki is up to date."))
        return False

-    # Commit
+    # Commit — ensure git identity is configured (CI environments may lack it)
+    subprocess.run(  # nosec
+        ["git", "config", "user.email", "devin-ai-integration[bot]@users.noreply.github.com"],
+        cwd=wiki_dir,
+        capture_output=True,
+        check=True,
+    )
+    subprocess.run(  # nosec
+        ["git", "config", "user.name", "Devin CI"],
+        cwd=wiki_dir,
+        capture_output=True,
+        check=True,
+    )
    subprocess.run(  # nosec
        ["git", "commit", "-m", "Sync wiki from docs/ [skip ci]"],
        cwd=wiki_dir,
@@ -218,7 +251,7 @@ def commit_and_push(wiki_dir: Path, wiki_url: str, dry_run: bool) -> bool:

    # Push
    result = subprocess.run(  # nosec
-        ["git", "push", wiki_url, "HEAD:master"],
+        ["git", "push", "--force", wiki_url, "HEAD:master"],
        cwd=wiki_dir,
        capture_output=True,
        text=True,
@@ -293,6 +326,9 @@ def main(dry_run: bool, repo: str | None, verify: bool) -> None:

        # Verification
        if verify and not dry_run:
+            if pushed:
+                click.echo(_("Waiting 5s for Gitea to process pushed commits..."))
+                time.sleep(5)
            click.echo(_("\nVerifying wiki pages..."))
            # Re-clone to verify
            verify_dir = Path(tmpdir) / "verify"
@@ -301,8 +337,8 @@ def main(dry_run: bool, repo: str | None, verify: bool) -> None:
                raise click.ClickException(_("Wiki verification failed — could not clone wiki"))
            failures = 0
            for _file_path, page_title in sorted(mapping.items()):
-                wiki_filename = page_title.replace(" ", "-") + ".md"
-                if (verify_dir / wiki_filename).exists():
+                fname = wiki_filename(page_title)
+                if (verify_dir / fname).exists():
                    click.echo(_("  OK: {title}", title=page_title))
                else:
                    click.echo(_("  FAIL: {title} — page not found in wiki!", title=page_title))
@@ -304,7 +304,7 @@ devx-test-unit:
 	@$(DEVX_BIN)/pytest $(DEVX_TEST_PATHS) -q --no-cov

 devx-pytest-cov:
-	@$(DEVX_BIN)/pytest $(DEVX_TEST_PATHS) -v --cov=$(DEVX_COV_PKG) --cov-report=term-missing --cov-fail-under=100
+	@$(DEVX_BIN)/pytest $(DEVX_TEST_PATHS) -n auto --cov=$(DEVX_COV_PKG) --cov-report=term-missing --cov-fail-under=100

 # ── Quality checks ────────────────────────────────────────────────────────────

@@ -328,10 +328,14 @@ devx-check-docs:
 devx-check-doc-versions:
 	@$(DEVX_PYTHON) -m devx.tools.check_doc_versions --root .

-# Run Vale prose linter on docs and README
+# Run Vale prose linter on docs and README (skips if vale not installed)
 devx-vale:
 	@export PATH="$$HOME/.local/bin:$$PATH" && \
-		vale --minAlertLevel=error docs/ AGENTS.md README.md
+		if ! command -v vale >/dev/null 2>&1; then \
+			echo "[devx-vale] vale not installed — skipping (install with 'make install-tools')"; \
+		else \
+			vale --minAlertLevel=error docs/ AGENTS.md README.md; \
+		fi

 # Verify test suite timing
 devx-check-test-speed:
@@ -68,8 +68,8 @@ def detect_package_name(repo_root: Path) -> str | None:
    Looks for the first subdirectory under ``src/`` that contains
    an ``__init__.py`` file with ``__version__``.

-    Returns the package directory name (e.g., ``devx``) or ``None`` if
-    no package is found.
+    Returns the package directory name (e.g., ``devx``,
+    ``grm``) or ``None`` if no package is found.
    """
    src_dir = repo_root / "src"
    if not src_dir.is_dir():
@@ -909,3 +909,65 @@ class TestGiteaClientActions:
            "https://git.example.com/repos/owner/repo/actions/jobs/10026/logs",
            timeout=DEFAULT_TIMEOUT,
        )
+
+    def test_get_repo_variable_returns_value(self) -> None:
+        client = GiteaClient("https://git.example.com", "tok", "owner", "repo")
+        client._session.request = MagicMock(return_value=_mock_response({"value": "v0.28.1"}))
+        result = client.get_repo_variable("PRODUCTION_DEPLOY_TAG")
+        assert result == "v0.28.1"
+        client._session.request.assert_called_once_with(
+            "GET",
+            "https://git.example.com/repos/owner/repo/actions/variables/PRODUCTION_DEPLOY_TAG",
+            timeout=DEFAULT_TIMEOUT,
+        )
+
+    def test_get_repo_variable_returns_none_on_404(self) -> None:
+        client = GiteaClient("https://git.example.com", "tok", "owner", "repo")
+        not_found = MagicMock()
+        not_found.raise_for_status.side_effect = _mock_http_error(404, "not found")
+        client._session.request = MagicMock(return_value=not_found)
+        result = client.get_repo_variable("MISSING_VAR")
+        assert result is None
+
+    @patch("time.sleep")
+    def test_get_repo_variable_reraises_non_404(self, mock_sleep: MagicMock) -> None:
+        client = GiteaClient("https://git.example.com", "tok", "owner", "repo")
+        server_error = MagicMock()
+        server_error.raise_for_status.side_effect = _mock_http_error(500, "server error")
+        client._session.request = MagicMock(return_value=server_error)
+        with pytest.raises(APIError) as exc_info:
+            client.get_repo_variable("SOME_VAR")
+        assert exc_info.value.status == 500
+
+    def test_set_repo_variable_updates_existing(self) -> None:
+        client = GiteaClient("https://git.example.com", "tok", "owner", "repo")
+        client._session.request = MagicMock(return_value=_mock_response({}))
+        client.set_repo_variable("PRODUCTION_DEPLOY_TAG", "v0.28.2")
+        client._session.request.assert_called_once_with(
+            "PUT",
+            "https://git.example.com/repos/owner/repo/actions/variables/PRODUCTION_DEPLOY_TAG",
+            timeout=DEFAULT_TIMEOUT,
+            json={"value": "v0.28.2"},
+        )
+
+    def test_set_repo_variable_creates_on_404(self) -> None:
+        client = GiteaClient("https://git.example.com", "tok", "owner", "repo")
+        not_found = MagicMock()
+        not_found.raise_for_status.side_effect = _mock_http_error(404, "not found")
+        created = _mock_response({})
+        client._session.request = MagicMock(side_effect=[not_found, created])
+        client.set_repo_variable("NEW_VAR", "v0.29.0")
+        assert client._session.request.call_count == 2
+        second_call = client._session.request.call_args_list[1]
+        assert second_call.args[0] == "POST"
+        assert second_call.args[1] == "https://git.example.com/repos/owner/repo/actions/variables/NEW_VAR"
+        assert second_call.kwargs["json"] == {"value": "v0.29.0"}
+
+    def test_set_repo_variable_reraises_non_404(self) -> None:
+        client = GiteaClient("https://git.example.com", "tok", "owner", "repo")
+        forbidden = MagicMock()
+        forbidden.raise_for_status.side_effect = _mock_http_error(403, "forbidden")
+        client._session.request = MagicMock(return_value=forbidden)
+        with pytest.raises(APIError) as exc_info:
+            client.set_repo_variable("SOME_VAR", "val")
+        assert exc_info.value.status == 403
@@ -19,6 +19,7 @@ from devx.ci.sync_wiki import (
    main,
    sync_files,
    transform_links,
+    wiki_filename,
 )


@@ -96,6 +97,29 @@ class TestGetWikiCloneUrl:
        assert "owner/repo.wiki.git" in url


+class TestWikiFilename:
+    def test_no_dashes(self) -> None:
+        assert wiki_filename("Home") == "Home.md"
+
+    def test_single_word(self) -> None:
+        assert wiki_filename("Architecture") == "Architecture.md"
+
+    def test_with_dashes_adds_marker(self) -> None:
+        assert wiki_filename("Getting-Started") == "Getting-Started.-.md"
+
+    def test_spaces_become_dashes_with_marker(self) -> None:
+        # "Getting Started" → "Getting-Started" (has dash) → marker added
+        assert wiki_filename("Getting Started") == "Getting-Started.-.md"
+
+    def test_spaces_no_dashes_no_marker(self) -> None:
+        # "Foo Bar" → "Foo-Bar" (has dash) → marker added
+        assert wiki_filename("Foo Bar") == "Foo-Bar.-.md"
+
+    def test_single_word_with_spaces_no_dash(self) -> None:
+        # No dash at all after conversion → no marker
+        assert wiki_filename("HelloWorld") == "HelloWorld.md"
+
+
 class TestCloneWiki:
    @patch("devx.ci.sync_wiki.subprocess.run")
    def test_clone_success(self, mock_run: MagicMock, tmp_path: Path) -> None:
@@ -208,6 +232,8 @@ class TestCommitAndPush:
        mock_run.side_effect = [
            MagicMock(returncode=0),  # git add
            MagicMock(returncode=1),  # git diff --cached --quiet (has changes)
+            MagicMock(returncode=0),  # git config user.email
+            MagicMock(returncode=0),  # git config user.name
            MagicMock(returncode=0),  # git commit
            MagicMock(returncode=0, stdout="", stderr=""),  # git push
        ]
@@ -219,6 +245,8 @@ class TestCommitAndPush:
        mock_run.side_effect = [
            MagicMock(returncode=0),  # git add
            MagicMock(returncode=1),  # git diff --cached --quiet (has changes)
+            MagicMock(returncode=0),  # git config user.email
+            MagicMock(returncode=0),  # git config user.name
            MagicMock(returncode=0),  # git commit
            MagicMock(returncode=1, stdout="", stderr="push failed"),  # git push
        ]
@@ -319,6 +347,7 @@ class TestMain:
        assert result.exit_code == 0
        mock_init.assert_called_once()

+    @patch("devx.ci.sync_wiki.time.sleep")
    @patch("devx.ci.sync_wiki.clone_wiki")
    @patch("devx.ci.sync_wiki.commit_and_push", return_value=True)
    @patch("devx.ci.sync_wiki.sync_files", return_value=(1, 0))
@@ -327,6 +356,7 @@ class TestMain:
        mock_sync: MagicMock,
        mock_push: MagicMock,
        mock_clone: MagicMock,
+        mock_sleep: MagicMock,
        tmp_path: Path,
        monkeypatch: pytest.MonkeyPatch,
    ) -> None:
@@ -376,6 +406,7 @@ class TestMain:
        assert result.exit_code == 0
        assert "No push needed" in result.output

+    @patch("devx.ci.sync_wiki.time.sleep")
    @patch("devx.ci.sync_wiki.clone_wiki", side_effect=[True, False])
    @patch("devx.ci.sync_wiki.commit_and_push", return_value=True)
    @patch("devx.ci.sync_wiki.sync_files", return_value=(1, 0))
@@ -384,6 +415,7 @@ class TestMain:
        mock_sync: MagicMock,
        mock_push: MagicMock,
        mock_clone: MagicMock,
+        mock_sleep: MagicMock,
        tmp_path: Path,
        monkeypatch: pytest.MonkeyPatch,
    ) -> None:
@@ -400,6 +432,7 @@ class TestMain:
        assert result.exit_code != 0
        assert "could not clone" in result.output

+    @patch("devx.ci.sync_wiki.time.sleep")
    @patch("devx.ci.sync_wiki.clone_wiki")
    @patch("devx.ci.sync_wiki.commit_and_push", return_value=True)
    @patch("devx.ci.sync_wiki.sync_files", return_value=(1, 0))
@@ -408,6 +441,7 @@ class TestMain:
        mock_sync: MagicMock,
        mock_push: MagicMock,
        mock_clone: MagicMock,
+        mock_sleep: MagicMock,
        tmp_path: Path,
        monkeypatch: pytest.MonkeyPatch,
    ) -> None:
Author	SHA1	Message	Date
devx-ci-bot	05de2b0aa9	release: v0.36.2 [skip ci]	2026-07-07 15:52:35 +00:00
emil	6a463a93d2	DEVX-121: fix: GiteaClient.set_repo_variable uses PUT instead of PATCH	2026-07-07 15:51:45 +00:00
gitea-actions-bot	ad7b52c368	chore: update badge URLs to commit d9423d85 [skip ci]	2026-07-07 12:05:28 +00:00
devx-ci-bot	6b81e1a50a	release: v0.36.1 [skip ci]	2026-07-07 12:04:41 +00:00
emil	443dc01b4e	DEVX-120: fix: preserve .badges/ dir during git clean in push_badges	2026-07-07 12:03:51 +00:00
devx-ci-bot	1d7bf7118a	release: v0.36.0 [skip ci]	2026-07-07 11:58:00 +00:00
emil	f98534ebe2	DEVX-119: feat: add GiteaClient repo variable methods and parallelize pytest-cov	2026-07-07 11:57:04 +00:00
emilandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	c62b168b25	DEVX-116: chore: update grm package name references Update hardcoded path and docstring examples from `gitea_runner_manager` to `grm` after the package rename in grm PR #203. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	2026-07-06 15:51:10 +02:00
devx-ci-bot	40a94df029	release: v0.35.7 [skip ci]	2026-07-06 13:22:27 +00:00
emilandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	f50c4c1e00	DEVX-118: fix: use Gitea wiki dash-marker filename convention Gitea appends a ".-" suffix before ".md" for wiki page titles that contain dashes, to distinguish literal dashes from space-to-dash conversions. For example, "Getting-Started" becomes "Getting-Started.-.md", while "Architecture" becomes "Architecture.md". Previously the code wrote "Getting-Started.md" which Gitea couldn't recognize as a valid wiki page, causing verification to fail with "page not found" for 15 of 21 pages. Also force-push to handle concurrent CI runs that may have pushed to the wiki repo between our clone and push. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	2026-07-06 15:21:22 +02:00
devx-ci-bot	bbb264efc9	release: v0.35.6 [skip ci]	2026-07-06 13:00:59 +00:00
emilandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	c97b249935	DEVX-118: fix: add delay before wiki verification to avoid race condition Gitea needs a few seconds to process pushed wiki commits before a re-clone will see them. Add a 5s sleep after a successful push before verification re-clones the wiki. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	2026-07-06 15:00:02 +02:00
devx-ci-bot	32b9a53151	release: v0.35.5 [skip ci]	2026-07-06 09:46:57 +00:00
emilandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	ae68df63f1	DEVX-118: fix: embed token in wiki clone URL for push auth The wiki Git push failed with "could not read Username" because the clone URL didn't include credentials. Use token@host URL format so both clone and push authenticate properly. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	2026-07-06 11:46:05 +02:00
devx-ci-bot	6402f31345	release: v0.35.4 [skip ci]	2026-07-06 09:42:49 +00:00
emilandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	f017fec8f5	DEVX-118: fix: configure git identity before commit in sync_wiki CI environments may lack git user.email/user.name config, causing git commit to fail with exit code 128. Set identity explicitly before committing wiki changes. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>	2026-07-06 11:41:36 +02:00