syntopica-codeality-py 0.2.0__tar.gz

syntopica_codeality_py-0.2.0/.gitignore

@@ -0,0 +1,44 @@
+node_modules/
+.pnpm-store/
+**/.astro/
+**/.next/
+**/.nuxt/
+**/.output/
+**/dist/
+**/build/
+**/coverage/
+**/*.tsbuildinfo
+**/.lighthouseci/
+# Written per workspace by scripts/deps-graph-aliased.mjs and removed again on
+# the way out; ignored so a crashed run cannot leave a tracked file behind.
+**/.baseline-depcruise.tsconfig.json
+**/.turbo/
+.turbo/
+.DS_Store
+# CocoIndex Code (ccc)
+/.cocoindex_code/
+# Codegraph local index
+/.codegraph/
+
+# Serena (local tool state)
+.serena/
+
+target/
+
+# eslint-suppressions.json is deliberately committed: it is the shared
+# frozen baseline of pre-existing violations.
+
+# Stryker's mutant sandbox and HTML report
+.stryker-tmp/
+reports/mutation/
+
+# Python (packages/codeality-py, templates/python-package)
+**/.venv/
+**/__pycache__/
+**/.pytest_cache/
+**/.mypy_cache/
+**/.ruff_cache/
+**/*.egg-info/
+
+# coverage.py writes its SQLite database beside the tests it measured.
+.coverage

syntopica_codeality_py-0.2.0/CHANGELOG.md

@@ -0,0 +1,222 @@
+# Changelog
+
+All notable changes to `syntopica-codeality-py` are documented here. The format
+follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.2.0
+
+### Changed
+
+- Renamed everywhere: the distribution is `syntopica-codeality-py`, the import
+  package is `codeality_py`, the console script is `codeality-py`, and the
+  configuration file is `codeality-py.toml`. The old `busirocket-baseline-py`
+  releases stay on PyPI and receive no further updates.
+- The inline suppression prefix is now `# codeality-py: ignore[...]` and
+  `# codeality-py: ignore-file[...]`. Rule codes keep the `BPY` prefix: codes
+  are permanent identifiers and never change meaning.
+
+### Migration
+
+- Replace the dependency, rename `baseline-py.toml` to `codeality-py.toml`,
+  rewrite any `# baseline-py:` suppression comment, and change
+  `uv run baseline-py gate` to `uv run codeality-py gate` in CI.
+
+## 0.1.12
+
+### Fixed
+
+- A failing stage's detail now carries its stderr as well as its stdout. deptry
+  reports on stderr, so a red deptry stage in CI showed an exit code and an
+  empty detail, and the reader had nothing to act on.
+
+## 0.1.11
+
+### Fixed
+
+- An f-string holding SQL is one `BPY006` finding, reported at the string. Its
+  constant parts were reported too, and their positions differ between Python
+  3.11 and 3.12, so the same query fingerprinted differently depending on the
+  interpreter: a baseline recorded on 3.13 reported one new and one resolved
+  finding on a 3.11 runner.
+- `init --ci` in a project nested inside a repository writes the workflow at the
+  repository root, named `quality-<project>.yml`, with every step running from
+  the project directory. GitHub reads workflows only from the root, so the file
+  scaffolded inside `tools/qlctool` was never picked up.
+
+## 0.1.10
+
+### Fixed
+
+- The scaffolded workflow listens on the branch the project is checked out on
+  instead of always `main`. Two of the first eight adopters lived on `master`
+  and on a feature branch, and a workflow watching `main` never ran for either;
+  a nested project reads the enclosing repository's branch.
+
+## 0.1.9
+
+### Fixed
+
+- `init` no longer rewrites a consumer's `[tool.ruff.lint]` `select` and
+  `ignore` arrays when merging. The old merge rebuilt each array as a sorted
+  set, which kept every code and dropped every comment - and a consumer's ignore
+  list is usually a dated ledger of adoption debt, one family per line with the
+  count found. The arrays are now extended in place: missing codes land on one
+  new line, marked, and nothing else moves. A project with nothing missing is
+  reported `unchanged`.
+- The scaffolded CI matrix and ruff `target-version` follow the project's
+  `requires-python` floor instead of a hard-coded 3.11. A matrix cell below the
+  floor failed on `uv sync` before the gate ran; a ruff target below it let
+  pyupgrade stop short of the syntax the project may already use.
+
+### Changed
+
+- The scaffolded workflow installs with
+  `uv sync --locked --all-extras --all-groups`, so CI audits and tests the same
+  environment a local `uv run codeality-py gate` does; a group-only install left
+  out the extras the tests import. Its actions are pinned by commit SHA.
+- The shipped `mypy.ini` no longer carries a `[mypy-tests.*]` section. The
+  gate's mypy stage checks source roots only, so the section relaxed nothing;
+  configuration should not promise what the gate does not do.
+
+## 0.1.8
+
+### Added
+
+- `init` now reports a `ruff.toml` sitting beside a pyproject that also declares
+  `[tool.ruff]`. Ruff reads one configuration per directory, so the file wins
+  outright and the table is never read - silently. The pair builds itself over
+  time: init writes the file when no table exists, and a table arrives later.
+  Found in DJCenterDeluxe, which spent a release linting against a config nobody
+  read; once the shadow was removed, 1707 findings resolved to 6 real ones.
+
+### Changed
+
+- The shipped deptry ignores gained `DEP004` defaults for the pytest family:
+  test tooling legitimately lives in a dev group and is imported only by tests.
+
+## 0.1.7
+
+### Changed
+
+- A missing shadow-stage tool is now `skipped-not-applicable` instead of
+  `failed-to-run`. A required tool that cannot run is still a failure; an
+  advisory tool that was never installed is not an alarm.
+- `init` no longer adds the quality dependency group to a project whose
+  `requires-python` floor is below 3.11: the group carries
+  `syntopica-codeality-py`, and declaring it there makes every uv resolution
+  unsatisfiable. Found adopting the baseline in `djplayerdeluxe`, which declares
+  `>=3.8` for its Raspberry Pi target.
+
+## 0.1.6
+
+### Added
+
+- `[audit] ignore-vulns` in `codeality-py.toml`: accepted advisories, each
+  expected to carry a written reason, reach pip-audit as `--ignore-vuln` flags.
+  Found adopting the baseline in `clawd-pet`, where platformio 6.x pins
+  starlette below the patched release and the gate had no way to accept the
+  documented risk.
+- `init` records the discovered `import-package`, so coverage measures the
+  package instead of a source directory path.
+
+### Changed
+
+- Tests' per-file-ignores grew `S105`, `S106`, `S108` (fixtures hold dummy
+  tokens and /tmp sockets) and now ignore the whole `PLR` family (a test factory
+  with seven keywords is a fixture, not a design smell).
+
+## 0.1.5
+
+### Changed
+
+- Root discovery now reads the layout a `pyproject.toml` already declares -
+  pytest's `pythonpath` and `testpaths`, hatch's wheel `packages` - before
+  guessing from directories. Found adopting the baseline in `clawd-pet`, a
+  firmware host whose Python lives under `host/src` where directory scanning
+  sees nothing.
+- The test per-file-ignores pattern is `**/tests/**`, so it also reaches nested
+  test roots such as `host/tests`.
+- `D107` joined the ignore list: an `__init__` that stores its arguments has
+  nothing to add to the class docstring.
+
+### Fixed
+
+- The package now passes its own `init`-scaffolded configuration - it had been
+  gating itself with ruff's and mypy's defaults instead of the strict config it
+  ships, because no `ruff.toml` or `mypy.ini` existed in the repository.
+
+## 0.1.4
+
+### Fixed
+
+- The gate's structural stage now honors a recorded baseline: when
+  `.codeality-py-baseline.json` exists it runs `codeality-py baseline check`
+  instead of the bare `check`, so recording debt can actually turn the gate
+  green. Found adopting the baseline in `atrium`, where 61 recorded findings
+  still failed the gate.
+- Merging into an existing `[tool.ruff]` no longer drops the per-file test
+  ignores and the pydocstyle convention the standalone `ruff.toml` always
+  carried. A project that already had a ruff table was held to docstring rules
+  in its tests that a fresh project was not.
+- The shipped `codeality-py.toml` now carries `coverage-threshold = 80`, which
+  the dogfooded config always had and the asset silently lacked.
+
+## 0.1.3
+
+### Changed
+
+- Python 3.11 is now supported. `ast.TypeAlias` handling degrades gracefully: on
+  3.11 the PEP 695 syntax cannot parse at all, so nothing is lost. Found
+  adopting the baseline in `atrium`, whose `requires-python = ">=3.11"` made the
+  quality group unresolvable.
+- `init` now discovers what it used to ask for: `source-roots` in
+  `codeality-py.toml`, `known_first_party` for deptry, and the import-linter
+  root package are filled from the project's real layout instead of `src` and
+  `CHANGE_ME` placeholders. The placeholder survives only when nothing is
+  discoverable.
+
+## 0.1.2
+
+### Fixed
+
+- Baseline fingerprints no longer collapse several violations of one rule in one
+  file into a single entry, which let a fixed finding pay for a new one.
+  Identity is now decided per rule: a file-level rule (`BPY001`, `BPY004`)
+  identifies itself, a naming rule (`BPY002`, `BPY003`) identifies its symbol,
+  and everything else uses the offending line's content plus an occurrence
+  counter, so it survives edits elsewhere in the file. Found adopting the
+  baseline in DJCenterDeluxe, where 155 findings recorded as only 91 entries.
+
+## 0.1.1
+
+### Fixed
+
+- Glob patterns now mean what they do everywhere else: `*` stops at a directory
+  separator and `**` crosses it. They were matched with `fnmatch`, whose `*`
+  crosses separators, so a role or override written for the scripts in a
+  repository root silently claimed every file in the tree. Found while adopting
+  the baseline in DJCenterDeluxe, where `entrypoint = ["*.py"]` matched all 106
+  files instead of the 40 at the root and hid 25 real `BPY002` findings.
+
+## 0.1.0
+
+Initial release.
+
+### Added
+
+- `codeality-py check`: six structural rules no ruff rule covers, over module
+  roles assigned before any file is parsed.
+  - `BPY000` parse-error, `BPY001` one-primary-unit, `BPY002` file-matches-unit,
+    `BPY003` no-grab-bag-names, `BPY004` max-file-lines, `BPY005`
+    barrel-only-init, `BPY006` no-inline-sql.
+  - Text and versioned JSON output, four exit codes, inline and configured
+    suppressions. The command never writes.
+- `codeality-py init`: scaffolds ruff, mypy, deptry, pytest, coverage and CI
+  configuration by merging into what a project already has. A project that
+  configures ruff gets its `[tool.ruff]` extended, never a `ruff.toml` that
+  would silently take precedence over it.
+- `codeality-py gate`: runs the whole quality chain. A required tool that is not
+  installed fails the gate rather than being skipped.
+- `codeality-py baseline update|check`: records migration debt by content
+  fingerprint, reports new, known and resolved findings.

syntopica_codeality_py-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) BusiRocket
+
+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.

syntopica_codeality_py-0.2.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: syntopica-codeality-py
+Version: 0.2.0
+Summary: Structural linter and config scaffolder for Python: atomic files, placement, size caps, no inline SQL
+Project-URL: Homepage, https://github.com/syntopica/codeality
+Project-URL: Issues, https://github.com/syntopica/codeality/issues
+Author: Cristian Deluxe
+License: MIT License
+        
+        Copyright (c) BusiRocket
+        
+        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.
+License-File: LICENSE
+Keywords: architecture,ast,code-quality,linter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: click<9,>=8.1
+Requires-Dist: tomlkit<1,>=0.13
+Description-Content-Type: text/markdown
+
+# codeality-py
+
+Structural linter and config scaffolder for Python: atomic files, placement,
+size caps, no inline SQL. Brings the same discipline as
+`@syntopica/eslint-config` and `cargo-baseline` to Python projects.
+
+- **Design spec:**
+  [docs/superpowers/specs/2026-08-31-python-baseline-design.md](https://github.com/syntopica/codeality/blob/main/docs/superpowers/specs/2026-08-31-python-baseline-design.md).
+
+## Install
+
+```bash
+uv add --dev syntopica-codeality-py
+```
+
+## Usage
+
+```bash
+codeality-py init [--check|--apply|--force]  # scaffold ruff, mypy, deptry,
+                                            # pytest, coverage and CI config
+codeality-py check [PATH...]                 # run the structural rules
+codeality-py gate                            # run the whole quality chain
+codeality-py baseline create|update|check    # track migration debt
+```
+
+`init` never overwrites: it merges into existing configuration, or reports a
+conflict. `check` never writes. `gate` fails when a required tool is absent
+rather than skipping it.
+
+## Rules
+
+| Code     | Rule                | Enforces                                                       |
+| -------- | ------------------- | -------------------------------------------------------------- |
+| `BPY000` | `parse-error`       | A file that fails to parse is a finding, never a silent skip.  |
+| `BPY001` | `one-primary-unit`  | Exactly one primary declaration per ordinary module.           |
+| `BPY002` | `file-matches-unit` | File name is the snake_case of its primary declaration.        |
+| `BPY003` | `no-grab-bag-names` | No `utils`, `helpers`, `misc` or `common` in any path segment. |
+| `BPY004` | `max-file-lines`    | Code-line cap per file; tests get their own, looser cap.       |
+| `BPY005` | `barrel-only-init`  | `__init__.py` holds imports, `__all__` and nothing else.       |
+| `BPY006` | `no-inline-sql`     | SQL lives in resource files, not in string literals.           |
+
+## Exit codes
+
+| Code | Meaning                                                         |
+| ---- | --------------------------------------------------------------- |
+| 0    | All blocking checks passed.                                     |
+| 1    | Policy findings.                                                |
+| 2    | Invalid usage or invalid configuration.                         |
+| 3    | Infrastructure failure: a required tool is missing or unusable. |
+
+## License
+
+MIT

syntopica_codeality_py-0.2.0/README.md

@@ -0,0 +1,53 @@
+# codeality-py
+
+Structural linter and config scaffolder for Python: atomic files, placement,
+size caps, no inline SQL. Brings the same discipline as
+`@syntopica/eslint-config` and `cargo-baseline` to Python projects.
+
+- **Design spec:**
+  [docs/superpowers/specs/2026-08-31-python-baseline-design.md](https://github.com/syntopica/codeality/blob/main/docs/superpowers/specs/2026-08-31-python-baseline-design.md).
+
+## Install
+
+```bash
+uv add --dev syntopica-codeality-py
+```
+
+## Usage
+
+```bash
+codeality-py init [--check|--apply|--force]  # scaffold ruff, mypy, deptry,
+                                            # pytest, coverage and CI config
+codeality-py check [PATH...]                 # run the structural rules
+codeality-py gate                            # run the whole quality chain
+codeality-py baseline create|update|check    # track migration debt
+```
+
+`init` never overwrites: it merges into existing configuration, or reports a
+conflict. `check` never writes. `gate` fails when a required tool is absent
+rather than skipping it.
+
+## Rules
+
+| Code     | Rule                | Enforces                                                       |
+| -------- | ------------------- | -------------------------------------------------------------- |
+| `BPY000` | `parse-error`       | A file that fails to parse is a finding, never a silent skip.  |
+| `BPY001` | `one-primary-unit`  | Exactly one primary declaration per ordinary module.           |
+| `BPY002` | `file-matches-unit` | File name is the snake_case of its primary declaration.        |
+| `BPY003` | `no-grab-bag-names` | No `utils`, `helpers`, `misc` or `common` in any path segment. |
+| `BPY004` | `max-file-lines`    | Code-line cap per file; tests get their own, looser cap.       |
+| `BPY005` | `barrel-only-init`  | `__init__.py` holds imports, `__all__` and nothing else.       |
+| `BPY006` | `no-inline-sql`     | SQL lives in resource files, not in string literals.           |
+
+## Exit codes
+
+| Code | Meaning                                                         |
+| ---- | --------------------------------------------------------------- |
+| 0    | All blocking checks passed.                                     |
+| 1    | Policy findings.                                                |
+| 2    | Invalid usage or invalid configuration.                         |
+| 3    | Infrastructure failure: a required tool is missing or unusable. |
+
+## License
+
+MIT

syntopica_codeality_py-0.2.0/codeality-py.toml

@@ -0,0 +1,27 @@
+# codeality-py configuration - https://github.com/syntopica/codeality
+schema-version = 1
+source-roots = ["src"]
+test-roots = ["tests"]
+import-package = "codeality_py"
+coverage-threshold = 80
+
+[limits]
+max-file-lines = 150
+test-max-file-lines = 300
+
+[roles]
+data = [
+  "src/codeality_py/traversal/default_excludes.py",
+  "src/codeality_py/rules/grab_bag_names.py",
+  "src/codeality_py/roles/test_file_patterns.py",
+  "src/codeality_py/config/default_generated_globs.py",
+  "src/codeality_py/engine/rule_registry.py",
+  "src/codeality_py/init/managed_asset_files.py",
+  "src/codeality_py/commands/project_option.py",
+]
+entrypoint = ["src/codeality_py/cli.py"]
+
+[[overrides]]
+paths = ["tests/rules/test_no_inline_sql.py", "tests/baseline/test_classify_findings.py"]
+disable = ["BPY006"]
+reason = "Fixtures for the SQL detector and for fingerprinting are queries by definition"

syntopica_codeality_py-0.2.0/mypy.ini

@@ -0,0 +1,10 @@
+; Managed by codeality-py.
+[mypy]
+strict = True
+warn_unreachable = True
+show_error_codes = True
+pretty = True
+exclude = (?x)(^build/|^dist/|/migrations/)
+
+[mypy-tests.*]
+disallow_untyped_defs = False

syntopica_codeality_py-0.2.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "syntopica-codeality-py"
+version = "0.2.0"
+description = "Structural linter and config scaffolder for Python: atomic files, placement, size caps, no inline SQL"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+authors = [{ name = "Cristian Deluxe" }]
+keywords = ["linter", "code-quality", "architecture", "ast"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = ["click>=8.1,<9", "tomlkit>=0.13,<1"]
+
+[project.scripts]
+codeality-py = "codeality_py.cli:cli"
+
+[project.urls]
+Homepage = "https://github.com/syntopica/codeality"
+Issues = "https://github.com/syntopica/codeality/issues"
+
+[dependency-groups]
+dev = [
+  "deptry>=0.20,<1",
+  "mypy>=1.11,<2",
+  "pip-audit>=2.7,<3",
+  "pytest>=8,<10",
+  "pytest-cov>=5,<8",
+  "ruff>=0.15,<1",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/codeality_py"]
+
+[tool.deptry]
+known_first_party = ["codeality_py"]
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true
+fail_under = 80
+

syntopica_codeality_py-0.2.0/ruff.toml

@@ -0,0 +1,51 @@
+# Managed by codeality-py. Rules are listed explicitly: ALL expands silently on
+# every ruff upgrade, turning a dependency bump into a lint failure.
+line-length = 100
+target-version = "py311"
+
+[lint]
+select = [
+  "E",    # pycodestyle errors
+  "W",    # pycodestyle warnings
+  "F",    # pyflakes
+  "I",    # import sorting
+  "N",    # pep8-naming
+  "UP",   # pyupgrade
+  "B",    # bugbear
+  "A",    # builtin shadowing
+  "C4",   # comprehensions
+  "DTZ",  # naive datetimes
+  "T20",  # print in library code
+  "SIM",  # simplifiable code
+  "RET",  # return control flow
+  "ARG",  # unused arguments
+  "PTH",  # pathlib over os.path
+  "ERA",  # commented-out code
+  "PL",   # pylint: complexity, branches, statements
+  "RUF",  # ruff-specific
+  "D",    # docstrings; replaces interrogate
+  # bandit, curated: the full S set is intentionally noisy in tests and in
+  # subprocess-heavy code.
+  "S102", "S103", "S104", "S105", "S106", "S107", "S108",
+  "S301", "S302", "S303", "S304", "S305", "S306",
+  "S324", "S501", "S506", "S508", "S509",
+  "S608", "S609", "S612",
+]
+ignore = [
+  # Conflicts with the formatter; keeping these on fights ruff format forever.
+  "E501", "W191", "E111", "E114", "E117", "D206", "D300", "COM812", "ISC001",
+  "D203",  # incompatible with D211
+  "D107",  # an __init__ that stores its arguments has nothing to add to the class docstring
+  "D213",  # incompatible with D212
+]
+
+[lint.per-file-ignores]
+# **/ so the pattern also reaches nested test roots such as host/tests.
+"**/tests/**" = ["D", "S101", "ARG", "PLR2004"]
+"**/conftest.py" = ["D"]
+
+[lint.pydocstyle]
+convention = "google"
+
+[format]
+docstring-code-format = true

syntopica_codeality_py-0.2.0/src/codeality_py/__init__.py

@@ -0,0 +1 @@
+"""Structural linter and config scaffolder for Python projects."""

syntopica_codeality_py-0.2.0/src/codeality_py/assets/codeality-py-ci.yml

@@ -0,0 +1,51 @@
+name: Quality
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  gate:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.11', '3.13']
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7.6.0
+        with:
+          enable-cache: true
+
+      - name: Check the lockfile is current
+        run: uv lock --check
+
+      # Every extra and every group: the gate audits and tests the environment
+      # it runs in, and a group-only install leaves out the extras the tests
+      # import.
+      - name: Install from the lockfile
+        run: uv sync --locked --all-extras --all-groups
+        env:
+          UV_PYTHON: ${{ matrix.python-version }}
+
+      - name: Run the quality gate
+        run: uv run codeality-py gate --json
+
+      - name: Type-check with pyrefly, without blocking
+        continue-on-error: true
+        run: |
+          uv run --with pyrefly pyrefly check --output-format json > pyrefly.json || true
+
+      - name: Upload the pyrefly shadow report
+        if: always()
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        with:
+          name: pyrefly-shadow-${{ matrix.python-version }}
+          path: pyrefly.json
+          retention-days: 90

syntopica_codeality_py-0.2.0/src/codeality_py/assets/codeality-py.toml

@@ -0,0 +1,19 @@
+# codeality-py configuration - https://github.com/syntopica/codeality
+schema-version = 1
+source-roots = ["src"]
+test-roots = ["tests"]
+respect-gitignore = true
+coverage-threshold = 80
+
+[limits]
+max-file-lines = 150
+test-max-file-lines = 300
+
+# A role states what a file is. Prefer a role over a suppression: it explains
+# the file instead of silencing an alarm.
+[roles]
+data = []
+registry = []
+entrypoint = []
+generated = []
+namespace-init = []

syntopica_codeality_py-0.2.0/src/codeality_py/assets/importlinter.ini

@@ -0,0 +1,12 @@
+; Managed by codeality-py, scaffolded only with --profile app. Declare the real
+; layers of the project; an empty contract enforces nothing.
+[importlinter]
+root_package = CHANGE_ME
+
+[importlinter:contract:layers]
+name = Layered architecture
+type = layers
+layers =
+    cli
+    services
+    domain