Fix PyPI readiness issues from final review

- Replace Mermaid diagram with ASCII art (PyPI doesn't render Mermaid)
- Convert relative links to absolute GitHub URLs in README
- Remove dead --deterministic-only CLI flag and its test
- Add missing classifiers (OS Independent, Python 3 :: Only)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: roli-lpci

README.md

@@ -1,6 +1,6 @@
 # PyGate
 
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/roli-lpci/pygate/blob/main/LICENSE)
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![CI](https://github.com/roli-lpci/pygate/actions/workflows/ci.yml/badge.svg)](https://github.com/roli-lpci/pygate/actions/workflows/ci.yml)
 
@@ -41,6 +41,8 @@ pygate summarize --input .pygate/failures.json
 pygate repair --input .pygate/failures.json --max-attempts 3
 ```
 
+> **Note:** The PyPI package is `pygate-ci` but the CLI command is `pygate`.
+
 ## What It Does
 
 PyGate runs deterministic quality gates on your Python project and produces structured, machine-readable artifacts designed for both humans and AI agents.
@@ -55,15 +57,18 @@ PyGate runs deterministic quality gates on your Python project and produces stru
 
 ### How It Works
 
-```mermaid
-flowchart LR
-    A[Changed Files] --> B[Run Gates]
-    B --> C{Findings?}
-    C -- No --> D[Pass ✓]
-    C -- Yes --> E[Repair Loop]
-    E --> F{Improved?}
-    F -- Fixed --> D
-    F -- No --> G[Escalate with Evidence]
+```
+Changed Files ──> Run Gates ──> Findings? ──No──> Pass
+                                    |
+                                   Yes
+                                    |
+                                    v
+                              Repair Loop ──> Improved? ──Fixed──> Pass
+                                                  |
+                                                  No
+                                                  |
+                                                  v
+                                        Escalate with Evidence
 ```
 
 1. You tell PyGate which files changed (from your CI diff, PR, etc.)
@@ -82,8 +87,6 @@ pygate repair --input .pygate/failures.json [--max-attempts N]
 
 **Exit codes:** `0` = pass, `1` = fail (`run`), `2` = escalated (`repair`)
 
-> **Note:** The PyPI package is `pygate-ci` but the CLI command is `pygate`.
-
 ## Artifacts
 
 All artifacts are written to `.pygate/`:
@@ -97,7 +100,7 @@ All artifacts are written to `.pygate/`:
 | `repair-report.json` | Repair attempt history (on success) |
 | `escalation.json` | Escalation reason and evidence (on failure) |
 
-JSON Schema files for all artifact types are available in [`schemas/`](schemas/) for downstream validation and code generation. See [`demo/artifacts/`](demo/artifacts/) for sample output.
+JSON Schema files for all artifact types are available in [`schemas/`](https://github.com/roli-lpci/pygate/tree/main/schemas) for downstream validation and code generation. See [`demo/artifacts/`](https://github.com/roli-lpci/pygate/tree/main/demo/artifacts) for sample output.
 
 ## Repair Loop
 
@@ -197,8 +200,8 @@ The action detects changed files from the PR, runs gates, optionally repairs, an
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+See [CONTRIBUTING.md](https://github.com/roli-lpci/pygate/blob/main/CONTRIBUTING.md) for development setup and guidelines.
 
 ## License
 
-[Apache 2.0](LICENSE)
+[Apache 2.0](https://github.com/roli-lpci/pygate/blob/main/LICENSE)

pyproject.toml

@@ -21,7 +21,9 @@ classifiers = [
     "Environment :: Console",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",

src/pygate/cli.py

@@ -36,12 +36,6 @@ def _build_parser() -> argparse.ArgumentParser:
     rep_p = sub.add_parser("repair", help="Run bounded repair loop")
     rep_p.add_argument("--input", required=True, help="Path to failures.json")
     rep_p.add_argument("--max-attempts", type=int, default=None, help="Maximum repair attempts")
-    rep_p.add_argument(
-        "--deterministic-only",
-        action="store_true",
-        default=False,
-        help="Only apply deterministic fixes (skip model-assisted repair)",
-    )
 
     return parser
 

tests/test_edge_cases.py

@@ -206,20 +206,6 @@ def test_repair_with_max_attempts_flag(self, mock_repair, tmp_path: Path):
         assert exc.value.code == 0
         assert mock_repair.call_args.kwargs["max_attempts"] == 5
 
-    @patch("pygate.cli.execute_repair")
-    def test_repair_deterministic_only_flag_accepted(self, mock_repair, tmp_path: Path):
-        mock_repair.return_value = {"status": "pass", "attempts": []}
-        with pytest.raises(SystemExit) as exc:
-            main(
-                [
-                    "repair",
-                    "--input",
-                    str(tmp_path / "f.json"),
-                    "--deterministic-only",
-                ]
-            )
-        assert exc.value.code == 0
-
     def test_invalid_mode_rejected(self):
         with pytest.raises(SystemExit) as exc:
             main(["run", "--mode", "invalid", "--changed-files", "f.txt"])