@andrian.yablonskyy/thub-agent 1.0.32 → 1.0.34

package/README.md

@@ -29,10 +29,10 @@ thub config set user "Your Name"     # optional default --user
 
 ```
 thub run      [options]        Submit a test job and follow its log
-thub status   <jobId>          Show status; follow log if running, show artifacts if done
+thub status   <jobId>          Show status; follow log if running, verdict, test counts and artifacts if done
 thub cancel   <jobId>          Cancel a job
 thub resources                 List resources and their status
-thub jobs     [--mine] [--state <s>]   List recent jobs
+thub jobs     [--mine] [--state <s>]   List recent jobs (a cli token: only its own; a ci token: all, or its own with --mine)
 thub config   set <key> <value>        Save coordinator URL / token / default group / default user locally
 thub check-update                      Compare this Agent with the latest published version
 thub self-update [--to <x.y.z>]        Update this Agent with npm i -g
@@ -68,7 +68,7 @@ Key options for `thub run`. **On the Client** names the environment variable the
 | `--json` | Machine-readable output. | — (Agent only) |
 
 - `thub run` prints the **job ID**, then streams logs until Ctrl-C. Ctrl-C detaches; the job keeps running on the Client.
-- `thub status <jobId>` prints the current state; if active it keeps streaming, if done it prints the verdict and artifact download links. `--json` prints the job once and never follows it (see [Job status and PASS/FAIL](#job-status-and-passfail)).
+- `thub status <jobId>` prints the current state; if active it keeps streaming, if done it prints the verdict, the command's exit code and the JUnit test counts. `--json` prints the job once and never follows it (see [Job status and PASS/FAIL](#job-status-and-passfail)).
 
 Exit codes make the Agent usable as a CI step:
 
@@ -222,14 +222,14 @@ thub run --type sw --git-repo git@bitbucket.org:yourorg/tests.git main --depth 1
 
 ## Job status and PASS/FAIL
 
-The verdict is `--command`'s exit code: `0` → **PASSED**, anything else → **FAILED**. ERROR, TIMEOUT, LOST and CANCELED mean the job didn't run to a verdict. JUnit XML written to `results/` or `artifacts/` in the work directory is uploaded and summed into the job's `summary`.
+The verdict is `--command`'s exit code: `0` → **PASSED**, anything else → **FAILED**. ERROR, TIMEOUT, LOST and CANCELED mean the job didn't run to a verdict. JUnit XML written to `results/` or `artifacts/` in the work directory is summed into the job's `summary` by the Client. Nothing is uploaded: a job's files stay in its workspace on the Client, deleted when it ends — publish anything you need to keep from `--command`, e.g. to Artifactory.
 
 **In CI:** `thub run … --wait` exits with the verdict code (table above): `0` PASSED, `1` FAILED, `2` infrastructure, `3` canceled.
 
 **Check a job:**
 
 ```bash
-thub status M-00125          # state; follows the log while active; then "Verdict: …" and artifact links; exit = verdict
+thub status M-00125          # state; follows the log while active; then "Verdict: …" and test counts; exit = verdict
 thub jobs --mine --state FAILED
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrian.yablonskyy/thub-agent",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "description": "TestHub Agent CLI — the single entry point CI/CD and developers use to submit and follow test jobs",
   "bin": {
     "thub": "./src/cli.js"
@@ -12,7 +12,7 @@
     "lint:fix": "eslint . --fix"
   },
   "dependencies": {
-    "@andrian.yablonskyy/thub-common": "^1.0.32",
+    "@andrian.yablonskyy/thub-common": "^1.0.33",
     "commander": "^13.1.0"
   },
   "devDependencies": {

package/src/cli.js

@@ -207,7 +207,7 @@ program
   )
   .option(
     '--dry-run',
-    'Exercise the full pipeline (schedule, accept, state transitions, logs, artifact, result) ' +
+    'Exercise the full pipeline (schedule, accept, state transitions, logs, result) ' +
       'without the Client flashing/running anything for real',
     false
   )
@@ -252,7 +252,7 @@ program
 
 program
   .command('status')
-  .description('Show status; follow log if running, show artifacts if done')
+  .description('Show status; follow log if running, verdict, test counts and artifacts if done')
   .argument('<jobId>')
   .option('--json', 'Print the job as JSON once, without following it; exit code: its verdict, or 5 while it\'s still active', false)
   .action(async (jobId, opts) => {
@@ -274,10 +274,20 @@ program
         return process.exit(code);
       }
 
-      const { artifacts } = await c.get(`/jobs/${jobId}/artifacts`);
-      console.log(`Verdict: ${job.state}`);
-      for (const a of artifacts){
-        console.log(`  ${a.name}  ${a.url}`);
+      console.log(`Verdict: ${job.state}${job.exit_code != null ? ` (exit code ${job.exit_code})` : ''}`);
+      const s = job.summary;
+      if (s && Number.isFinite(s.total) && s.total > 0){
+        console.log(`Tests: ${s.total} total, ${s.passed} passed, ${s.failed} failed, ${s.skipped} skipped`);
+      }
+      if (job.message){
+        console.log(`Message: ${job.message}`);
+      }
+      // What the job published elsewhere and reported (links, not files).
+      if (job.artifacts?.length){
+        console.log('Artifacts:');
+        for (const a of job.artifacts){
+          console.log(`  ${a.name}  ${a.size != null ? formatBytes(a.size) : '—'}  ${a.link}`);
+        }
       }
       process.exit(exitCodeForJobState(job.state));
     }
@@ -327,7 +337,7 @@ program
 program
   .command('jobs')
   .description('List recent jobs')
-  .option('--mine', 'Only jobs submitted by this agent token', false)
+  .option('--mine', 'Only jobs submitted by this agent token (always so for a cli token, which sees only its own)', false)
   .option('--state <state>', 'Filter by state')
   .option('--json', 'Machine-readable output', false)
   .action(async (opts) => {
@@ -349,6 +359,18 @@ program
     }
   });
 
+// 1233 -> "1.2 KB" (1024-based), for artifact sizes.
+function formatBytes(bytes){
+  const units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'];
+  let value = bytes,
+    unit = 0;
+  while (value >= 1024 && unit < units.length - 1){
+    value /= 1024;
+    unit += 1;
+  }
+  return unit === 0 ? `${value} B` : `${value < 10 ? value.toFixed(1) : Math.round(value)} ${units[unit]}`;
+}
+
 const config = program.command('config').description('Manage local Agent configuration');
 config
   .command('set')

package/src/streaming.js

@@ -82,9 +82,6 @@ async function followJob(client, jobId, { fromSeq = 0, waitMode = false, print =
             }
             else if (event === 'end'){
               print(`\nJob finished: ${data.state}`);
-              if (data.artifactsUrl){
-                print(`Artifacts: ${data.artifactsUrl}`);
-              }
               resolveOnce(exitCodeForJobState(data.state));
             }
           }