@andrian.yablonskyy/thub-agent 1.1.10 → 1.1.14

package/README.md

@@ -1,8 +1,8 @@
 # @andrian.yablonskyy/thub-agent
 
-The Agent CLI (`thub`) for [TestHub](https://github.com/andrianyablonskyy/thub) — a self-hosted job network that lets CI/CD pipelines and individual developers run firmware tests on real hardware or emulators in a private lab. `thub` is the single entry point for both: it's stateless, everything it knows comes from the [Coordinator](https://github.com/andrianyablonskyy/thub-coordinator) API, and it runs identically on a GitHub-hosted runner and a developer laptop — a developer reproducing a CI failure runs exactly the same command the pipeline runs.
+The Agent CLI (`thub`) is a self-hosted job network that lets CI/CD pipelines and individual developers run firmware tests on real hardware or emulators in a private lab. `thub` is the single entry point for both: it's stateless, everything it knows comes from the [Coordinator](https://github.com/andrianyablonskyy/thub-coordinator) API, and it runs identically on a GitHub-hosted runner and a developer laptop — a developer reproducing a CI failure runs exactly the same command the pipeline runs.
 
-See the [main TestHub repo](https://github.com/andrianyablonskyy/thub) for the full system architecture and how this fits with the Coordinator and the [Client](https://github.com/andrianyablonskyy/thub-client).
+See how this fits with the [Coordinator](https://github.com/andrianyablonskyy/thub-coordinator) and the [Client](https://github.com/andrianyablonskyy/thub-client).
 
 ## Install
 
@@ -14,7 +14,7 @@ npx -y @andrian.yablonskyy/thub-agent run --type sw --download-file "$IMAGE_URL"
 
 ## Configuration
 
-Read from flags (`--url`, `--key`), then environment (`THUB_URL`, `THUB_KEY`; the old names `--token`/`THUB_TOKEN` still work), then `~/.config/thub/agent.json`, then a bundled default. `url`/`token` are required by the time a command actually talks to the Coordinator; `group`/`user` are optional everywhere.
+Read from flags (`--url`, `--key`), then environment (`THUB_URL`, `THUB_KEY`), then `~/.config/thub/agent.json`, then a bundled default. `url`/`key` are required by the time a command actually talks to the Coordinator; `group`/`user` are optional everywhere.
 
 `npm install -g` creates `~/.config/thub/agent.json` for you (blank `url`/`token`, so nothing works until you set them) if it doesn't already exist — a re-install never overwrites it. Fill it in with `thub config set`:
 
@@ -347,7 +347,7 @@ Report only, quietly, with the verdict as a commit status:
           commit-status: true
 ```
 
-Complete workflows, every input, and how the PR comment and test table work are in `packages/action/README.md` and the main README §11.1.
+Complete workflows, every input, and how the PR comment and test table work are in the [thub-action README](https://github.com/andrianyablonskyy/thub-action#readme) and the main README §11.1.
 
 With the Agent directly:
 

package/RELEASE.md

@@ -2,6 +2,50 @@
 
 What changed in each release, newest first. `## Unreleased` collects the changes since the version on npm; `bin/publish` turns that heading into the version and date it releases.
 
+## 1.1.14 — 2026-10-09
+
+### Removed
+
+- **`--token`, `THUB_TOKEN` and the config file's `token`.** Use `--key`, `THUB_KEY` and `key`; `thub config set` accepts `url` and `key` only.
+- The unused `PLATFORMS` export of `report.js`.
+
+## 1.1.13 — 2026-10-09
+
+Changes since 1.1.12.
+
+### Changed
+
+- **Back on npm.** Install with `npm i -g @andrian.yablonskyy/thub-agent`. `check-update`, `self-update` and dashboard-requested updates use npm again, and require thub-common from npm. The git-based updates in the versions released only as git tags (1.1.11–1.1.12) are gone. An install of one of those updates from git tags, which are still pushed with every release, so it keeps updating.
+
+## 1.1.12 — 2026-10-08
+
+Changes since 1.1.11.
+
+### Changed
+
+- **Updates come from the Agent's git repository.** `thub check-update` reads its newest release tag. `thub self-update` and an update requested on the dashboard install with `npm i -g --install-links git+https://github.com/andrianyablonskyy/thub-agent.git#vX.Y.Z`, retrying with sudo on a terminal.
+- **Install:** `npm i -g --install-links git+https://github.com/andrianyablonskyy/thub-agent.git`, or in CI `npx -y --package='git+https://github.com/andrianyablonskyy/thub-agent.git#semver:*' thub …`.
+
+### Upgrading from npm
+
+- An Agent installed from npm (1.1.10 or older) can only update from npm, where nothing new comes: reinstall it once from git with the command above.
+
+## 1.1.11 — 2026-10-08
+
+Changes since 1.1.11.
+
+### Changed
+
+- **Not published to npm any more.** A release is its `vX.Y.Z` tag on GitHub. thub-common comes from its public repository by tag (`git+https://github.com/andrianyablonskyy/thub-common.git#semver:^…`), so installing needs `git` on the host. `package.json` has `"private": true`.
+
+## 1.1.11 — 2026-10-08
+
+Changes since 1.1.10.
+
+### Changed
+
+- When the Coordinator rejects an option this Agent sent (it's older), the hint says to update it with **Update app** on the dashboard or `thub-admin self-update` on its host. The Coordinator isn't on npm any more.
+
 ## 1.1.8 — 2026-10-08
 
 Changes since 1.1.7.

package/eslint.config.js

@@ -29,6 +29,9 @@ module.exports = [
     },
     rules: {
       // Core JS
+      // Dead code: unused variables, imports and functions. Unused trailing
+      // arguments are fine when named _x (an Express error handler's next).
+      'no-unused-vars': ['error', { args: 'after-used', argsIgnorePattern: '^_', caughtErrors: 'none', ignoreRestSiblings: true }],
       'prefer-const': 'error',
       strict: ['error', 'global'],
       camelcase: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrian.yablonskyy/thub-agent",
-  "version": "1.1.10",
+  "version": "1.1.14",
   "description": "TestHub Agent CLI — the single entry point CI/CD and developers use to submit and follow test jobs",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Andrian Yablonskyy <andrian.yablonskyy@gmail.com>",
@@ -15,7 +15,7 @@
     "lint:fix": "eslint . --fix"
   },
   "dependencies": {
-    "@andrian.yablonskyy/thub-common": "^1.1.9",
+    "@andrian.yablonskyy/thub-common": "^2.0.0",
     "commander": "^13.1.0"
   },
   "devDependencies": {

package/src/cli.js

@@ -15,7 +15,7 @@
 
 'use strict';
 
-const { Command, Option } = require('commander'),
+const { Command } = require('commander'),
   {
     ApiClient, EXIT_CODES, ACTIVE_JOB_STATES, exitCodeForJobState, PACKAGES, fetchLatestVersion, isNewer, isValidVersion, formatDateTime,
     parseEnvList, POWER_ACTIONS, DEFAULT_RESET_DELAY_SEC, MAX_RESET_DELAY_SEC, powerRequestErrors
@@ -33,7 +33,6 @@ program
   .description('TestHub Agent — submit test jobs and follow them, from CI or your laptop')
   .option('--url <url>', 'Coordinator URL (overrides THUB_URL / config file)')
   .option('--key <key>', 'Your access key (overrides THUB_KEY / config file)')
-  .addOption(new Option('--token <token>', 'Old name of --key').hideHelp())
   .version(version);
 
 // An admin-requested self-update (README §10.2) is applied at the start of
@@ -126,7 +125,7 @@ function fail(err){
     }
     catch { /* keep the generic wording */ }
     console.error(`Hint: the Coordinator at ${url} doesn't know an option ` +
-      `this Agent (v${version}) sent — update the Coordinator (dashboard → Update app, or npm i -g @andrian.yablonskyy/thub-coordinator@latest).`);
+      `this Agent (v${version}) sent — update the Coordinator (dashboard → Update app, or on its host: thub-admin self-update).`);
   }
   process.exit(err.status && Number.isInteger(err.status) && err.status < 100 ? err.status : EXIT_CODES.USAGE);
 }
@@ -436,19 +435,12 @@ config
   .argument('<name>', 'url | key')
   .argument('<value>')
   .action((name, value) => {
-    // `token` is the old name of `key`.
-    const setting = name === 'token' ? 'key' : name;
-    if (!['url', 'key'].includes(setting)){
-      console.error(setting === 'group'
-        ? 'Error: a job\'s group is set on the dashboard now (Users / CI tokens), not in the Agent'
-        : setting === 'user'
-          ? 'Error: a job\'s user comes from your access key now (thub whoami shows it), not from the Agent'
-          : 'Error: the setting must be "url" or "key"');
+    if (!['url', 'key'].includes(name)){
+      console.error('Error: the setting must be "url" or "key"');
       process.exit(EXIT_CODES.USAGE);
     }
-    const { token: _old, ...current } = readConfigFile();
-    writeConfigFile({ ...(setting === 'key' ? current : { ...current, ...(_old ? { token: _old } : {}) }), [setting]: value });
-    console.log(`Saved ${setting} to config`);
+    writeConfigFile({ ...readConfigFile(), [name]: value });
+    console.log(`Saved ${name} to config`);
   });
 
 // Who this access key belongs to (§10.3).
@@ -498,8 +490,7 @@ keyCommand
       const { keySource } = resolveConnection(program.opts()),
         { key, username } = await client().post('/me/key/rotate');
       if (keySource === 'file'){
-        const { token: _old, ...current } = readConfigFile();
-        writeConfigFile({ ...current, key });
+        writeConfigFile({ ...readConfigFile(), key });
         console.log(`New access key for ${username} saved to ${CONFIG_PATH} — the old one has stopped working.`);
       }
       else {

package/src/config.js

@@ -1,6 +1,6 @@
 /**
  * @file        packages/agent/src/config.js
- * @description Agent config resolution: flags > env > config file > bundled default (url/token/user)
+ * @description Agent config resolution: flags > env > config file > bundled default (url and access key)
  *
  * @author      Andrian Yablonskyy
  * @copyright   Copyright (c) 2026 Andrian Yablonskyy. All rights reserved.
@@ -18,8 +18,7 @@ const fs = require('node:fs'),
   path = require('node:path');
 
 // §7: "Configuration is read from flags, then environment (THUB_URL,
-// THUB_KEY), then ~/.config/thub/agent.json." The access key (§10.3) used to
-// be called a token: --token, THUB_TOKEN and a saved `token` still work.
+// THUB_KEY), then ~/.config/thub/agent.json."
 const CONFIG_PATH = path.join(os.homedir(), '.config', 'thub', 'agent.json'),
 
   // Bundled with the package as a last-resort default, below the user's own
@@ -51,9 +50,9 @@ function writeConfigFile(config){
 function resolveConnection(flags = {}){
   const file = { ...readJsonFile(PACKAGE_DEFAULT_CONFIG_PATH), ...readConfigFile() },
     url = flags.url || process.env.THUB_URL || file.url,
-    [token, keySource] = flags.key || flags.token ? [flags.key || flags.token, 'flag']
-      : process.env.THUB_KEY || process.env.THUB_TOKEN ? [process.env.THUB_KEY || process.env.THUB_TOKEN, process.env.THUB_KEY ? 'THUB_KEY' : 'THUB_TOKEN']
-        : file.key || file.token ? [file.key || file.token, 'file'] : [null, null];
+    [token, keySource] = flags.key ? [flags.key, 'flag']
+      : process.env.THUB_KEY ? [process.env.THUB_KEY, 'THUB_KEY']
+        : file.key ? [file.key, 'file'] : [null, null];
   if (!url || !token){
     const err = new Error(
       'Missing Coordinator URL or access key. Set them with `thub config set url <url>` and `thub config set key <key>`, ' +

package/src/report.js

@@ -303,4 +303,4 @@ async function report(api, baseUrl, jobId, opts, { env = process.env, out = cons
   return result;
 }
 
-module.exports = { report, PLATFORMS };
+module.exports = { report };