Metadata-Version: 2.4
Name: rulestamp-payroll-deduction-code-audit
Version: 1.0.5
Summary: Twelve rules over the deduction-code map, before the January 31 W-2 filing date (bundled Node.js runtime)
Author-email: Rulestamp <support@getreadystack.com>
License: Proprietary - see LICENSE.txt
Project-URL: Homepage, https://getreadystack.com/tools/payroll-deduction-code-audit?ref=pypi
Project-URL: Documentation, https://getreadystack.com/tools/payroll-deduction-code-audit?ref=pypi
Project-URL: Support, https://getreadystack.com/support
Keywords: payroll,deduction code,W-2 Box 12,pre-tax,HRIS,csv lint,plan year
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

# Payroll Deduction Code Audit 2026

> 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.

![Payroll Deduction Code Audit 2026 — finds the line](https://getreadystack.com/img/promo/payroll-deduction-code-audit_demo.gif)

Twelve rules over the deduction-code map, before the January 31 W-2 filing date

## Install

```
payroll-deduction-code-audit file
```

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

## Free

- Every deduction code in the open map is audited against twelve rules and each broken line is named with its line number.
- `--rules` lists every rule

## With a licence ($29 once)

- Audits every deduction map in the workspace at once and writes a dated exposure report you keep as the payroll audit trail.

```
payroll-deduction-code-audit --dir ./templates --report html --out report.html
```

Hand-checking one deduction map against the IRS Box 12 letter list is about half a day of a payroll analyst's time, every plan year

## Use from an AI agent (MCP)

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

```json
{ "mcpServers": { "payroll-deduction-code-audit": { "command": "payroll-deduction-code-audit", "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: Payroll Deduction Code Audit 2026
  run: pip install rulestamp-payroll-deduction-code-audit && payroll-deduction-code-audit --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_nAgRlEvSuB50Wdx5AxIH3jJ7eqwgOTIAwUFRk26gtYC)


<!-- payroll deduction code audit -->


## Install (PyPI)

```
pip install rulestamp-payroll-deduction-code-audit
payroll-deduction-code-audit --help
```
