govgate 0.2.1 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # govgate
 
-Pipeline-step CLI for the MT Testing Tool: parses standard test output (JUnit XML),
+Pipeline-step CLI for Governance OS: parses standard test output (JUnit XML),
 maps tests to test cases, reports a run, and **gates the release** via its exit code.
 No SDK in application code — only the pipeline YAML changes.
 
@@ -19,9 +19,9 @@ standard reporter.
 
 | Flag | Default | Meaning |
 |---|---|---|
-| `--url <url>` | `MT_TESTING_TOOL_URL` | Tool deployment URL |
-| `--api-key <key>` | `MT_TESTING_TOOL_API_KEY` | API key (env var strongly preferred) |
-| `--config <path>` | `.mt-testing.json` searched upward | Config file |
+| `--url <url>` | `GOVGATE_URL` | Tool deployment URL |
+| `--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 |
 | `--name <name>` | derived from CI context | Run name |
@@ -61,7 +61,7 @@ Resolution per test (results are unioned):
    what .NET JUnit loggers emit), an underscore-delimited `Mt<n>` token maps the test:
    `Mt5_DuplicateEmail_Rejected`, `Profiles_Mt12_NotFound`, `Delete_Resolves_MT28`.
    Embedded substrings (`GMT5_…`, `Format2_…`) do not match.
-3. **Config patterns** in `.mt-testing.json`:
+3. **Config patterns** in `govgate/config.json`:
 
 ```jsonc
 {
@@ -83,10 +83,9 @@ any passing → `pass`; all skipped → the case is not posted (stays pending
 test is a non-observation). Suite cases with no mapped tests stay pending and are
 listed as "uncovered" in the summary.
 
-Use the `map-tests` Claude Code skill (in the
-[Maersk-Training/mt-testing-tool](https://github.com/Maersk-Training/mt-testing-tool)
-repo under `skills/`) to generate the mapping semi-automatically, and `--dry-run` to
-validate it.
+Use the `map-tests` Governance OS skill (served by your deployment at
+`${GOVGATE_URL}/api/v1/skills`) to generate the mapping semi-automatically, and
+`--dry-run` to validate it.
 
 ## .NET specifics (learned the hard way)
 
@@ -102,28 +101,25 @@ validate it.
 - **Classic Release has no source checkout**: `dotnet publish` the test project into
   the build artifact (`drop/tests/`) and run it with the ".NET Core" task using
   Command `custom` + `vstest` — the `run` command does NOT execute arbitrary commands.
-- The full ADO runbook (variable groups, stage scoping, exact task configs) lives in
-  `skills/onboard-repo/reference.md` in the
-  [Maersk-Training/mt-testing-tool](https://github.com/Maersk-Training/mt-testing-tool)
-  repo — or run the `onboard-repo` skill.
+- The full ADO runbook (variable groups, stage scoping, exact task configs) is the
+  `onboard-repo` Governance OS skill (served at `${GOVGATE_URL}/api/v1/skills`) — run it,
+  or read its `reference.md`.
 
 ## Multi-job pipelines
 
 ```bash
 # job A — creates the run, leaves it open
-govgate report unit-results.xml --no-complete       # emits MT_RUN_ID (GH output / ADO variable)
+govgate report unit-results.xml --no-complete       # emits GOVGATE_RUN_ID (GH output / ADO variable)
 
 # job B — appends to the same run
-govgate report e2e-results.xml --run-id $MT_RUN_ID --no-complete
+govgate report e2e-results.xml --run-id $GOVGATE_RUN_ID --no-complete
 
 # final job — completes + gates over everything
-govgate complete --run-id $MT_RUN_ID --fail-on fail --min-executed 80
+govgate complete --run-id $GOVGATE_RUN_ID --fail-on fail --min-executed 80
 ```
 
-See `docs/examples/github-actions-ci-report.yml` and
-`docs/examples/azure-devops-ci-report.yml` in the
-[Maersk-Training/mt-testing-tool](https://github.com/Maersk-Training/mt-testing-tool)
-repo for full pipelines.
+Full pipeline examples for GitHub Actions and Azure DevOps ship with your Governance OS
+deployment (served alongside the skills at `${GOVGATE_URL}/api/v1/skills`).
 
 ## Registry
 

package/dist/index.js

@@ -104,12 +104,12 @@ function detectCiContext(env = process.env) {
   };
 }
 function emitRunIdVariable(runId, ctx, env = process.env) {
-  console.log(`MT_RUN_ID=${runId}`);
+  console.log(`GOVGATE_RUN_ID=${runId}`);
   if (ctx.provider === "github" && env.GITHUB_OUTPUT) {
     appendFileSync(env.GITHUB_OUTPUT, `run-id=${runId}
 `);
   } else if (ctx.provider === "azure-devops") {
-    console.log(`##vso[task.setvariable variable=MT_RUN_ID;isOutput=true]${runId}`);
+    console.log(`##vso[task.setvariable variable=GOVGATE_RUN_ID;isOutput=true]${runId}`);
   }
 }
 
@@ -126,7 +126,7 @@ function findConfigFile(startDir, explicitPath) {
   }
   let dir = resolve(startDir);
   for (; ; ) {
-    const candidate = join(dir, ".mt-testing.json");
+    const candidate = join(dir, "govgate", "config.json");
     if (existsSync(candidate)) return candidate;
     const parent = dirname(dir);
     if (parent === dir) return void 0;
@@ -169,26 +169,36 @@ function loadFileConfig(path) {
   }
   return out;
 }
+function loadFileMappings(flags, cwd = process.cwd()) {
+  const configPath = findConfigFile(cwd, flags.config);
+  const file = configPath ? loadFileConfig(configPath) : {};
+  return {
+    mappings: file.mappings ?? {},
+    suite: flags.suite ?? file.suite,
+    environment: flags.env ?? file.defaultEnvironment,
+    configPath
+  };
+}
 function resolveConfig(flags, cwd = process.cwd()) {
   const configPath = findConfigFile(cwd, flags.config);
   const file = configPath ? loadFileConfig(configPath) : {};
-  const url = flags.url ?? process.env.MT_TESTING_TOOL_URL;
-  const apiKey = flags.apiKey ?? process.env.MT_TESTING_TOOL_API_KEY;
+  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;
   if (!url) {
     throw new ConfigError(
-      "Tool URL missing. Set MT_TESTING_TOOL_URL or pass --url https://<your-deployment>"
+      "Tool URL missing. Set GOVGATE_URL or pass --url https://<your-deployment>"
     );
   }
   if (!apiKey) {
     throw new ConfigError(
-      "API key missing. Set MT_TESTING_TOOL_API_KEY (create one in the tool: Admin -> API keys, scoped to this application)."
+      "API key missing. Set GOVGATE_API_KEY (create one in the tool: Admin -> API keys, scoped to this application)."
     );
   }
   if (!suite) {
     throw new ConfigError(
-      'Suite missing. Pass --suite <slug> or add { "suite": "<slug>" } to .mt-testing.json in the repo root.'
+      'Suite missing. Pass --suite <slug> or add { "suite": "<slug>" } to govgate/config.json in the repo root.'
     );
   }
   return {
@@ -392,7 +402,7 @@ function printMappingTable(outcome) {
   }
   if (outcome.unmappedTests.length) {
     console.log(`
-Unmapped tests (${outcome.unmappedTests.length}) \u2014 add @mt-<case> tags or .mt-testing.json mappings:`);
+Unmapped tests (${outcome.unmappedTests.length}) \u2014 add @mt-<case> tags or govgate/config.json mappings:`);
     for (const t of outcome.unmappedTests.slice(0, 20)) console.log(`  - ${t.id}`);
     if (outcome.unmappedTests.length > 20)
       console.log(`  \u2026 and ${outcome.unmappedTests.length - 20} more`);
@@ -476,8 +486,8 @@ async function completeAndGate(api, url, runId, gate) {
   printRunUrl(url, runId);
   if (!verdict.passed) process.exit(EXIT_GATE_FAILED);
 }
-var program = new Command().name("govgate").description("Report CI test results to the MT 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 MT_TESTING_TOOL_URL)").option("--api-key <key>", "API key (prefer MT_TESTING_TOOL_API_KEY)").option("--config <path>", "path to .mt-testing.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) => {
+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) => {
   try {
     const flags = {
       url: opts.url,
@@ -488,7 +498,7 @@ program.command("report").description("Parse test result files (JUnit XML), map
     };
     const tests = await parseFiles(files, opts.format);
     const config = opts.dryRun ? tryResolveConfig(flags) : resolveConfig(flags);
-    const mappings = config?.mappings ?? {};
+    const mappings = config?.mappings ?? (opts.dryRun ? loadFileMappings(flags).mappings : {});
     const outcome = mapTestsToCases(tests, mappings);
     console.log(
       `Parsed ${tests.length} test(s) from ${files.join(", ")} \u2014 ${outcome.results.length} case(s) mapped, ${outcome.unmappedTests.length} unmapped test(s)`
@@ -554,7 +564,7 @@ function tryResolveConfig(flags) {
     return void 0;
   }
 }
-program.command("complete").description("Complete a run and evaluate the gate (final job of a multi-job pipeline)").requiredOption("--run-id <uuid>", "run to complete").option("--url <url>", "tool URL (or MT_TESTING_TOOL_URL)").option("--api-key <key>", "API key (prefer MT_TESTING_TOOL_API_KEY)").option("--config <path>", "path to .mt-testing.json").option("--suite <slug>", "suite slug (only used for config resolution)").option("--fail-on <list>", "statuses that fail the gate: fail | fail,blocked", "fail").option("--min-executed <pct>", "minimum executed percentage required by the gate").action(async (opts) => {
+program.command("complete").description("Complete a run and evaluate the gate (final job of a multi-job pipeline)").requiredOption("--run-id <uuid>", "run to complete").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").option("--suite <slug>", "suite slug (only used for config resolution)").option("--fail-on <list>", "statuses that fail the gate: fail | fail,blocked", "fail").option("--min-executed <pct>", "minimum executed percentage required by the gate").action(async (opts) => {
   try {
     const config = resolveConfig({
       url: opts.url,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "govgate",
-  "version": "0.2.1",
+  "version": "0.3.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",