test(docs): update docs

Statistics: 6 files changed, 135 insertions, 221 deletions

Summary:
- Dirs: .=4, regix=1, tests=1
- Exts: .md=2, .py=2, .yml=1, .json=1
- A/M/D: 0/6/0
- Symbols: test_signature_break_detected, _check_signature_break, _check_mock_inflation, class TestSmellsInReport

Modified files:
- README.md (+4/-4)
- SUMD.md (+54/-30)
- Taskfile.yml (+15/-2)
- regix/smells.py (+31/-0)
- sumd.json (+25/-185)
- tests/test_smells.py (+6/-0)

Changes (notes):
- README.md (+4/-4): update documentation
- SUMD.md (+54/-30): update
- Taskfile.yml (+15/-2): update
- regix/smells.py (+31/-0): add functions: _check_signature_break
- sumd.json (+25/-185): update
- tests/test_smells.py (+6/-0): add functions: test_signature_break_detected

Implementation notes (heuristics):
- Type inferred from file paths + diff keywords + add/delete ratio
- Scope prefers 'goal' when goal/* is touched; otherwise based on top-level dirs
- For <=6 files: generate short per-file notes from added lines (defs/classes/click options/headings)
- A/M/D derived from git name-status; per-file +X/-X from git numstat

Author: tom-sapletta-com

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased]
 
+## [0.1.26] - 2026-05-27
+
+### Docs
+- Update README.md
+- Update SUMD.md
+
+### Test
+- Update tests/test_smells.py
+
+### Other
+- Update Taskfile.yml
+- Update regix/smells.py
+- Update sumd.json
+
 ## [0.1.25] - 2026-05-27
 
 ### Docs

README.md

@@ -1,10 +1,10 @@
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.25-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.71-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-14.2h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.26-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$2.92-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-14.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $2.7136 (35 commits)
-- 👤 **Human dev:** ~$1417 (14.2h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $2.9201 (36 commits)
+- 👤 **Human dev:** ~$1467 (14.7h @ $100/h, 30min dedup)
 
 Generated on 2026-05-27 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 

SUMD.md

@@ -13,7 +13,7 @@ Regression Index — detect and measure code quality regressions between git ver
 ## Metadata
 
 - **name**: `regix`
-- **version**: `0.1.24`
+- **version**: `0.1.25`
 - **python_requires**: `>=3.10`
 - **license**: Apache-2.0
 - **ecosystem**: SUMD + DOQL + testql + taskfile
@@ -27,41 +27,65 @@ SUMD (description) → DOQL/source (code) → taskfile (automation) → testql (
 
 ## Dependencies
 
-- **runtime**: `pyyaml>=6.0`, `typer>=0.12`, `rich>=13.0`
-- **analysis (optional)**: `lizard>=1.17`, `radon>=6.0`, `coverage[toml]>=7.0`, `vallm>=0.1`
-- **dev/test**: `pytest>=8.0`, `pytest-cov>=5.0`, `mypy`, `ruff`, `tox`
+- **runtime**: pyyaml>=6.0, typer>=0.12, rich>=13.0
+- **analysis (optional)**: lizard, radon, coverage[toml], vallm
+- **dev/test**: pytest, pytest-cov, tox, ruff, mypy
 
 ## Source Map
 
-- regix/cli.py
-- regix/compare.py
-- regix/config.py
-- regix/git.py
-- regix/history.py
-- regix/impact.py
-- regix/models.py
-- regix/report.py
-- regix/smells.py
-- regix/snapshot.py
+- tests/test_gates.py
+- tests/test_backends.py
+- tests/test_history.py
+- tests/test_exceptions.py
+- tests/conftest.py
+- tests/test_report.py
+- tests/test_config_full.py
+- tests/test_smells.py
+- tests/test_git.py
+- tests/__init__.py
+- tests/test_impact.py
+- tests/test_config.py
+- tests/test_code2llm_backend.py
+- tests/test_benchmark.py
+- tests/test_regix_class.py
+- tests/test_models.py
+- tests/test_cache.py
+- tests/test_report_full.py
+- tests/test_compare.py
+- tests/test_compare_full.py
+- tests/test_snapshot.py
+- tests/test_cli.py
+- tests/test_integrations.py
+- tests/test_regix.py
+- scripts/check_regression.py
 - regix/backends/architecture_backend.py
-- regix/backends/structure_backend.py
-- regix/backends/lizard_backend.py
-- regix/backends/radon_backend.py
-- regix/backends/coverage_backend.py
+- regix/backends/base.py
 - regix/backends/docstring_backend.py
+- regix/backends/radon_backend.py
 - regix/backends/vallm_backend.py
-- tests/test_cli.py
-- tests/test_compare.py
-- tests/test_git.py
-- tests/test_smells.py
-- tests/test_snapshot.py
-- tests/test_report.py
-- tests/test_backends.py
-- tests/test_history.py
+- regix/backends/__init__.py
+- regix/backends/structure_backend.py
+- regix/backends/code2llm_backend.py
+- regix/backends/coverage_backend.py
+- regix/backends/lizard_backend.py
+- regix/config.py
+- regix/exceptions.py
+- regix/cli.py
+- regix/impact.py
+- regix/gates.py
+- regix/__init__.py
+- regix/compare.py
+- regix/benchmark/cli.py
+- regix/benchmark/reporter.py
+- regix/benchmark/__init__.py
+- regix/benchmark/__main__.py
+- regix/benchmark/models.py
+- regix/benchmark/suite.py
+- regix/benchmark/factory.py
+- regix/benchmark/probes.py
 
 ## Intent
 
-- Track code-quality regressions between refs, not only absolute threshold violations.
-- Provide diff-scoped LLM regression gating via `regix review`.
-- Use dependency-aware impact analysis (`regix impact`) to run only relevant tests.
-- Emit machine-readable outputs for CI, quality gates, and automation loops.
+- Track code-quality regressions between refs.
+- Support LLM patch validation via diff-scoped `regix review`.
+- Target selective tests using impact + dependency analysis.

Taskfile.yml

@@ -192,19 +192,32 @@ tasks:
       echo "- **name**: \`$(basename $(pwd))\`" >> SUMD.md
       echo "- **version**: \`$(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('version','unknown'))" 2>/dev/null || echo 'unknown')\`" >> SUMD.md
       echo "- **python_requires**: \`>=$(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('requires-python','3.10').replace('>=','').replace('^',''))" 2>/dev/null || echo '3.10')\`" >> SUMD.md
-      echo "- **license**: $(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); print(d.get('project',{}).get('license',{}).get('text','MIT'))" 2>/dev/null || echo 'MIT')" >> SUMD.md
+      echo "- **license**: $(python3 -c "import tomllib; f=open('pyproject.toml','rb'); d=tomllib.load(f); lic=d.get('project',{}).get('license','MIT'); print(lic if isinstance(lic,str) else lic.get('text','MIT'))" 2>/dev/null || echo 'MIT')" >> SUMD.md
       echo "- **ecosystem**: SUMD + DOQL + testql + taskfile" >> SUMD.md
-      echo "- **generated_from**: pyproject.toml, Taskfile.yml, Makefile, src/" >> SUMD.md
+      echo "- **generated_from**: pyproject.toml, Taskfile.yml, Makefile, regix/" >> SUMD.md
       echo "" >> SUMD.md
       echo "## Architecture" >> SUMD.md
       echo "" >> SUMD.md
       echo '```' >> SUMD.md
       echo "SUMD (description) → DOQL/source (code) → taskfile (automation) → testql (verification)" >> SUMD.md
       echo '```' >> SUMD.md
       echo "" >> SUMD.md
+      echo "## Dependencies" >> SUMD.md
+      echo "" >> SUMD.md
+      runtime_deps=$(python3 -c 'import tomllib; f=open("pyproject.toml","rb"); d=tomllib.load(f); print(", ".join(d.get("project",{}).get("dependencies",[])) or "none")' 2>/dev/null || echo 'none')
+      echo "- **runtime**: ${runtime_deps}" >> SUMD.md
+      echo "- **analysis (optional)**: lizard, radon, coverage[toml], vallm" >> SUMD.md
+      echo "- **dev/test**: pytest, pytest-cov, tox, ruff, mypy" >> SUMD.md
+      echo "" >> SUMD.md
       echo "## Source Map" >> SUMD.md
       echo "" >> SUMD.md
       find . -name '*.py' -not -path './.venv/*' -not -path './venv/*' -not -path './__pycache__/*' -not -path './.git/*' -not -path './.tox/*' -not -path './dist/*' -not -path './build/*' -not -path './.pytest_cache/*' -not -path './.ruff_cache/*' -not -path './.coverage/*' -not -path './.code2llm_cache/*' -not -path './.taskill/*' | head -50 | sed 's|^./||' | sed 's|^|- |' >> SUMD.md
+      echo "" >> SUMD.md
+      echo "## Intent" >> SUMD.md
+      echo "" >> SUMD.md
+      echo "- Track code-quality regressions between refs." >> SUMD.md
+      echo '- Support LLM patch validation via diff-scoped `regix review`.' >> SUMD.md
+      echo "- Target selective tests using impact + dependency analysis." >> SUMD.md
       echo "Generated SUMD.md"
     - |
       python3 -c "

VERSION

@@ -1 +1 @@
-0.1.25
+0.1.26

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "regix"
-version = "0.1.25"
+version = "0.1.26"
 description = "Regression Index — detect and measure code quality regressions between git versions"
 readme = "README.md"
 license = "Apache-2.0"

regix/__init__.py

@@ -129,4 +129,4 @@ def check_gates(self, ref: str = "HEAD") -> GateResult:
     "ArchSmell",
 ]
 
-__version__ = "0.1.25"
+__version__ = "0.1.26"

regix/smells.py

@@ -97,6 +97,7 @@ def _check_symbol_smells(
         _check_logic_density_drop,
         _check_cohesion_loss,
         _check_no_delegation,
+        _check_signature_break,
         _check_assertion_loss,
         _check_mock_inflation,
         _check_dead_branch,
@@ -426,6 +427,36 @@ def _check_assertion_loss(
     )
 
 
+def _check_signature_break(
+    file: str,
+    sym: str,
+    m_before: SymbolMetrics,
+    m_after: SymbolMetrics,
+    config: RegressionConfig,
+    ref_b: str,
+    ref_a: str,
+) -> ArchSmell | None:
+    """Detect parameter-count inflation that may break call sites."""
+    before = m_before.param_count
+    after = m_after.param_count
+    if before is None or after is None:
+        return None
+    if after <= before:
+        return None
+    delta = after - before
+    severity = "error" if delta >= 2 else "warning"
+    return ArchSmell(
+        smell="signature_break",
+        file=file,
+        symbol=sym,
+        line=m_after.line_start,
+        severity=severity,
+        detail=f"Parameter count increased {before}→{after} (+{delta}) in '{sym}'",
+        ref_before=ref_b,
+        ref_after=ref_a,
+    )
+
+
 def _check_mock_inflation(
     file: str,
     sym: str,