ruff-sync 0.1.3.dev1__tar.gz → 0.1.3.dev2__tar.gz

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/.agents/skills/ruff-sync-usage/SKILL.md

@@ -77,8 +77,9 @@ upstream = [
 CI Setup Progress:
 - [ ] 1. Add ruff-sync check step to CI workflow (see references/ci-integration.md)
 - [ ] 2. Decide: --semantic for value-only checks, or full string comparison
-- [ ] 3. Set exit-code expectations (0 = in sync, 1 = config drift, 2 = pre-commit only)
-- [ ] 4. Verify locally: `ruff-sync check --semantic`
+- [ ] 3. Set output format: --output-format github for PR annotations
+- [ ] 4. Set exit-code expectations (0 = in sync, 1 = config drift, 2 = pre-commit only)
+- [ ] 5. Verify locally: `ruff-sync check --semantic`
 ```
 
 Keep the `ruff-pre-commit` hook version in `.pre-commit-config.yaml` aligned with the project's Ruff version.
@@ -112,6 +113,15 @@ ruff-sync https://raw.githubusercontent.com/my-org/standards/main/pyproject.toml
 ruff-sync git@github.com:my-org/standards.git             # SSH (shallow clone)
 ```
 
+## CLI Reference (Short)
+
+| Flag | Meaning |
+|------|---------|
+| `--output-format` | `text` (default), `json`, `github` (PR annotations) |
+| `--semantic`      | Ignore whitespace/comments in `check` |
+| `--pre-commit`    | Sync `.pre-commit-config.yaml` hook version |
+| `--save`          | Persist CLI args to `pyproject.toml` |
+
 ## Gotchas
 
 - **`exclude` uses dotted paths, not TOML paths.** `lint.per-file-ignores` refers to the `per-file-ignores` key inside `[tool.ruff.lint]`. Do NOT write `tool.ruff.lint.per-file-ignores`.

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/.agents/skills/ruff-sync-usage/references/ci-integration.md

@@ -8,10 +8,11 @@ Add this step to any existing workflow (e.g., `.github/workflows/ci.yaml`):
 
 ```yaml
 - name: Check Ruff config is in sync
-  run: ruff-sync check --semantic
+  run: ruff-sync check --semantic --output-format github
 ```
 
 `--semantic` ignores cosmetic differences (comments, whitespace) — only real value or rule changes cause failure.
+`--output-format github` creates inline PR annotations for errors and warnings.
 
 ### Full Workflow Example
 
@@ -40,7 +41,7 @@ jobs:
         run: uv tool install ruff-sync
 
       - name: Check Ruff config is in sync with upstream
-        run: ruff-sync check --semantic
+        run: ruff-sync check --semantic --output-format github
 ```
 
 ### With Pre-commit Sync Check
@@ -49,7 +50,7 @@ To also verify the pre-commit hook version, add the `--pre-commit` flag. Any non
 
 ```yaml
 - name: Check Ruff config and pre-commit hook
-  run: ruff-sync check --semantic --pre-commit
+  run: ruff-sync check --semantic --pre-commit --output-format github
 ```
 
 (Note: For better consistency, you can instead set `pre-commit-version-sync = true` in your `pyproject.toml` — then `ruff-sync check --semantic` will automatically include this check.)

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/.agents/skills/ruff-sync-usage/references/configuration.md

@@ -127,7 +127,7 @@ pre-commit-version-sync = true
 All config keys have CLI equivalents. CLI values always win over `pyproject.toml`:
 
 ```bash
-ruff-sync --exclude lint.ignore --branch develop https://github.com/my-org/standards
+ruff-sync https://github.com/my-org/standards --exclude lint.ignore --branch develop --output-format github
 ```
 
 ## Config Discovery for `ruff.toml` Projects

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/.github/workflows/ci.yaml

@@ -31,6 +31,26 @@ jobs:
 
       - run: uv run invoke ${{ matrix.task }} --check
 
+  validate-docs-build:
+    name: Validate documentation build
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.10
+
+      - name: Install dependencies
+        run: uv sync --group docs --frozen
+
+      - name: Build documentation
+        run: uv run mkdocs build --strict
+
   tests:
     strategy:
       fail-fast: ${{ github.event.pull_request.draft == true }}
@@ -102,6 +122,13 @@ jobs:
           echo "Testing ruff-sync check against Kilo59/ruff-sync..."
           ruff-sync check https://github.com/Kilo59/ruff-sync
 
+      - name: Dogfood Ruff-Sync Check (GitHub Format)
+        run: |
+          echo "Dogfooding ruff-sync check with GitHub annotations..."
+          # This will produce annotations if the current branch's ruff config
+          # has drifted from the upstream (main branch).
+          ruff-sync check https://github.com/Kilo59/ruff-sync --output-format github
+
       - name: Verify semantic check failure
         run: |
           echo "Verifying that --semantic check fails for kitchen-sink config (expected failure)..."
@@ -131,4 +158,15 @@ jobs:
         run: uv build
 
       - name: Publish package
-        run: uv publish
+        run: |
+          # Capture stderr to a file so we can check for specific error strings
+          uv publish 2> publish_err.log || {
+            exit_code=$?
+            # Check for common "version already exists" markers in the output
+            if grep -qi "already exists" publish_err.log; then
+              echo "::warning title=Ruff Sync Publish::Version already exists on PyPI. Skipping upload."
+            else
+              cat publish_err.log
+              exit $exit_code
+            fi
+          }

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/AGENTS.md

@@ -158,6 +158,7 @@ uv run coverage run -m pytest -vv
 - Prefer f-strings for logging (we ignore `G004`).
 - Do not create custom exception classes for simple errors (`TRY003` is ignored).
 - **Prefer `NamedTuple` for return types** over plain tuples to improve readability and type safety.
+- **Prefer `typing.Protocol` over `abc.ABC`** for abstract base classes to promote structural subtyping.
 
 ### TOML Handling
 
@@ -219,3 +220,4 @@ CI is defined in `.github/workflows/ci.yaml`:
 2. **`cast(Any, ...)` in tests**: Use `cast(Any, tomlkit.parse(...))["tool"]["ruff"]` pattern in tests to avoid mypy complaints about `tomlkit`'s `Item | Container` return types.
 3. **Pre-commit ruff version**: The ruff version in `.pre-commit-config.yaml` must stay in sync with the version in `pyproject.toml`. The test `test_pre_commit_versions_are_in_sync` enforces this.
 4. **Keep the ruff-sync-usage skill current**: After any change to CLI behavior (new flags, changed exit codes, new configuration keys, updated URL handling, etc.), update `.agents/skills/ruff-sync-usage/` accordingly. The `SKILL.md` covers quick start, workflows, exit codes, and gotchas. Detailed references live in `references/configuration.md`, `references/troubleshooting.md`, and `references/ci-integration.md`.
+5. **No `autouse=True` fixtures**: NEVER use `autouse=True` for pytest fixtures. All fixtures must be explicitly requested by the test functions that require them. This ensures dependencies are explicit and avoids hidden side effects.

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ruff-sync
-Version: 0.1.3.dev1
+Version: 0.1.3.dev2
 Summary: Synchronize Ruff linter configuration across projects
 Project-URL: Homepage, https://github.com/Kilo59/ruff-sync
 Project-URL: Documentation, https://kilo59.github.io/ruff-sync/
@@ -208,6 +208,7 @@ See the [Usage documentation](https://kilo59.github.io/ruff-sync/usage/) for mor
 - 🧠 **Semantic mode** — Use `--semantic` to ignore cosmetic differences (comments, whitespace) and only fail on real value changes.
 - 🔗 **Pre-commit hook sync** — Use `--pre-commit` to automatically keep your `ruff-pre-commit` hook version in `.pre-commit-config.yaml` matching your project's Ruff version.
 - 🦾 **Agent Skill** — Ships a bundled [Agent Skill](https://kilo59.github.io/ruff-sync/agent-skill/) so AI coding agents can guide you through setup, configuration, and troubleshooting automatically.
+- 📊 **Multiple Output Formats** — Supports `text`, `json`, and GitHub Actions `github` (inline annotations) formats for seamless integration with both human developers and CI/CD pipelines.
 
 ## Configuration
 
@@ -289,7 +290,7 @@ The `check` command is designed for use in CI pipelines. Add it as a step to cat
 # .github/workflows/ci.yaml
 - name: Check ruff config is in sync
   run: |
-    ruff-sync check --semantic
+    ruff-sync check --semantic --output-format github
 ```
 
 With `--semantic`, minor reformatting of your local file won't cause a false positive — only actual rule or value differences will fail the check.
@@ -442,7 +443,9 @@ flowchart TD
 
 ## Dogfooding
 
-To see `ruff-sync` in action, you can ["dogfood" it on this project's own config](./scripts).
+To see `ruff-sync` in action, this project automatically "dogfoods" its own configuration. Every pull request runs a `ruff-sync check` against the repository's own `pyproject.toml` using the `--output-format github` flag, providing real-time feedback and inline annotations whenever configuration drift is detected.
+
+You can also run these checks manually or experiment with syncing:
 
 [**Check if this project is in sync with its upstream:**](./scripts/check_dogfood.sh)
 

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/README.md

@@ -177,6 +177,7 @@ See the [Usage documentation](https://kilo59.github.io/ruff-sync/usage/) for mor
 - 🧠 **Semantic mode** — Use `--semantic` to ignore cosmetic differences (comments, whitespace) and only fail on real value changes.
 - 🔗 **Pre-commit hook sync** — Use `--pre-commit` to automatically keep your `ruff-pre-commit` hook version in `.pre-commit-config.yaml` matching your project's Ruff version.
 - 🦾 **Agent Skill** — Ships a bundled [Agent Skill](https://kilo59.github.io/ruff-sync/agent-skill/) so AI coding agents can guide you through setup, configuration, and troubleshooting automatically.
+- 📊 **Multiple Output Formats** — Supports `text`, `json`, and GitHub Actions `github` (inline annotations) formats for seamless integration with both human developers and CI/CD pipelines.
 
 ## Configuration
 
@@ -258,7 +259,7 @@ The `check` command is designed for use in CI pipelines. Add it as a step to cat
 # .github/workflows/ci.yaml
 - name: Check ruff config is in sync
   run: |
-    ruff-sync check --semantic
+    ruff-sync check --semantic --output-format github
 ```
 
 With `--semantic`, minor reformatting of your local file won't cause a false positive — only actual rule or value differences will fail the check.
@@ -411,7 +412,9 @@ flowchart TD
 
 ## Dogfooding
 
-To see `ruff-sync` in action, you can ["dogfood" it on this project's own config](./scripts).
+To see `ruff-sync` in action, this project automatically "dogfoods" its own configuration. Every pull request runs a `ruff-sync check` against the repository's own `pyproject.toml` using the `--output-format github` flag, providing real-time feedback and inline annotations whenever configuration drift is detected.
+
+You can also run these checks manually or experiment with syncing:
 
 [**Check if this project is in sync with its upstream:**](./scripts/check_dogfood.sh)
 

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/codecov.yml

@@ -6,4 +6,4 @@ flag_management:
         target: auto # the default target for the project
         threshold: 75% # the default minimum threshold for the project
       - type: patch
-        target: 95%
+        target: 90%

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/docs/ci-integration.md

@@ -25,10 +25,13 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: astral-sh/setup-uv@v5
-      - run: uvx ruff-sync check --semantic
+      - name: Check Ruff Config
+        run: uvx ruff-sync check --semantic --output-format github
 ```
 
-#### Automated Sync PRs
+By using `--output-format github`, `ruff-sync` will emit special workflow commands that GitHub translates into inline annotations directly on your Pull Request's file diff.
+
+### Automated Sync PRs
 
 Instead of just checking, you can have a bot automatically open a PR when the upstream configuration changes.
 

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/docs/usage.md

@@ -165,6 +165,10 @@ ruff-sync [UPSTREAM_URL...] [--to PATH] [--exclude KEY...] [--init] [--pre-commi
 * **`--exclude KEY...`**: Dotted paths of keys to keep local and never overwrite (e.g., `lint.isort`).
 * **`--init`**: Create a new `pyproject.toml` with the upstream configuration if it doesn't already exist. This automatically saves the upstream source and any other CLI flags into the `[tool.ruff-sync]` section.
 * **`--save` / `--no-save`**: Force serialization (or prevent serialization) of the provided CLI arguments (like `upstream`, `exclude`, etc.) directly into the `[tool.ruff-sync]` section of the target `pyproject.toml` for future use. Note: any credentials present in the upstream URL will cause this operation to safely abort.
+* **`--output-format [text|json|github]`**: Specify the output format for synchronization results.
+    - `text` (default): Human-readable terminal output.
+    - `json`: Machine-readable JSON output for tool integration.
+    - `github`: GitHub Actions workflow commands (`::error`, `::warning`) for inline PR annotations.
 * **`--pre-commit`**: Sync the `astral-sh/ruff-pre-commit` hook version inside `.pre-commit-config.yaml` with the project's Ruff version.
 
 ### `check`
@@ -182,6 +186,7 @@ ruff-sync check [UPSTREAM_URL...] [--semantic] [--diff] [--pre-commit]
 * **`UPSTREAM_URL...`**: The source URL(s). Optional if defined locally.
 * **`--semantic`**: Ignore "non-functional" differences like whitespace, comments, or key order. Only errors if the actual Python-level data differs.
 * **`--diff` / `--no-diff`**: Control the display of the unified diff in the terminal.
+* **`--output-format [text|json|github]`**: Specify the output format for check results. Defaults to `text`.
 * **`--pre-commit`**: Verify that the `astral-sh/ruff-pre-commit` hook version matches the project's Ruff version in addition to checking configuration drift. If you have `pre-commit-version-sync = true` configured in your `pyproject.toml`, the `check` command will automatically respect this setting and you do not need to pass this flag.
 
 ---

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ruff-sync"
-version = "0.1.3.dev1"
+version = "0.1.3.dev2"
 description = "Synchronize Ruff linter configuration across projects"
 keywords = ["ruff", "linter", "config", "synchronize", "python", "linting", "automation", "tomlkit", "pre-commit"]
 authors = [
@@ -162,6 +162,8 @@ select = [
     "TID", # flake8-tidy-imports
     # https://docs.astral.sh/ruff/rules/#tryceratops-try
     "TRY", # tryceratops - exception handling
+    # https://docs.astral.sh/ruff/rules/#flake8-print-t20
+    "T20", # flake8-print
     # https://beta.ruff.rs/docs/rules/#pyupgrade-up
     "UP", # pyupgrade
 ]
@@ -173,8 +175,12 @@ ignore = [
 ]
 
 [tool.ruff.lint.per-file-ignores]
+"src/ruff_sync/formatters.py" = ["T20"]
+"tasks.py" = ["T20"]
 "tests/**/*.py" = [
+    "T20", # allow print in tests
     "D100", # missing docstring in module
+    "D101", # missing docstring in class
     "D103", # missing docstring in function
     "D400", # first line should end with a period
     "D401", # first line of docstring should be in imperative mood

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/src/ruff_sync/cli.py

@@ -33,6 +33,7 @@ from ruff_sync.constants import (
     DEFAULT_PATH,
     MISSING,
     MissingType,
+    OutputFormat,
     resolve_defaults,
 )
 from ruff_sync.core import (
@@ -102,6 +103,7 @@ class Arguments(NamedTuple):
     init: bool = False
     pre_commit: bool | MissingType = MISSING
     save: bool | None = None
+    output_format: OutputFormat = OutputFormat.TEXT
 
     @property
     @deprecated("Use 'to' instead")
@@ -249,6 +251,13 @@ def _get_cli_parser() -> ArgumentParser:
         default=None,
         help="Sync the pre-commit Ruff hook version with the project's Ruff version.",
     )
+    common_parser.add_argument(
+        "--output-format",
+        type=OutputFormat,
+        choices=list(OutputFormat),
+        default=OutputFormat.TEXT,
+        help="Format for output. Default: text.",
+    )
 
     # Pull subcommand (the default action)
     pull_parser = subparsers.add_parser(
@@ -433,11 +442,17 @@ def main() -> int:
         1: logging.INFO,
     }.get(args.verbose, logging.DEBUG)
 
-    LOGGER.setLevel(log_level)
-    handler = logging.StreamHandler()
-    handler.setFormatter(ColoredFormatter())
-    LOGGER.addHandler(handler)
-    LOGGER.propagate = "PYTEST_CURRENT_TEST" in os.environ  # Allow capturing in tests
+    # Configure logging for the entire ruff_sync package
+    root_logger = logging.getLogger("ruff_sync")
+    root_logger.setLevel(log_level)
+
+    # Avoid adding multiple handlers if main() is called multiple times (e.g. in tests)
+    if not root_logger.handlers:
+        handler = logging.StreamHandler()
+        handler.setFormatter(ColoredFormatter())
+        root_logger.addHandler(handler)
+
+    root_logger.propagate = "PYTEST_CURRENT_TEST" in os.environ
 
     # Determine target 'to' from CLI or use default '.'
     # Defer Path conversion to avoid pyfakefs issues with captured Path class
@@ -473,6 +488,7 @@ def main() -> int:
         init=getattr(args, "init", False),
         pre_commit=pre_commit_val,
         save=getattr(args, "save", None),
+        output_format=getattr(args, "output_format", OutputFormat.TEXT),
     )
 
     # Use the shared helper from constants so the MISSING→default logic for

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/src/ruff_sync/constants.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 import enum
 from typing import TYPE_CHECKING, Final
 
+from typing_extensions import override
+
 if TYPE_CHECKING:
     from collections.abc import Iterable
 
@@ -14,6 +16,7 @@ __all__: Final[list[str]] = [
     "DEFAULT_PATH",
     "MISSING",
     "MissingType",
+    "OutputFormat",
     "resolve_defaults",
 ]
 
@@ -42,6 +45,20 @@ class MissingType(enum.Enum):
 MISSING: Final[MissingType] = MissingType.SENTINEL
 
 
+@enum.unique
+class OutputFormat(str, enum.Enum):
+    """Output formats for the CLI."""
+
+    TEXT = "text"
+    JSON = "json"
+    GITHUB = "github"
+
+    @override
+    def __str__(self) -> str:
+        """Return the string value for argparse help."""
+        return self.value
+
+
 def resolve_defaults(
     branch: str | MissingType,
     path: str | MissingType,

{ruff_sync-0.1.3.dev1 → ruff_sync-0.1.3.dev2}/src/ruff_sync/core.py

@@ -38,6 +38,7 @@ from ruff_sync.constants import (
     MISSING,
     resolve_defaults,
 )
+from ruff_sync.formatters import ResultFormatter, get_formatter
 from ruff_sync.pre_commit import sync_pre_commit
 
 if TYPE_CHECKING:
@@ -116,6 +117,16 @@ class UpstreamError(Exception):
         super().__init__(msg)
 
 
+class DiffContext(NamedTuple):
+    """Context for printing a diff between local and merged configurations."""
+
+    source_toml_path: pathlib.Path
+    source_doc: TOMLDocument
+    merged_doc: TOMLDocument
+    source_val: Any
+    merged_val: Any
+
+
 class Config(TypedDict, total=False):
     """Configuration schema for [tool.ruff-sync] in pyproject.toml."""
 
@@ -837,25 +848,22 @@ async def _merge_multiple_upstreams(
 
 def _print_diff(
     args: Arguments,
-    source_toml_path: pathlib.Path,
-    source_doc: tomlkit.TOMLDocument,
-    merged_doc: tomlkit.TOMLDocument,
-    source_val: Any,
-    merged_val: Any,
+    fmt: ResultFormatter,
+    ctx: DiffContext,
 ) -> None:
     """Print the unified diff between the local and expected configurations."""
     if args.semantic:
         # Semantic diff of the managed section
-        from_lines = json.dumps(source_val, indent=2, sort_keys=True).splitlines(keepends=True)
-        to_lines = json.dumps(merged_val, indent=2, sort_keys=True).splitlines(keepends=True)
+        from_lines = json.dumps(ctx.source_val, indent=2, sort_keys=True).splitlines(keepends=True)
+        to_lines = json.dumps(ctx.merged_val, indent=2, sort_keys=True).splitlines(keepends=True)
         from_file = "local (semantic)"
         to_file = "upstream (semantic)"
     else:
         # Full text diff of the file
-        from_lines = source_doc.as_string().splitlines(keepends=True)
-        to_lines = merged_doc.as_string().splitlines(keepends=True)
-        from_file = f"local/{source_toml_path.name}"
-        to_file = f"upstream/{source_toml_path.name}"
+        from_lines = ctx.source_doc.as_string().splitlines(keepends=True)
+        to_lines = ctx.merged_doc.as_string().splitlines(keepends=True)
+        from_file = f"local/{ctx.source_toml_path.name}"
+        to_file = f"upstream/{ctx.source_toml_path.name}"
 
     diff = difflib.unified_diff(
         from_lines,
@@ -863,16 +871,23 @@ def _print_diff(
         fromfile=from_file,
         tofile=to_file,
     )
-    sys.stdout.writelines(diff)
+    fmt.diff("".join(diff))
 
 
-def _check_pre_commit_sync(args: Arguments) -> int | None:
+def _check_pre_commit_sync(args: Arguments, fmt: ResultFormatter) -> int | None:
     """Return exit code 2 if pre-commit hook version is out of sync, otherwise None.
 
     Shared helper to avoid duplicating the pre-commit synchronization logic.
     """
     if getattr(args, "pre_commit", False) and not sync_pre_commit(pathlib.Path.cwd(), dry_run=True):
-        print("⚠️ Pre-commit hook version is out of sync!")
+        repo_root = pathlib.Path.cwd()
+        pre_commit_config = repo_root / ".pre-commit-config.yaml"
+        file_path = pre_commit_config if pre_commit_config.exists() else repo_root
+        fmt.warning(
+            "⚠️ Pre-commit hook version is out of sync!",
+            logger=LOGGER,
+            file_path=file_path,
+        )
         return 2
     return None
 
@@ -898,13 +913,16 @@ async def check(
         ... )
         >>> # asyncio.run(check(args))
     """
-    print("🔍 Checking Ruff sync status...")
+    fmt = get_formatter(args.output_format)
+    fmt.note("🔍 Checking Ruff sync status...")
 
     _source_toml_path = resolve_target_path(args.to, args.upstream).resolve(strict=False)
     if not _source_toml_path.exists():
-        print(
+        fmt.error(
             f"❌ Configuration file {_source_toml_path} does not exist. "
-            "Run 'ruff-sync pull' to create it."
+            "Run 'ruff-sync pull' to create it.",
+            file_path=_source_toml_path,
+            logger=LOGGER,
         )
         return 1
 
@@ -939,14 +957,14 @@ async def check(
         merged_val = merged_ruff.unwrap() if merged_ruff is not None else None
 
         if source_val == merged_val:
-            print("✅ Ruff configuration is semantically in sync.")
-            exit_code = _check_pre_commit_sync(args)
+            fmt.success("✅ Ruff configuration is semantically in sync.")
+            exit_code = _check_pre_commit_sync(args, fmt)
             if exit_code is not None:
                 return exit_code
             return 0
     elif source_doc.as_string() == merged_doc.as_string():
-        print("✅ Ruff configuration is in sync.")
-        exit_code = _check_pre_commit_sync(args)
+        fmt.success("✅ Ruff configuration is in sync.")
+        exit_code = _check_pre_commit_sync(args, fmt)
         if exit_code is not None:
             return exit_code
         return 0
@@ -955,16 +973,23 @@ async def check(
         rel_path = _source_toml_path.relative_to(pathlib.Path.cwd())
     except ValueError:
         rel_path = _source_toml_path
-    print(f"❌ Ruff configuration at {rel_path} is out of sync!")
+    fmt.error(
+        f"❌ Ruff configuration at {rel_path} is out of sync!",
+        file_path=rel_path,
+        logger=LOGGER,
+    )
 
     if args.diff:
         _print_diff(
             args=args,
-            source_toml_path=_source_toml_path,
-            source_doc=source_doc,
-            merged_doc=merged_doc,
-            source_val=source_val,
-            merged_val=merged_val,
+            fmt=fmt,
+            ctx=DiffContext(
+                source_toml_path=_source_toml_path,
+                source_doc=source_doc,
+                merged_doc=merged_doc,
+                source_val=source_val,
+                merged_val=merged_val,
+            ),
         )
     return 1
 
@@ -1059,7 +1084,8 @@ async def pull(
         ... )
         >>> # asyncio.run(pull(args))
     """
-    print("🔄 Syncing Ruff...")
+    fmt = get_formatter(args.output_format)
+    fmt.note("🔄 Syncing Ruff...")
     _source_toml_path = resolve_target_path(args.to, args.upstream).resolve(strict=False)
 
     source_toml_file = TOMLFile(_source_toml_path)
@@ -1073,12 +1099,14 @@ async def pull(
             _source_toml_path.parent.mkdir(parents=True, exist_ok=True)
             _source_toml_path.touch()
         except OSError as e:
-            print(f"❌ Failed to create {_source_toml_path}: {e}", file=sys.stderr)
+            fmt.error(f"❌ Failed to create {_source_toml_path}: {e}", logger=LOGGER)
             return 1
     else:
-        print(
+        fmt.error(
             f"❌ Configuration file {_source_toml_path} does not exist. "
-            "Pass the '--init' flag to create it."
+            "Pass the '--init' flag to create it.",
+            file_path=_source_toml_path,
+            logger=LOGGER,
         )
         return 1
 
@@ -1105,7 +1133,7 @@ async def pull(
         rel_path = _source_toml_path.resolve().relative_to(pathlib.Path.cwd())
     except ValueError:
         rel_path = _source_toml_path.resolve()
-    print(f"✅ Updated {rel_path}")
+    fmt.success(f"✅ Updated {rel_path}")
 
     if args.pre_commit is not MISSING and args.pre_commit:
         sync_pre_commit(pathlib.Path.cwd(), dry_run=False)