prisma-guard-lite 0.1.0 → 0.1.1

package/README.md

@@ -93,6 +93,8 @@ Git-aware modes require a Git worktree.
 | `--no-write` | Do not write `prisma-guard-report.md` |
 | `--fail-on high` | Exit with code 1 when high findings exist |
 | `--fail-on medium` | Exit with code 1 when high or medium findings exist |
+| `--help`, `-h` | Print CLI usage and options |
+| `--version`, `-v` | Print the installed package version |
 
 ## Example output
 

package/dist/index.js

@@ -8,7 +8,33 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 const report_js_1 = require("./report.js");
 const scanner_js_1 = require("./scanner.js");
+const helpText = `Prisma Guard Lite
+
+Pre-deploy migration risk checker for Prisma projects.
+
+Usage:
+  prisma-guard-lite [project-path] [options]
+
+Examples:
+  npx prisma-guard-lite --latest
+  npx prisma-guard-lite --since main
+  npx prisma-guard-lite --staged --fail-on high
+  npx prisma-guard-lite /path/to/project --changed
+
+Options:
+  --latest                  Scan only the latest migration
+  --since <git-ref>         Scan migrations changed since a Git ref
+  --staged                  Scan staged migration files
+  --changed                 Scan changed and untracked migration files
+  --json                    Output JSON
+  --include-low             Include low-severity best-practice checks
+  --no-write                Do not write prisma-guard-report.md
+  --fail-on high|medium     Exit 1 at the selected severity threshold
+  --help, -h                Show help
+  --version, -v             Show version
+`;
 function parseArgs(args) {
+    let action;
     let projectPath;
     let json = false;
     let mode = "history";
@@ -26,7 +52,13 @@ function parseArgs(args) {
     };
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
-        if (arg === "--json") {
+        if (arg === "--help" || arg === "-h") {
+            action = "help";
+        }
+        else if (arg === "--version" || arg === "-v") {
+            action = "version";
+        }
+        else if (arg === "--json") {
             json = true;
         }
         else if (arg === "--latest") {
@@ -71,6 +103,7 @@ function parseArgs(args) {
         }
     }
     return {
+        action,
         projectRoot: node_path_1.default.resolve(projectPath ?? process.cwd()),
         json,
         mode,
@@ -80,8 +113,24 @@ function parseArgs(args) {
         failOn,
     };
 }
+async function packageVersion() {
+    const packagePath = node_path_1.default.join(__dirname, "..", "package.json");
+    const packageJson = JSON.parse(await node_fs_1.promises.readFile(packagePath, "utf8"));
+    if (typeof packageJson.version !== "string") {
+        throw new Error("Unable to read package version.");
+    }
+    return packageJson.version;
+}
 async function main() {
     const options = parseArgs(process.argv.slice(2));
+    if (options.action === "help") {
+        process.stdout.write(helpText);
+        return;
+    }
+    if (options.action === "version") {
+        process.stdout.write(`${await packageVersion()}\n`);
+        return;
+    }
     const stat = await node_fs_1.promises.stat(options.projectRoot).catch(() => null);
     if (!stat?.isDirectory()) {
         throw new Error(`Project directory not found: ${options.projectRoot}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prisma-guard-lite",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Pre-deploy migration risk checker for Prisma projects",
   "keywords": [
     "prisma",