@promptscore/cli 0.1.1

package/dist/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import {
+  analyze,
+  createDefaultRegistry,
+  format,
+  ProfileLoader
+} from "@promptscore/core";
+var program = new Command();
+program.name("promptscore").description("Static analysis for LLM prompts \u2014 ESLint, but for prompts.").version("0.1.1");
+program.command("analyze").description("Analyze a prompt and print a report").argument("[file]", "path to a prompt file").option("-i, --inline <prompt>", "analyze an inline prompt string").option("-m, --model <model>", "model profile name (e.g. claude, gpt)", "_base").option("-f, --format <format>", "output format: text, json, markdown", "text").option("-r, --rules <rules>", "comma-separated rule ids to include").option("--llm", "include LLM-powered rules (requires API key)", false).option("--no-color", "disable colored output").action(async (file, opts) => {
+  try {
+    const prompt = await resolvePromptInput(file, opts.inline);
+    if (!prompt) {
+      process.stderr.write("No prompt provided. Pass a file path or use --inline.\n");
+      process.exit(1);
+    }
+    const only = opts.rules ? String(opts.rules).split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+    const report = await analyze(prompt, {
+      model: opts.model,
+      only,
+      includeLlm: Boolean(opts.llm)
+    });
+    const fmt = normalizeFormat(opts.format);
+    const output = format(report, fmt, { color: opts.color !== false });
+    process.stdout.write(output + "\n");
+    const hasErrors = report.results.some((r) => !r.passed && r.severity === "error");
+    process.exit(hasErrors ? 1 : 0);
+  } catch (err) {
+    printError(err);
+    process.exit(2);
+  }
+});
+program.command("rules").description("List all available rules").option("-f, --format <format>", "output format: text, json", "text").action((opts) => {
+  const registry = createDefaultRegistry();
+  const rules = registry.all();
+  if (opts.format === "json") {
+    process.stdout.write(JSON.stringify(rules.map(stripRuleCheck), null, 2) + "\n");
+    return;
+  }
+  for (const rule of rules) {
+    process.stdout.write(`${rule.id}  [${rule.category}, ${rule.defaultSeverity}]
+`);
+    process.stdout.write(`  ${rule.description}
+
+`);
+  }
+});
+program.command("profiles").description("List available profiles").action(async () => {
+  try {
+    const loader = new ProfileLoader();
+    const names = await loader.list();
+    for (const name of names) {
+      const profile = await loader.load(name);
+      process.stdout.write(`${profile.name}  ${profile.displayName}
+`);
+    }
+  } catch (err) {
+    printError(err);
+    process.exit(2);
+  }
+});
+async function resolvePromptInput(file, inline) {
+  if (inline) return inline;
+  if (file) {
+    if (!existsSync(file)) {
+      throw new Error(`File not found: ${file}`);
+    }
+    return readFile(file, "utf8");
+  }
+  if (!process.stdin.isTTY) {
+    return readStdin();
+  }
+  return void 0;
+}
+async function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      data += chunk;
+    });
+    process.stdin.on("end", () => resolve(data));
+    process.stdin.on("error", reject);
+  });
+}
+function normalizeFormat(input) {
+  if (input === "json" || input === "markdown" || input === "text") return input;
+  return "text";
+}
+function stripRuleCheck(rule) {
+  const { check: _check, ...rest } = rule;
+  return rest;
+}
+function printError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  process.stderr.write(`error: ${msg}
+`);
+}
+program.parseAsync(process.argv).catch((err) => {
+  printError(err);
+  process.exit(2);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { readFile } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport {\n  analyze,\n  createDefaultRegistry,\n  format,\n  ProfileLoader,\n  type ReportFormat,\n} from '@promptscore/core';\n\nconst program = new Command();\n\nprogram\n  .name('promptscore')\n  .description('Static analysis for LLM prompts — ESLint, but for prompts.')\n  .version('0.1.1');\n\nprogram\n  .command('analyze')\n  .description('Analyze a prompt and print a report')\n  .argument('[file]', 'path to a prompt file')\n  .option('-i, --inline <prompt>', 'analyze an inline prompt string')\n  .option('-m, --model <model>', 'model profile name (e.g. claude, gpt)', '_base')\n  .option('-f, --format <format>', 'output format: text, json, markdown', 'text')\n  .option('-r, --rules <rules>', 'comma-separated rule ids to include')\n  .option('--llm', 'include LLM-powered rules (requires API key)', false)\n  .option('--no-color', 'disable colored output')\n  .action(async (file: string | undefined, opts) => {\n    try {\n      const prompt = await resolvePromptInput(file, opts.inline);\n      if (!prompt) {\n        process.stderr.write('No prompt provided. Pass a file path or use --inline.\\n');\n        process.exit(1);\n      }\n\n      const only = opts.rules\n        ? String(opts.rules)\n            .split(',')\n            .map((s) => s.trim())\n            .filter(Boolean)\n        : undefined;\n\n      const report = await analyze(prompt, {\n        model: opts.model,\n        only,\n        includeLlm: Boolean(opts.llm),\n      });\n\n      const fmt = normalizeFormat(opts.format);\n      const output = format(report, fmt, { color: opts.color !== false });\n      process.stdout.write(output + '\\n');\n\n      const hasErrors = report.results.some((r) => !r.passed && r.severity === 'error');\n      process.exit(hasErrors ? 1 : 0);\n    } catch (err) {\n      printError(err);\n      process.exit(2);\n    }\n  });\n\nprogram\n  .command('rules')\n  .description('List all available rules')\n  .option('-f, --format <format>', 'output format: text, json', 'text')\n  .action((opts) => {\n    const registry = createDefaultRegistry();\n    const rules = registry.all();\n    if (opts.format === 'json') {\n      process.stdout.write(JSON.stringify(rules.map(stripRuleCheck), null, 2) + '\\n');\n      return;\n    }\n    for (const rule of rules) {\n      process.stdout.write(`${rule.id}  [${rule.category}, ${rule.defaultSeverity}]\\n`);\n      process.stdout.write(`  ${rule.description}\\n\\n`);\n    }\n  });\n\nprogram\n  .command('profiles')\n  .description('List available profiles')\n  .action(async () => {\n    try {\n      const loader = new ProfileLoader();\n      const names = await loader.list();\n      for (const name of names) {\n        const profile = await loader.load(name);\n        process.stdout.write(`${profile.name}  ${profile.displayName}\\n`);\n      }\n    } catch (err) {\n      printError(err);\n      process.exit(2);\n    }\n  });\n\nasync function resolvePromptInput(\n  file: string | undefined,\n  inline: string | undefined,\n): Promise<string | undefined> {\n  if (inline) return inline;\n  if (file) {\n    if (!existsSync(file)) {\n      throw new Error(`File not found: ${file}`);\n    }\n    return readFile(file, 'utf8');\n  }\n  // Try reading from stdin if piped\n  if (!process.stdin.isTTY) {\n    return readStdin();\n  }\n  return undefined;\n}\n\nasync function readStdin(): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    process.stdin.setEncoding('utf8');\n    process.stdin.on('data', (chunk) => {\n      data += chunk;\n    });\n    process.stdin.on('end', () => resolve(data));\n    process.stdin.on('error', reject);\n  });\n}\n\nfunction normalizeFormat(input: string): ReportFormat {\n  if (input === 'json' || input === 'markdown' || input === 'text') return input;\n  return 'text';\n}\n\nfunction stripRuleCheck<T extends { check: unknown }>(rule: T): Omit<T, 'check'> {\n  const { check: _check, ...rest } = rule;\n  return rest;\n}\n\nfunction printError(err: unknown): void {\n  const msg = err instanceof Error ? err.message : String(err);\n  process.stderr.write(`error: ${msg}\\n`);\n}\n\nprogram.parseAsync(process.argv).catch((err) => {\n  printError(err);\n  process.exit(2);\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@promptscore/cli",
+  "version": "0.1.1",
+  "description": "CLI for PromptScore — static analysis for LLM prompts.",
+  "license": "MIT",
+  "author": "Riccardo Merenda",
+  "homepage": "https://promptscore.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/riccardomerenda/promptscore.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "llm",
+    "prompt",
+    "prompt-engineering",
+    "cli",
+    "linter"
+  ],
+  "type": "module",
+  "bin": {
+    "promptscore": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rimraf dist .turbo"
+  },
+  "dependencies": {
+    "@promptscore/core": "^0.1.1",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}