rsmetacheck-bot 0.6.0__tar.gz

rsmetacheck_bot-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Software Understanding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rsmetacheck_bot-0.6.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: rsmetacheck-bot
+Version: 0.6.0
+Summary: Metadata quality bot for software repositories, leveraging metacheck for analysis and GitHub/GitLab APIs for issue management.
+Author-email: Tom François <tom.francois@lapp.in2p3.fr>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/SoftwareUnderstanding/rsmetacheck-bot
+Project-URL: Repository, https://github.com/SoftwareUnderstanding/rsmetacheck-bot
+Project-URL: Issues, https://github.com/SoftwareUnderstanding/rsmetacheck-bot/issues
+Keywords: codemeta,metadata,bot,quality software
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.3.1
+Requires-Dist: rsmetacheck>=0.3.6
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.32.5
+Requires-Dist: setuptools[test]<83.0.0
+Requires-Dist: pydantic>=2.13.4
+Provides-Extra: dev
+Requires-Dist: bandit>=1.9.3; extra == "dev"
+Requires-Dist: interrogate>=1.7.0; extra == "dev"
+Requires-Dist: ruff>=0.14.13; extra == "dev"
+Requires-Dist: ty>=0.0.12; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: setuptools<85.0.0; extra == "test"
+Requires-Dist: genbadge[coverage]>=1.0.0; extra == "test"
+Provides-Extra: docs
+Requires-Dist: furo>=2025.12.19; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinxcontrib-mermaid>=1.0.0; extra == "docs"
+Requires-Dist: tomli>=2.0.1; python_version < "3.11" and extra == "docs"
+Dynamic: license-file
+
+# rsmetacheck-bot
+
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19468976.svg)](https://doi.org/10.5281/zenodo.19468976)
+[![SWH](https://archive.softwareheritage.org/badge/swh:1:dir:9f3d474c040158cc675e8db135767e0d2d3fba7b/)](https://archive.softwareheritage.org/swh:1:dir:9f3d474c040158cc675e8db135767e0d2d3fba7b;origin=https://github.com/SoftwareUnderstanding/rsmetacheck-bot;visit=swh:1:snp:03da984544982fdf5aa1f556012b917250f1e4c3;anchor=swh:1:rev:fc64150edf2e35f045cf3858d81b00ca6e7f6e68)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/releases)
+[![Python 3.11--3.12](https://img.shields.io/badge/python-3.11--3.12-blue.svg)](https://www.python.org/downloads/)
+[![CI (build)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/actions/workflows/ci.yml/badge.svg)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/actions/workflows/ci.yml)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+![coverage](coverage.svg)
+![interrogate](interrogate_badge.svg)
+[![rsmetacheck Validation](https://github.com/SoftwareUnderstanding/sw-metadata-bot/actions/workflows/rsmetacheck.yml/badge.svg)](https://github.com/SoftwareUnderstanding/sw-metadata-bot/actions/workflows/rsmetacheck.yml)
+
+
+An automated bot that analyzes repository metadata quality and creates issues with improvement suggestions.
+
+Part of the [CodeMetaSoft](https://w3id.org/codemetasoft) project to improve research software metadata quality.
+
+[![Subscribe](https://img.shields.io/badge/subscribe%20to%20the%20bot-blue?style=for-the-badge)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/issues/new?template=subscribe.yml)
+
+---
+
+## 📋 What This Bot Does
+
+If you received an issue from this bot, it means your repository's metadata was automatically analyzed and some improvements were detected on the main default branch.
+
+The issue contains:
+
+- **Pitfalls**: Critical metadata issues that should be fixed
+- **Warnings**: Metadata improvements that are recommended
+- **Suggestions**: Specific recommendations on how to fix each issue
+- **Codemeta.json generation**: if your repo does not contain any `codemeta.json` file, the bot suggests one.  
+
+### Example Issues You Might See
+
+```md
+### [P002](https://w3id.org/rsmetacheck/catalog/#P002)
+**Evidence:** P002 detected: LICENSE file contains unreplaced template placeholders
+
+**Suggestion:** Update the copyright section with accurate names, organizations, and the current year. Personalizing this section ensures clarity and legal accuracy.
+```
+
+---
+
+## 💬 How to Respond
+
+### If You Agree with the Suggestions
+
+Fix the identified issues and **close the issue** with a comment explaining what you fixed. Your improvements help your software become more discoverable and citable!
+
+### If You Disagree or Have Questions
+
+Feel free to **comment on the issue**. We're happy to discuss the suggestions and help clarify what's needed.
+
+### If You're Not Interested
+
+Simply comment **"unsubscribe"** on the issue and we'll remove your repository from future analysis.
+
+---
+
+## 🔍 What Analysis Is Used
+
+This bot uses [rsmetacheck](https://github.com/SoftwareUnderstanding/rsmetacheck), which analyzes:
+
+- Software metadata completeness
+- Citation and documentation quality
+- Repository structure and best practices
+
+The bot **does not**:
+
+- Modify your code or files
+- Make pull requests
+- Have access to your repository secrets
+
+---
+
+## Install
+
+### pip install
+
+```bash
+pip install rsmetacheck-bot
+```
+
+### uv
+
+```bash
+uv add rsmetacheck-bot
+```
+
+## 📚 Learn More
+
+- [CodeMetaSoft Project](https://w3id.org/codemetasoft) - About the initiative
+- [rsmetacheck](https://github.com/SoftwareUnderstanding/rsmetacheck) - The analysis tool
+- [Citation File Format](https://citation-file-format.github.io/) - How to add CITATION.cff
+
+---
+
+## 🛠️ For Maintainers Running This Bot
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and usage instructions.
+
+Project storage policy: the repo-centric layout and migration rules are described in [docs/output_storage.rst](docs/output_storage.rst).
+
+The pipeline is config driven: one JSON file defines the repository list, issue message, inline opt-outs, and output layout.
+
+Supported platforms:
+
+- ✅ GitHub.com
+- ✅ Gitlab.com
+
+The bot is handling self-hosted gitlab platform but requires providing a token to this server (and not gitlab.com).
+
+### Safe workflow for local validation
+
+Use these commands when validating the bot without creating live issues:
+
+1. Legacy snapshot conversion
+
+```bash
+uv run sw-metadata-bot convert-legacy outputs/legacy_snapshot --target-root outputs/converted
+```
+
+This converts a legacy snapshot tree into the current repo-centric layout without publishing anything.
+
+2. Fresh dry-run analysis from scratch
+
+```bash
+uv run sw-metadata-bot run-analysis --config-file config.json --snapshot-tag 202603
+```
+
+This writes analysis outputs and run reports, but remains dry-run and does not create issues.
+
+3. Simulated publish review
+
+```bash
+uv run sw-metadata-bot simulate-publish --analysis-root outputs/batch-a/202603
+```
+
+This replays the analysis decisions with a fake issue client so you can review the generated issue bodies and opt-out logic without spamming real repositories.
+
+> Avoid the live `publish` command unless you explicitly want to create or update real repository issues.
+
+---
+
+## 📝 License
+
+See [LICENSE](LICENSE) file.

rsmetacheck_bot-0.6.0/README.md

@@ -0,0 +1,148 @@
+# rsmetacheck-bot
+
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19468976.svg)](https://doi.org/10.5281/zenodo.19468976)
+[![SWH](https://archive.softwareheritage.org/badge/swh:1:dir:9f3d474c040158cc675e8db135767e0d2d3fba7b/)](https://archive.softwareheritage.org/swh:1:dir:9f3d474c040158cc675e8db135767e0d2d3fba7b;origin=https://github.com/SoftwareUnderstanding/rsmetacheck-bot;visit=swh:1:snp:03da984544982fdf5aa1f556012b917250f1e4c3;anchor=swh:1:rev:fc64150edf2e35f045cf3858d81b00ca6e7f6e68)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/releases)
+[![Python 3.11--3.12](https://img.shields.io/badge/python-3.11--3.12-blue.svg)](https://www.python.org/downloads/)
+[![CI (build)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/actions/workflows/ci.yml/badge.svg)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/actions/workflows/ci.yml)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+![coverage](coverage.svg)
+![interrogate](interrogate_badge.svg)
+[![rsmetacheck Validation](https://github.com/SoftwareUnderstanding/sw-metadata-bot/actions/workflows/rsmetacheck.yml/badge.svg)](https://github.com/SoftwareUnderstanding/sw-metadata-bot/actions/workflows/rsmetacheck.yml)
+
+
+An automated bot that analyzes repository metadata quality and creates issues with improvement suggestions.
+
+Part of the [CodeMetaSoft](https://w3id.org/codemetasoft) project to improve research software metadata quality.
+
+[![Subscribe](https://img.shields.io/badge/subscribe%20to%20the%20bot-blue?style=for-the-badge)](https://github.com/SoftwareUnderstanding/rsmetacheck-bot/issues/new?template=subscribe.yml)
+
+---
+
+## 📋 What This Bot Does
+
+If you received an issue from this bot, it means your repository's metadata was automatically analyzed and some improvements were detected on the main default branch.
+
+The issue contains:
+
+- **Pitfalls**: Critical metadata issues that should be fixed
+- **Warnings**: Metadata improvements that are recommended
+- **Suggestions**: Specific recommendations on how to fix each issue
+- **Codemeta.json generation**: if your repo does not contain any `codemeta.json` file, the bot suggests one.  
+
+### Example Issues You Might See
+
+```md
+### [P002](https://w3id.org/rsmetacheck/catalog/#P002)
+**Evidence:** P002 detected: LICENSE file contains unreplaced template placeholders
+
+**Suggestion:** Update the copyright section with accurate names, organizations, and the current year. Personalizing this section ensures clarity and legal accuracy.
+```
+
+---
+
+## 💬 How to Respond
+
+### If You Agree with the Suggestions
+
+Fix the identified issues and **close the issue** with a comment explaining what you fixed. Your improvements help your software become more discoverable and citable!
+
+### If You Disagree or Have Questions
+
+Feel free to **comment on the issue**. We're happy to discuss the suggestions and help clarify what's needed.
+
+### If You're Not Interested
+
+Simply comment **"unsubscribe"** on the issue and we'll remove your repository from future analysis.
+
+---
+
+## 🔍 What Analysis Is Used
+
+This bot uses [rsmetacheck](https://github.com/SoftwareUnderstanding/rsmetacheck), which analyzes:
+
+- Software metadata completeness
+- Citation and documentation quality
+- Repository structure and best practices
+
+The bot **does not**:
+
+- Modify your code or files
+- Make pull requests
+- Have access to your repository secrets
+
+---
+
+## Install
+
+### pip install
+
+```bash
+pip install rsmetacheck-bot
+```
+
+### uv
+
+```bash
+uv add rsmetacheck-bot
+```
+
+## 📚 Learn More
+
+- [CodeMetaSoft Project](https://w3id.org/codemetasoft) - About the initiative
+- [rsmetacheck](https://github.com/SoftwareUnderstanding/rsmetacheck) - The analysis tool
+- [Citation File Format](https://citation-file-format.github.io/) - How to add CITATION.cff
+
+---
+
+## 🛠️ For Maintainers Running This Bot
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and usage instructions.
+
+Project storage policy: the repo-centric layout and migration rules are described in [docs/output_storage.rst](docs/output_storage.rst).
+
+The pipeline is config driven: one JSON file defines the repository list, issue message, inline opt-outs, and output layout.
+
+Supported platforms:
+
+- ✅ GitHub.com
+- ✅ Gitlab.com
+
+The bot is handling self-hosted gitlab platform but requires providing a token to this server (and not gitlab.com).
+
+### Safe workflow for local validation
+
+Use these commands when validating the bot without creating live issues:
+
+1. Legacy snapshot conversion
+
+```bash
+uv run sw-metadata-bot convert-legacy outputs/legacy_snapshot --target-root outputs/converted
+```
+
+This converts a legacy snapshot tree into the current repo-centric layout without publishing anything.
+
+2. Fresh dry-run analysis from scratch
+
+```bash
+uv run sw-metadata-bot run-analysis --config-file config.json --snapshot-tag 202603
+```
+
+This writes analysis outputs and run reports, but remains dry-run and does not create issues.
+
+3. Simulated publish review
+
+```bash
+uv run sw-metadata-bot simulate-publish --analysis-root outputs/batch-a/202603
+```
+
+This replays the analysis decisions with a fake issue client so you can review the generated issue bodies and opt-out logic without spamming real repositories.
+
+> Avoid the live `publish` command unless you explicitly want to create or update real repository issues.
+
+---
+
+## 📝 License
+
+See [LICENSE](LICENSE) file.

rsmetacheck_bot-0.6.0/pyproject.toml

@@ -0,0 +1,123 @@
+[build-system]
+requires = ["setuptools>=69", "wheel>=0.47.0,<0.49.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rsmetacheck-bot"
+version = "0.6.0"
+description = "Metadata quality bot for software repositories, leveraging metacheck for analysis and GitHub/GitLab APIs for issue management."
+readme = "README.md"
+requires-python = ">=3.11,<3.13"
+license = "MIT"
+authors = [
+    {name = "Tom François", email = "tom.francois@lapp.in2p3.fr"}
+]
+dependencies = [
+    "click>=8.3.1",
+    "rsmetacheck>=0.3.6",
+    "python-dotenv>=1.0.0",
+    "requests>=2.32.5",
+    "setuptools[test]<83.0.0",
+    "pydantic>=2.13.4",
+]
+
+keywords = ["codemeta", "metadata", "bot", "quality software"]
+classifiers = [
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/SoftwareUnderstanding/rsmetacheck-bot"
+Repository = "https://github.com/SoftwareUnderstanding/rsmetacheck-bot"
+Issues = "https://github.com/SoftwareUnderstanding/rsmetacheck-bot/issues"
+
+[project.scripts]
+rsmetacheck-bot = "rsmetacheck_bot.main:main"
+
+[project.optional-dependencies]
+dev = [
+    "bandit>=1.9.3",
+    "interrogate>=1.7.0",
+    "ruff>=0.14.13",
+    "ty>=0.0.12",
+]
+test = [
+    "pytest",
+    "pytest-cov",
+    "setuptools<85.0.0",
+    "genbadge[coverage]>=1.0.0",
+]
+docs = [
+    "furo>=2025.12.19",
+    "sphinx",
+    "sphinxcontrib-mermaid>=1.0.0",
+    "tomli>=2.0.1; python_version < '3.11'",
+]
+
+[tool.uv]
+package = true
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = { find = { where = ["src"] } }
+include-package-data = true
+
+
+[tool.setuptools.package-data]
+rsmetacheck_bot = ["config/rsmetacheck_non_failing.toml"]
+
+[tool.rsmetacheck_bot.docs]
+# Start year for copyright range (displayed as "YYYY–present" in docs)
+copyright_year = "2026"
+
+
+[tool.pytest.ini_options]
+pythonpath = [
+    "src",
+    "scripts"
+]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"
+markers = [
+    "integration_gitlab: real GitLab API integration tests requiring a valid GITLAB_API_TOKEN",
+]
+
+[tool.bandit]
+exclude_dirs = ["tests",".venv", ".ruff-cache"]
+tests = ["B201", "B301"]
+skips = ["B101", "B601"]
+
+[tool.interrogate]
+ignore-init-method = false
+ignore-init-module = false
+ignore-magic = false
+ignore-semiprivate = false
+ignore-private = false
+ignore-property-decorators = false
+ignore-module = false
+ignore-nested-functions = false
+ignore-nested-classes = false
+ignore-setters = false
+ignore-overloaded-functions = false
+fail-under = 90
+# example values
+exclude = ["setup.py", "docs", "build"]
+# example regex
+ignore-regex = ["^get$", "^mock_.*", ".*BaseClass.*"]
+ext = []
+# possible values: sphinx (default), google
+style = "sphinx"
+# possible values: 0 (minimal output), 1 (-v), 2 (-vv)
+verbose = 0
+quiet = false
+whitelist-regex = []
+color = true
+omit-covered-files = false
+# output file location
+generate-badge = "."
+badge-format = "svg"

rsmetacheck_bot-0.6.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rsmetacheck_bot-0.6.0/src/conversion/__init__.py

@@ -0,0 +1,5 @@
+"""Public conversion package for legacy snapshot migration."""
+
+from .convert_legacy_outputs import convert_legacy_output_tree, main
+
+__all__ = ["convert_legacy_output_tree", "main"]

rsmetacheck_bot-0.6.0/src/conversion/convert_legacy_outputs.py

@@ -0,0 +1,149 @@
+"""Convert legacy snapshot-based output trees into the repo-centric state layout."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import shutil
+from pathlib import Path
+from typing import Any
+
+from rsmetacheck_bot import constants, repo_state
+from rsmetacheck_bot.config.config_utils import sanitize_repo_name
+
+
+def _iter_legacy_repo_dirs(snapshot_root: Path) -> list[Path]:
+    """Return repository directories inside a legacy snapshot root."""
+    if not snapshot_root.exists():
+        return []
+
+    repo_dirs = [
+        child
+        for child in snapshot_root.iterdir()
+        if child.is_dir() and not child.name.startswith(".")
+    ]
+    return sorted(repo_dirs)
+
+
+def _load_json_if_present(path: Path) -> Any | None:
+    """Load JSON from disk when present, otherwise return None."""
+    if not path.exists():
+        return None
+    try:
+        with open(path, encoding="utf-8") as handle:
+            return json.load(handle)
+    except (json.JSONDecodeError, OSError):
+        return None
+
+
+def _copy_if_present(source: Path, destination: Path) -> None:
+    """Copy a file to the destination when it exists."""
+    if source.exists():
+        destination.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(source, destination)
+
+
+def convert_legacy_output_tree(
+    snapshot_root: Path, *, target_root: Path | None = None
+) -> list[Path]:
+    """Convert a legacy snapshot root into repo-centric state folders.
+
+    The converter copies repository artifacts from legacy per-repo directories into
+    a new layout rooted at ``target_root``. It also writes current-state and
+    event-log files for each converted repository and mirrors the legacy
+    run_report.json into the target root when present.
+    """
+    snapshot_root = snapshot_root.resolve()
+    target_root = (target_root or snapshot_root).resolve()
+    target_root.mkdir(parents=True, exist_ok=True)
+
+    repo_dirs = _iter_legacy_repo_dirs(snapshot_root)
+    print(f"[convert-legacy] Converting legacy snapshot: {snapshot_root}")
+    print(f"[convert-legacy] Target root: {target_root}")
+
+    converted: list[Path] = []
+    for repo_dir in repo_dirs:
+        repo_name = sanitize_repo_name(repo_dir.name)
+        repo_folder = target_root / repo_name
+        repo_paths = {
+            "repo_folder": repo_folder,
+            "event_log": repo_folder / constants.FILENAME_EVENT_LOG,
+            "current_state": repo_folder / constants.FILENAME_CURRENT_STATE,
+            "analyses_folder": repo_folder / constants.DIRNAME_ANALYSES,
+            "issues_folder": repo_folder / constants.DIRNAME_ISSUES,
+        }
+        repo_state.ensure_repo_state_dirs(repo_paths)
+
+        copied_files = []
+        for filename in (
+            constants.FILENAME_PITFALL,
+            constants.FILENAME_SOMEF_OUTPUT,
+            constants.FILENAME_REPORT,
+            constants.FILENAME_ISSUE_REPORT,
+            constants.FILENAME_CODEMETA_STATUS,
+            constants.FILENAME_CODEMETA_GENERATED,
+        ):
+            source = repo_dir / filename
+            if source.exists():
+                _copy_if_present(source, repo_folder / filename)
+                copied_files.append(filename)
+
+        legacy_report = _load_json_if_present(repo_dir / constants.FILENAME_REPORT)
+        if isinstance(legacy_report, dict):
+            records = legacy_report.get("records")
+            if isinstance(records, list) and records:
+                record = records[0]
+                if isinstance(record, dict):
+                    repo_state.write_current_state(
+                        repo_folder, repo_state.build_analysis_current_state(record)
+                    )
+                    repo_state.append_event_log(
+                        repo_folder,
+                        {
+                            "event": "analysis_completed",
+                            "commit_id": record.get("current_commit_id") or "unknown",
+                            "analysis_file": str(
+                                (repo_folder / constants.DIRNAME_ANALYSES).relative_to(
+                                    repo_folder
+                                )
+                            ),
+                        },
+                    )
+
+        print(
+            f"[convert-legacy]   - {repo_dir.name} -> {repo_folder} "
+            f"({len(copied_files)} file(s) copied)"
+        )
+        converted.append(snapshot_root)
+
+    legacy_run_report = snapshot_root / constants.FILENAME_RUN_REPORT
+    if legacy_run_report.exists():
+        target_run_report = target_root / constants.FILENAME_RUN_REPORT
+        shutil.copy2(legacy_run_report, target_run_report)
+        print(f"[convert-legacy]   - copied run_report.json to {target_run_report}")
+
+    print(
+        f"[convert-legacy] Finished: {len(repo_dirs)} repository directory(s) converted."
+    )
+    return converted
+
+
+def main() -> None:
+    """CLI entry point for the conversion utility."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "snapshot_root", type=Path, help="Legacy snapshot root to convert"
+    )
+    parser.add_argument(
+        "--target-root",
+        type=Path,
+        default=None,
+        help="Destination root for the converted repo-centric layout",
+    )
+    args = parser.parse_args()
+
+    convert_legacy_output_tree(args.snapshot_root, target_root=args.target_root)
+
+
+if __name__ == "__main__":
+    main()

rsmetacheck_bot-0.6.0/src/rsmetacheck_bot/__init__.py

@@ -0,0 +1,11 @@
+"""rsmetacheck-bot: RSMetaCheck bot for pushing issues with existing repository metadata."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("rsmetacheck-bot")
+except PackageNotFoundError:
+    # Package is not installed
+    __version__ = "unknown"
+
+__all__ = ["__version__"]