ci: add reproducible master-data checks

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+      - name: Install project and test tools
+        run: python -m pip install --disable-pip-version-check -e '.[dev]'
+      - name: Lint
+        run: python -m ruff check src tests scripts
+      - name: Tests
+        run: PYTHONPATH=src python -m pytest
+      - name: Compile Python sources
+        run: python -m compileall -q src tests scripts

README.md

@@ -42,6 +42,8 @@ python3.12 -m venv .venv
 
 Tests cover company/product normalization, blocking, exact matches, identifier/brand conflicts, rejection memory, idempotent/conflicting mappings, survivorship, transitive false-merge protection, metric math and the deterministic 10,000-record benchmark.
 
+CI additionally runs `ruff` and `compileall`; it uses only synthetic records and does not connect to 1C or a master-data system.
+
 ## Limitations
 
 - The benchmark is synthetic/easy and its quality metrics are not a production claim.

pyproject.toml

@@ -9,7 +9,7 @@ requires-python=">=3.11"
 description="Explainable entity-resolution engine for companies/products with normalization, blocking, conflict-aware scoring, remembered review decisions, canonical mappings and provenance."
 
 [project.optional-dependencies]
-dev=["pytest>=8,<9"]
+dev=["pytest>=8,<9", "ruff>=0.12,<1"]
 
 [tool.pytest.ini_options]
 testpaths=["tests"]