@cejel/cejel 0.1.1 → 0.1.3

package/dist/index.js

@@ -5,10 +5,10 @@ import {
   renderWitanBadgeSvg,
   renderWitanHtmlReport,
   runCejelScan
-} from "./chunk-H5T65GGS.js";
+} from "./chunk-QQVCIG4N.js";
 
 // src/index.ts
-import { mkdirSync, realpathSync, writeFileSync } from "fs";
+import { mkdirSync, readFileSync, realpathSync, writeFileSync } from "fs";
 import { join, resolve } from "path";
 import { pathToFileURL } from "url";
 
@@ -73,12 +73,88 @@ function formatScore(score) {
 
 // src/index.ts
 var DEFAULT_OUT_DIR = ".cejel";
+var CLI_FLAG_SPECS = [
+  {
+    tokens: ["--out", "--out-dir"],
+    value: "<dir>",
+    description: "write the certificate here (default: .cejel; --out-dir is a compatibility alias)",
+    kind: "out"
+  },
+  {
+    tokens: ["--min-score"],
+    value: "<0-4>",
+    description: "exit nonzero below this overall score",
+    kind: "minScore"
+  },
+  {
+    tokens: ["--ingest"],
+    value: "<file>",
+    description: "fold in a SARIF/JSON scanner report (repeatable)",
+    kind: "ingest"
+  },
+  {
+    tokens: ["--quiet"],
+    description: "suppress the terminal summary",
+    kind: "quiet"
+  },
+  {
+    tokens: ["-h", "--help"],
+    description: "show this help",
+    kind: "help"
+  },
+  {
+    tokens: ["-v", "--version"],
+    description: "print the version",
+    kind: "version"
+  }
+];
+var CLI_FLAG_TOKENS = CLI_FLAG_SPECS.flatMap(
+  (spec) => spec.tokens
+);
+var CLI_FLAG_KIND_BY_TOKEN = new Map(
+  CLI_FLAG_SPECS.flatMap((spec) => spec.tokens.map((token) => [token, spec.kind]))
+);
+function cliVersion() {
+  const manifest = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8")
+  );
+  if (typeof manifest.version !== "string" || manifest.version.length === 0) {
+    throw new Error("Cejel package manifest has no version.");
+  }
+  return manifest.version;
+}
+var usageOptionLabels = CLI_FLAG_SPECS.map(
+  (spec) => `${spec.tokens.join(", ")}${"value" in spec && spec.value ? ` ${spec.value}` : ""}`
+);
+var usageOptionLabelWidth = Math.max(...usageOptionLabels.map((label) => label.length));
+var usageOptions = CLI_FLAG_SPECS.map(
+  (spec, index) => `  ${usageOptionLabels[index]?.padEnd(usageOptionLabelWidth)}  ${spec.description}`
+).join("\n");
+var USAGE = `cejel \u2014 a trust certificate for your codebase
+
+Usage:  npx @cejel/cejel [path] [options]
+
+Options:
+${usageOptions}
+
+Runs entirely offline. No code leaves your machine.
+Docs: https://cejel.dev
+`;
 async function main() {
   const exitCode = await runWitanFreeCli(process.argv.slice(2));
   process.exitCode = exitCode;
 }
 async function runWitanFreeCli(args) {
   const options = parseArgs(args);
+  if (options.showVersion) {
+    process.stdout.write(`${cliVersion()}
+`);
+    return 0;
+  }
+  if (options.showHelp) {
+    process.stdout.write(USAGE);
+    return 0;
+  }
   const { report, summary } = runCejelScan({
     repoPath: options.repoPath,
     ingestPatterns: options.ingestPatterns,
@@ -120,42 +196,55 @@ function parseArgs(args) {
   let outDir = DEFAULT_OUT_DIR;
   let minScore;
   let quiet = false;
+  let showHelp = false;
+  let showVersion = false;
   const ingestPatterns = [];
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg === "--" || arg === void 0) continue;
-    if (arg === "--quiet") {
-      quiet = true;
-      continue;
-    }
-    if (arg === "--out-dir") {
-      const value = args[index + 1];
-      if (!value) throw new Error("Missing value for --out-dir");
-      outDir = value;
-      index += 1;
-      continue;
+    const flagKind = CLI_FLAG_KIND_BY_TOKEN.get(arg);
+    if (!flagKind && arg.startsWith("-")) {
+      throw new Error(`Unknown Cejel CLI flag: ${arg}`);
     }
-    if (arg === "--min-score") {
-      const value = args[index + 1];
-      if (!value) throw new Error("Missing value for --min-score");
-      const parsed = Number(value);
-      if (!Number.isFinite(parsed) || parsed < 0 || parsed > 4) {
-        throw new Error(`--min-score must be between 0 and 4, got: ${value}`);
+    if (flagKind) {
+      switch (flagKind) {
+        case "help":
+          showHelp = true;
+          break;
+        case "version":
+          showVersion = true;
+          break;
+        case "quiet":
+          quiet = true;
+          break;
+        case "out": {
+          const value = args[index + 1];
+          if (!value) throw new Error(`Missing value for ${arg}`);
+          outDir = value;
+          index += 1;
+          break;
+        }
+        case "minScore": {
+          const value = args[index + 1];
+          if (!value) throw new Error("Missing value for --min-score");
+          const parsed = Number(value);
+          if (!Number.isFinite(parsed) || parsed < 0 || parsed > 4) {
+            throw new Error(`--min-score must be between 0 and 4, got: ${value}`);
+          }
+          minScore = parsed;
+          index += 1;
+          break;
+        }
+        case "ingest": {
+          const value = args[index + 1];
+          if (!value) throw new Error("Missing value for --ingest");
+          ingestPatterns.push(value);
+          index += 1;
+          break;
+        }
       }
-      minScore = parsed;
-      index += 1;
       continue;
     }
-    if (arg === "--ingest") {
-      const value = args[index + 1];
-      if (!value) throw new Error("Missing value for --ingest");
-      ingestPatterns.push(value);
-      index += 1;
-      continue;
-    }
-    if (arg.startsWith("--")) {
-      throw new Error(`Unknown Cejel CLI flag: ${arg}`);
-    }
     if (repoPath === void 0) repoPath = arg;
   }
   return {
@@ -163,6 +252,8 @@ function parseArgs(args) {
     outDir,
     ...minScore != null ? { minScore } : {},
     quiet,
+    showHelp,
+    showVersion,
     ingestPatterns
   };
 }
@@ -186,6 +277,9 @@ if (isEntryPoint()) {
   });
 }
 export {
+  CLI_FLAG_SPECS,
+  CLI_FLAG_TOKENS,
+  USAGE,
   parseArgs,
   runWitanFreeCli
 };