@testcollab/cli 1.6.0 → 1.8.0

package/README.md

@@ -85,6 +85,20 @@ tc report \
 | `--result-file <path>` | Yes | Path to the result file |
 | `--api-key <key>` | No | TestCollab API key (or set `TESTCOLLAB_TOKEN` env var) |
 | `--api-url <url>` | No | API base URL override (default: `https://api.testcollab.io`). Use `https://api-eu.testcollab.io` for EU region. |
+| `--skip-missing` | No | Mark test cases in the test plan but not in the result file as **skipped** |
+
+#### `--skip-missing`
+
+By default, test cases in the test plan that don't appear in the result file are left untouched. When `--skip-missing` is passed, these unmatched cases are automatically marked as **skipped**. This is useful when your result file only contains the tests that actually ran, and you want the full test plan status to reflect that anything not executed was skipped.
+
+```bash
+tc report \
+  --project 123 \
+  --test-plan-id 555 \
+  --format junit \
+  --result-file ./results.xml \
+  --skip-missing
+```
 
 #### Mapping test cases
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testcollab/cli",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Command-line interface for TestCollab operations",
   "main": "src/index.js",
   "bin": {

package/src/commands/report.js

@@ -775,6 +775,18 @@ class TcApiClient {
       return false;
     }
   }
+
+  async bulkSkipTestCases(data) {
+    try {
+      const result = await this.request('/testplantestcases/bulkAction', {
+        method: 'POST',
+        body: data
+      });
+      return result;
+    } catch {
+      return null;
+    }
+  }
 }
 
 function findMatchingExecutedCase(casesAssigned, runRecord, hasConfig, configId) {
@@ -834,7 +846,8 @@ async function uploadUsingReporterFlow({
   apiUrl,
   hasConfig,
   resultsToUpload,
-  unresolvedIds
+  unresolvedIds,
+  skipMissing = false
 }) {
   const tcApiInstance = new TcApiClient({
     accessToken: apiKey,
@@ -883,9 +896,11 @@ async function uploadUsingReporterFlow({
 
   const unmatchedCaseIds = new Set();
   const unmatchedConfigIds = new Set();
+  const matchedExecCaseIds = new Set();
   let matched = 0;
   let updated = 0;
   let errors = 0;
+  let skippedMissing = 0;
 
   const configIds = Object.keys(resultsToUpload);
 
@@ -916,6 +931,7 @@ async function uploadUsingReporterFlow({
         }
 
         matched += 1;
+        matchedExecCaseIds.add(execCase.id);
 
         const updatePayload = buildUpdatePayload({
           execCase,
@@ -955,10 +971,67 @@ async function uploadUsingReporterFlow({
     }
   }
 
+  // --skip-missing: mark all assigned cases not present in the result file as skipped
+  if (skipMissing) {
+    const missingCases = casesAssigned.filter(
+      (assignedCase) => assignedCase && assignedCase.id && !matchedExecCaseIds.has(assignedCase.id)
+    );
+
+    if (missingCases.length) {
+      console.log(`\n⏭️  --skip-missing: marking ${missingCases.length} unmatched test case(s) as skipped...`);
+
+      // Group missing cases by config ID — the bulkAction endpoint requires
+      // test_plan_config when configs exist, so we need one call per config
+      const missingByConfig = {};
+      for (const c of missingCases) {
+        const tptc = c.test_plan_test_case;
+        const testCaseId = tptc && typeof tptc === 'object' ? tptc.test_case : null;
+        if (testCaseId === null || testCaseId === undefined) {
+          continue;
+        }
+        const configId = c.test_plan_config && typeof c.test_plan_config === 'object'
+          ? String(c.test_plan_config.id)
+          : c.test_plan_config ? String(c.test_plan_config) : '0';
+        if (!missingByConfig[configId]) {
+          missingByConfig[configId] = [];
+        }
+        missingByConfig[configId].push(testCaseId);
+      }
+
+      for (const [configId, testCaseIds] of Object.entries(missingByConfig)) {
+        if (!testCaseIds.length) {
+          continue;
+        }
+
+        const bulkPayload = {
+          actionType: 'skip',
+          testcases: testCaseIds,
+          project: projectId,
+          testplan: testPlanId
+        };
+
+        if (configId && configId !== '0') {
+          bulkPayload.test_plan_config = Number(configId);
+        }
+
+        const bulkResult = await tcApiInstance.bulkSkipTestCases(bulkPayload);
+
+        if (bulkResult && bulkResult.status === true) {
+          skippedMissing += bulkResult.affected || testCaseIds.length;
+        } else {
+          const errMsg = (bulkResult && bulkResult.message) || 'Unknown error';
+          console.warn(`⚠️  Bulk skip failed for config ${configId}: ${errMsg}`);
+          errors += testCaseIds.length;
+        }
+      }
+    }
+  }
+
   return {
     matched,
     updated,
     errors,
+    skippedMissing,
     unresolvedIds: unique(unresolvedIds || []),
     unmatchedCaseIds: unique([...unmatchedCaseIds]),
     unmatchedConfigIds: unique([...unmatchedConfigIds])
@@ -1001,6 +1074,9 @@ function validateRequiredOptions({ apiKey, project, testPlanId }) {
 function logUploadSummary(formatLabel, summary) {
   console.log(`✅ ${formatLabel} report processed (${summary.matched || 0} matched, ${summary.updated || 0} updated)`);
 
+  if (summary.skippedMissing) {
+    console.log(`⏭️  ${summary.skippedMissing} test case(s) not in result file marked as skipped`);
+  }
   if (summary.unresolvedIds?.length) {
     console.warn(`⚠️  ${summary.unresolvedIds.length} testcase(s) missing TestCollab ID`);
   }
@@ -1029,7 +1105,8 @@ export async function report(options) {
     testPlanId,
     format,
     resultFile,
-    apiUrl
+    apiUrl,
+    skipMissing
   } = options;
 
   // Resolve API key: --api-key flag takes precedence, then TESTCOLLAB_TOKEN env var
@@ -1076,7 +1153,8 @@ export async function report(options) {
         apiUrl,
         hasConfig: parsedReport.hasConfig,
         resultsToUpload: parsedReport.resultsToUpload,
-        unresolvedIds: parsedReport.unresolvedIds
+        unresolvedIds: parsedReport.unresolvedIds,
+        skipMissing: Boolean(skipMissing)
       });
 
       logUploadSummary('JUnit', summary);
@@ -1105,7 +1183,8 @@ export async function report(options) {
       apiUrl,
       hasConfig: parsedReport.hasConfig,
       resultsToUpload: parsedReport.resultsToUpload,
-      unresolvedIds: parsedReport.unresolvedIds
+      unresolvedIds: parsedReport.unresolvedIds,
+      skipMissing: Boolean(skipMissing)
     });
 
     logUploadSummary('Mochawesome', summary);

package/src/index.js

@@ -51,6 +51,7 @@ program
   .requiredOption('--format <type>', 'Result format: mochawesome or junit')
   .requiredOption('--result-file <path>', 'Path to test result file')
   .option('--api-url <url>', 'TestCollab API base URL override', 'https://api.testcollab.io')
+  .option('--skip-missing', 'Mark test cases in the test plan but not in the result file as skipped', false)
   .action(report);
 
 // Add specgen command