grai-gate 0.2.0__tar.gz

grai_gate-0.2.0/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 grai
+
+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.
+
+The paid cockpit at grai.page is a separate product and is not covered by
+this license.

grai_gate-0.2.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: grai-gate
+Version: 0.2.0
+Summary: Deterministic style linter for markdown written by coding agents
+Author-email: Adrian Peticila <adrian@grai.page>
+License: MIT
+Project-URL: Homepage, https://grai.page?utm_source=pypi&utm_medium=gate&utm_campaign=gate_v0.1#developer
+Project-URL: Repository, https://github.com/adrianpeticila/grai-gate-action
+Project-URL: Issues, https://github.com/adrianpeticila/grai-gate-action/issues
+Keywords: markdown,linter,style-linter,ai-slop,writing,cadence
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# grai-gate
+
+[![Marketplace](https://img.shields.io/badge/marketplace-grai--gate-6f42c1)](https://github.com/marketplace/actions/grai-gate)
+[![PyPI](https://img.shields.io/pypi/v/grai-gate)](https://pypi.org/project/grai-gate/)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen)](https://github.com/adrianpeticila/grai-gate-action)
+
+Deterministic style gate for markdown written by coding agents. One Python
+engine, no model calls, no network. It scores sentence burstiness and flags
+structural patterns that survive spellcheck. It is a style gate, not an
+authorship detector.
+
+On the v2 corpus (58 human-edited docs, 63 model-generated docs), the gate
+flagged 7 of 63 model docs and 3 of 58 human docs. It catches visible patterns,
+not provenance. Full report: [VALIDATION.md](./VALIDATION.md).
+
+## GitHub Action
+
+```yaml
+name: cadence
+on:
+  pull_request:
+    paths: ['**.md', '**.mdx', '**.txt']
+jobs:
+  gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: adrianpeticila/grai-gate-action@v0.2.0
+        with:
+          fail-on-slop: "false"
+```
+
+The action scores only files changed in the pull request. It fetches the base
+ref itself, so a shallow checkout is fine. The default is advisory: the card
+lands in the log and the job stays green. Set `fail-on-slop: "true"` to block.
+
+Inputs: `path` (scan target when no pull request base is available),
+`fail-on-slop`, `verbose`.
+
+## Python package
+
+```bash
+pipx run grai-gate README.md
+```
+
+or
+
+```bash
+pip install grai-gate
+grai-gate docs/
+```
+
+Exit codes: 0 clean, 1 slop, 2 input error. The CLI accepts `-h` and `--help`.
+
+## pre-commit
+
+```yaml
+repos:
+  - repo: https://github.com/adrianpeticila/grai-gate-action
+    rev: v0.2.0
+    hooks:
+      - id: grai-gate
+```
+
+The hook scores markdown, mdx, and plain text. It exits 1 on slop and stops the
+commit. Skip one commit with `SKIP=grai-gate git commit`.
+
+## One engine
+
+`src/grai_gate/gate.py` is vendored byte-for-byte from the Antigravity plugin
+in the grai repo. Run `python scripts/sync_engine.py --check` to prove the
+copies match; it exits 1 on drift.
+
+## UTM attribution
+
+The report card links to the Pro Cockpit. Attribution resolves from
+`GRAI_UTM_SOURCE`, then `GITHUB_ACTIONS`, then `PRE_COMMIT`. The installed PyPI
+command defaults to `pypi`; a direct engine run defaults to `cli`.

grai_gate-0.2.0/README.md

@@ -0,0 +1,78 @@
+# grai-gate
+
+[![Marketplace](https://img.shields.io/badge/marketplace-grai--gate-6f42c1)](https://github.com/marketplace/actions/grai-gate)
+[![PyPI](https://img.shields.io/pypi/v/grai-gate)](https://pypi.org/project/grai-gate/)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen)](https://github.com/adrianpeticila/grai-gate-action)
+
+Deterministic style gate for markdown written by coding agents. One Python
+engine, no model calls, no network. It scores sentence burstiness and flags
+structural patterns that survive spellcheck. It is a style gate, not an
+authorship detector.
+
+On the v2 corpus (58 human-edited docs, 63 model-generated docs), the gate
+flagged 7 of 63 model docs and 3 of 58 human docs. It catches visible patterns,
+not provenance. Full report: [VALIDATION.md](./VALIDATION.md).
+
+## GitHub Action
+
+```yaml
+name: cadence
+on:
+  pull_request:
+    paths: ['**.md', '**.mdx', '**.txt']
+jobs:
+  gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: adrianpeticila/grai-gate-action@v0.2.0
+        with:
+          fail-on-slop: "false"
+```
+
+The action scores only files changed in the pull request. It fetches the base
+ref itself, so a shallow checkout is fine. The default is advisory: the card
+lands in the log and the job stays green. Set `fail-on-slop: "true"` to block.
+
+Inputs: `path` (scan target when no pull request base is available),
+`fail-on-slop`, `verbose`.
+
+## Python package
+
+```bash
+pipx run grai-gate README.md
+```
+
+or
+
+```bash
+pip install grai-gate
+grai-gate docs/
+```
+
+Exit codes: 0 clean, 1 slop, 2 input error. The CLI accepts `-h` and `--help`.
+
+## pre-commit
+
+```yaml
+repos:
+  - repo: https://github.com/adrianpeticila/grai-gate-action
+    rev: v0.2.0
+    hooks:
+      - id: grai-gate
+```
+
+The hook scores markdown, mdx, and plain text. It exits 1 on slop and stops the
+commit. Skip one commit with `SKIP=grai-gate git commit`.
+
+## One engine
+
+`src/grai_gate/gate.py` is vendored byte-for-byte from the Antigravity plugin
+in the grai repo. Run `python scripts/sync_engine.py --check` to prove the
+copies match; it exits 1 on drift.
+
+## UTM attribution
+
+The report card links to the Pro Cockpit. Attribution resolves from
+`GRAI_UTM_SOURCE`, then `GITHUB_ACTIONS`, then `PRE_COMMIT`. The installed PyPI
+command defaults to `pypi`; a direct engine run defaults to `cli`.

grai_gate-0.2.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "grai-gate"
+version = "0.2.0"
+description = "Deterministic style linter for markdown written by coding agents"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Adrian Peticila", email = "adrian@grai.page" }]
+keywords = ["markdown", "linter", "style-linter", "ai-slop", "writing", "cadence"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Software Development :: Quality Assurance",
+  "Topic :: Text Processing :: Markup :: Markdown",
+]
+
+[project.urls]
+Homepage = "https://grai.page?utm_source=pypi&utm_medium=gate&utm_campaign=gate_v0.1#developer"
+Repository = "https://github.com/adrianpeticila/grai-gate-action"
+Issues = "https://github.com/adrianpeticila/grai-gate-action/issues"
+
+[project.scripts]
+grai-gate = "grai_gate.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

grai_gate-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

grai_gate-0.2.0/src/grai_gate/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

grai_gate-0.2.0/src/grai_gate/cli.py

@@ -0,0 +1,20 @@
+"""Console entry point for the grai-gate package."""
+
+import os
+import sys
+
+from . import gate
+
+
+def main():
+    if (
+        not os.environ.get("GRAI_UTM_SOURCE")
+        and not os.environ.get("GITHUB_ACTIONS")
+        and not os.environ.get("PRE_COMMIT")
+    ):
+        os.environ["GRAI_UTM_SOURCE"] = "pypi"
+    return gate.main()
+
+
+if __name__ == "__main__":
+    sys.exit(main())