gitacross 2.1.0__tar.gz → 2.2.0__tar.gz

{gitacross-2.1.0/src/gitacross.egg-info → gitacross-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitacross
-Version: 2.1.0
+Version: 2.2.0
 Summary: Mirror releases and git commits across platforms (Gitea, GitHub, local) with transform pipelines.
 Author: Matthew Deik
 License-Expression: MIT
@@ -112,7 +112,7 @@ gitacross --config config.yml --lint
 gitacross --config config.yml
 ```
 
-Run it again later — releases that were already synced are skipped, so nothing is duplicated. Use `--project my-project` to sync a single project. See [CLI](#cli) for all flags, or the [Python API](#python-api) to drive GitAcross from code.
+Run it again later — releases that were already synced are skipped, so nothing is duplicated. Use `--project-name my-project` to sync a single project. See [CLI](#cli) for all flags, or the [Python API](#python-api) to drive GitAcross from code.
 
 ## How it works
 
@@ -176,11 +176,11 @@ Copy the source release notes/body to the target release. Default `true`. Set at
 
 #### `release_description`
 
-Format the target release notes from a template (aliases: `release_notes_template`, `description_template`). Placeholders: `{body}`, `{description}`, `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`.
+Format the target release notes from a template. Placeholders: `{body}`, `{description}`, `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`.
 
 #### `commit_message`
 
-Custom commit message for the target commits (alias: `commit_template`). Default: `"Release {tag}"` or `"Sync commit {short_sha}"`. Placeholders: `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`, `{body}`, `{description}`.
+Custom commit message for the target commits. Default: `"Release {tag}"` or `"Sync commit {short_sha}"`. Placeholders: `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`, `{body}`, `{description}`.
 
 #### `sync_assets`
 
@@ -436,13 +436,13 @@ GitAcross can be driven from the command line or called directly from Python.
 ### CLI
 
 ```
-gitacross --config PATH [--project NAME] [--workdir PATH] [--dry-run] [--reset] [--lint] [--fix] [-v]
+gitacross --config PATH [--project-name NAME] [--workdir PATH] [--dry-run] [--reset] [--lint] [--fix] [-v]
 ```
 
 | Flag | Description |
 |---|---|
 | `--config PATH` | Config file to use (required) |
-| `--project NAME` | Sync only this project |
+| `--project-name NAME` | Sync only the project with this name |
 | `--workdir PATH` | Where state and cache live (default: `.gitsync`) |
 | `--dry-run` | Preview changes without committing or pushing |
 | `--reset` | Clear saved state and cache before running (fresh start) |
@@ -477,7 +477,7 @@ for r in results:
 # Preview only — nothing is committed or pushed
 results = gitacross.run(
     "config.yml",
-    project="my-project",
+    project_name="my-project",
     dry_run=True,
     work_dir="/data/custom_dir",
 )
@@ -501,9 +501,9 @@ results = gitacross.run("config.yml", reset=True)
 ```python
 config = gitacross.Config("config.yml")
 
-for project in config.projects:
-    if project.enabled:
-        gitacross.sync_project(project, ".gitsync", dry_run=False)
+for project_config in config.projects:
+    if project_config.enabled:
+        gitacross.sync_project(project_config, ".gitsync", dry_run=False)
 ```
 
 </details>
@@ -513,7 +513,7 @@ for project in config.projects:
 
 ```python
 # ${VAR} tokens still resolve from the environment
-project = gitacross.ProjectConfig({
+project_config = gitacross.ProjectConfig({
     "name": "my-project",
     "source": {
         "type": "gitea",
@@ -528,7 +528,7 @@ project = gitacross.ProjectConfig({
         "token": "${GITHUB_TOKEN}",
     },
 })
-gitacross.sync_project(project, ".gitsync")
+gitacross.sync_project(project_config, ".gitsync")
 ```
 
 </details>
@@ -573,16 +573,16 @@ All public symbols are importable directly from `gitacross`:
 
 | Symbol | What it does |
 |---|---|
-| `run(config, project=None, dry_run=False, reset=False, work_dir=".gitsync")` | **Primary entry point.** Sync from a config — a `Config` instance, a path, or an open file object
-| `sync_project(project, work_dir=".gitsync", dry_run=False)` | Sync one project's new releases (respects `project.enabled`); state and cache live in `work_dir`. Returns dicts with `tag`, `source_commit`, `target_commit`, `source_date` |
+| `run(config, project_name=None, dry_run=False, reset=False, work_dir=".gitsync")` | **Primary entry point.** Sync from a config — a `Config` instance, a path, or an open file object
+| `sync_project(project_config, work_dir=".gitsync", dry_run=False)` | Sync one project's new releases (respects `project_config.enabled`); state and cache live in `work_dir`. Returns dicts with `tag`, `source_commit`, `target_commit`, `source_date` |
 | `lint_config(config, print_output=True)` | Lint a config (path or open file object) → `LintReport` |
 | `fix_config(config, write_back=True, print_output=True)` | Fix misplaced/redundant options (path only — writes back to the file) → `FixReport` |
 | `Config(config_source)` | Load a config from a path or open file object; exposes `.projects`. `Config.from_yaml_string(content)` loads a config from raw YAML text (`str` or `bytes`) — no file or stream needed |
 | `ProjectConfig(raw)` | Build one mirror project from a raw config dict (see the “No config file” example). Fields: `name`, `enabled`, `source`, `target`, `renderer`, `retry`, `preserve_description`, `sync_assets`, `stream_assets`, `commit_message`, `release_description` |
 | `ConfigLinter()` | Collect lint issues programmatically: `lint_file(config)`, `lint_yaml_string(content)`; results accumulate in `.issues` |
 | `ConfigFixer()` | Fix a config programmatically: `fix_yaml_string(content)` → `FixReport`; actions recorded in `.fixes` |
-| `LintIssue(severity, message, project=None, key=None)` | One lint finding |
-| `FixIssue(message, project=None)` | One applied fix |
+| `LintIssue(severity, message, project_name=None, key=None)` | One lint finding |
+| `FixIssue(message, project_name=None)` | One applied fix |
 | `LintReport(issues)` | Lint results: `.issues`, `.errors`, `.warnings`, `.redundant`, `.is_valid`, `.format_text()` |
 | `FixReport(fixes, content, is_valid, error=None)` | Fix results: `.fixes`, `.content`, `.is_valid`, `.error`, `.format_text()` |
 | `LintSeverity` | Severity levels used by `LintIssue`: `LintSeverity.ERROR`, `LintSeverity.WARNING`, `LintSeverity.REDUNDANT` |

{gitacross-2.1.0 → gitacross-2.2.0}/README.md

@@ -83,7 +83,7 @@ gitacross --config config.yml --lint
 gitacross --config config.yml
 ```
 
-Run it again later — releases that were already synced are skipped, so nothing is duplicated. Use `--project my-project` to sync a single project. See [CLI](#cli) for all flags, or the [Python API](#python-api) to drive GitAcross from code.
+Run it again later — releases that were already synced are skipped, so nothing is duplicated. Use `--project-name my-project` to sync a single project. See [CLI](#cli) for all flags, or the [Python API](#python-api) to drive GitAcross from code.
 
 ## How it works
 
@@ -147,11 +147,11 @@ Copy the source release notes/body to the target release. Default `true`. Set at
 
 #### `release_description`
 
-Format the target release notes from a template (aliases: `release_notes_template`, `description_template`). Placeholders: `{body}`, `{description}`, `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`.
+Format the target release notes from a template. Placeholders: `{body}`, `{description}`, `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`.
 
 #### `commit_message`
 
-Custom commit message for the target commits (alias: `commit_template`). Default: `"Release {tag}"` or `"Sync commit {short_sha}"`. Placeholders: `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`, `{body}`, `{description}`.
+Custom commit message for the target commits. Default: `"Release {tag}"` or `"Sync commit {short_sha}"`. Placeholders: `{tag}`, `{commit_sha}`, `{short_sha}`, `{project_name}`, `{name}`, `{source_date}`, `{body}`, `{description}`.
 
 #### `sync_assets`
 
@@ -407,13 +407,13 @@ GitAcross can be driven from the command line or called directly from Python.
 ### CLI
 
 ```
-gitacross --config PATH [--project NAME] [--workdir PATH] [--dry-run] [--reset] [--lint] [--fix] [-v]
+gitacross --config PATH [--project-name NAME] [--workdir PATH] [--dry-run] [--reset] [--lint] [--fix] [-v]
 ```
 
 | Flag | Description |
 |---|---|
 | `--config PATH` | Config file to use (required) |
-| `--project NAME` | Sync only this project |
+| `--project-name NAME` | Sync only the project with this name |
 | `--workdir PATH` | Where state and cache live (default: `.gitsync`) |
 | `--dry-run` | Preview changes without committing or pushing |
 | `--reset` | Clear saved state and cache before running (fresh start) |
@@ -448,7 +448,7 @@ for r in results:
 # Preview only — nothing is committed or pushed
 results = gitacross.run(
     "config.yml",
-    project="my-project",
+    project_name="my-project",
     dry_run=True,
     work_dir="/data/custom_dir",
 )
@@ -472,9 +472,9 @@ results = gitacross.run("config.yml", reset=True)
 ```python
 config = gitacross.Config("config.yml")
 
-for project in config.projects:
-    if project.enabled:
-        gitacross.sync_project(project, ".gitsync", dry_run=False)
+for project_config in config.projects:
+    if project_config.enabled:
+        gitacross.sync_project(project_config, ".gitsync", dry_run=False)
 ```
 
 </details>
@@ -484,7 +484,7 @@ for project in config.projects:
 
 ```python
 # ${VAR} tokens still resolve from the environment
-project = gitacross.ProjectConfig({
+project_config = gitacross.ProjectConfig({
     "name": "my-project",
     "source": {
         "type": "gitea",
@@ -499,7 +499,7 @@ project = gitacross.ProjectConfig({
         "token": "${GITHUB_TOKEN}",
     },
 })
-gitacross.sync_project(project, ".gitsync")
+gitacross.sync_project(project_config, ".gitsync")
 ```
 
 </details>
@@ -544,16 +544,16 @@ All public symbols are importable directly from `gitacross`:
 
 | Symbol | What it does |
 |---|---|
-| `run(config, project=None, dry_run=False, reset=False, work_dir=".gitsync")` | **Primary entry point.** Sync from a config — a `Config` instance, a path, or an open file object
-| `sync_project(project, work_dir=".gitsync", dry_run=False)` | Sync one project's new releases (respects `project.enabled`); state and cache live in `work_dir`. Returns dicts with `tag`, `source_commit`, `target_commit`, `source_date` |
+| `run(config, project_name=None, dry_run=False, reset=False, work_dir=".gitsync")` | **Primary entry point.** Sync from a config — a `Config` instance, a path, or an open file object
+| `sync_project(project_config, work_dir=".gitsync", dry_run=False)` | Sync one project's new releases (respects `project_config.enabled`); state and cache live in `work_dir`. Returns dicts with `tag`, `source_commit`, `target_commit`, `source_date` |
 | `lint_config(config, print_output=True)` | Lint a config (path or open file object) → `LintReport` |
 | `fix_config(config, write_back=True, print_output=True)` | Fix misplaced/redundant options (path only — writes back to the file) → `FixReport` |
 | `Config(config_source)` | Load a config from a path or open file object; exposes `.projects`. `Config.from_yaml_string(content)` loads a config from raw YAML text (`str` or `bytes`) — no file or stream needed |
 | `ProjectConfig(raw)` | Build one mirror project from a raw config dict (see the “No config file” example). Fields: `name`, `enabled`, `source`, `target`, `renderer`, `retry`, `preserve_description`, `sync_assets`, `stream_assets`, `commit_message`, `release_description` |
 | `ConfigLinter()` | Collect lint issues programmatically: `lint_file(config)`, `lint_yaml_string(content)`; results accumulate in `.issues` |
 | `ConfigFixer()` | Fix a config programmatically: `fix_yaml_string(content)` → `FixReport`; actions recorded in `.fixes` |
-| `LintIssue(severity, message, project=None, key=None)` | One lint finding |
-| `FixIssue(message, project=None)` | One applied fix |
+| `LintIssue(severity, message, project_name=None, key=None)` | One lint finding |
+| `FixIssue(message, project_name=None)` | One applied fix |
 | `LintReport(issues)` | Lint results: `.issues`, `.errors`, `.warnings`, `.redundant`, `.is_valid`, `.format_text()` |
 | `FixReport(fixes, content, is_valid, error=None)` | Fix results: `.fixes`, `.content`, `.is_valid`, `.error`, `.format_text()` |
 | `LintSeverity` | Severity levels used by `LintIssue`: `LintSeverity.ERROR`, `LintSeverity.WARNING`, `LintSeverity.REDUNDANT` |

{gitacross-2.1.0 → gitacross-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitacross"
-version = "2.1.0"
+version = "2.2.0"
 description = "Mirror releases and git commits across platforms (Gitea, GitHub, local) with transform pipelines."
 readme = "README.md"
 requires-python = ">=3.8"

{gitacross-2.1.0 → gitacross-2.2.0}/src/gitacross/__init__.py

@@ -8,13 +8,13 @@ Quickstart (Python API)::
     results = gitacross.run("config.yml")
 
     # Sync a single project with dry-run mode:
-    results = gitacross.run("config.yml", project="my-mirror", dry_run=True)
+    results = gitacross.run("config.yml", project_name="my-mirror", dry_run=True)
 
     # Lower-level: build objects yourself for full control:
     config = gitacross.Config("config.yml")
-    for project in config.projects:
-        if project.enabled:
-            gitacross.sync_project(project, ".gitsync")
+    for project_config in config.projects:
+        if project_config.enabled:
+            gitacross.sync_project(project_config, ".gitsync")
 
     # Lint / fix a config file:
     report = gitacross.lint_config("config.yml")

{gitacross-2.1.0 → gitacross-2.2.0}/src/gitacross/cli.py

@@ -26,7 +26,7 @@ def main():
 
     parser = argparse.ArgumentParser(description="Sync releases from source to target")
     _ = parser.add_argument("--config", required=True, help="Path to config.yml")
-    _ = parser.add_argument("--project", help="Sync only this project (by name)")
+    _ = parser.add_argument("--project-name", help="Sync only this project (by name)")
     _ = parser.add_argument(
         "--dry-run", action="store_true", help="Print changes without pushing"
     )
@@ -58,7 +58,7 @@ def main():
     config_path = Path(cast(str, args.config))
     fix_flag = cast(bool, args.fix)
     lint_flag = cast(bool, args.lint)
-    project_filter = None if args.project is None else cast(str, args.project)
+    project_name = None if args.project_name is None else cast(str, args.project_name)
     dry_run_flag = cast(bool, args.dry_run)
     reset_flag = cast(bool, args.reset)
     workdir = cast(str, args.workdir)
@@ -92,7 +92,7 @@ def main():
     try:
         results = run(
             config_path,
-            project=project_filter,
+            project_name=project_name,
             dry_run=dry_run_flag,
             reset=reset_flag,
             work_dir=workdir,

{gitacross-2.1.0 → gitacross-2.2.0}/src/gitacross/config.py

@@ -22,10 +22,7 @@ VALID_PROJECT_KEYS = {
     "sync_assets",
     "stream_assets",
     "commit_message",
-    "commit_template",
     "release_description",
-    "release_notes_template",
-    "description_template",
 }
 
 KNOWN_SOURCE_KEYS = {
@@ -256,15 +253,10 @@ class ProjectConfig:
         self.stream_assets = bool(raw.get("stream_assets", False))
 
         # commit_message — project-level commit message template (e.g. "chore(sync): {tag}")
-        self.commit_message = raw.get("commit_message") or raw.get("commit_template") or None
+        self.commit_message = raw.get("commit_message") or None
 
         # release_description — project-level release description template
-        self.release_description = (
-            raw.get("release_description")
-            or raw.get("release_notes_template")
-            or raw.get("description_template")
-            or None
-        )
+        self.release_description = raw.get("release_description") or None
 
     def __repr__(self):
         return (
@@ -309,9 +301,8 @@ def _cascade(raw_project, raw_source, raw_target, keys, default):
     """Return the first value found for any of *keys* across project, source, target.
 
     Lookup order: project-level first (highest priority), then source-level,
-    then target-level, then *default*.  All alias keys are checked at each
-    level before moving to the next — so a project-level alias wins over a
-    source-level primary key.
+    then target-level, then *default*. The first *key* present at the first
+    level wins — so a project-level value beats a source-level one.
     """
     for raw in (raw_project, raw_source, raw_target):
         for k in keys:

{gitacross-2.1.0 → gitacross-2.2.0}/src/gitacross/linter/fixer.py

@@ -18,8 +18,8 @@ class ConfigFixer:
     def __repr__(self):
         return f"ConfigFixer(fixes={len(self.fixes)})"
 
-    def _add(self, message: str, project: str | None = None):
-        self.fixes.append(FixIssue(message=message, project=project))
+    def _add(self, message: str, project_name: str | None = None):
+        self.fixes.append(FixIssue(message=message, project_name=project_name))
 
     def fix_yaml_string(self, content: str) -> FixReport:
         # Fresh accumulator — reusing an instance must not leak prior fixes
@@ -68,12 +68,12 @@ class ConfigFixer:
                     p["source"][k] = val
                     self._add(
                         f"Moved '{k}: {val}' from project level into 'source:'",
-                        project=p_name,
+                        project_name=p_name,
                     )
                 else:
                     self._add(
                         f"Removed duplicate project-level '{k}' (already present under source)",
-                        project=p_name,
+                        project_name=p_name,
                     )
 
         # 2. Misplaced project-level keys inside source -> move to project level
@@ -85,12 +85,12 @@ class ConfigFixer:
                         p[k] = val
                         self._add(
                             f"Moved '{k}' from 'source:' to project level",
-                            project=p_name,
+                            project_name=p_name,
                         )
                     else:
                         self._add(
                             f"Removed duplicate '{k}' from 'source:' (already present at project level)",
-                            project=p_name,
+                            project_name=p_name,
                         )
 
         # 3. Misplaced project keys in target -> move to project level
@@ -103,12 +103,12 @@ class ConfigFixer:
                         p[k] = val
                         self._add(
                             f"Moved '{k}' from 'target:' to project level",
-                            project=p_name,
+                            project_name=p_name,
                         )
                     else:
                         self._add(
                             f"Removed duplicate '{k}' from 'target:' (already present at project level)",
-                            project=p_name,
+                            project_name=p_name,
                         )
                 elif k in KNOWN_SOURCE_KEYS:
                     val = p["target"].pop(k)
@@ -118,32 +118,32 @@ class ConfigFixer:
                         p["source"][k] = val
                         self._add(
                             f"Moved '{k}: {val}' from 'target:' into 'source:'",
-                            project=p_name,
+                            project_name=p_name,
                         )
                     else:
                         self._add(
                             f"Removed duplicate '{k}' from 'target:' (already present under source)",
-                            project=p_name,
+                            project_name=p_name,
                         )
 
         # 4. Redundant project-level options
         if p.get("enabled") is True:
             del p["enabled"]
-            self._add("Removed redundant 'enabled: true'", project=p_name)
+            self._add("Removed redundant 'enabled: true'", project_name=p_name)
 
         for key in ("preserve_description",):
             if p.get(key) is True:
                 del p[key]
-                self._add(f"Removed redundant '{key}: true'", project=p_name)
+                self._add(f"Removed redundant '{key}: true'", project_name=p_name)
 
         for key in ("sync_assets",):
             if p.get(key) is False:
                 del p[key]
-                self._add(f"Removed redundant '{key}: false'", project=p_name)
+                self._add(f"Removed redundant '{key}: false'", project_name=p_name)
 
         if p.get("stream_assets") is False:
             del p["stream_assets"]
-            self._add("Removed redundant 'stream_assets: false'", project=p_name)
+            self._add("Removed redundant 'stream_assets: false'", project_name=p_name)
 
         # 3. Source endpoint fixes
         if isinstance(p.get("source"), dict):
@@ -151,31 +151,31 @@ class ConfigFixer:
             if src.get("mode") == "release":
                 del src["mode"]
                 self._add(
-                    "Removed redundant 'source.mode: release'", project=p_name
+                    "Removed redundant 'source.mode: release'", project_name=p_name
                 )
             if src.get("include_prereleases") is False:
                 del src["include_prereleases"]
                 self._add(
                     "Removed redundant 'source.include_prereleases: false'",
-                    project=p_name,
+                    project_name=p_name,
                 )
             if src.get("include_drafts") is False:
                 del src["include_drafts"]
                 self._add(
                     "Removed redundant 'source.include_drafts: false'",
-                    project=p_name,
+                    project_name=p_name,
                 )
             if src.get("sync_from") == "":
                 del src["sync_from"]
                 self._add(
                     "Removed redundant 'source.sync_from: \"\"'",
-                    project=p_name,
+                    project_name=p_name,
                 )
             if src.get("tag_pattern") == "*":
                 del src["tag_pattern"]
                 self._add(
                     "Removed redundant 'source.tag_pattern: \"*\"'",
-                    project=p_name,
+                    project_name=p_name,
                 )
 
         # 4. Target endpoint fixes
@@ -184,7 +184,7 @@ class ConfigFixer:
             if tgt.get("branch") == "main":
                 del tgt["branch"]
                 self._add(
-                    "Removed redundant 'target.branch: main'", project=p_name
+                    "Removed redundant 'target.branch: main'", project_name=p_name
                 )
 
         # 5. Retry fixes
@@ -198,11 +198,11 @@ class ConfigFixer:
                 del p["retry"]
                 self._add(
                     "Removed default 'retry' configuration block",
-                    project=p_name,
+                    project_name=p_name,
                 )
             else:
                 self._add(
-                    "Removed redundant retry defaults", project=p_name
+                    "Removed redundant retry defaults", project_name=p_name
                 )
 
         # 6. Renderer fixes
@@ -221,20 +221,20 @@ class ConfigFixer:
                                     del item["pattern"]
                                     self._add(
                                         f"Removed redundant 'pattern: literal' in {op_type} operation",
-                                        project=p_name,
+                                        project_name=p_name,
                                     )
                                 if op_type == "replace":
                                     if item.get("case_sensitive") is True:
                                         del item["case_sensitive"]
                                         self._add(
                                             "Removed redundant 'case_sensitive: true' in replace operation",
-                                            project=p_name,
+                                            project_name=p_name,
                                         )
                                     if item.get("match_case") is False:
                                         del item["match_case"]
                                         self._add(
                                             "Removed redundant 'match_case: false' in replace operation",
-                                            project=p_name,
+                                            project_name=p_name,
                                         )
                                 if op_type == "validate" and item.get(
                                     "case_sensitive"
@@ -242,7 +242,7 @@ class ConfigFixer:
                                     del item["case_sensitive"]
                                     self._add(
                                         "Removed redundant 'case_sensitive: true' in validate operation",
-                                        project=p_name,
+                                        project_name=p_name,
                                     )
 
 

{gitacross-2.1.0 → gitacross-2.2.0}/src/gitacross/linter/models.py

@@ -21,13 +21,13 @@ class LintSeverity(Enum):
 class LintIssue:
     severity: LintSeverity
     message: str
-    project: str | None = None
+    project_name: str | None = None
     key: str | None = None
 
     def __str__(self) -> str:
         prefix = f"[{self.severity.value}]"
-        if self.project:
-            return f"  {prefix} (project '{self.project}'): {self.message}"
+        if self.project_name:
+            return f"  {prefix} (project '{self.project_name}'): {self.message}"
         return f"  {prefix} {self.message}"
 
 
@@ -63,7 +63,7 @@ class LintReport:
         # Group issues by project (None first)
         by_proj: dict[str | None, list[LintIssue]] = {}
         for issue in self.issues:
-            by_proj.setdefault(issue.project, []).append(issue)
+            by_proj.setdefault(issue.project_name, []).append(issue)
 
         if None in by_proj:
             for issue in by_proj[None]:
@@ -98,11 +98,11 @@ _CleanDumper.add_representer(str, _str_presenter)
 @dataclass
 class FixIssue:
     message: str
-    project: str | None = None
+    project_name: str | None = None
 
     def __str__(self) -> str:
-        if self.project:
-            return f"  ✓ (project '{self.project}'): {self.message}"
+        if self.project_name:
+            return f"  ✓ (project '{self.project_name}'): {self.message}"
         return f"  ✓ {self.message}"
 
 
@@ -121,7 +121,7 @@ class FixReport:
         out = [f"Applied {len(self.fixes)} fix(es):"]
         by_proj: dict[str | None, list[FixIssue]] = {}
         for fix in self.fixes:
-            by_proj.setdefault(fix.project, []).append(fix)
+            by_proj.setdefault(fix.project_name, []).append(fix)
 
         if None in by_proj:
             for fix in by_proj[None]: