@criterionx/cli 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Tomas Maritano
+
+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,80 @@
+# @criterionx/cli
+
+CLI for scaffolding Criterion decisions.
+
+## Installation
+
+```bash
+npm install -g @criterionx/cli
+# or
+npx @criterionx/cli
+```
+
+## Commands
+
+### `criterion init`
+
+Initialize a new Criterion project with example decision.
+
+```bash
+criterion init
+criterion init --dir my-project
+criterion init --no-install
+```
+
+Creates:
+- `package.json` with dependencies
+- `tsconfig.json` configured for ESM
+- `src/decisions/transaction-risk.ts` - Example decision
+- `src/index.ts` - Example usage
+
+### `criterion new decision <name>`
+
+Generate a new decision boilerplate.
+
+```bash
+criterion new decision user-eligibility
+criterion new decision LoanApproval
+criterion new decision "payment risk" --dir src/decisions
+```
+
+Creates a decision file with:
+- Input/output/profile schemas
+- Default rule
+- TODO comments for customization
+
+### `criterion new profile <name>`
+
+Generate a new profile template.
+
+```bash
+criterion new profile us-standard
+criterion new profile eu-premium
+```
+
+### `criterion list` (coming soon)
+
+List all decisions in the project.
+
+### `criterion validate` (coming soon)
+
+Validate all decisions in the project.
+
+## Example Workflow
+
+```bash
+# 1. Create new project
+criterion init --dir my-decisions
+cd my-decisions
+
+# 2. Generate decisions
+criterion new decision loan-approval
+criterion new decision fraud-detection
+
+# 3. Run your code
+npx tsx src/index.ts
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,641 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/init.ts
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+import pc from "picocolors";
+var PACKAGE_JSON = `{
+  "name": "my-criterion-project",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@criterionx/core": "^0.3.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  }
+}`;
+var TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"]
+}`;
+var EXAMPLE_DECISION = `import { defineDecision } from "@criterionx/core";
+import { z } from "zod";
+
+/**
+ * Example: Transaction Risk Decision
+ *
+ * Evaluates the risk level of a transaction based on amount and profile thresholds.
+ */
+export const transactionRisk = defineDecision({
+  id: "transaction-risk",
+  version: "1.0.0",
+
+  inputSchema: z.object({
+    amount: z.number().positive(),
+    currency: z.string().length(3),
+  }),
+
+  outputSchema: z.object({
+    risk: z.enum(["HIGH", "MEDIUM", "LOW"]),
+    reason: z.string(),
+  }),
+
+  profileSchema: z.object({
+    highThreshold: z.number(),
+    mediumThreshold: z.number(),
+  }),
+
+  rules: [
+    {
+      id: "high-risk",
+      when: (input, profile) => input.amount > profile.highThreshold,
+      emit: () => ({ risk: "HIGH", reason: "Amount exceeds high threshold" }),
+      explain: (input, profile) =>
+        \`Amount \${input.amount} > \${profile.highThreshold}\`,
+    },
+    {
+      id: "medium-risk",
+      when: (input, profile) => input.amount > profile.mediumThreshold,
+      emit: () => ({ risk: "MEDIUM", reason: "Amount exceeds medium threshold" }),
+      explain: (input, profile) =>
+        \`Amount \${input.amount} > \${profile.mediumThreshold}\`,
+    },
+    {
+      id: "low-risk",
+      when: () => true,
+      emit: () => ({ risk: "LOW", reason: "Amount within acceptable range" }),
+      explain: () => "Default: amount within limits",
+    },
+  ],
+});
+`;
+var EXAMPLE_MAIN = `import { Engine } from "@criterionx/core";
+import { transactionRisk } from "./decisions/transaction-risk.js";
+
+const engine = new Engine();
+
+// Example: Evaluate a transaction
+const result = engine.run(
+  transactionRisk,
+  { amount: 15000, currency: "USD" },
+  { profile: { highThreshold: 10000, mediumThreshold: 5000 } }
+);
+
+console.log("Status:", result.status);
+console.log("Data:", result.data);
+console.log("\\nExplanation:");
+console.log(engine.explain(result));
+`;
+async function initCommand(options) {
+  const targetDir = path.resolve(options.dir);
+  console.log(pc.cyan("\\n\u{1F3AF} Initializing Criterion project...\\n"));
+  const dirs = [
+    targetDir,
+    path.join(targetDir, "src"),
+    path.join(targetDir, "src", "decisions")
+  ];
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+      console.log(pc.green("  \u2713"), pc.dim("Created"), dir);
+    }
+  }
+  const files = [
+    { path: path.join(targetDir, "package.json"), content: PACKAGE_JSON },
+    { path: path.join(targetDir, "tsconfig.json"), content: TSCONFIG },
+    {
+      path: path.join(targetDir, "src", "decisions", "transaction-risk.ts"),
+      content: EXAMPLE_DECISION
+    },
+    { path: path.join(targetDir, "src", "index.ts"), content: EXAMPLE_MAIN }
+  ];
+  for (const file of files) {
+    if (!fs.existsSync(file.path)) {
+      fs.writeFileSync(file.path, file.content);
+      console.log(pc.green("  \u2713"), pc.dim("Created"), file.path);
+    } else {
+      console.log(pc.yellow("  \u26A0"), pc.dim("Exists"), file.path);
+    }
+  }
+  if (options.install) {
+    console.log(pc.cyan("\\n\u{1F4E6} Installing dependencies...\\n"));
+    try {
+      execSync("npm install", { cwd: targetDir, stdio: "inherit" });
+    } catch {
+      console.log(pc.yellow("\\n\u26A0 Failed to install dependencies. Run 'npm install' manually."));
+    }
+  }
+  console.log(pc.green("\\n\u2705 Project initialized!\\n"));
+  console.log("Next steps:");
+  console.log(pc.dim("  cd " + (options.dir === "." ? "." : options.dir)));
+  if (!options.install) {
+    console.log(pc.dim("  npm install"));
+  }
+  console.log(pc.dim("  npx tsx src/index.ts"));
+  console.log();
+}
+
+// src/commands/new.ts
+import fs2 from "fs";
+import path2 from "path";
+import pc2 from "picocolors";
+function toKebabCase(str) {
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+}
+function toPascalCase(str) {
+  return str.split(/[-_\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+}
+function toCamelCase(str) {
+  const pascal = toPascalCase(str);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function generateDecision(name) {
+  const id = toKebabCase(name);
+  const varName = toCamelCase(name);
+  return `import { defineDecision } from "@criterionx/core";
+import { z } from "zod";
+
+/**
+ * ${toPascalCase(name)} Decision
+ *
+ * TODO: Add description
+ */
+export const ${varName} = defineDecision({
+  id: "${id}",
+  version: "1.0.0",
+
+  inputSchema: z.object({
+    // TODO: Define input schema
+    value: z.string(),
+  }),
+
+  outputSchema: z.object({
+    // TODO: Define output schema
+    result: z.string(),
+  }),
+
+  profileSchema: z.object({
+    // TODO: Define profile schema (parameters that can vary)
+  }),
+
+  rules: [
+    {
+      id: "default",
+      when: () => true,
+      emit: () => ({ result: "OK" }),
+      explain: () => "Default rule",
+    },
+  ],
+});
+`;
+}
+function generateProfile(name) {
+  const varName = toCamelCase(name) + "Profile";
+  return `/**
+ * ${toPascalCase(name)} Profile
+ *
+ * Profiles parameterize decisions without changing logic.
+ * Create different profiles for different regions, tiers, or environments.
+ */
+export const ${varName} = {
+  // TODO: Define profile values
+  // These should match the profileSchema of your decision
+};
+
+// Example: Multiple profiles for different contexts
+// export const ${varName}US = { threshold: 10000 };
+// export const ${varName}EU = { threshold: 8000 };
+`;
+}
+async function newCommand(type, name, options) {
+  const validTypes = ["decision", "profile"];
+  if (!validTypes.includes(type)) {
+    console.log(pc2.red(`\\n\u274C Invalid type: ${type}`));
+    console.log(pc2.dim(`   Valid types: ${validTypes.join(", ")}\\n`));
+    process.exit(1);
+  }
+  const fileName = toKebabCase(name) + ".ts";
+  const targetDir = path2.resolve(options.dir);
+  const filePath = path2.join(targetDir, fileName);
+  console.log(pc2.cyan(`\\n\u{1F3AF} Generating ${type}: ${name}\\n`));
+  if (!fs2.existsSync(targetDir)) {
+    fs2.mkdirSync(targetDir, { recursive: true });
+    console.log(pc2.green("  \u2713"), pc2.dim("Created directory"), targetDir);
+  }
+  if (fs2.existsSync(filePath)) {
+    console.log(pc2.red(`\\n\u274C File already exists: ${filePath}\\n`));
+    process.exit(1);
+  }
+  let content;
+  switch (type) {
+    case "decision":
+      content = generateDecision(name);
+      break;
+    case "profile":
+      content = generateProfile(name);
+      break;
+    default:
+      throw new Error(`Unknown type: ${type}`);
+  }
+  fs2.writeFileSync(filePath, content);
+  console.log(pc2.green("  \u2713"), pc2.dim("Created"), filePath);
+  console.log(pc2.green(`\\n\u2705 ${toPascalCase(type)} created!\\n`));
+  console.log("Next steps:");
+  console.log(pc2.dim(`  1. Edit ${filePath}`));
+  console.log(pc2.dim(`  2. Define your schemas and rules`));
+  console.log(pc2.dim(`  3. Import and use in your application\\n`));
+}
+
+// src/commands/list.ts
+import fs3 from "fs";
+import path3 from "path";
+import pc3 from "picocolors";
+function findDecisionFiles(dir) {
+  const files = [];
+  function walk(currentDir) {
+    if (!fs3.existsSync(currentDir)) return;
+    const entries = fs3.readdirSync(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path3.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === "node_modules" || entry.name === "dist" || entry.name.startsWith(".")) {
+          continue;
+        }
+        walk(fullPath);
+      } else if (entry.isFile() && entry.name.endsWith(".ts") && !entry.name.endsWith(".test.ts")) {
+        files.push(fullPath);
+      }
+    }
+  }
+  walk(dir);
+  return files;
+}
+function isDecisionFile(content) {
+  return content.includes("defineDecision") && content.includes("@criterionx/core");
+}
+function extractDecisionInfo(content, filePath) {
+  const defineDecisionMatch = content.match(/defineDecision\s*\(\s*\{/);
+  if (!defineDecisionMatch) {
+    return null;
+  }
+  const startPos = defineDecisionMatch.index;
+  const blockEnd = findBlockEnd(content, startPos);
+  const block = content.slice(startPos, blockEnd);
+  const idMatch = block.match(/id\s*:\s*["'`]([^"'`]+)["'`]/);
+  const id = idMatch ? idMatch[1] : "unknown";
+  const versionMatch = block.match(/version\s*:\s*["'`]([^"'`]+)["'`]/);
+  const version = versionMatch ? versionMatch[1] : "unknown";
+  const rulesMatch = block.match(/rules\s*:\s*\[/);
+  let rulesCount = 0;
+  if (rulesMatch) {
+    const rulesStart = rulesMatch.index + rulesMatch[0].length;
+    const rulesEnd = findArrayEnd(block, rulesMatch.index);
+    const rulesBlock = block.slice(rulesStart, rulesEnd);
+    const ruleMatches = rulesBlock.match(/\{\s*id\s*:/g);
+    rulesCount = ruleMatches ? ruleMatches.length : 0;
+  }
+  return { file: filePath, id, version, rulesCount };
+}
+function findBlockEnd(text, start) {
+  let depth = 0;
+  let inString = false;
+  let stringChar = "";
+  for (let i = start; i < text.length; i++) {
+    const char = text[i];
+    const prevChar = i > 0 ? text[i - 1] : "";
+    if (inString) {
+      if (char === stringChar && prevChar !== "\\") {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === '"' || char === "'" || char === "`") {
+      inString = true;
+      stringChar = char;
+      continue;
+    }
+    if (char === "{") {
+      depth++;
+    } else if (char === "}") {
+      depth--;
+      if (depth === 0) {
+        return i + 1;
+      }
+    }
+  }
+  return text.length;
+}
+function findArrayEnd(text, start) {
+  let depth = 0;
+  let inString = false;
+  let stringChar = "";
+  for (let i = start; i < text.length; i++) {
+    const char = text[i];
+    const prevChar = i > 0 ? text[i - 1] : "";
+    if (inString) {
+      if (char === stringChar && prevChar !== "\\") {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === '"' || char === "'" || char === "`") {
+      inString = true;
+      stringChar = char;
+      continue;
+    }
+    if (char === "[") {
+      depth++;
+    } else if (char === "]") {
+      depth--;
+      if (depth === 0) {
+        return i;
+      }
+    }
+  }
+  return text.length;
+}
+async function listCommand(options) {
+  const targetDir = path3.resolve(options.dir);
+  if (!fs3.existsSync(targetDir)) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "Directory not found", decisions: [] }));
+    } else {
+      console.log(pc3.red(`
+\u274C Directory not found: ${targetDir}
+`));
+    }
+    process.exit(1);
+  }
+  const files = findDecisionFiles(targetDir);
+  const decisions = [];
+  for (const file of files) {
+    const content = fs3.readFileSync(file, "utf-8");
+    if (!isDecisionFile(content)) {
+      continue;
+    }
+    const info = extractDecisionInfo(content, file);
+    if (info) {
+      decisions.push(info);
+    }
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ decisions }, null, 2));
+    return;
+  }
+  if (decisions.length === 0) {
+    console.log(pc3.yellow("\n\u26A0 No decisions found in"), pc3.dim(targetDir));
+    console.log(pc3.dim("  Decisions should import from '@criterionx/core' and use defineDecision()"));
+    console.log();
+    return;
+  }
+  console.log(pc3.cyan("\n\u{1F4CB} Criterion Decisions\n"));
+  const maxIdLen = Math.max(...decisions.map((d) => d.id.length), 2);
+  const maxVersionLen = Math.max(...decisions.map((d) => d.version.length), 7);
+  console.log(
+    pc3.dim("  ") + pc3.bold("ID".padEnd(maxIdLen + 2)) + pc3.bold("VERSION".padEnd(maxVersionLen + 2)) + pc3.bold("RULES".padEnd(7)) + pc3.bold("FILE")
+  );
+  console.log(pc3.dim("  " + "\u2500".repeat(60)));
+  for (const decision of decisions) {
+    const relativePath = path3.relative(targetDir, decision.file);
+    console.log(
+      pc3.dim("  ") + pc3.green(decision.id.padEnd(maxIdLen + 2)) + pc3.cyan(decision.version.padEnd(maxVersionLen + 2)) + String(decision.rulesCount).padEnd(7) + pc3.dim(relativePath)
+    );
+  }
+  console.log();
+  console.log(pc3.dim(`  Found ${decisions.length} decision(s)`));
+  console.log();
+}
+
+// src/commands/validate.ts
+import fs4 from "fs";
+import path4 from "path";
+import pc4 from "picocolors";
+function findDecisionFiles2(dir) {
+  const files = [];
+  function walk(currentDir) {
+    if (!fs4.existsSync(currentDir)) return;
+    const entries = fs4.readdirSync(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path4.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === "node_modules" || entry.name === "dist" || entry.name.startsWith(".")) {
+          continue;
+        }
+        walk(fullPath);
+      } else if (entry.isFile() && entry.name.endsWith(".ts") && !entry.name.endsWith(".test.ts")) {
+        files.push(fullPath);
+      }
+    }
+  }
+  walk(dir);
+  return files;
+}
+function isDecisionFile2(content) {
+  return content.includes("defineDecision") && content.includes("@criterionx/core");
+}
+function validateDecision(content, filePath) {
+  const errors = [];
+  const warnings = [];
+  const defineDecisionMatch = content.match(/defineDecision\s*\(\s*\{/);
+  if (!defineDecisionMatch) {
+    return null;
+  }
+  const startPos = defineDecisionMatch.index;
+  const blockEnd = findBlockEnd2(content, startPos);
+  const block = content.slice(startPos, blockEnd);
+  const requiredProps = [
+    { prop: "id:", message: "Missing required 'id' property" },
+    { prop: "version:", message: "Missing required 'version' property" },
+    { prop: "inputSchema:", message: "Missing required 'inputSchema' property" },
+    { prop: "outputSchema:", message: "Missing required 'outputSchema' property" },
+    { prop: "profileSchema:", message: "Missing required 'profileSchema' property" },
+    { prop: "rules:", message: "Missing required 'rules' property" }
+  ];
+  for (const { prop, message } of requiredProps) {
+    if (!block.includes(prop)) {
+      errors.push(message);
+    }
+  }
+  if (/rules\s*:\s*\[\s*\]/.test(block)) {
+    warnings.push("Decision has empty rules array");
+  }
+  const rulesMatch = block.match(/rules\s*:\s*\[/);
+  if (rulesMatch) {
+    const rulesStart = rulesMatch.index + rulesMatch[0].length;
+    const rulesEnd = findArrayEnd2(block, rulesMatch.index);
+    const rulesBlock = block.slice(rulesStart, rulesEnd);
+    const ruleRegex = /\{\s*id\s*:/g;
+    let ruleMatch;
+    while ((ruleMatch = ruleRegex.exec(rulesBlock)) !== null) {
+      const ruleStart = ruleMatch.index;
+      const ruleEnd = findBlockEnd2(rulesBlock, ruleStart);
+      const rule = rulesBlock.slice(ruleStart, ruleEnd);
+      const idMatch = rule.match(/id\s*:\s*["'`]([^"'`]+)["'`]/);
+      const ruleId = idMatch ? idMatch[1] : "unknown";
+      const requiredFunctions = ["when:", "emit:", "explain:"];
+      for (const func of requiredFunctions) {
+        if (!rule.includes(func)) {
+          errors.push(`Rule '${ruleId}' missing required '${func.replace(":", "")}' function`);
+        }
+      }
+    }
+  }
+  if (errors.length === 0 && warnings.length === 0) {
+    return null;
+  }
+  return { file: filePath, errors, warnings };
+}
+function findBlockEnd2(text, start) {
+  let depth = 0;
+  let inString = false;
+  let stringChar = "";
+  for (let i = start; i < text.length; i++) {
+    const char = text[i];
+    const prevChar = i > 0 ? text[i - 1] : "";
+    if (inString) {
+      if (char === stringChar && prevChar !== "\\") {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === '"' || char === "'" || char === "`") {
+      inString = true;
+      stringChar = char;
+      continue;
+    }
+    if (char === "{") {
+      depth++;
+    } else if (char === "}") {
+      depth--;
+      if (depth === 0) {
+        return i + 1;
+      }
+    }
+  }
+  return text.length;
+}
+function findArrayEnd2(text, start) {
+  let depth = 0;
+  let inString = false;
+  let stringChar = "";
+  for (let i = start; i < text.length; i++) {
+    const char = text[i];
+    const prevChar = i > 0 ? text[i - 1] : "";
+    if (inString) {
+      if (char === stringChar && prevChar !== "\\") {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === '"' || char === "'" || char === "`") {
+      inString = true;
+      stringChar = char;
+      continue;
+    }
+    if (char === "[") {
+      depth++;
+    } else if (char === "]") {
+      depth--;
+      if (depth === 0) {
+        return i;
+      }
+    }
+  }
+  return text.length;
+}
+async function validateCommand(options) {
+  const targetDir = path4.resolve(options.dir);
+  console.log(pc4.cyan("\n\u{1F50D} Validating Criterion decisions...\n"));
+  if (!fs4.existsSync(targetDir)) {
+    console.log(pc4.red(`
+\u274C Directory not found: ${targetDir}
+`));
+    process.exit(1);
+  }
+  const files = findDecisionFiles2(targetDir);
+  if (files.length === 0) {
+    console.log(pc4.yellow("  No TypeScript files found in"), pc4.dim(targetDir));
+    console.log();
+    return;
+  }
+  let decisionsFound = 0;
+  let decisionsValid = 0;
+  const validationErrors = [];
+  for (const file of files) {
+    const content = fs4.readFileSync(file, "utf-8");
+    if (!isDecisionFile2(content)) {
+      continue;
+    }
+    decisionsFound++;
+    const result = validateDecision(content, file);
+    if (result) {
+      validationErrors.push(result);
+    } else {
+      decisionsValid++;
+      const relativePath = path4.relative(targetDir, file);
+      console.log(pc4.green("  \u2713"), pc4.dim(relativePath));
+    }
+  }
+  if (validationErrors.length > 0) {
+    console.log();
+    for (const result of validationErrors) {
+      const relativePath = path4.relative(targetDir, result.file);
+      console.log(pc4.red("  \u2717"), pc4.dim(relativePath));
+      for (const error of result.errors) {
+        console.log(pc4.red("    \u2192"), error);
+      }
+      for (const warning of result.warnings) {
+        console.log(pc4.yellow("    \u2192"), warning);
+      }
+    }
+  }
+  console.log();
+  if (decisionsFound === 0) {
+    console.log(pc4.yellow("\u26A0 No decisions found in"), pc4.dim(targetDir));
+    console.log(pc4.dim("  Decisions should import from '@criterionx/core' and use defineDecision()"));
+  } else if (validationErrors.length === 0) {
+    console.log(pc4.green(`\u2705 All ${decisionsFound} decision(s) are valid!`));
+  } else {
+    const errorCount = validationErrors.reduce((sum, e) => sum + e.errors.length, 0);
+    const warningCount = validationErrors.reduce((sum, e) => sum + e.warnings.length, 0);
+    console.log(
+      pc4.red(`\u274C Found issues in ${validationErrors.length} of ${decisionsFound} decision(s)`)
+    );
+    if (errorCount > 0) {
+      console.log(pc4.red(`   ${errorCount} error(s)`));
+    }
+    if (warningCount > 0) {
+      console.log(pc4.yellow(`   ${warningCount} warning(s)`));
+    }
+    process.exit(1);
+  }
+  console.log();
+}
+
+// src/index.ts
+var program = new Command();
+program.name("criterion").description("CLI for scaffolding and managing Criterion decisions").version("0.3.1");
+program.command("init").description("Initialize a new Criterion project").option("-d, --dir <directory>", "Target directory", ".").option("--no-install", "Skip npm install").action(initCommand);
+program.command("new").description("Generate new Criterion components").argument("<type>", "Type to generate (decision, profile)").argument("<name>", "Name of the component").option("-d, --dir <directory>", "Target directory", "src/decisions").action(newCommand);
+program.command("list").description("List all decisions in the project").option("-d, --dir <directory>", "Directory to search", ".").option("--json", "Output as JSON").action(listCommand);
+program.command("validate").description("Validate all decisions in the project").option("-d, --dir <directory>", "Directory to validate", ".").action(validateCommand);
+program.parse();

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@criterionx/cli",
+  "version": "0.3.1",
+  "description": "CLI for scaffolding Criterion decisions",
+  "type": "module",
+  "bin": {
+    "criterion": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "criterion",
+    "cli",
+    "decision-engine",
+    "scaffolding",
+    "generator"
+  ],
+  "author": {
+    "name": "Tomas Maritano",
+    "url": "https://github.com/tomymaritano"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tomymaritano/criterionx.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/tomymaritano/criterionx/issues"
+  },
+  "homepage": "https://github.com/tomymaritano/criterionx#readme",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "picocolors": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  }
+}