Metadata-Version: 2.4
Name: rulestamp-wp-plugin-review-gate
Version: 1.0.7
Summary: The readme.txt and plugin-header lines that send a wordpress.org submission back, found before you submit (bundled Node.js runtime)
Author-email: Rulestamp <support@getreadystack.com>
License: Proprietary - see LICENSE.txt
Project-URL: Homepage, https://getreadystack.com/tools/wp-plugin-review-gate?ref=pypi
Project-URL: Documentation, https://getreadystack.com/tools/wp-plugin-review-gate?ref=pypi
Project-URL: Support, https://getreadystack.com/support
Keywords: wordpress,plugin,readme.txt,stable tag,plugin review,wordpress.org,linter
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: nodejs-wheel-binaries>=20
Dynamic: license-file

# WP Plugin Review Gate

> Runs the same checker as our npm package on a Node.js runtime that pip installs for you (`nodejs-wheel-binaries`) - no system Node.js needed. Your files are checked locally.

![WordPress Plugin Review Gate - wp.org pre-submission check — finds the line](https://getreadystack.com/img/promo/wp-plugin-review-gate_demo.gif)

The readme.txt and plugin-header lines that send a wordpress.org submission back, found before you submit

## Install

```
wp-plugin-review-gate file
```

Node 18+. The same 21 rules as the VS Code extension, from a terminal or CI.

## Free

- Checks the readme.txt or main plugin PHP file you have open against 21 rules and prints every blocker with its line number and the exact replacement line. On the sample readme.txt shipped with it, 6 blockers: Stable tag: trunk, no Requires PHP, Tested up to: 6.8.2 carrying a patch number, Tested up to 6.8 older than Requires at least 6.9, a short description of 179 characters against the 150-character cut, and a missing License URI.
- `--rules` lists every rule

## With a licence ($29 once)

- Sweeps the whole plugin folder in one pass - readme.txt read against the plugin header, Stable tag against Version across files - and exports a dated submission report you keep. $29 once, one licence key per person or team seat.

```
wp-plugin-review-gate --dir ./templates --report html --out report.html
```

A freelance WordPress developer bills $30 to $90 an hour; a pre-submission read is an hour or two.

## Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

```json
{ "mcpServers": { "wp-plugin-review-gate": { "command": "wp-plugin-review-gate", "args": ["--mcp"] } } }
```

Tools: `check_text` and `check_file` (free) · `check_dir` (licence). The agent gets every finding with the line number.

## Use in CI

```yaml
- name: WP Plugin Review Gate
  run: pip install rulestamp-wp-plugin-review-gate && wp-plugin-review-gate --dir . --ci
```


The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set `READYSTACK_LICENSE=<key>` or run `--license <key>` once.

[Get a licence](https://getreadystack.com/api/buy/cl/polar_cl_qArF3mNB1PwK3Pdmu8u0XW9Y9cxzGW2ytS3iq05dr5h)


<!-- wp plugin review gate -->


## Install (PyPI)

```
pip install rulestamp-wp-plugin-review-gate
wp-plugin-review-gate --help
```
