@run-iq/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Abdou-Raouf ATARMLA
+
+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.

package/README.md

@@ -0,0 +1,114 @@
+# @run-iq/cli
+
+CLI tool for testing and debugging **Parametric Policy Engine (PPE)** rules locally.
+
+## Installation
+
+```bash
+npm install -g @run-iq/cli
+```
+
+## Commands
+
+### `run-iq evaluate`
+
+Evaluate rules against input data.
+
+```bash
+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:**
+
+```bash
+run-iq evaluate --rules ./rules.json --input ./input.json --format json
+```
+
+### `run-iq validate`
+
+Validate rule structure (required fields, checksum, types).
+
+```bash
+run-iq validate --rules rules.json [--format json|table|compact]
+```
+
+**Example:**
+
+```bash
+run-iq validate --rules ./rules.json
+```
+
+Output:
+```
+=== Rule Validation ===
+  [OK  ] rule-irpp-2024
+  [OK  ] rule-tva-2024
+  [FAIL] rule-bad
+         - checksum must be a non-empty string
+2/3 rules valid
+```
+
+## File formats
+
+### rules.json
+
+```json
+[
+  {
+    "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"
+  }
+]
+```
+
+### input.json
+
+```json
+{
+  "requestId": "req-001",
+  "data": { "grossSalary": 2500000 },
+  "meta": { "tenantId": "tenant-1" }
+}
+```
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | Evaluation or validation error |
+| 2 | File not found or parse error |
+
+## Programmatic usage
+
+```typescript
+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']);
+```
+
+## License
+
+MIT — Abdou-Raouf ATARMLA

package/bin/run-iq.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js').then((m) => m.run(process.argv));

package/dist/index.cjs

@@ -0,0 +1,285 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createCli: () => createCli,
+  formatResult: () => formatResult,
+  formatValidation: () => formatValidation,
+  loadInput: () => loadInput,
+  loadRules: () => loadRules,
+  run: () => run
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/cli.ts
+var import_commander = require("commander");
+
+// src/commands/evaluate.ts
+var import_core2 = require("@run-iq/core");
+
+// src/utils/loader.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var import_core = require("@run-iq/core");
+async function loadRules(filePath) {
+  const absolute = (0, import_node_path.resolve)(filePath);
+  const content = await (0, import_promises.readFile)(absolute, "utf-8");
+  const raw = JSON.parse(content);
+  if (!Array.isArray(raw)) {
+    throw new Error(`Rules file must contain a JSON array: ${filePath}`);
+  }
+  return (0, import_core.hydrateRules)(raw);
+}
+async function loadInput(filePath) {
+  const absolute = (0, import_node_path.resolve)(filePath);
+  const content = await (0, import_promises.readFile)(absolute, "utf-8");
+  const raw = JSON.parse(content);
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    throw new Error(`Input file must contain a JSON object: ${filePath}`);
+  }
+  const meta = raw["meta"];
+  const input = {
+    requestId: raw["requestId"],
+    data: raw["data"] ?? {},
+    meta: {
+      tenantId: meta?.["tenantId"] ?? "",
+      userId: meta?.["userId"],
+      tags: meta?.["tags"],
+      context: meta?.["context"],
+      effectiveDate: meta?.["effectiveDate"] ? new Date(meta["effectiveDate"]) : void 0
+    }
+  };
+  return input;
+}
+
+// src/utils/formatter.ts
+function formatResult(result, format) {
+  switch (format) {
+    case "json":
+      return formatJson(result);
+    case "compact":
+      return formatCompact(result);
+    case "table":
+    default:
+      return formatTable(result);
+  }
+}
+function formatJson(result) {
+  return JSON.stringify(result, null, 2);
+}
+function formatCompact(result) {
+  const parts = [
+    `requestId: ${result.requestId}`,
+    `value: ${String(result.value)}`,
+    `applied: ${result.appliedRules.length}`,
+    `skipped: ${result.skippedRules.length}`,
+    `duration: ${result.trace.totalDurationMs}ms`
+  ];
+  return parts.join(" | ");
+}
+function formatTable(result) {
+  const lines = [];
+  lines.push("=== Evaluation Result ===");
+  lines.push(`Request ID : ${result.requestId}`);
+  lines.push(`Value      : ${String(result.value)}`);
+  lines.push(`Engine     : ${result.engineVersion}`);
+  lines.push(`Duration   : ${result.trace.totalDurationMs}ms`);
+  lines.push("");
+  if (result.breakdown.length > 0) {
+    lines.push("--- Breakdown ---");
+    for (const item of result.breakdown) {
+      const label = item.label ? ` (${item.label})` : "";
+      lines.push(`  [${item.ruleId}] ${item.modelUsed}${label} => ${String(item.contribution)}`);
+    }
+    lines.push("");
+  }
+  if (result.skippedRules.length > 0) {
+    lines.push("--- Skipped ---");
+    for (const skip of result.skippedRules) {
+      lines.push(`  [${skip.rule.id}] ${skip.reason}`);
+    }
+    lines.push("");
+  }
+  if (result.trace.steps.length > 0) {
+    lines.push("--- Trace ---");
+    for (const step of result.trace.steps) {
+      const dsl = step.dslUsed ? ` (dsl: ${step.dslUsed})` : "";
+      lines.push(
+        `  [${step.ruleId}] condition=${String(step.conditionResult)} model=${step.modelUsed} => ${String(step.contribution)} (${step.durationMs}ms)${dsl}`
+      );
+    }
+  }
+  return lines.join("\n");
+}
+function formatValidation(entries, format) {
+  switch (format) {
+    case "json":
+      return JSON.stringify(entries, null, 2);
+    case "compact":
+      return entries.map((e) => `${e.ruleId}: ${e.status}`).join(" | ");
+    case "table":
+    default:
+      return formatValidationTable(entries);
+  }
+}
+function formatValidationTable(entries) {
+  const lines = ["=== Rule Validation ==="];
+  for (const entry of entries) {
+    const mark = entry.status === "OK" ? "OK  " : "FAIL";
+    lines.push(`  [${mark}] ${entry.ruleId}`);
+    if (entry.errors && entry.errors.length > 0) {
+      for (const err of entry.errors) {
+        lines.push(`         - ${err}`);
+      }
+    }
+  }
+  const passed = entries.filter((e) => e.status === "OK").length;
+  lines.push("");
+  lines.push(`${passed}/${entries.length} rules valid`);
+  return lines.join("\n");
+}
+
+// src/commands/evaluate.ts
+function registerEvaluateCommand(program, writer) {
+  program.command("evaluate").description("Evaluate rules against input data").requiredOption("--rules <path>", "Path to rules JSON file").requiredOption("--input <path>", "Path to input JSON file").option("--format <format>", "Output format: json, table, compact", "table").option("--dry-run", "Run without snapshot persistence", true).option("--strict", "Enable strict mode", false).action(
+    async (options) => {
+      try {
+        const rules = await loadRules(options.rules);
+        const input = await loadInput(options.input);
+        const engine = new import_core2.PPEEngine({
+          plugins: [],
+          dsls: [],
+          strict: options.strict,
+          dryRun: options.dryRun
+        });
+        const result = await engine.evaluate(rules, input);
+        const output = formatResult(result, options.format);
+        writer.stdout(output);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writer.stderr(`Error: ${message}`);
+        process.exitCode = isFileError(error) ? 2 : 1;
+      }
+    }
+  );
+}
+function isFileError(error) {
+  if (error instanceof Error) {
+    const code = error.code;
+    return code === "ENOENT" || code === "EACCES" || error.message.includes("JSON");
+  }
+  return false;
+}
+
+// src/commands/validate.ts
+var REQUIRED_FIELDS = [
+  "id",
+  "version",
+  "model",
+  "params",
+  "priority",
+  "effectiveFrom",
+  "tags",
+  "checksum"
+];
+function registerValidateCommand(program, writer) {
+  program.command("validate").description("Validate rule structure and checksum").requiredOption("--rules <path>", "Path to rules JSON file").option("--format <format>", "Output format: json, table, compact", "table").action(async (options) => {
+    try {
+      const rules = await loadRules(options.rules);
+      const entries = [];
+      for (const rule of rules) {
+        const errors = [];
+        for (const field of REQUIRED_FIELDS) {
+          if (rule[field] === void 0 || rule[field] === null) {
+            errors.push(`missing required field: ${field}`);
+          }
+        }
+        if (typeof rule.id !== "string" || rule.id.length === 0) {
+          errors.push("id must be a non-empty string");
+        }
+        if (typeof rule.version !== "number") {
+          errors.push("version must be a number");
+        }
+        if (typeof rule.priority !== "number") {
+          errors.push("priority must be a number");
+        }
+        if (!(rule.effectiveFrom instanceof Date) || isNaN(rule.effectiveFrom.getTime())) {
+          errors.push("effectiveFrom must be a valid date");
+        }
+        if (typeof rule.checksum !== "string" || rule.checksum.length === 0) {
+          errors.push("checksum must be a non-empty string");
+        }
+        if (!Array.isArray(rule.tags)) {
+          errors.push("tags must be an array");
+        }
+        entries.push({
+          ruleId: rule.id,
+          status: errors.length === 0 ? "OK" : "FAIL",
+          errors: errors.length > 0 ? errors : void 0
+        });
+      }
+      const output = formatValidation(entries, options.format);
+      writer.stdout(output);
+      const hasFailures = entries.some((e) => e.status === "FAIL");
+      if (hasFailures) {
+        process.exitCode = 1;
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      writer.stderr(`Error: ${message}`);
+      process.exitCode = 2;
+    }
+  });
+}
+
+// src/cli.ts
+function createCli(writer) {
+  const program = new import_commander.Command();
+  program.name("run-iq").description("CLI for the Parametric Policy Engine (PPE)").version("0.1.0");
+  registerEvaluateCommand(program, writer);
+  registerValidateCommand(program, writer);
+  return program;
+}
+
+// src/index.ts
+function run(argv) {
+  const writer = {
+    // eslint-disable-next-line no-console
+    stdout: (msg) => console.log(msg),
+    // eslint-disable-next-line no-console
+    stderr: (msg) => console.error(msg)
+  };
+  const cli = createCli(writer);
+  cli.parseAsync(argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCli,
+  formatResult,
+  formatValidation,
+  loadInput,
+  loadRules,
+  run
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cli.ts","../src/commands/evaluate.ts","../src/utils/loader.ts","../src/utils/formatter.ts","../src/commands/validate.ts"],"sourcesContent":["export { createCli } from './cli.js';\nexport type { Writer } from './utils/loader.js';\nexport type { OutputFormat, ValidationEntry } from './utils/formatter.js';\nexport { formatResult, formatValidation } from './utils/formatter.js';\nexport { loadRules, loadInput } from './utils/loader.js';\n\nimport { createCli } from './cli.js';\n\nexport function run(argv: string[]): void {\n  const writer = {\n    // eslint-disable-next-line no-console\n    stdout: (msg: string) => console.log(msg),\n    // eslint-disable-next-line no-console\n    stderr: (msg: string) => console.error(msg),\n  };\n  const cli = createCli(writer);\n  cli.parseAsync(argv).catch((err: unknown) => {\n    // eslint-disable-next-line no-console\n    console.error(err instanceof Error ? err.message : String(err));\n    process.exitCode = 1;\n  });\n}\n","import { Command } from 'commander';\nimport { registerEvaluateCommand } from './commands/evaluate.js';\nimport { registerValidateCommand } from './commands/validate.js';\nimport type { Writer } from './utils/loader.js';\n\nexport function createCli(writer: Writer): Command {\n  const program = new Command();\n\n  program.name('run-iq').description('CLI for the Parametric Policy Engine (PPE)').version('0.1.0');\n\n  registerEvaluateCommand(program, writer);\n  registerValidateCommand(program, writer);\n\n  return program;\n}\n","import type { Command } from 'commander';\nimport { PPEEngine } from '@run-iq/core';\nimport { loadRules, loadInput } from '../utils/loader.js';\nimport { formatResult } from '../utils/formatter.js';\nimport type { OutputFormat } from '../utils/formatter.js';\nimport type { Writer } from '../utils/loader.js';\n\nexport function registerEvaluateCommand(program: Command, writer: Writer): void {\n  program\n    .command('evaluate')\n    .description('Evaluate rules against input data')\n    .requiredOption('--rules <path>', 'Path to rules JSON file')\n    .requiredOption('--input <path>', 'Path to input JSON file')\n    .option('--format <format>', 'Output format: json, table, compact', 'table')\n    .option('--dry-run', 'Run without snapshot persistence', true)\n    .option('--strict', 'Enable strict mode', false)\n    .action(\n      async (options: {\n        rules: string;\n        input: string;\n        format: string;\n        dryRun: boolean;\n        strict: boolean;\n      }) => {\n        try {\n          const rules = await loadRules(options.rules);\n          const input = await loadInput(options.input);\n\n          const engine = new PPEEngine({\n            plugins: [],\n            dsls: [],\n            strict: options.strict,\n            dryRun: options.dryRun,\n          });\n\n          const result = await engine.evaluate(rules, input);\n          const output = formatResult(result, options.format as OutputFormat);\n          writer.stdout(output);\n        } catch (error) {\n          const message = error instanceof Error ? error.message : String(error);\n          writer.stderr(`Error: ${message}`);\n          process.exitCode = isFileError(error) ? 2 : 1;\n        }\n      },\n    );\n}\n\nfunction isFileError(error: unknown): boolean {\n  if (error instanceof Error) {\n    const code = (error as NodeJS.ErrnoException).code;\n    return code === 'ENOENT' || code === 'EACCES' || error.message.includes('JSON');\n  }\n  return false;\n}\n","import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { hydrateRules } from '@run-iq/core';\nimport type { Rule, EvaluationInput } from '@run-iq/core';\n\nexport interface Writer {\n  stdout(message: string): void;\n  stderr(message: string): void;\n}\n\nexport async function loadRules(filePath: string): Promise<Rule[]> {\n  const absolute = resolve(filePath);\n  const content = await readFile(absolute, 'utf-8');\n  const raw = JSON.parse(content) as Record<string, unknown>[];\n\n  if (!Array.isArray(raw)) {\n    throw new Error(`Rules file must contain a JSON array: ${filePath}`);\n  }\n\n  return hydrateRules(raw);\n}\n\nexport async function loadInput(filePath: string): Promise<EvaluationInput> {\n  const absolute = resolve(filePath);\n  const content = await readFile(absolute, 'utf-8');\n  const raw = JSON.parse(content) as Record<string, unknown>;\n\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n    throw new Error(`Input file must contain a JSON object: ${filePath}`);\n  }\n\n  const meta = raw['meta'] as Record<string, unknown> | undefined;\n\n  const input: EvaluationInput = {\n    requestId: raw['requestId'] as string,\n    data: (raw['data'] as Record<string, unknown>) ?? {},\n    meta: {\n      tenantId: (meta?.['tenantId'] as string) ?? '',\n      userId: meta?.['userId'] as string | undefined,\n      tags: meta?.['tags'] as string[] | undefined,\n      context: meta?.['context'] as Record<string, unknown> | undefined,\n      effectiveDate: meta?.['effectiveDate']\n        ? new Date(meta['effectiveDate'] as string)\n        : undefined,\n    },\n  };\n\n  return input;\n}\n","import type { EvaluationResult } from '@run-iq/core';\n\nexport type OutputFormat = 'json' | 'table' | 'compact';\n\nexport function formatResult(result: EvaluationResult, format: OutputFormat): string {\n  switch (format) {\n    case 'json':\n      return formatJson(result);\n    case 'compact':\n      return formatCompact(result);\n    case 'table':\n    default:\n      return formatTable(result);\n  }\n}\n\nfunction formatJson(result: EvaluationResult): string {\n  return JSON.stringify(result, null, 2);\n}\n\nfunction formatCompact(result: EvaluationResult): string {\n  const parts: string[] = [\n    `requestId: ${result.requestId}`,\n    `value: ${String(result.value)}`,\n    `applied: ${result.appliedRules.length}`,\n    `skipped: ${result.skippedRules.length}`,\n    `duration: ${result.trace.totalDurationMs}ms`,\n  ];\n  return parts.join(' | ');\n}\n\nfunction formatTable(result: EvaluationResult): string {\n  const lines: string[] = [];\n\n  lines.push('=== Evaluation Result ===');\n  lines.push(`Request ID : ${result.requestId}`);\n  lines.push(`Value      : ${String(result.value)}`);\n  lines.push(`Engine     : ${result.engineVersion}`);\n  lines.push(`Duration   : ${result.trace.totalDurationMs}ms`);\n  lines.push('');\n\n  if (result.breakdown.length > 0) {\n    lines.push('--- Breakdown ---');\n    for (const item of result.breakdown) {\n      const label = item.label ? ` (${item.label})` : '';\n      lines.push(`  [${item.ruleId}] ${item.modelUsed}${label} => ${String(item.contribution)}`);\n    }\n    lines.push('');\n  }\n\n  if (result.skippedRules.length > 0) {\n    lines.push('--- Skipped ---');\n    for (const skip of result.skippedRules) {\n      lines.push(`  [${skip.rule.id}] ${skip.reason}`);\n    }\n    lines.push('');\n  }\n\n  if (result.trace.steps.length > 0) {\n    lines.push('--- Trace ---');\n    for (const step of result.trace.steps) {\n      const dsl = step.dslUsed ? ` (dsl: ${step.dslUsed})` : '';\n      lines.push(\n        `  [${step.ruleId}] condition=${String(step.conditionResult)} model=${step.modelUsed} => ${String(step.contribution)} (${step.durationMs}ms)${dsl}`,\n      );\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nexport interface ValidationEntry {\n  ruleId: string;\n  status: 'OK' | 'FAIL';\n  errors?: readonly string[] | undefined;\n}\n\nexport function formatValidation(entries: ValidationEntry[], format: OutputFormat): string {\n  switch (format) {\n    case 'json':\n      return JSON.stringify(entries, null, 2);\n    case 'compact':\n      return entries.map((e) => `${e.ruleId}: ${e.status}`).join(' | ');\n    case 'table':\n    default:\n      return formatValidationTable(entries);\n  }\n}\n\nfunction formatValidationTable(entries: ValidationEntry[]): string {\n  const lines: string[] = ['=== Rule Validation ==='];\n\n  for (const entry of entries) {\n    const mark = entry.status === 'OK' ? 'OK  ' : 'FAIL';\n    lines.push(`  [${mark}] ${entry.ruleId}`);\n    if (entry.errors && entry.errors.length > 0) {\n      for (const err of entry.errors) {\n        lines.push(`         - ${err}`);\n      }\n    }\n  }\n\n  const passed = entries.filter((e) => e.status === 'OK').length;\n  lines.push('');\n  lines.push(`${passed}/${entries.length} rules valid`);\n\n  return lines.join('\\n');\n}\n","import type { Command } from 'commander';\nimport { loadRules } from '../utils/loader.js';\nimport { formatValidation } from '../utils/formatter.js';\nimport type { OutputFormat, ValidationEntry } from '../utils/formatter.js';\nimport type { Writer } from '../utils/loader.js';\n\nconst REQUIRED_FIELDS = [\n  'id',\n  'version',\n  'model',\n  'params',\n  'priority',\n  'effectiveFrom',\n  'tags',\n  'checksum',\n] as const;\n\nexport function registerValidateCommand(program: Command, writer: Writer): void {\n  program\n    .command('validate')\n    .description('Validate rule structure and checksum')\n    .requiredOption('--rules <path>', 'Path to rules JSON file')\n    .option('--format <format>', 'Output format: json, table, compact', 'table')\n    .action(async (options: { rules: string; format: string }) => {\n      try {\n        const rules = await loadRules(options.rules);\n        const entries: ValidationEntry[] = [];\n\n        for (const rule of rules) {\n          const errors: string[] = [];\n\n          for (const field of REQUIRED_FIELDS) {\n            if (rule[field] === undefined || rule[field] === null) {\n              errors.push(`missing required field: ${field}`);\n            }\n          }\n\n          if (typeof rule.id !== 'string' || rule.id.length === 0) {\n            errors.push('id must be a non-empty string');\n          }\n\n          if (typeof rule.version !== 'number') {\n            errors.push('version must be a number');\n          }\n\n          if (typeof rule.priority !== 'number') {\n            errors.push('priority must be a number');\n          }\n\n          if (!(rule.effectiveFrom instanceof Date) || isNaN(rule.effectiveFrom.getTime())) {\n            errors.push('effectiveFrom must be a valid date');\n          }\n\n          if (typeof rule.checksum !== 'string' || rule.checksum.length === 0) {\n            errors.push('checksum must be a non-empty string');\n          }\n\n          if (!Array.isArray(rule.tags)) {\n            errors.push('tags must be an array');\n          }\n\n          entries.push({\n            ruleId: rule.id,\n            status: errors.length === 0 ? 'OK' : 'FAIL',\n            errors: errors.length > 0 ? errors : undefined,\n          });\n        }\n\n        const output = formatValidation(entries, options.format as OutputFormat);\n        writer.stdout(output);\n\n        const hasFailures = entries.some((e) => e.status === 'FAIL');\n        if (hasFailures) {\n          process.exitCode = 1;\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        writer.stderr(`Error: ${message}`);\n        process.exitCode = 2;\n      }\n    });\n}\n"],"mappings":"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","names":["import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import { EvaluationInput, Rule, EvaluationResult } from '@run-iq/core';
+
+interface Writer {
+    stdout(message: string): void;
+    stderr(message: string): void;
+}
+declare function loadRules(filePath: string): Promise<Rule[]>;
+declare function loadInput(filePath: string): Promise<EvaluationInput>;
+
+declare function createCli(writer: Writer): Command;
+
+type OutputFormat = 'json' | 'table' | 'compact';
+declare function formatResult(result: EvaluationResult, format: OutputFormat): string;
+interface ValidationEntry {
+    ruleId: string;
+    status: 'OK' | 'FAIL';
+    errors?: readonly string[] | undefined;
+}
+declare function formatValidation(entries: ValidationEntry[], format: OutputFormat): string;
+
+declare function run(argv: string[]): void;
+
+export { type OutputFormat, type ValidationEntry, type Writer, createCli, formatResult, formatValidation, loadInput, loadRules, run };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import { EvaluationInput, Rule, EvaluationResult } from '@run-iq/core';
+
+interface Writer {
+    stdout(message: string): void;
+    stderr(message: string): void;
+}
+declare function loadRules(filePath: string): Promise<Rule[]>;
+declare function loadInput(filePath: string): Promise<EvaluationInput>;
+
+declare function createCli(writer: Writer): Command;
+
+type OutputFormat = 'json' | 'table' | 'compact';
+declare function formatResult(result: EvaluationResult, format: OutputFormat): string;
+interface ValidationEntry {
+    ruleId: string;
+    status: 'OK' | 'FAIL';
+    errors?: readonly string[] | undefined;
+}
+declare function formatValidation(entries: ValidationEntry[], format: OutputFormat): string;
+
+declare function run(argv: string[]): void;
+
+export { type OutputFormat, type ValidationEntry, type Writer, createCli, formatResult, formatValidation, loadInput, loadRules, run };

package/dist/index.js

@@ -0,0 +1,253 @@
+// src/cli.ts
+import { Command } from "commander";
+
+// src/commands/evaluate.ts
+import { PPEEngine } from "@run-iq/core";
+
+// src/utils/loader.ts
+import { readFile } from "fs/promises";
+import { resolve } from "path";
+import { hydrateRules } from "@run-iq/core";
+async function loadRules(filePath) {
+  const absolute = resolve(filePath);
+  const content = await readFile(absolute, "utf-8");
+  const raw = JSON.parse(content);
+  if (!Array.isArray(raw)) {
+    throw new Error(`Rules file must contain a JSON array: ${filePath}`);
+  }
+  return hydrateRules(raw);
+}
+async function loadInput(filePath) {
+  const absolute = resolve(filePath);
+  const content = await readFile(absolute, "utf-8");
+  const raw = JSON.parse(content);
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    throw new Error(`Input file must contain a JSON object: ${filePath}`);
+  }
+  const meta = raw["meta"];
+  const input = {
+    requestId: raw["requestId"],
+    data: raw["data"] ?? {},
+    meta: {
+      tenantId: meta?.["tenantId"] ?? "",
+      userId: meta?.["userId"],
+      tags: meta?.["tags"],
+      context: meta?.["context"],
+      effectiveDate: meta?.["effectiveDate"] ? new Date(meta["effectiveDate"]) : void 0
+    }
+  };
+  return input;
+}
+
+// src/utils/formatter.ts
+function formatResult(result, format) {
+  switch (format) {
+    case "json":
+      return formatJson(result);
+    case "compact":
+      return formatCompact(result);
+    case "table":
+    default:
+      return formatTable(result);
+  }
+}
+function formatJson(result) {
+  return JSON.stringify(result, null, 2);
+}
+function formatCompact(result) {
+  const parts = [
+    `requestId: ${result.requestId}`,
+    `value: ${String(result.value)}`,
+    `applied: ${result.appliedRules.length}`,
+    `skipped: ${result.skippedRules.length}`,
+    `duration: ${result.trace.totalDurationMs}ms`
+  ];
+  return parts.join(" | ");
+}
+function formatTable(result) {
+  const lines = [];
+  lines.push("=== Evaluation Result ===");
+  lines.push(`Request ID : ${result.requestId}`);
+  lines.push(`Value      : ${String(result.value)}`);
+  lines.push(`Engine     : ${result.engineVersion}`);
+  lines.push(`Duration   : ${result.trace.totalDurationMs}ms`);
+  lines.push("");
+  if (result.breakdown.length > 0) {
+    lines.push("--- Breakdown ---");
+    for (const item of result.breakdown) {
+      const label = item.label ? ` (${item.label})` : "";
+      lines.push(`  [${item.ruleId}] ${item.modelUsed}${label} => ${String(item.contribution)}`);
+    }
+    lines.push("");
+  }
+  if (result.skippedRules.length > 0) {
+    lines.push("--- Skipped ---");
+    for (const skip of result.skippedRules) {
+      lines.push(`  [${skip.rule.id}] ${skip.reason}`);
+    }
+    lines.push("");
+  }
+  if (result.trace.steps.length > 0) {
+    lines.push("--- Trace ---");
+    for (const step of result.trace.steps) {
+      const dsl = step.dslUsed ? ` (dsl: ${step.dslUsed})` : "";
+      lines.push(
+        `  [${step.ruleId}] condition=${String(step.conditionResult)} model=${step.modelUsed} => ${String(step.contribution)} (${step.durationMs}ms)${dsl}`
+      );
+    }
+  }
+  return lines.join("\n");
+}
+function formatValidation(entries, format) {
+  switch (format) {
+    case "json":
+      return JSON.stringify(entries, null, 2);
+    case "compact":
+      return entries.map((e) => `${e.ruleId}: ${e.status}`).join(" | ");
+    case "table":
+    default:
+      return formatValidationTable(entries);
+  }
+}
+function formatValidationTable(entries) {
+  const lines = ["=== Rule Validation ==="];
+  for (const entry of entries) {
+    const mark = entry.status === "OK" ? "OK  " : "FAIL";
+    lines.push(`  [${mark}] ${entry.ruleId}`);
+    if (entry.errors && entry.errors.length > 0) {
+      for (const err of entry.errors) {
+        lines.push(`         - ${err}`);
+      }
+    }
+  }
+  const passed = entries.filter((e) => e.status === "OK").length;
+  lines.push("");
+  lines.push(`${passed}/${entries.length} rules valid`);
+  return lines.join("\n");
+}
+
+// src/commands/evaluate.ts
+function registerEvaluateCommand(program, writer) {
+  program.command("evaluate").description("Evaluate rules against input data").requiredOption("--rules <path>", "Path to rules JSON file").requiredOption("--input <path>", "Path to input JSON file").option("--format <format>", "Output format: json, table, compact", "table").option("--dry-run", "Run without snapshot persistence", true).option("--strict", "Enable strict mode", false).action(
+    async (options) => {
+      try {
+        const rules = await loadRules(options.rules);
+        const input = await loadInput(options.input);
+        const engine = new PPEEngine({
+          plugins: [],
+          dsls: [],
+          strict: options.strict,
+          dryRun: options.dryRun
+        });
+        const result = await engine.evaluate(rules, input);
+        const output = formatResult(result, options.format);
+        writer.stdout(output);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writer.stderr(`Error: ${message}`);
+        process.exitCode = isFileError(error) ? 2 : 1;
+      }
+    }
+  );
+}
+function isFileError(error) {
+  if (error instanceof Error) {
+    const code = error.code;
+    return code === "ENOENT" || code === "EACCES" || error.message.includes("JSON");
+  }
+  return false;
+}
+
+// src/commands/validate.ts
+var REQUIRED_FIELDS = [
+  "id",
+  "version",
+  "model",
+  "params",
+  "priority",
+  "effectiveFrom",
+  "tags",
+  "checksum"
+];
+function registerValidateCommand(program, writer) {
+  program.command("validate").description("Validate rule structure and checksum").requiredOption("--rules <path>", "Path to rules JSON file").option("--format <format>", "Output format: json, table, compact", "table").action(async (options) => {
+    try {
+      const rules = await loadRules(options.rules);
+      const entries = [];
+      for (const rule of rules) {
+        const errors = [];
+        for (const field of REQUIRED_FIELDS) {
+          if (rule[field] === void 0 || rule[field] === null) {
+            errors.push(`missing required field: ${field}`);
+          }
+        }
+        if (typeof rule.id !== "string" || rule.id.length === 0) {
+          errors.push("id must be a non-empty string");
+        }
+        if (typeof rule.version !== "number") {
+          errors.push("version must be a number");
+        }
+        if (typeof rule.priority !== "number") {
+          errors.push("priority must be a number");
+        }
+        if (!(rule.effectiveFrom instanceof Date) || isNaN(rule.effectiveFrom.getTime())) {
+          errors.push("effectiveFrom must be a valid date");
+        }
+        if (typeof rule.checksum !== "string" || rule.checksum.length === 0) {
+          errors.push("checksum must be a non-empty string");
+        }
+        if (!Array.isArray(rule.tags)) {
+          errors.push("tags must be an array");
+        }
+        entries.push({
+          ruleId: rule.id,
+          status: errors.length === 0 ? "OK" : "FAIL",
+          errors: errors.length > 0 ? errors : void 0
+        });
+      }
+      const output = formatValidation(entries, options.format);
+      writer.stdout(output);
+      const hasFailures = entries.some((e) => e.status === "FAIL");
+      if (hasFailures) {
+        process.exitCode = 1;
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      writer.stderr(`Error: ${message}`);
+      process.exitCode = 2;
+    }
+  });
+}
+
+// src/cli.ts
+function createCli(writer) {
+  const program = new Command();
+  program.name("run-iq").description("CLI for the Parametric Policy Engine (PPE)").version("0.1.0");
+  registerEvaluateCommand(program, writer);
+  registerValidateCommand(program, writer);
+  return program;
+}
+
+// src/index.ts
+function run(argv) {
+  const writer = {
+    // eslint-disable-next-line no-console
+    stdout: (msg) => console.log(msg),
+    // eslint-disable-next-line no-console
+    stderr: (msg) => console.error(msg)
+  };
+  const cli = createCli(writer);
+  cli.parseAsync(argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+  });
+}
+export {
+  createCli,
+  formatResult,
+  formatValidation,
+  loadInput,
+  loadRules,
+  run
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/commands/evaluate.ts","../src/utils/loader.ts","../src/utils/formatter.ts","../src/commands/validate.ts","../src/index.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { registerEvaluateCommand } from './commands/evaluate.js';\nimport { registerValidateCommand } from './commands/validate.js';\nimport type { Writer } from './utils/loader.js';\n\nexport function createCli(writer: Writer): Command {\n  const program = new Command();\n\n  program.name('run-iq').description('CLI for the Parametric Policy Engine (PPE)').version('0.1.0');\n\n  registerEvaluateCommand(program, writer);\n  registerValidateCommand(program, writer);\n\n  return program;\n}\n","import type { Command } from 'commander';\nimport { PPEEngine } from '@run-iq/core';\nimport { loadRules, loadInput } from '../utils/loader.js';\nimport { formatResult } from '../utils/formatter.js';\nimport type { OutputFormat } from '../utils/formatter.js';\nimport type { Writer } from '../utils/loader.js';\n\nexport function registerEvaluateCommand(program: Command, writer: Writer): void {\n  program\n    .command('evaluate')\n    .description('Evaluate rules against input data')\n    .requiredOption('--rules <path>', 'Path to rules JSON file')\n    .requiredOption('--input <path>', 'Path to input JSON file')\n    .option('--format <format>', 'Output format: json, table, compact', 'table')\n    .option('--dry-run', 'Run without snapshot persistence', true)\n    .option('--strict', 'Enable strict mode', false)\n    .action(\n      async (options: {\n        rules: string;\n        input: string;\n        format: string;\n        dryRun: boolean;\n        strict: boolean;\n      }) => {\n        try {\n          const rules = await loadRules(options.rules);\n          const input = await loadInput(options.input);\n\n          const engine = new PPEEngine({\n            plugins: [],\n            dsls: [],\n            strict: options.strict,\n            dryRun: options.dryRun,\n          });\n\n          const result = await engine.evaluate(rules, input);\n          const output = formatResult(result, options.format as OutputFormat);\n          writer.stdout(output);\n        } catch (error) {\n          const message = error instanceof Error ? error.message : String(error);\n          writer.stderr(`Error: ${message}`);\n          process.exitCode = isFileError(error) ? 2 : 1;\n        }\n      },\n    );\n}\n\nfunction isFileError(error: unknown): boolean {\n  if (error instanceof Error) {\n    const code = (error as NodeJS.ErrnoException).code;\n    return code === 'ENOENT' || code === 'EACCES' || error.message.includes('JSON');\n  }\n  return false;\n}\n","import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { hydrateRules } from '@run-iq/core';\nimport type { Rule, EvaluationInput } from '@run-iq/core';\n\nexport interface Writer {\n  stdout(message: string): void;\n  stderr(message: string): void;\n}\n\nexport async function loadRules(filePath: string): Promise<Rule[]> {\n  const absolute = resolve(filePath);\n  const content = await readFile(absolute, 'utf-8');\n  const raw = JSON.parse(content) as Record<string, unknown>[];\n\n  if (!Array.isArray(raw)) {\n    throw new Error(`Rules file must contain a JSON array: ${filePath}`);\n  }\n\n  return hydrateRules(raw);\n}\n\nexport async function loadInput(filePath: string): Promise<EvaluationInput> {\n  const absolute = resolve(filePath);\n  const content = await readFile(absolute, 'utf-8');\n  const raw = JSON.parse(content) as Record<string, unknown>;\n\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n    throw new Error(`Input file must contain a JSON object: ${filePath}`);\n  }\n\n  const meta = raw['meta'] as Record<string, unknown> | undefined;\n\n  const input: EvaluationInput = {\n    requestId: raw['requestId'] as string,\n    data: (raw['data'] as Record<string, unknown>) ?? {},\n    meta: {\n      tenantId: (meta?.['tenantId'] as string) ?? '',\n      userId: meta?.['userId'] as string | undefined,\n      tags: meta?.['tags'] as string[] | undefined,\n      context: meta?.['context'] as Record<string, unknown> | undefined,\n      effectiveDate: meta?.['effectiveDate']\n        ? new Date(meta['effectiveDate'] as string)\n        : undefined,\n    },\n  };\n\n  return input;\n}\n","import type { EvaluationResult } from '@run-iq/core';\n\nexport type OutputFormat = 'json' | 'table' | 'compact';\n\nexport function formatResult(result: EvaluationResult, format: OutputFormat): string {\n  switch (format) {\n    case 'json':\n      return formatJson(result);\n    case 'compact':\n      return formatCompact(result);\n    case 'table':\n    default:\n      return formatTable(result);\n  }\n}\n\nfunction formatJson(result: EvaluationResult): string {\n  return JSON.stringify(result, null, 2);\n}\n\nfunction formatCompact(result: EvaluationResult): string {\n  const parts: string[] = [\n    `requestId: ${result.requestId}`,\n    `value: ${String(result.value)}`,\n    `applied: ${result.appliedRules.length}`,\n    `skipped: ${result.skippedRules.length}`,\n    `duration: ${result.trace.totalDurationMs}ms`,\n  ];\n  return parts.join(' | ');\n}\n\nfunction formatTable(result: EvaluationResult): string {\n  const lines: string[] = [];\n\n  lines.push('=== Evaluation Result ===');\n  lines.push(`Request ID : ${result.requestId}`);\n  lines.push(`Value      : ${String(result.value)}`);\n  lines.push(`Engine     : ${result.engineVersion}`);\n  lines.push(`Duration   : ${result.trace.totalDurationMs}ms`);\n  lines.push('');\n\n  if (result.breakdown.length > 0) {\n    lines.push('--- Breakdown ---');\n    for (const item of result.breakdown) {\n      const label = item.label ? ` (${item.label})` : '';\n      lines.push(`  [${item.ruleId}] ${item.modelUsed}${label} => ${String(item.contribution)}`);\n    }\n    lines.push('');\n  }\n\n  if (result.skippedRules.length > 0) {\n    lines.push('--- Skipped ---');\n    for (const skip of result.skippedRules) {\n      lines.push(`  [${skip.rule.id}] ${skip.reason}`);\n    }\n    lines.push('');\n  }\n\n  if (result.trace.steps.length > 0) {\n    lines.push('--- Trace ---');\n    for (const step of result.trace.steps) {\n      const dsl = step.dslUsed ? ` (dsl: ${step.dslUsed})` : '';\n      lines.push(\n        `  [${step.ruleId}] condition=${String(step.conditionResult)} model=${step.modelUsed} => ${String(step.contribution)} (${step.durationMs}ms)${dsl}`,\n      );\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nexport interface ValidationEntry {\n  ruleId: string;\n  status: 'OK' | 'FAIL';\n  errors?: readonly string[] | undefined;\n}\n\nexport function formatValidation(entries: ValidationEntry[], format: OutputFormat): string {\n  switch (format) {\n    case 'json':\n      return JSON.stringify(entries, null, 2);\n    case 'compact':\n      return entries.map((e) => `${e.ruleId}: ${e.status}`).join(' | ');\n    case 'table':\n    default:\n      return formatValidationTable(entries);\n  }\n}\n\nfunction formatValidationTable(entries: ValidationEntry[]): string {\n  const lines: string[] = ['=== Rule Validation ==='];\n\n  for (const entry of entries) {\n    const mark = entry.status === 'OK' ? 'OK  ' : 'FAIL';\n    lines.push(`  [${mark}] ${entry.ruleId}`);\n    if (entry.errors && entry.errors.length > 0) {\n      for (const err of entry.errors) {\n        lines.push(`         - ${err}`);\n      }\n    }\n  }\n\n  const passed = entries.filter((e) => e.status === 'OK').length;\n  lines.push('');\n  lines.push(`${passed}/${entries.length} rules valid`);\n\n  return lines.join('\\n');\n}\n","import type { Command } from 'commander';\nimport { loadRules } from '../utils/loader.js';\nimport { formatValidation } from '../utils/formatter.js';\nimport type { OutputFormat, ValidationEntry } from '../utils/formatter.js';\nimport type { Writer } from '../utils/loader.js';\n\nconst REQUIRED_FIELDS = [\n  'id',\n  'version',\n  'model',\n  'params',\n  'priority',\n  'effectiveFrom',\n  'tags',\n  'checksum',\n] as const;\n\nexport function registerValidateCommand(program: Command, writer: Writer): void {\n  program\n    .command('validate')\n    .description('Validate rule structure and checksum')\n    .requiredOption('--rules <path>', 'Path to rules JSON file')\n    .option('--format <format>', 'Output format: json, table, compact', 'table')\n    .action(async (options: { rules: string; format: string }) => {\n      try {\n        const rules = await loadRules(options.rules);\n        const entries: ValidationEntry[] = [];\n\n        for (const rule of rules) {\n          const errors: string[] = [];\n\n          for (const field of REQUIRED_FIELDS) {\n            if (rule[field] === undefined || rule[field] === null) {\n              errors.push(`missing required field: ${field}`);\n            }\n          }\n\n          if (typeof rule.id !== 'string' || rule.id.length === 0) {\n            errors.push('id must be a non-empty string');\n          }\n\n          if (typeof rule.version !== 'number') {\n            errors.push('version must be a number');\n          }\n\n          if (typeof rule.priority !== 'number') {\n            errors.push('priority must be a number');\n          }\n\n          if (!(rule.effectiveFrom instanceof Date) || isNaN(rule.effectiveFrom.getTime())) {\n            errors.push('effectiveFrom must be a valid date');\n          }\n\n          if (typeof rule.checksum !== 'string' || rule.checksum.length === 0) {\n            errors.push('checksum must be a non-empty string');\n          }\n\n          if (!Array.isArray(rule.tags)) {\n            errors.push('tags must be an array');\n          }\n\n          entries.push({\n            ruleId: rule.id,\n            status: errors.length === 0 ? 'OK' : 'FAIL',\n            errors: errors.length > 0 ? errors : undefined,\n          });\n        }\n\n        const output = formatValidation(entries, options.format as OutputFormat);\n        writer.stdout(output);\n\n        const hasFailures = entries.some((e) => e.status === 'FAIL');\n        if (hasFailures) {\n          process.exitCode = 1;\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        writer.stderr(`Error: ${message}`);\n        process.exitCode = 2;\n      }\n    });\n}\n","export { createCli } from './cli.js';\nexport type { Writer } from './utils/loader.js';\nexport type { OutputFormat, ValidationEntry } from './utils/formatter.js';\nexport { formatResult, formatValidation } from './utils/formatter.js';\nexport { loadRules, loadInput } from './utils/loader.js';\n\nimport { createCli } from './cli.js';\n\nexport function run(argv: string[]): void {\n  const writer = {\n    // eslint-disable-next-line no-console\n    stdout: (msg: string) => console.log(msg),\n    // eslint-disable-next-line no-console\n    stderr: (msg: string) => console.error(msg),\n  };\n  const cli = createCli(writer);\n  cli.parseAsync(argv).catch((err: unknown) => {\n    // eslint-disable-next-line no-console\n    console.error(err instanceof Error ? err.message : String(err));\n    process.exitCode = 1;\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@run-iq/cli",
+  "version": "0.1.0",
+  "description": "PPE — CLI tool for testing and debugging Parametric Policy Engine rules",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "run-iq": "./bin/run-iq.js"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": ["dist", "bin"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ tests/ && prettier --check src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix && prettier --write src/ tests/",
+    "prepublishOnly": "npm run build && npm run typecheck && npm test && npm run lint"
+  },
+  "keywords": ["ppe", "policy-engine", "rules-engine", "parametric", "cli"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Run-IQ/cli.git"
+  },
+  "homepage": "https://github.com/Run-IQ/cli#readme",
+  "bugs": {
+    "url": "https://github.com/Run-IQ/cli/issues"
+  },
+  "author": "Abdou-Raouf ATARMLA",
+  "license": "MIT",
+  "dependencies": {
+    "@run-iq/core": "^0.1.2",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.3.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}