@pixlcore/xycli 1.2.0 → 1.2.1

package/.github/workflows/offline-tests.yml

@@ -2,7 +2,7 @@ name: Offline Tests
 
 on:
   push:
-  pull_request:
+    tags: [ '*' ]
 
 permissions:
   contents: read

package/LICENSE.md

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026 PixlCore LLC & CONTRIBUTORS.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -243,7 +243,7 @@ xy job JOB_ID
 xy job log JOB_ID --download ./job-output.log
 ```
 
-You can also rerun a previous job with `xy job run JOB_ID --follow`, or resume a workflow job where supported. Job reports bring together results, performance, output, files, and workflow details.
+You can also rerun a previous job with `xy job run JOB_ID --follow`, or resume a workflow job where supported. When a job you are following fails and is retried, the CLI automatically follows the retry, continuing until the job succeeds or no further retry is scheduled. Job reports bring together results, performance, output, files, and workflow details.
 
 - **Command reference:** [Job searches](docs/help.md#jobs) and [Job operations](docs/help.md#job).
 - **Learn more about xyOps:** [xyOps Events and job execution](https://docs.xyops.io/events) and [xyOps Job data](https://docs.xyops.io/data#job).

package/lib/jobs.js

@@ -173,7 +173,7 @@ module.exports = {
 		// check if job is still active
 		if (job.final) {
 			// job must have completed, hop over to job details
-			return await this.cmd_get_job();
+			return await this.cmd_get_job(true);
 		}
 		
 		// print def list of job summary data
@@ -231,10 +231,10 @@ module.exports = {
 		
 		// this.printJobCompletionBanner(job);
 		// delete this.activeJobs[this.args.id];
-		await this.cmd_get_job();
+		await this.cmd_get_job(true);
 	},
 	
-	async cmd_get_job() {
+	async cmd_get_job(follow = false) {
 		// get job progress or result
 		if (this.args.other && this.args.other.length && !this.args.id) {
 			this.args.id = this.args.other.shift();
@@ -255,6 +255,24 @@ module.exports = {
 			return await this.cmd_stream_job();
 		}
 		
+		// A live follow continues through retries using the completed record,
+		// which includes additional jobs that may be absent from stream updates.
+		// Ordinary lookups of completed jobs still display the requested attempt.
+		if (follow && job.code && Array.isArray(job.jobs)) {
+			var retry = job.jobs.find( item => item && item.id && (item.reason === 'retry') );
+			if (retry) {
+				if (!this.format.match(/json/)) {
+					this.printJobCompletionBanner(job);
+					println( "\n " + yellow.bold("Following retry: ") + this.getNiceJob(retry.id) );
+				}
+				
+				// Reuse the stream entry point so queued retries and attempts that
+				// already finished before we attached are handled the same way.
+				this.args.id = retry.id;
+				return await this.cmd_stream_job();
+			}
+		}
+		
 		if (this.format.match(/json/)) {
 			return this.jsonOutput(job);
 		}

package/lib/mcp.js

@@ -44,6 +44,9 @@ function configuration(config, args) {
 }
 
 async function main(argv) {
+	// Give the long-running MCP server a recognizable name in process lists.
+	process.title = 'xyOps MCP Server';
+	
 	const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: {
 		port: { type: 'string' }, host: { type: 'string' }, 'read-only': { type: 'boolean' },
 		'tls-cert': { type: 'string' }, 'tls-key': { type: 'string' },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pixlcore/xycli",
-	"version": "1.2.0",
+	"version": "1.2.1",
 	"description": "A complete command-line interface for the xyOps workflow automation system.",
 	"author": "Joseph Huckaby <jhuckaby@pixlcore.com>",
 	"homepage": "https://github.com/pixlcore/xycli",
@@ -21,7 +21,7 @@
 	],
 	"scripts": {
 		"test": "node test.js",
-		"test:offline": "node --test test/config.test.js test/help.test.js test/markdown.test.js test/sync-buckets-unit.test.js test/sync-syshook-unit.test.js test/sync-unit.test.js test/toast.test.js test/upgrade.test.js test/utils-unit.test.js test/mcp-tools-unit.test.js test/mcp-stdio-unit.test.js test/mcp-http-unit.test.js",
+		"test:offline": "node --test test/config.test.js test/help.test.js test/jobs-follow-unit.test.js test/markdown.test.js test/sync-buckets-unit.test.js test/sync-syshook-unit.test.js test/sync-unit.test.js test/toast.test.js test/upgrade.test.js test/utils-unit.test.js test/mcp-tools-unit.test.js test/mcp-stdio-unit.test.js test/mcp-http-unit.test.js",
 		"changelog": "node tools/changelog.js"
 	},
 	"overrides": {

package/test/README.md

@@ -59,6 +59,7 @@ node --test test/config.test.js test/sync-buckets-unit.test.js test/sync-unit.te
 | `config` | Offline user-file updates, inherited-setting isolation, missing-file creation, dotted edits, permissions, and read-only display |
 | `events` | CRUD, dependency filters, nested edits, triggers, actions, limits, fields, validation, and help |
 | `jobs` | Event launch, parameter and input overrides, completed reports, output logs, search, rerun, deletion, validation, and help |
+| `jobs-follow-unit` | Offline live-follow retry chains, queued and already-completed retries, completed-job lookups, and stopping without a retry |
 | `log` | Log searches, latest rows, matching, column selection, native output |
 | `markdown` | Terminal rendering, inline formatting inside list items, typographic bullets, and output margins |
 | `monitors` | CRUD, groups, evaluator requests, type conversions, validation, help |

package/test/jobs-follow-unit.test.js

@@ -0,0 +1,107 @@
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const cli = require('pixl-cli');
+const jobs = require('../lib/jobs.js');
+
+cli.global();
+
+function makeFollower(t, records) {
+	// Exercise the real command transitions with an offline SDK stub.  Streaming
+	// finishes an attempt, but only getJob exposes its additional-job links.
+	const streamed = [];
+	const results = [];
+	const context = {
+		...jobs,
+		args: { id: records[0].id },
+		format: 'json',
+		async getMultiple() {},
+		api: {
+			async getJob({ id }) {
+				const job = records.find( item => item.id === id );
+				assert.ok(job, 'Unexpected job lookup: ' + id);
+				return { data: { job: { ...job } } };
+			},
+			async streamJob({ id }, callback) {
+				const job = records.find( item => item.id === id );
+				streamed.push(id);
+				job.final = true;
+				callback({ id, final: true, code: job.code });
+				return {};
+			}
+		},
+		jsonOutput(job) { results.push(job.id); },
+		die(message) { throw new Error(message); },
+		color() { return cli.chalk.white; },
+		printBoxList() {}
+	};
+	
+	// Keep terminal rendering out of these tests, including progress timers.
+	for (const name of ['start', 'update', 'end']) t.mock.method(cli.progress, name, () => {});
+	for (const name of ['print', 'println', 'verboseln']) t.mock.method(global, name, () => {});
+	for (const name of ['getNiceJob', 'getNiceJobEvent', 'getNiceCategory', 'getNicePlugin',
+		'getNiceTargets', 'getNiceServer', 'getNiceAlgo', 'getNiceJobSource',
+		'getRelativeDateTime', 'getNiceJobState']) {
+		context[name] = () => '';
+	}
+	
+	return { context, streamed, results };
+}
+
+test('live follow crosses completed and queued retries, ignoring unrelated jobs', async t => {
+	const { context, streamed, results } = makeFollower(t, [
+		{ id: 'initial', code: 1, jobs: [{ id: 'other', reason: 'action' }, { id: 'retry1', reason: 'retry' }] },
+		{ id: 'retry1', final: true, code: 'warning', jobs: [{ id: 'retry2', reason: 'retry' }] },
+		{ id: 'retry2', state: 'queued', code: 0 }
+	]);
+	
+	await context.cmd_stream_job();
+	assert.deepEqual(streamed, ['initial', 'retry2']);
+	assert.deepEqual(results, ['retry2']);
+});
+
+test('directly opening an active job also follows its retry', async t => {
+	const { context, streamed, results } = makeFollower(t, [
+		{ id: 'initial', code: 1, jobs: [{ id: 'retry', reason: 'retry' }] },
+		{ id: 'retry', code: 2 }
+	]);
+	
+	await context.cmd_get_job();
+	assert.deepEqual(streamed, ['initial', 'retry']);
+	assert.deepEqual(results, ['retry']);
+});
+
+test('follow catches retries when the initial job finishes before streaming starts', async t => {
+	const { context, streamed, results } = makeFollower(t, [
+		{ id: 'initial', final: true, code: 1, jobs: [{ id: 'retry', reason: 'retry' }] },
+		{ id: 'retry', code: 0 }
+	]);
+	
+	await context.cmd_stream_job();
+	assert.deepEqual(streamed, ['retry']);
+	assert.deepEqual(results, ['retry']);
+});
+
+test('opening a completed job preserves the requested attempt', async t => {
+	const { context, streamed, results } = makeFollower(t, [
+		{ id: 'initial', final: true, code: 1, jobs: [{ id: 'retry', reason: 'retry' }] }
+	]);
+	
+	await context.cmd_get_job();
+	assert.deepEqual(streamed, []);
+	assert.deepEqual(results, ['initial']);
+});
+
+test('follow stops on success or failure without a valid retry link', async t => {
+	for (const record of [
+		{ code: 0, jobs: [{ id: 'other', reason: 'retry' }] },
+		{ code: 1 },
+		{ code: 1, jobs: [] },
+		{ code: 1, jobs: {} },
+		{ code: 1, jobs: [null, { reason: 'retry' }, { id: 'other', reason: 'action' }] }
+	]) {
+		const { context, streamed, results } = makeFollower(t, [{ id: 'initial', ...record }]);
+		await context.cmd_stream_job();
+		assert.deepEqual(streamed, ['initial']);
+		assert.deepEqual(results, ['initial']);
+	}
+});