securewithtrace 0.21.1 → 0.21.3

package/README.md

@@ -129,6 +129,12 @@ tracecli vulnerabilities list --severity CRITICAL --status OPEN
 # Increase result limit
 tracecli vulnerabilities list --limit 100
 
+# Filter by CWE ID
+tracecli vulnerabilities list --filter cweId=CWE-89
+
+# Filter by vulnerability type and scan mode (repeatable)
+tracecli vulnerabilities list --filter vulnerabilityType=SAST --filter scanMode!=DAST
+
 # JSON output for scripting
 tracecli vulnerabilities list --output json | jq '.[].title'
 
@@ -146,6 +152,7 @@ Flags:
 | `--repo <repo>` | | Filter by repository name or `owner/repo` |
 | `--severity <level>` | | Filter by severity |
 | `--status <status>` | | Filter by status |
+| `--filter <expression>` | `-f` | Repeatable filter expression: `field=value` or `field!=value`. Supported fields: `repositoryId`, `severity`, `vulnerabilityType`, `status`, `cweId`, `scanMode` |
 | `--limit <n>` | `-L` | Max results (default: 30, max: 100) |
 | `--output <format>` | `-o` | Output format: `table` (default), `json`, `tsv` |
 | `--web` | `-w` | Open vulnerabilities dashboard in browser |
@@ -179,6 +186,9 @@ tracecli pentest list --limit 50
 # JSON output for scripting
 tracecli pentest list --output json | jq '.[].title'
 
+# Open pentests dashboard in browser
+tracecli pentest list --web
+
 # List findings for a pentest
 tracecli pentest findings list --pentest PT-3
 
@@ -187,6 +197,9 @@ tracecli pentest findings list --pentest PT-3 --output json
 
 # Findings as TSV
 tracecli pentest findings list --pentest PT-3 --output tsv | cut -f1,4
+
+# Open pentests dashboard in browser
+tracecli pentest findings list --pentest PT-3 --web
 ```
 
 Flags for `pentest list`:
@@ -195,6 +208,7 @@ Flags for `pentest list`:
 |------|-----------|-------------|
 | `--limit <n>` | `-L` | Max results (default: 30, max: 100) |
 | `--output <format>` | `-o` | Output format: `table` (default), `json`, `tsv` |
+| `--web` | `-w` | Open pentests dashboard in browser |
 
 Flags for `pentest findings list`:
 
@@ -202,6 +216,7 @@ Flags for `pentest findings list`:
 |------|-----------|-------------|
 | `--pentest <id>` | | Pentest display ID (e.g. `PT-3`) or UUID (required) |
 | `--output <format>` | `-o` | Output format: `table` (default), `json`, `tsv` |
+| `--web` | `-w` | Open pentests dashboard in browser |
 
 ### Upgrades
 
@@ -214,6 +229,9 @@ tracecli upgrade --check
 # Upgrade to the latest published CLI version
 tracecli upgrade
 
+# Non-interactive upgrade (CI/scripts)
+tracecli upgrade --no-confirm
+
 # Alias
 tracecli self-update
 ```
@@ -223,7 +241,8 @@ Flags:
 | Flag | Shorthand | Description |
 |------|-----------|-------------|
 | `--check` | | Check for updates without installing |
-| `--yes` | `-y` | Skip confirmation prompt before install |
+| `--no-confirm` | | Skip confirmation prompt (for CI/scripts) |
+| `--yes` | `-y` | Skip confirmation prompt (alias: `--no-confirm`) |
 
 ## Security Notes
 

package/dist/index.js

@@ -27598,7 +27598,7 @@ function createListCommand() {
       }
       return Math.min(n, MAX_LIMIT);
     }
-  ).option("-o, --output <format>", "Output format: table, json, tsv (default: table)", "table").addHelpText(
+  ).option("-o, --output <format>", "Output format: table, json, tsv (default: table)", "table").option("-w, --web", "Open the pentests dashboard in a browser").addHelpText(
     "after",
     `
 Examples:
@@ -27606,8 +27606,18 @@ Examples:
   tracecli pentest list --status IN_PROGRESS
   tracecli pentest list --limit 10
   tracecli pentest list --output json | jq '.[].title'
-  tracecli pentest list --output tsv | cut -f1,2`
+  tracecli pentest list --output tsv | cut -f1,2
+  tracecli pentest list --web`
   ).action(async (options) => {
+    if (options.web) {
+      const slug = await resolveOrganizationSlug();
+      const url2 = `${getAppBaseUrl()}/dashboard/${slug}/pentests`;
+      const opened = await openBrowser(url2);
+      if (!opened) {
+        console.log(`Open in browser: ${url2}`);
+      }
+      return;
+    }
     const organizationId = await resolveOrganizationId();
     const result = await authenticatedRequest(
       (client) => client.pentest.listPentests({
@@ -27695,7 +27705,7 @@ function createFindingsListCommand() {
       }
       return Math.min(n, MAX_LIMIT);
     }
-  ).option("-o, --output <format>", "Output format: table, json, tsv (default: table)", "table").addHelpText(
+  ).option("-o, --output <format>", "Output format: table, json, tsv (default: table)", "table").option("-w, --web", "Open the pentests dashboard in a browser").addHelpText(
     "after",
     `
 Examples:
@@ -27703,9 +27713,19 @@ Examples:
   tracecli pentest findings list --pentest PT-3 --severity CRITICAL
   tracecli pentest findings list --pentest PT-3 --status OPEN --limit 20
   tracecli pentest findings list --pentest PT-3 --output json
-  tracecli pentest findings list --pentest PT-3 --output tsv | cut -f1,4`
+  tracecli pentest findings list --pentest PT-3 --output tsv | cut -f1,4
+  tracecli pentest findings list --pentest PT-3 --web`
   ).action(
     async (options) => {
+      if (options.web) {
+        const slug = await resolveOrganizationSlug();
+        const url2 = `${getAppBaseUrl()}/dashboard/${slug}/pentests`;
+        const opened = await openBrowser(url2);
+        if (!opened) {
+          console.log(`Open in browser: ${url2}`);
+        }
+        return;
+      }
       const organizationId = await resolveOrganizationId();
       const pentestId = await resolvePentestId(organizationId, options.pentest);
       const result = await authenticatedRequest(
@@ -28902,12 +28922,13 @@ async function promptForUpgradeConfirmation(latestVersion) {
   }
 }
 function createUpgradeCommand() {
-  return new Command("upgrade").alias("self-update").description("Upgrade tracecli to the latest version").option("--check", "Check whether an update is available").option("-y, --yes", "Skip upgrade confirmation prompt").addHelpText(
+  return new Command("upgrade").alias("self-update").description("Upgrade tracecli to the latest version").option("--check", "Check whether an update is available").option("--no-confirm", "Skip upgrade confirmation prompt (for CI/scripts)").option("-y, --yes", "Skip upgrade confirmation prompt (alias: --no-confirm)").addHelpText(
     "after",
     `
 Examples:
   tracecli upgrade
   tracecli upgrade --check
+  tracecli upgrade --no-confirm
   tracecli self-update`
   ).action(async (options) => {
     const availability = await getUpdateAvailability(true);
@@ -28929,7 +28950,7 @@ Examples:
       return;
     }
     const versionLabel = availability.latestVersion ?? "the latest available version";
-    const shouldUpgrade = options.yes ? true : await promptForUpgradeConfirmation(versionLabel);
+    const shouldUpgrade = !options.confirm || !!options.yes ? true : await promptForUpgradeConfirmation(versionLabel);
     if (!shouldUpgrade) {
       console.log("Upgrade cancelled.");
       return;
@@ -28961,6 +28982,34 @@ Examples:
 // src/vulnerabilities/commands.ts
 var DEFAULT_LIMIT3 = 30;
 var MAX_LIMIT3 = 100;
+var VULNERABILITY_FILTER_FIELDS = [
+  "repositoryId",
+  "severity",
+  "vulnerabilityType",
+  "status",
+  "cweId",
+  "scanMode"
+];
+function parseVulnerabilityFilter(expression) {
+  const match = expression.match(/^([^!=]+)(!=|=)(.+)$/);
+  if (!match?.[1] || !match[2] || !match[3]) {
+    return {
+      error: `Invalid filter expression '${expression}'. Expected format: field=value or field!=value (e.g. cweId=CWE-89).`
+    };
+  }
+  const field = match[1].trim();
+  const op = match[2];
+  const value = match[3].trim();
+  if (value.length === 0) {
+    return { error: `Filter value cannot be empty in expression '${expression}'.` };
+  }
+  if (!VULNERABILITY_FILTER_FIELDS.includes(field)) {
+    return {
+      error: `Unknown filter field '${field}'. Supported fields: ${VULNERABILITY_FILTER_FIELDS.join(", ")}.`
+    };
+  }
+  return { field, operator: op === "!=" ? "neq" : "eq", value };
+}
 async function resolveRepositoryIdAuthenticated(organizationId, repoIdentifier) {
   const result = await authenticatedRequest(
     (client) => client.repository.listRepositories({
@@ -29078,6 +29127,11 @@ function createListCommand3() {
       }
       return Math.min(n, MAX_LIMIT3);
     }
+  ).option(
+    "-f, --filter <expression>",
+    "Additional filter expression: field=value or field!=value. Repeatable. Supported fields: vulnerabilityType, cweId, scanMode (and any other API-supported field).",
+    (value, previous) => [...previous, value],
+    []
   ).option("-o, --output <format>", "Output format: table, json, tsv (default: table)", "table").option("-w, --web", "Open the vulnerabilities dashboard in a browser").addHelpText(
     "after",
     `
@@ -29085,6 +29139,8 @@ Examples:
   tracecli vulnerabilities list
   tracecli vulnerabilities list --severity CRITICAL --status OPEN
   tracecli vulnerabilities list --repo securewithtrace/trace --limit 50
+  tracecli vulnerabilities list --filter cweId=CWE-89
+  tracecli vulnerabilities list --filter vulnerabilityType=SAST --filter scanMode=sast
   tracecli vulnerabilities list --output json | jq '.[].title'
   tracecli vulnerabilities list --output tsv | cut -f1,7
   tracecli vulnerabilities list --web`
@@ -29111,6 +29167,14 @@ Examples:
       if (options.status) {
         conditions.push({ field: "status", operator: "eq", value: options.status });
       }
+      for (const expression of options.filter) {
+        const parsed = parseVulnerabilityFilter(expression);
+        if ("error" in parsed) {
+          console.error(parsed.error);
+          process.exit(1);
+        }
+        conditions.push({ field: parsed.field, operator: parsed.operator, value: parsed.value });
+      }
       const filterBody = {
         filters: conditions.length > 0 ? { operator: "and", conditions } : void 0,
         defaultBranchOnly: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "securewithtrace",
-  "version": "0.21.1",
+  "version": "0.21.3",
   "description": "Official Trace CLI for vulnerability intelligence in your terminal",
   "type": "module",
   "bin": {