govgate 0.4.0 → 0.5.0

package/README.md

@@ -23,7 +23,8 @@ standard reporter.
 | `--api-key <key>` | `GOVGATE_API_KEY` | API key (env var strongly preferred) |
 | `--config <path>` | `govgate/config.json` searched upward | Config file |
 | `--suite <slug>` | config `suite` | Target suite |
-| `--env <slug>` | config `defaultEnvironment` | Environment for the run |
+| `--env <slug>` | inferred, else config `defaultEnvironment` | Environment for the run (overrides inference) |
+| `--base-url <url>` | `API_BASEURL` | Live app base URL; matched against the declared environments' `baseUrl`s to infer the environment |
 | `--name <name>` | derived from CI context | Run name |
 | `--build-version <v>` | short commit SHA from CI | Build version |
 | `--external-url <url>` | CI build URL | "Build ↗" link on the run page |
@@ -49,6 +50,23 @@ automatically before creating a run when the block is present, so a brand-new st
 can never fail on an unknown environment — the explicit command exists for
 onboarding-time provisioning and for verifying the catalog without reporting.
 
+## Environment inference (v0.5.0+)
+
+When `--env` is absent, `report` resolves the environment **from the deployment
+under test**: the base URL (from `--base-url` or the `API_BASEURL` env var — the
+same variable your smoke tests already use) is matched against the declared
+environments' `baseUrl`s, and the matching slug wins. Falls back to
+`defaultEnvironment` when nothing matches. Matching ignores scheme, casing, and
+trailing slashes.
+
+This makes one identical report step correct in every stage — no per-stage
+`--env` variable to configure or mis-copy. The chosen slug is always printed to
+the CI log.
+
+```
+npx govgate report "test-results/*.xml" --fail-on fail   # env inferred from API_BASEURL
+```
+
 ## Exit codes
 
 | Code | Meaning |

package/dist/index.js

@@ -272,6 +272,28 @@ function parseEnvironments(path, raw) {
   }
   return out;
 }
+function normalizeBaseUrl(raw) {
+  const trimmed = raw.trim();
+  if (trimmed === "") return void 0;
+  const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+  let url;
+  try {
+    url = new URL(withScheme);
+  } catch {
+    return void 0;
+  }
+  const path = url.pathname.replace(/\/+$/, "");
+  return `${url.host}${path}`.toLowerCase();
+}
+function inferEnvironment(environments, baseUrl) {
+  if (!baseUrl || !environments?.length) return void 0;
+  const target = normalizeBaseUrl(baseUrl);
+  if (!target) return void 0;
+  for (const env of environments) {
+    if (env.baseUrl && normalizeBaseUrl(env.baseUrl) === target) return env.slug;
+  }
+  return void 0;
+}
 function loadFileMappings(flags, cwd = process.cwd()) {
   const configPath = findConfigFile(cwd, flags.config);
   const file = configPath ? loadFileConfig(configPath) : {};
@@ -288,7 +310,22 @@ function resolveConfig(flags, cwd = process.cwd()) {
   const url = flags.url ?? process.env.GOVGATE_URL;
   const apiKey = flags.apiKey ?? process.env.GOVGATE_API_KEY;
   const suite = flags.suite ?? file.suite;
-  const environment = flags.env ?? file.defaultEnvironment;
+  let environment = flags.env;
+  if (!environment) {
+    const liveBaseUrl = flags.baseUrl ?? process.env.API_BASEURL;
+    const inferred = inferEnvironment(file.environments, liveBaseUrl);
+    if (inferred) {
+      console.error(`govgate: environment '${inferred}' inferred from base URL ${liveBaseUrl}`);
+      environment = inferred;
+    } else {
+      if (liveBaseUrl && file.environments?.some((e) => e.baseUrl)) {
+        console.error(
+          `govgate: base URL ${liveBaseUrl} matches no declared environment baseUrl` + (file.defaultEnvironment ? `; falling back to defaultEnvironment '${file.defaultEnvironment}'` : " and no defaultEnvironment is set")
+        );
+      }
+      environment = file.defaultEnvironment;
+    }
+  }
   if (!url) {
     throw new ConfigError(
       "Tool URL missing. Set GOVGATE_URL or pass --url https://<your-deployment>"
@@ -602,14 +639,18 @@ async function completeAndGate(api, url, runId, gate) {
   if (!verdict.passed) process.exit(EXIT_GATE_FAILED);
 }
 var program = new Command().name("govgate").description("Report CI test results to your testing tool and gate releases on the outcome.");
-program.command("report").description("Parse test result files (JUnit XML), map tests to cases, and report a run").argument("<files...>", "result files or globs, e.g. test-results/*.xml").option("--url <url>", "tool URL (or GOVGATE_URL)").option("--api-key <key>", "API key (prefer GOVGATE_API_KEY)").option("--config <path>", "path to govgate/config.json (default: searched upward)").option("--suite <slug>", "suite slug (overrides config)").option("--env <slug>", "environment slug (overrides config)").option("--name <name>", "run name (default: derived from CI context)").option("--build-version <v>", "build version (default: short commit SHA from CI)").option("--external-url <url>", "link to the build/PR (default: from CI context)").option("--format <format>", "input format", "junit").option("--run-id <uuid>", "append results to an existing run instead of creating one").option("--no-complete", "leave the run in progress (multi-job pipelines); skips the gate").option("--fail-on <list>", "statuses that fail the gate: fail | fail,blocked", "fail").option("--min-executed <pct>", "minimum executed percentage required by the gate").option("--actor <label>", "tested-by label on results", "govgate").option("--dry-run", "parse and map only; post nothing").action(async (files, opts) => {
+program.command("report").description("Parse test result files (JUnit XML), map tests to cases, and report a run").argument("<files...>", "result files or globs, e.g. test-results/*.xml").option("--url <url>", "tool URL (or GOVGATE_URL)").option("--api-key <key>", "API key (prefer GOVGATE_API_KEY)").option("--config <path>", "path to govgate/config.json (default: searched upward)").option("--suite <slug>", "suite slug (overrides config)").option("--env <slug>", "environment slug (overrides config and inference)").option(
+  "--base-url <url>",
+  "base URL of the app under test; matched against the declared environments' baseUrls to infer the environment (default: API_BASEURL)"
+).option("--name <name>", "run name (default: derived from CI context)").option("--build-version <v>", "build version (default: short commit SHA from CI)").option("--external-url <url>", "link to the build/PR (default: from CI context)").option("--format <format>", "input format", "junit").option("--run-id <uuid>", "append results to an existing run instead of creating one").option("--no-complete", "leave the run in progress (multi-job pipelines); skips the gate").option("--fail-on <list>", "statuses that fail the gate: fail | fail,blocked", "fail").option("--min-executed <pct>", "minimum executed percentage required by the gate").option("--actor <label>", "tested-by label on results", "govgate").option("--dry-run", "parse and map only; post nothing").action(async (files, opts) => {
   try {
     const flags = {
       url: opts.url,
       apiKey: opts.apiKey,
       suite: opts.suite,
       env: opts.env,
-      config: opts.config
+      config: opts.config,
+      baseUrl: opts.baseUrl
     };
     const tests = await parseFiles(files, opts.format);
     const config = opts.dryRun ? tryResolveConfig(flags) : resolveConfig(flags);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "govgate",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Governance gate for releases: report CI test results (JUnit XML) to your testing tool and gate promotion on the outcome.",
   "license": "MIT",
   "author": "HatStack",