@ksmv/ui-checks 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.1 - 2026-09-27
+
+- A CLI responde a `--help`/`-h` e a `--version`/`-v` antes de ler qualquer configuração, com código de saída 0. Na 0.1.0 essas opções caíam no carregamento da configuração e terminavam com código 2, e `-h` era interpretado como caminho de arquivo de configuração.
+- A ajuda lista os comandos de análise e de baseline, as opções que cada um aceita e os três códigos de saída.
+- Sem configuração e sem essas opções, a CLI continua falhando fechada com código 2.
+
 ## 0.1.0 - 2026-09-22
 
 - Primeira versão pública das verificações de contrato e acessibilidade.

package/dist/cli.js

@@ -6,6 +6,28 @@ import { approveBaselineGrowth, baselineFor, validateBaseline, writeBaselineFile
 import { applyConfiguredSuppressions } from "./governance.js";
 import { formatHumanReport, formatJsonReport, } from "./result.js";
 import { runChecks } from "./scan.js";
+const usage = `Usage:
+  ksmv-ui-checks [config] [--json | --format=json]
+  ksmv-ui-checks baseline [config] --write --first-seen-version=<version>
+      --owner-role=<role> --reduction-target=<YYYY-MM-DD>
+      [--allow-growth --reason-file=<path>]
+  ksmv-ui-checks --help | -h
+  ksmv-ui-checks --version | -v
+
+[config] defaults to ksmv-ui.config.js in the current directory.
+
+Exit codes:
+  0  analysis complete, no new violations
+  1  a new violation, or a regression against the baseline
+  2  invalid configuration, a failed read or operation, no files found,
+     or mandatory coverage left unresolved
+`;
+// The manifest sits one level above both src/ and the published dist/, so the
+// same relative URL resolves in the repository and in an installed package.
+async function packageVersion() {
+    const manifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
+    return manifest.version;
+}
 function optionValue(argv, name) {
     return argv
         .find((argument) => argument.startsWith(`--${name}=`))
@@ -94,6 +116,24 @@ async function runBaselineWrite(config, argv) {
     return 0;
 }
 export async function main(argv = process.argv.slice(2)) {
+    // Answered before anything else, and before any configuration is read. In
+    // 0.1.0 both flags fell through to configuration loading and failed with
+    // exit code 2, and `-h`, which does not start with `--`, was taken for a
+    // configuration path.
+    if (argv.some((argument) => argument === "--help" || argument === "-h")) {
+        process.stdout.write(usage);
+        return 0;
+    }
+    if (argv.some((argument) => argument === "--version" || argument === "-v")) {
+        try {
+            process.stdout.write(`${await packageVersion()}\n`);
+            return 0;
+        }
+        catch {
+            process.stderr.write("ksmv-ui-checks: unable to read the package version.\n");
+            return 2;
+        }
+    }
     const useJson = argv.includes("--json") || argv.includes("--format=json");
     const baselineCommand = argv[0] === "baseline";
     const commandArguments = baselineCommand ? argv.slice(1) : argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksmv/ui-checks",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Static and computed quality checks for semantic UI token contracts.",
   "keywords": ["accessibility", "design-tokens", "quality", "static-analysis"],
   "license": "Apache-2.0",