CLI tool for testing and debugging Parametric Policy Engine (PPE) rules locally.
npm install -g @run-iq/cliEvaluate rules against input data.
run-iq evaluate --rules rules.json --input input.json [--format json|table|compact] [--dry-run] [--strict]Options:
| Option | Default | Description |
|---|---|---|
--rules <path> |
required | Path to rules JSON file |
--input <path> |
required | Path to input JSON file |
--format <fmt> |
table |
Output format: json, table, compact |
--dry-run |
true |
Run without snapshot persistence |
--strict |
false |
Enable strict mode |
Example:
run-iq evaluate --rules ./rules.json --input ./input.json --format jsonValidate rule structure (required fields, checksum, types).
run-iq validate --rules rules.json [--format json|table|compact]Example:
run-iq validate --rules ./rules.jsonOutput:
=== Rule Validation ===
[OK ] rule-irpp-2024
[OK ] rule-tva-2024
[FAIL] rule-bad
- checksum must be a non-empty string
2/3 rules valid
[
{
"id": "rule-1",
"version": 1,
"model": "FLAT_RATE",
"params": { "rate": 0.18, "base": "grossSalary" },
"priority": 1,
"effectiveFrom": "2024-01-01T00:00:00.000Z",
"effectiveUntil": null,
"tags": ["togo"],
"checksum": "abc123"
}
]{
"requestId": "req-001",
"data": { "grossSalary": 2500000 },
"meta": { "tenantId": "tenant-1" }
}| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Evaluation or validation error |
| 2 | File not found or parse error |
import { createCli } from '@run-iq/cli';
const cli = createCli({
stdout: (msg) => console.log(msg),
stderr: (msg) => console.error(msg),
});
await cli.parseAsync(['node', 'run-iq', 'evaluate', '--rules', 'r.json', '--input', 'i.json']);MIT — Abdou-Raouf ATARMLA
