@automatify-au/cli 0.1.17 → 0.1.18

package/README.md

@@ -74,8 +74,10 @@ Publish notes:
 Minimum:
 - `JIRA_BASE_URL`
 - At least one of `JIRA_PROJECT_KEY` or `JIRA_ISSUE_KEY`
-- `TESTOPS_FORGE_ENDPOINT` for commands that call Forge contracts (`doctor`, `ingest`, `run`, `sync`)
-- `TESTOPS_FORGE_AUTH_TOKEN` from the one-time token shown in Forge `Operations -> CLI access`
+- `TESTOPS_FORGE_ENDPOINT` for commands that call Forge contracts (`doctor`, `ingest`, `run`, `sync`); copy the installation-specific endpoint from Jira `Automatify TestOps -> CLI`
+- `TESTOPS_FORGE_AUTH_TOKEN`; create a CLI key in Jira `Automatify TestOps -> CLI` and copy the one-time token when it is shown
+
+Customer admins do not need the Forge developer CLI to obtain either value. The Jira CLI workspace resolves the webtrigger endpoint for the current app installation at runtime.
 
 Local Jira auth helper on macOS/Windows:
 ```bash
@@ -88,10 +90,10 @@ automatify testops auth status
 
 On Linux/CI, keep `JIRA_API_TOKEN` in the environment and run `auth login` without `--token-stdin`; the CLI stores only non-secret Jira settings. Use `automatify testops auth logout` to remove local Jira and Forge credentials while preserving non-secret URL/email settings. Environment variables are not modified by logout.
 
-Forge transport auth remains an advanced setting:
+Forge transport auth remains an advanced setting. First open the Jira project, go to `Automatify TestOps -> CLI`, copy the displayed CLI endpoint, create a CLI key, and copy its one-time token. Then configure the CLI:
 ```bash
 automatify testops config set projectKey DEV
-automatify testops config set forgeEndpoint "<webtrigger-url>"
+automatify testops config set forgeEndpoint "<endpoint-copied-from-jira>"
 printf "%s" "$TESTOPS_FORGE_AUTH_TOKEN" | automatify testops config set forgeAuthToken --stdin
 ```
 
@@ -110,6 +112,9 @@ All TestOps commands are invoked as `automatify testops <command>`:
 ### Core browse commands
 
 - `bdd`
+  - `automatify testops bdd scenarios list`
+  - `automatify testops bdd scenarios list --json`
+  - `automatify testops bdd scenarios list --project-key <PROJECT_KEY> --issue-key <ISSUE_KEY>`
   - `automatify testops bdd scenarios show --id <SCENARIO_ID>`
   - `automatify testops bdd scenarios show --id <SCENARIO_ID> --format feature`
   - `automatify testops bdd scenarios show --id <SCENARIO_ID|SC-4> --feature`
@@ -141,6 +146,15 @@ All TestOps commands are invoked as `automatify testops <command>`:
   - `automatify allure open ./allure-report.zip`
   - `automatify allure open ./allure-report.zip --no-open --port 8080`
 
+`bdd scenarios list` uses the configured project context or `--project-key`; `--issue-key` optionally narrows the Jira issue context. Human output is concise and selector-first:
+
+```text
+BDD scenarios (1) for project DEV:
+SC-14 | Guest payment | Feature: Checkout | Steps: 3 | Issues: DEV-2
+```
+
+With `--json`, the command emits one JSON object with stable action `bdd-scenarios-list`, `projectKey`, optional `issueKey`, `count`, and `items`.
+
 ### Advanced browse commands
 
 - `cases`
@@ -224,7 +238,7 @@ Secrets must come from stdin or safe environment references. Secret values are r
 ```bash
 export TESTOPS_GITHUB_PROVIDER_TOKEN="<github-app-installation-or-fine-grained-token>"
 export TESTOPS_GITHUB_ADMIN_TOKEN="<least-privilege-token-allowed-to-manage-actions-secrets>"
-export TESTOPS_FORGE_ENDPOINT="<forge-webtrigger-url>"
+export TESTOPS_FORGE_ENDPOINT="<endpoint-copied-from-jira-cli-workspace>"
 export TESTOPS_FORGE_AUTH_TOKEN="<one-time-project-cli-key>"
 
 automatify testops setup apply \
@@ -270,7 +284,8 @@ Doctor verifies the local workflow hash, GitHub workflow metadata/content at the
 
 Current authentication boundary:
 
-- `TESTOPS_FORGE_AUTH_TOKEN` is still a project-scoped, project-admin-created CLI key from Jira `Operations -> CLI access`.
+- `TESTOPS_FORGE_ENDPOINT` is copied from the installation-specific endpoint displayed in Jira `Automatify TestOps -> CLI`.
+- `TESTOPS_FORGE_AUTH_TOKEN` is a project-scoped, project-admin-created CLI key from the same Jira CLI workspace.
 - The key authorizes the current Forge webtrigger transport for that project; command groups are not separate security scopes.
 - Setup does not turn this into an all-user auth model. Customer-admin packaging and any future user-level authentication remain separate work.
 - The same callback key may be stored as a GitHub Actions repository secret only under the explicit `github-secrets` apply scope.
@@ -423,20 +438,18 @@ Required env/config for real upload mode:
 - `TESTOPS_FORGE_ENDPOINT`
 - `TESTOPS_FORGE_AUTH_TOKEN` for the repo-owned authenticated webtrigger transport
 
-One-time Forge transport setup:
-```bash
-cd apps/forge
-forge deploy
-forge install --upgrade --site automatify-com-au.atlassian.net --product Jira -e development --confirm-scopes --non-interactive
-forge webtrigger create --functionKey cli-transport-webtrigger --site automatify-com-au.atlassian.net --product Jira -e development
-```
+Customer CLI transport setup (no Forge developer CLI required):
+1. Open the Jira project and go to `Automatify TestOps -> CLI`.
+2. Copy the `CLI endpoint` displayed for the current installation.
+3. Create a project CLI key and copy the token immediately; it is shown once only.
+4. Configure those two values in the local shell, CI secret store, or CLI config.
 
-Then open the Jira project page, go to `Operations -> CLI access`, create a CLI key, and copy the token immediately. It is shown once only.
+Repository maintainers deploy/install the Forge app through the repository's controlled deployment workflow. That internal deployment process is separate from customer CLI onboarding.
 
-Export the webtrigger URL and the one-time token for CLI use:
+Export the installation endpoint and one-time token for CLI use:
 ```bash
-export TESTOPS_FORGE_ENDPOINT="<webtrigger-url>"
-export TESTOPS_FORGE_AUTH_TOKEN="<one-time-token-from-forge-ui>"
+export TESTOPS_FORGE_ENDPOINT="<endpoint-copied-from-jira>"
+export TESTOPS_FORGE_AUTH_TOKEN="<one-time-token-from-jira-cli-workspace>"
 export JIRA_BASE_URL="https://automatify-com-au.atlassian.net"
 export JIRA_PROJECT_KEY="DEV"
 ```
@@ -445,18 +458,19 @@ Or store the non-secret values in `.testops-cli.json`; on macOS the token is sto
 ```bash
 automatify testops config set baseUrl https://automatify-com-au.atlassian.net
 automatify testops config set projectKey DEV
-automatify testops config set forgeEndpoint "<webtrigger-url>"
+automatify testops config set forgeEndpoint "<endpoint-copied-from-jira>"
 printf "%s" "$TESTOPS_FORGE_AUTH_TOKEN" | automatify testops config set forgeAuthToken --stdin
 ```
 
 On Linux and CI, keep the token in environment variables. Windows users can use the same `config set forgeAuthToken --stdin` flow from PowerShell; see [WINDOWS.md](./WINDOWS.md).
 ```bash
-export TESTOPS_FORGE_AUTH_TOKEN="<one-time-token-from-forge-ui>"
+export TESTOPS_FORGE_AUTH_TOKEN="<one-time-token-from-jira-cli-workspace>"
 ```
 
 Transport notes:
 - Bearer auth is required for operator/CI use. Forge stores only the token hash plus metadata.
-- Tokens are project-scoped, shown once at creation time, and can be revoked from the Forge UI.
+- Tokens are project-scoped, shown once at creation time, and can be revoked from the Jira CLI workspace.
+- The endpoint is resolved by the Forge runtime for the current installation; customers do not configure a Forge-side endpoint variable.
 - Expired or revoked tokens are rejected by the transport.
 
 Scenario automation callback example:
@@ -545,6 +559,7 @@ Azure DevOps setup note:
 
 Core browse examples:
 ```bash
+automatify testops bdd scenarios list --project-key DEV --json
 automatify testops bdd scenarios show --project-key DEV --id <SCENARIO_ID> --json
 automatify testops bdd scenarios export --project-key DEV --id SC-4 --output-dir ./artifacts/scenario-export --json
 automatify testops bdd scenarios import --project-key DEV --file ./artifacts/scenario-export/SC-4.feature --json
@@ -570,6 +585,7 @@ automatify testops suites cases list --project-key DEV --key TS-1
 Recommended browse flow:
 ```bash
 # Path A: scenario-first browse
+automatify testops bdd scenarios list --project-key DEV --json
 automatify testops bdd scenarios show --project-key DEV --id <SCENARIO_ID> --json
 automatify testops runs show --project-key DEV --id <RUN_ID> --json
 
@@ -608,7 +624,7 @@ Feature export notes:
 - `bdd features export` writes one `.feature` file per stored BDD feature plus `manifest.json`.
 - with `--zip`, the CLI also writes `./artifacts/features-export.zip` next to the export directory.
 - pass `--issue-key DEV-2` to export only features visible in that Jira issue context.
-- `getSummaryExport` remains the reporting/export path for JSON/CSV summary snapshots and is separate from feature-file round-trip export.
+- `getSummaryExport` remains the reporting/export path for JSON/CSV summary snapshots and is separate from feature-file round-trip export/import.
 
 Coverage and readiness report via the Forge transport:
 ```bash

package/dist/automatify.cjs

@@ -15339,6 +15339,138 @@ function createBddHandler(deps = {}) {
   };
 }
 
+// src/bddCommand.ts
+var CONFIG_VALUE_FLAGS = /* @__PURE__ */ new Set([
+  "--config",
+  "--base-url",
+  "--project-key",
+  "--issue-key",
+  "--auth-mode",
+  "--jira-email",
+  "--jira-api-token"
+]);
+function parseListArgs(args) {
+  let json = false;
+  const configArgs = [];
+  const invalid = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const token = args[index];
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    if (!CONFIG_VALUE_FLAGS.has(token)) {
+      invalid.push(token);
+      continue;
+    }
+    const value = args[index + 1];
+    if (!value || value.startsWith("--")) {
+      invalid.push(token);
+      continue;
+    }
+    configArgs.push(token, value);
+    index += 1;
+  }
+  return { json, configArgs, invalid };
+}
+function normalizeError4(error) {
+  if (error instanceof ForgeClientError) {
+    return `${error.code}: ${error.message}`;
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return "Unknown BDD scenario list transport error.";
+}
+function scenarioToJson(scenario) {
+  return {
+    id: scenario.id,
+    key: scenario.key ?? null,
+    featureId: scenario.featureId,
+    featureName: scenario.featureName,
+    name: scenario.name,
+    tags: [...scenario.tags],
+    linkedIssueKeys: [...scenario.linkedIssueKeys],
+    stepCount: scenario.steps.length,
+    createdAt: scenario.createdAt,
+    updatedAt: scenario.updatedAt
+  };
+}
+function scenarioToLine(scenario) {
+  const selector = scenario.key ?? scenario.id;
+  const issues = scenario.linkedIssueKeys.length > 0 ? scenario.linkedIssueKeys.join(", ") : "none";
+  return `${selector} | ${scenario.name} | Feature: ${scenario.featureName} | Steps: ${scenario.steps.length} | Issues: ${issues}`;
+}
+function createBddCommandHandler(deps = {}) {
+  const cwd = deps.cwd ?? process.cwd();
+  const env = deps.env ?? process.env;
+  const delegate = deps.delegate ?? createBddHandler({ cwd, env });
+  return async (request, context) => {
+    if (request.args[0] !== "scenarios" || request.args[1] !== "list") {
+      return delegate(request, context);
+    }
+    const parsed = parseListArgs(request.args.slice(2));
+    if (parsed.invalid.length > 0) {
+      return {
+        exitCode: ExitCode.UsageError,
+        stderr: [`ERROR: Unknown or invalid arguments: ${parsed.invalid.join(", ")}`]
+      };
+    }
+    const config = resolveCliConfig(parsed.configArgs, env, cwd).values;
+    if (!config.projectKey) {
+      return {
+        exitCode: ExitCode.ValidationError,
+        stderr: ["ERROR: Missing project context. Set JIRA_PROJECT_KEY or pass --project-key."]
+      };
+    }
+    try {
+      const result = await context.invokeForgeContract("listBddScenarios", {
+        context: {
+          projectKey: config.projectKey,
+          issueKey: config.issueKey || void 0
+        }
+      });
+      if (!result.ok) {
+        return {
+          exitCode: ExitCode.RemoteError,
+          stderr: [`ERROR: ${result.error.code}: ${result.error.message}`]
+        };
+      }
+      const scenarios = result.data;
+      if (parsed.json) {
+        return {
+          exitCode: ExitCode.Success,
+          stdout: toJsonLine({
+            action: "bdd-scenarios-list",
+            projectKey: config.projectKey,
+            issueKey: config.issueKey || null,
+            count: scenarios.length,
+            items: scenarios.map(scenarioToJson)
+          })
+        };
+      }
+      if (scenarios.length === 0) {
+        return {
+          exitCode: ExitCode.Success,
+          stdout: [`No BDD scenarios found for project ${config.projectKey}.`]
+        };
+      }
+      return {
+        exitCode: ExitCode.Success,
+        stdout: [
+          `BDD scenarios (${scenarios.length}) for project ${config.projectKey}:`,
+          ...scenarios.map(scenarioToLine)
+        ]
+      };
+    } catch (error) {
+      return {
+        exitCode: ExitCode.TransportError,
+        stderr: [`ERROR: ${normalizeError4(error)}`]
+      };
+    }
+  };
+}
+
 // src/cases.ts
 var CONFIG_FLAGS4 = /* @__PURE__ */ new Set([
   "--config",
@@ -15387,7 +15519,7 @@ function pickConfigArgs4(parsed) {
   }
   return args;
 }
-function normalizeError4(error) {
+function normalizeError5(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -15565,7 +15697,7 @@ function createCasesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError4(error)}`]
+          stderr: [`ERROR: ${normalizeError5(error)}`]
         };
       }
     }
@@ -15607,7 +15739,7 @@ function createCasesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError4(error)}`]
+          stderr: [`ERROR: ${normalizeError5(error)}`]
         };
       }
     }
@@ -15670,7 +15802,7 @@ function createCasesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError4(error)}`]
+          stderr: [`ERROR: ${normalizeError5(error)}`]
         };
       }
     }
@@ -15733,7 +15865,7 @@ function createCasesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError4(error)}`]
+          stderr: [`ERROR: ${normalizeError5(error)}`]
         };
       }
     }
@@ -16155,7 +16287,7 @@ function summarizeSuccess(result) {
   }
   return lines;
 }
-function normalizeError5(error) {
+function normalizeError6(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -16192,7 +16324,7 @@ function createIngestFeatureHandler(deps = {}) {
     } catch (error) {
       return {
         exitCode: ExitCode.InternalError,
-        stderr: [`ERROR: Failed to read feature source: ${normalizeError5(error)}`]
+        stderr: [`ERROR: Failed to read feature source: ${normalizeError6(error)}`]
       };
     }
     const name = (parsed.flags["--name"] ?? deriveNameFromGherkin(gherkin)).trim();
@@ -16283,14 +16415,14 @@ function createIngestFeatureHandler(deps = {}) {
             status: "failed",
             featureName: name,
             source: useStdin ? "stdin" : sourceFile,
-            errorMessage: normalizeError5(error)
+            errorMessage: normalizeError6(error)
           })
         };
       }
       return {
         exitCode: ExitCode.TransportError,
         stdout: ["Feature ingestion: FAILED", `Feature: ${name}`, `Source: ${useStdin ? "stdin" : sourceFile}`],
-        stderr: [`ERROR: ${normalizeError5(error)}`]
+        stderr: [`ERROR: ${normalizeError6(error)}`]
       };
     }
   };
@@ -16345,7 +16477,7 @@ function pickConfigArgs7(parsed) {
   }
   return args;
 }
-function normalizeError6(error) {
+function normalizeError7(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -16488,7 +16620,7 @@ function createProfilesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError6(error)}`]
+          stderr: [`ERROR: ${normalizeError7(error)}`]
         };
       }
     }
@@ -16574,7 +16706,7 @@ function createProfilesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError6(error)}`]
+          stderr: [`ERROR: ${normalizeError7(error)}`]
         };
       }
     }
@@ -16672,7 +16804,7 @@ function createProfilesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError6(error)}`]
+          stderr: [`ERROR: ${normalizeError7(error)}`]
         };
       }
     }
@@ -16783,7 +16915,7 @@ function createProfilesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError6(error)}`]
+          stderr: [`ERROR: ${normalizeError7(error)}`]
         };
       }
     }
@@ -16858,7 +16990,7 @@ function pickConfigArgs8(parsed) {
   }
   return configArgs;
 }
-function normalizeError7(error) {
+function normalizeError8(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -16977,7 +17109,7 @@ function createRunUploadHandler(deps = {}) {
     } catch (error) {
       return {
         exitCode: ExitCode.InternalError,
-        stderr: [`ERROR: Failed to read run payload source: ${normalizeError7(error)}`]
+        stderr: [`ERROR: Failed to read run payload source: ${normalizeError8(error)}`]
       };
     }
     const payloadFromSource = parseRunPayload(raw);
@@ -17007,7 +17139,7 @@ function createRunUploadHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError7(error)}`]
+          stderr: [`ERROR: ${normalizeError8(error)}`]
         };
       }
     }
@@ -17087,7 +17219,7 @@ function createRunUploadHandler(deps = {}) {
             featureName: runInput.featureName,
             scenarioName: runInput.scenarioName,
             executedAt: runInput.executedAt,
-            errorMessage: normalizeError7(error)
+            errorMessage: normalizeError8(error)
           })
         };
       }
@@ -17099,7 +17231,7 @@ function createRunUploadHandler(deps = {}) {
           `Scenario: ${runInput.scenarioName}`,
           `ExecutedAt: ${runInput.executedAt}`
         ],
-        stderr: [`ERROR: ${normalizeError7(error)}`]
+        stderr: [`ERROR: ${normalizeError8(error)}`]
       };
     }
   };
@@ -17153,7 +17285,7 @@ function pickConfigArgs9(parsed) {
   }
   return args;
 }
-function normalizeError8(error) {
+function normalizeError9(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -17271,7 +17403,7 @@ function createRunsHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError8(error)}`]
+          stderr: [`ERROR: ${normalizeError9(error)}`]
         };
       }
     }
@@ -19323,7 +19455,7 @@ function pickConfigArgs10(parsed) {
   }
   return args;
 }
-function normalizeError9(error) {
+function normalizeError10(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -19449,7 +19581,7 @@ function createSuitesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError9(error)}`]
+          stderr: [`ERROR: ${normalizeError10(error)}`]
         };
       }
     }
@@ -19490,7 +19622,7 @@ function createSuitesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError9(error)}`]
+          stderr: [`ERROR: ${normalizeError10(error)}`]
         };
       }
     }
@@ -19554,7 +19686,7 @@ function createSuitesHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError9(error)}`]
+          stderr: [`ERROR: ${normalizeError10(error)}`]
         };
       }
     }
@@ -19614,7 +19746,7 @@ function pickConfigArgs11(parsed) {
   }
   return args;
 }
-function normalizeError10(error) {
+function normalizeError11(error) {
   if (error instanceof ForgeClientError) {
     return `${error.code}: ${error.message}`;
   }
@@ -19717,7 +19849,7 @@ function createSyncHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError10(error)}`]
+          stderr: [`ERROR: ${normalizeError11(error)}`]
         };
       }
     }
@@ -19763,7 +19895,7 @@ function createSyncHandler(deps = {}) {
       } catch (error) {
         return {
           exitCode: ExitCode.TransportError,
-          stderr: [`ERROR: ${normalizeError10(error)}`]
+          stderr: [`ERROR: ${normalizeError11(error)}`]
         };
       }
     }
@@ -19797,9 +19929,9 @@ var COMMAND_REGISTRY = [
   },
   {
     name: "bdd",
-    description: "BDD scenario inspection and feature export commands",
+    description: "BDD scenario listing, inspection, and feature export commands",
     subcommands: ["features", "scenarios"],
-    handler: createBddHandler()
+    handler: createBddCommandHandler()
   },
   {
     name: "cases",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatify-au/cli",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "Forge-first CLI for Automatify Jira TestOps",
   "type": "module",
   "bin": {