ultravisor 1.0.2 → 1.0.4

package/source/services/tasks/Ultravisor-Task-CommandEach.cjs

@@ -1,190 +0,0 @@
-const libUltravisorTaskBase = require('./Ultravisor-Task-Base.cjs');
-
-const libChildProcess = require('child_process');
-
-class UltravisorTaskCommandEach extends libUltravisorTaskBase
-{
-	constructor(pFable)
-	{
-		super(pFable);
-	}
-
-	/**
-	 * Execute a templated shell command once for each value in an array.
-	 *
-	 * Takes an array from GlobalState and runs a shell command for each
-	 * element, substituting interpolation variables into the command
-	 * template.  Commands run sequentially (one at a time).
-	 *
-	 * Task definition fields:
-	 *   - Address: manyfest address in GlobalState pointing to the
-	 *       source array of values (e.g. "ObservationIDs").
-	 *   - Command: the shell command template.  Supports interpolation
-	 *       variables:
-	 *         {Value}  -- the current array element (stringified)
-	 *         {Index}  -- the zero-based index of the current element
-	 *         {Count}  -- total number of elements in the array
-	 *       Example: "curl https://api.example.com/obs/{Value} -o obs_{Value}.json"
-	 *   - ContinueOnError (optional, default true): if true, continue
-	 *       executing remaining commands when one fails.  If false,
-	 *       stop at the first failure.
-	 *   - Destination (optional): manyfest address in GlobalState
-	 *       where the results array is stored (default: "Output").
-	 *       Each result contains: { Value, Index, ExitCode, StdOut,
-	 *       StdErr, Success, Command }.
-	 *   - Persist (optional): standard persist options (file or address).
-	 */
-	execute(pTaskDefinition, pContext, pManifestEntry, fCallback)
-	{
-		// --- Validate required fields ---
-		if (!pTaskDefinition.Address || typeof(pTaskDefinition.Address) !== 'string' || pTaskDefinition.Address.length === 0)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Error';
-			pManifestEntry.Log.push(`CommandEach: missing or empty Address field.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		if (!pTaskDefinition.Command || typeof(pTaskDefinition.Command) !== 'string' || pTaskDefinition.Command.length === 0)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Error';
-			pManifestEntry.Log.push(`CommandEach: missing or empty Command field.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		// --- Resolve source array ---
-		let tmpSource = this.resolveAddress(pTaskDefinition.Address, pContext);
-
-		if (tmpSource === undefined || tmpSource === null)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Complete';
-			pManifestEntry.Success = true;
-			pManifestEntry.Output = '[]';
-			pManifestEntry.Log.push(`CommandEach: Address "${pTaskDefinition.Address}" resolved to null or undefined; nothing to execute.`);
-			this.storeDestination(pTaskDefinition, pContext, pManifestEntry, []);
-			return fCallback(null, pManifestEntry);
-		}
-
-		if (!Array.isArray(tmpSource))
-		{
-			// Wrap a single value into an array for uniform processing
-			tmpSource = [tmpSource];
-			pManifestEntry.Log.push(`CommandEach: source is not an array; wrapped in array.`);
-		}
-
-		if (tmpSource.length === 0)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Complete';
-			pManifestEntry.Success = true;
-			pManifestEntry.Output = '[]';
-			pManifestEntry.Log.push(`CommandEach: source array is empty, nothing to execute.`);
-			this.storeDestination(pTaskDefinition, pContext, pManifestEntry, []);
-			return fCallback(null, pManifestEntry);
-		}
-
-		let tmpContinueOnError = (pTaskDefinition.ContinueOnError !== false);
-		let tmpCommandTemplate = pTaskDefinition.Command;
-		let tmpTimeout = (this.fable?.ProgramConfiguration?.UltravisorCommandTimeoutMilliseconds) || 300000;
-		let tmpMaxBuffer = (this.fable?.ProgramConfiguration?.UltravisorCommandMaxBufferBytes) || 10485760;
-		let tmpCount = tmpSource.length;
-
-		pManifestEntry.Log.push(`CommandEach: executing command template for ${tmpCount} value(s).`);
-
-		let tmpResults = [];
-		let tmpSuccessCount = 0;
-		let tmpFailCount = 0;
-		let tmpIndex = 0;
-
-		let fRunNext = () =>
-		{
-			if (tmpIndex >= tmpCount)
-			{
-				// All commands have been executed
-				pManifestEntry.StopTime = new Date().toISOString();
-				pManifestEntry.Status = (tmpFailCount === 0) ? 'Complete' : 'Complete';
-				pManifestEntry.Success = (tmpFailCount === 0);
-				pManifestEntry.Output = JSON.stringify({
-					Total: tmpCount,
-					Succeeded: tmpSuccessCount,
-					Failed: tmpFailCount
-				});
-
-				pManifestEntry.Log.push(`CommandEach: finished. ${tmpSuccessCount} succeeded, ${tmpFailCount} failed out of ${tmpCount}.`);
-
-				this.storeDestination(pTaskDefinition, pContext, pManifestEntry, tmpResults);
-				this.storeResult(pTaskDefinition, pContext, pManifestEntry, tmpResults);
-
-				return fCallback(null, pManifestEntry);
-			}
-
-			let tmpValue = tmpSource[tmpIndex];
-			let tmpValueString = (tmpValue === null || tmpValue === undefined) ? '' : String(tmpValue);
-
-			// Interpolate the command template
-			let tmpCommand = tmpCommandTemplate;
-			tmpCommand = tmpCommand.split('{Value}').join(tmpValueString);
-			tmpCommand = tmpCommand.split('{Index}').join(String(tmpIndex));
-			tmpCommand = tmpCommand.split('{Count}').join(String(tmpCount));
-
-			let tmpCurrentIndex = tmpIndex;
-			tmpIndex++;
-
-			pManifestEntry.Log.push(`CommandEach [${tmpCurrentIndex}/${tmpCount}]: ${tmpCommand}`);
-
-			libChildProcess.exec(tmpCommand, { timeout: tmpTimeout, maxBuffer: tmpMaxBuffer },
-				(pError, pStdOut, pStdErr) =>
-				{
-					let tmpResult = {
-						Value: tmpValue,
-						Index: tmpCurrentIndex,
-						Command: tmpCommand,
-						ExitCode: pError ? (pError.code || 1) : 0,
-						StdOut: pStdOut || '',
-						StdErr: pStdErr || '',
-						Success: !pError
-					};
-
-					tmpResults.push(tmpResult);
-
-					if (pError)
-					{
-						tmpFailCount++;
-						pManifestEntry.Log.push(`CommandEach [${tmpCurrentIndex}]: failed - ${pError.message}`);
-
-						if (!tmpContinueOnError)
-						{
-							pManifestEntry.StopTime = new Date().toISOString();
-							pManifestEntry.Status = 'Error';
-							pManifestEntry.Success = false;
-							pManifestEntry.Output = JSON.stringify({
-								Total: tmpCount,
-								Succeeded: tmpSuccessCount,
-								Failed: tmpFailCount,
-								StoppedAtIndex: tmpCurrentIndex
-							});
-							pManifestEntry.Log.push(`CommandEach: stopping at index ${tmpCurrentIndex} due to ContinueOnError=false.`);
-
-							this.storeDestination(pTaskDefinition, pContext, pManifestEntry, tmpResults);
-							this.storeResult(pTaskDefinition, pContext, pManifestEntry, tmpResults);
-
-							return fCallback(null, pManifestEntry);
-						}
-					}
-					else
-					{
-						tmpSuccessCount++;
-						pManifestEntry.Log.push(`CommandEach [${tmpCurrentIndex}]: succeeded.`);
-					}
-
-					fRunNext();
-				});
-		};
-
-		fRunNext();
-	}
-}
-
-module.exports = UltravisorTaskCommandEach;

package/source/services/tasks/Ultravisor-Task-Conditional.cjs

@@ -1,104 +0,0 @@
-const libUltravisorTaskBase = require('./Ultravisor-Task-Base.cjs');
-
-class UltravisorTaskConditional extends libUltravisorTaskBase
-{
-	constructor(pFable)
-	{
-		super(pFable);
-	}
-
-	/**
-	 * Evaluate an address and execute one task if truthy, another if falsy.
-	 *
-	 * The "Address" field is resolved from pContext.GlobalState (dot-notation).
-	 * Alternatively, the "Value" field can provide a literal to test.
-	 *
-	 * Task definition fields:
-	 *   - Address: dot-notation path into pContext.GlobalState
-	 *   - Value (optional): literal value to evaluate instead of Address
-	 *   - TrueTask: GUID of the task to run when the value is truthy
-	 *   - FalseTask: GUID of the task to run when the value is falsy
-	 */
-	execute(pTaskDefinition, pContext, pManifestEntry, fCallback)
-	{
-		let tmpValue = undefined;
-
-		// Resolve the value to test
-		if (pTaskDefinition.hasOwnProperty('Value'))
-		{
-			tmpValue = pTaskDefinition.Value;
-			pManifestEntry.Log.push(`Conditional: evaluating literal Value: ${JSON.stringify(tmpValue)}`);
-		}
-		else if (pTaskDefinition.Address && typeof(pTaskDefinition.Address) === 'string')
-		{
-			tmpValue = this.resolveAddress(pTaskDefinition.Address, pContext);
-			pManifestEntry.Log.push(`Conditional: resolved Address "${pTaskDefinition.Address}" to: ${JSON.stringify(tmpValue)}`);
-		}
-		else
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Error';
-			pManifestEntry.Log.push(`Conditional: task requires an Address or Value field.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		let tmpIsTruthy = !!tmpValue;
-		let tmpTargetGUID = tmpIsTruthy ? pTaskDefinition.TrueTask : pTaskDefinition.FalseTask;
-
-		pManifestEntry.Log.push(`Conditional: value is ${tmpIsTruthy ? 'truthy' : 'falsy'}, selected ${tmpIsTruthy ? 'TrueTask' : 'FalseTask'}: ${tmpTargetGUID || '(none)'}`);
-
-		if (!tmpTargetGUID || typeof(tmpTargetGUID) !== 'string' || tmpTargetGUID.length === 0)
-		{
-			// No task to execute for this branch -- that is a valid no-op
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Complete';
-			pManifestEntry.Success = true;
-			pManifestEntry.Output = JSON.stringify({ Branch: tmpIsTruthy ? 'true' : 'false', Task: null });
-			pManifestEntry.Log.push(`Conditional: no task defined for this branch; completing as no-op.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		// Look up and execute the selected task
-		let tmpStateService = this.fable['Ultravisor-Hypervisor-State'];
-		let tmpTaskOrchestrator = this.fable['Ultravisor-Task'];
-
-		tmpStateService.getTask(tmpTargetGUID,
-			(pError, pBranchTaskDefinition) =>
-			{
-				if (pError)
-				{
-					pManifestEntry.StopTime = new Date().toISOString();
-					pManifestEntry.Status = 'Error';
-					pManifestEntry.Log.push(`Conditional: could not find task ${tmpTargetGUID}: ${pError.message}`);
-					return fCallback(null, pManifestEntry);
-				}
-
-				tmpTaskOrchestrator.executeCoreTaskStandalone(pBranchTaskDefinition, pContext,
-					(pExecError, pResult) =>
-					{
-						pManifestEntry.StopTime = new Date().toISOString();
-
-						if (pExecError)
-						{
-							pManifestEntry.Status = 'Error';
-							pManifestEntry.Log.push(`Conditional: error executing branch task ${tmpTargetGUID}: ${pExecError.message}`);
-							return fCallback(null, pManifestEntry);
-						}
-
-						pManifestEntry.Status = pResult.Status;
-						pManifestEntry.Success = pResult.Success;
-						pManifestEntry.Output = JSON.stringify(
-							{
-								Branch: tmpIsTruthy ? 'true' : 'false',
-								Task: tmpTargetGUID,
-								Result: pResult
-							});
-						pManifestEntry.Log.push(`Conditional: branch task ${tmpTargetGUID} completed with status ${pResult.Status}.`);
-
-						return fCallback(null, pManifestEntry);
-					});
-			});
-	}
-}
-
-module.exports = UltravisorTaskConditional;

package/source/services/tasks/Ultravisor-Task-DateWindow.cjs

@@ -1,72 +0,0 @@
-const libUltravisorTaskBase = require('./Ultravisor-Task-Base.cjs');
-
-class UltravisorTaskDateWindow extends libUltravisorTaskBase
-{
-	constructor(pFable)
-	{
-		super(pFable);
-	}
-
-	/**
-	 * Compute the last completed time-aligned window.
-	 *
-	 * Calculates the most recent completed N-minute window aligned to
-	 * clock boundaries (e.g. :00, :10, :20 for 10-minute windows).
-	 *
-	 * Examples for a 10-minute interval:
-	 *   Current time 10:13 → window is 10:00 – 10:09:59.999
-	 *   Current time 10:07 → window is 09:50 – 09:59:59.999
-	 *   Current time 10:30 → window is 10:20 – 10:29:59.999
-	 *
-	 * Task definition fields:
-	 *   - IntervalMinutes (optional, default 10): window size in minutes
-	 *   - Destination (optional): manyfest address in GlobalState for
-	 *       the result object (defaults to "Output")
-	 *
-	 * Result object:
-	 *   {
-	 *     WindowStart: "<ISO 8601>",  // e.g. "2026-02-12T04:20:00.000Z"
-	 *     WindowEnd:   "<ISO 8601>"   // e.g. "2026-02-12T04:29:59.999Z"
-	 *   }
-	 */
-	execute(pTaskDefinition, pContext, pManifestEntry, fCallback)
-	{
-		let tmpInterval = (typeof(pTaskDefinition.IntervalMinutes) === 'number' && pTaskDefinition.IntervalMinutes > 0)
-			? pTaskDefinition.IntervalMinutes
-			: 10;
-
-		let tmpNow = new Date();
-
-		// Floor to the nearest interval-aligned minute mark
-		let tmpEndMinutes = Math.floor(tmpNow.getMinutes() / tmpInterval) * tmpInterval;
-
-		let tmpEnd = new Date(tmpNow);
-		tmpEnd.setMinutes(tmpEndMinutes, 0, 0);
-
-		// The window start is one interval before the end
-		let tmpStart = new Date(tmpEnd.getTime() - (tmpInterval * 60 * 1000));
-
-		// The window end is 1ms before the aligned mark (exclusive upper bound)
-		let tmpEndExclusive = new Date(tmpEnd.getTime() - 1);
-
-		let tmpResult = {
-			WindowStart: tmpStart.toISOString(),
-			WindowEnd: tmpEndExclusive.toISOString()
-		};
-
-		pManifestEntry.StopTime = new Date().toISOString();
-		pManifestEntry.Status = 'Complete';
-		pManifestEntry.Success = true;
-		pManifestEntry.Output = JSON.stringify(tmpResult);
-
-		pManifestEntry.Log.push(`DateWindow: interval=${tmpInterval}min, now=${tmpNow.toISOString()}`);
-		pManifestEntry.Log.push(`DateWindow: WindowStart=${tmpResult.WindowStart}`);
-		pManifestEntry.Log.push(`DateWindow: WindowEnd=${tmpResult.WindowEnd}`);
-
-		this.storeDestination(pTaskDefinition, pContext, pManifestEntry, tmpResult);
-
-		return fCallback(null, pManifestEntry);
-	}
-}
-
-module.exports = UltravisorTaskDateWindow;

package/source/services/tasks/Ultravisor-Task-GeneratePagedOperation.cjs

@@ -1,336 +0,0 @@
-const libUltravisorTaskBase = require('./Ultravisor-Task-Base.cjs');
-
-const libFS = require('fs');
-const libPath = require('path');
-
-class UltravisorTaskGeneratePagedOperation extends libUltravisorTaskBase
-{
-	constructor(pFable)
-	{
-		super(pFable);
-	}
-
-	/**
-	 * Generate a paged operation from a template and optionally execute it.
-	 *
-	 * Task definition fields:
-	 *   - RecordCount: GlobalState address (string) or literal number for
-	 *       the total record count.
-	 *   - PageSize (optional, default 25): records per page.
-	 *   - MaximumRecordCount (optional): cap the resolved RecordCount to
-	 *       this value.  Useful for fetching only the first N records.
-	 *   - TaskTemplate: a task definition object used as the template for
-	 *       each page-fetch task.  String values in the template support
-	 *       interpolation variables: {PageStart}, {PageSize}, {PageIndex},
-	 *       {PageCount}.
-	 *   - OperationName (optional): human-readable name for the generated
-	 *       operation.
-	 *   - AutoExecute (optional, default true): whether to execute the
-	 *       generated operation immediately.
-	 *   - Retries (optional, default 0): number of retries per page task.
-	 *   - Destination (optional): manyfest address in GlobalState to store
-	 *       the generated operation GUID.
-	 */
-	execute(pTaskDefinition, pContext, pManifestEntry, fCallback)
-	{
-		// --- Resolve record count ---
-		let tmpRecordCount;
-
-		if (typeof(pTaskDefinition.RecordCount) === 'number')
-		{
-			tmpRecordCount = pTaskDefinition.RecordCount;
-		}
-		else if (typeof(pTaskDefinition.RecordCount) === 'string')
-		{
-			let tmpResolved = this.resolveAddress(pTaskDefinition.RecordCount, pContext);
-
-			if (typeof(tmpResolved) === 'number')
-			{
-				tmpRecordCount = tmpResolved;
-			}
-			else if (typeof(tmpResolved) === 'string')
-			{
-				tmpRecordCount = parseInt(tmpResolved, 10);
-			}
-			else
-			{
-				pManifestEntry.StopTime = new Date().toISOString();
-				pManifestEntry.Status = 'Error';
-				pManifestEntry.Log.push(`GeneratePagedOperation: could not resolve RecordCount from "${pTaskDefinition.RecordCount}".`);
-				return fCallback(null, pManifestEntry);
-			}
-		}
-		else
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Error';
-			pManifestEntry.Log.push(`GeneratePagedOperation: RecordCount is required (number or GlobalState address).`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		if (isNaN(tmpRecordCount) || tmpRecordCount < 0)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Error';
-			pManifestEntry.Log.push(`GeneratePagedOperation: RecordCount resolved to invalid value: ${tmpRecordCount}.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		// --- Apply MaximumRecordCount cap ---
-		if (typeof(pTaskDefinition.MaximumRecordCount) === 'number' && pTaskDefinition.MaximumRecordCount > 0)
-		{
-			if (tmpRecordCount > pTaskDefinition.MaximumRecordCount)
-			{
-				pManifestEntry.Log.push(`GeneratePagedOperation: capping RecordCount from ${tmpRecordCount} to MaximumRecordCount ${pTaskDefinition.MaximumRecordCount}.`);
-				tmpRecordCount = pTaskDefinition.MaximumRecordCount;
-			}
-		}
-
-		// --- Validate TaskTemplate ---
-		if (!pTaskDefinition.TaskTemplate || typeof(pTaskDefinition.TaskTemplate) !== 'object')
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Error';
-			pManifestEntry.Log.push(`GeneratePagedOperation: TaskTemplate is required.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		// --- Calculate paging ---
-		let tmpPageSize = (typeof(pTaskDefinition.PageSize) === 'number' && pTaskDefinition.PageSize > 0) ? pTaskDefinition.PageSize : 25;
-		let tmpPageCount = Math.ceil(tmpRecordCount / tmpPageSize);
-
-		if (tmpPageCount === 0)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Complete';
-			pManifestEntry.Success = true;
-			pManifestEntry.Log.push(`GeneratePagedOperation: RecordCount is 0, no pages to generate.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		let tmpRetries = (typeof(pTaskDefinition.Retries) === 'number' && pTaskDefinition.Retries > 0) ? pTaskDefinition.Retries : 0;
-		let tmpOperationName = pTaskDefinition.OperationName || 'Paged Operation';
-		let tmpAutoExecute = (pTaskDefinition.AutoExecute !== false);
-
-		// --- Generate a GUID for the paged operation ---
-		let tmpBaseGUID = pTaskDefinition.GUIDTask || 'paged';
-		let tmpOperationGUID = `${tmpBaseGUID}-paged-${Date.now()}`;
-
-		pManifestEntry.Log.push(`GeneratePagedOperation: ${tmpRecordCount} records, ${tmpPageSize} per page, ${tmpPageCount} page(s).`);
-
-		// --- Resolve URLAddress in TaskTemplate if present ---
-		// When the TaskTemplate has a URLAddress field, resolve it from
-		// GlobalState and set it as the URL before pagination interpolation.
-		if (pTaskDefinition.TaskTemplate.URLAddress && typeof(pTaskDefinition.TaskTemplate.URLAddress) === 'string')
-		{
-			let tmpResolvedURL = this.resolveAddress(pTaskDefinition.TaskTemplate.URLAddress, pContext);
-			if (tmpResolvedURL && typeof(tmpResolvedURL) === 'string')
-			{
-				pTaskDefinition.TaskTemplate.URL = tmpResolvedURL;
-				pManifestEntry.Log.push(`GeneratePagedOperation: resolved TaskTemplate URL from GlobalState address "${pTaskDefinition.TaskTemplate.URLAddress}": ${tmpResolvedURL.substring(0, 200)}`);
-			}
-			else
-			{
-				pManifestEntry.Log.push(`GeneratePagedOperation: WARNING URLAddress "${pTaskDefinition.TaskTemplate.URLAddress}" could not be resolved.`);
-			}
-			// Remove URLAddress from the template so generated page tasks
-			// use the interpolated URL directly instead of re-resolving
-			// from GlobalState (which would give the un-interpolated pattern).
-			delete pTaskDefinition.TaskTemplate.URLAddress;
-		}
-
-		// --- Generate task definitions ---
-		let tmpTasks = {};
-		let tmpTaskGUIDs = [];
-
-		for (let i = 0; i < tmpPageCount; i++)
-		{
-			let tmpPageStart = i * tmpPageSize;
-			let tmpTaskGUID = `${tmpOperationGUID}-page-${i}`;
-
-			let tmpVars = {
-				PageStart: String(tmpPageStart),
-				PageSize: String(tmpPageSize),
-				PageIndex: String(i),
-				PageCount: String(tmpPageCount)
-			};
-
-			let tmpTaskDef = this._interpolateTemplate(JSON.parse(JSON.stringify(pTaskDefinition.TaskTemplate)), tmpVars);
-			tmpTaskDef.GUIDTask = tmpTaskGUID;
-			tmpTaskDef.Name = `Page ${i + 1} of ${tmpPageCount}`;
-			tmpTaskDef.Destination = `Pages[${i}]`;
-
-			if (tmpRetries > 0)
-			{
-				tmpTaskDef.Retries = tmpRetries;
-			}
-
-			tmpTasks[tmpTaskGUID] = tmpTaskDef;
-			tmpTaskGUIDs.push(tmpTaskGUID);
-		}
-
-		// --- Generate operation definition ---
-		let tmpOperationDef = {
-			GUIDOperation: tmpOperationGUID,
-			Name: `${tmpOperationName} (${tmpPageCount} pages)`,
-			Tasks: tmpTaskGUIDs
-		};
-
-		// --- Write standalone config to staging ---
-		let tmpStagingPath = this.resolveStagingPath(pContext);
-		let tmpConfigContent = {
-			Tasks: tmpTasks,
-			Operations: {}
-		};
-		tmpConfigContent.Operations[tmpOperationGUID] = tmpOperationDef;
-
-		let tmpConfigPath = libPath.join(tmpStagingPath, `PagedOperation_${tmpOperationGUID}.json`);
-
-		try
-		{
-			if (!libFS.existsSync(tmpStagingPath))
-			{
-				libFS.mkdirSync(tmpStagingPath, { recursive: true });
-			}
-			libFS.writeFileSync(tmpConfigPath, JSON.stringify(tmpConfigContent, null, 4), 'utf8');
-			pManifestEntry.Log.push(`GeneratePagedOperation: wrote config to ${tmpConfigPath}.`);
-		}
-		catch (pWriteError)
-		{
-			pManifestEntry.Log.push(`GeneratePagedOperation: warning: could not write config file: ${pWriteError.message}`);
-		}
-
-		// --- Register tasks and operation in memory (no persist) ---
-		let tmpStateService = this.fable['Ultravisor-Hypervisor-State'];
-
-		for (let i = 0; i < tmpTaskGUIDs.length; i++)
-		{
-			tmpStateService._Tasks[tmpTaskGUIDs[i]] = tmpTasks[tmpTaskGUIDs[i]];
-		}
-		tmpStateService._Operations[tmpOperationGUID] = tmpOperationDef;
-
-		pManifestEntry.Log.push(`GeneratePagedOperation: registered ${tmpPageCount} task(s) and 1 operation in memory.`);
-
-		// --- Store the operation GUID at Destination ---
-		this.storeDestination(pTaskDefinition, pContext, pManifestEntry, tmpOperationGUID);
-
-		if (!tmpAutoExecute)
-		{
-			pManifestEntry.StopTime = new Date().toISOString();
-			pManifestEntry.Status = 'Complete';
-			pManifestEntry.Success = true;
-			pManifestEntry.Output = tmpOperationGUID;
-			pManifestEntry.Log.push(`GeneratePagedOperation: AutoExecute is false, operation ${tmpOperationGUID} ready for manual execution.`);
-			return fCallback(null, pManifestEntry);
-		}
-
-		// --- Auto-execute the generated operation ---
-		pManifestEntry.Log.push(`GeneratePagedOperation: auto-executing operation ${tmpOperationGUID}.`);
-
-		// Clone the current GlobalState so cookies/auth carry through
-		let tmpChildOperationDef = Object.assign({}, tmpOperationDef);
-		tmpChildOperationDef.GlobalState = pContext.GlobalState;
-		tmpChildOperationDef.StagingPath = tmpStagingPath;
-
-		let tmpOperationService = this.fable['Ultravisor-Operation'];
-
-		tmpOperationService.executeOperation(tmpChildOperationDef,
-			(pError, pChildManifest) =>
-			{
-				pManifestEntry.StopTime = new Date().toISOString();
-
-				if (pError)
-				{
-					pManifestEntry.Status = 'Error';
-					pManifestEntry.Log.push(`GeneratePagedOperation: execution error: ${pError.message}`);
-					return fCallback(null, pManifestEntry);
-				}
-
-				pManifestEntry.Status = 'Complete';
-				pManifestEntry.Success = pChildManifest.Success;
-				pManifestEntry.Output = JSON.stringify({
-					OperationGUID: tmpOperationGUID,
-					PageCount: tmpPageCount,
-					ChildManifestSummary: pChildManifest.Summary,
-					ChildManifestStatus: pChildManifest.Status,
-					ChildManifestSuccess: pChildManifest.Success
-				});
-
-				let tmpSuccessCount = 0;
-				let tmpFailCount = 0;
-				if (pChildManifest.TaskResults && Array.isArray(pChildManifest.TaskResults))
-				{
-					for (let i = 0; i < pChildManifest.TaskResults.length; i++)
-					{
-						if (pChildManifest.TaskResults[i].Success)
-						{
-							tmpSuccessCount++;
-						}
-						else
-						{
-							tmpFailCount++;
-						}
-					}
-				}
-
-				pManifestEntry.Log.push(`GeneratePagedOperation: completed ${tmpSuccessCount} of ${tmpPageCount} page(s) successfully${tmpFailCount > 0 ? `, ${tmpFailCount} failed` : ''}.`);
-
-				// Clean up ephemeral tasks and operation from state
-				for (let i = 0; i < tmpTaskGUIDs.length; i++)
-				{
-					delete tmpStateService._Tasks[tmpTaskGUIDs[i]];
-				}
-				delete tmpStateService._Operations[tmpOperationGUID];
-
-				return fCallback(null, pManifestEntry);
-			});
-	}
-
-	/**
-	 * Recursively replace interpolation variables in all string values
-	 * of an object.  Variables use {VarName} syntax.
-	 *
-	 * @param {*} pValue - The value to interpolate.
-	 * @param {object} pVars - Map of variable names to replacement values.
-	 * @returns {*} The interpolated value.
-	 */
-	_interpolateTemplate(pValue, pVars)
-	{
-		if (typeof(pValue) === 'string')
-		{
-			let tmpResult = pValue;
-			let tmpVarKeys = Object.keys(pVars);
-			for (let i = 0; i < tmpVarKeys.length; i++)
-			{
-				// Replace all occurrences of {VarName}
-				let tmpPattern = `{${tmpVarKeys[i]}}`;
-				while (tmpResult.indexOf(tmpPattern) !== -1)
-				{
-					tmpResult = tmpResult.replace(tmpPattern, pVars[tmpVarKeys[i]]);
-				}
-			}
-			return tmpResult;
-		}
-		else if (Array.isArray(pValue))
-		{
-			for (let i = 0; i < pValue.length; i++)
-			{
-				pValue[i] = this._interpolateTemplate(pValue[i], pVars);
-			}
-			return pValue;
-		}
-		else if (typeof(pValue) === 'object' && pValue !== null)
-		{
-			let tmpKeys = Object.keys(pValue);
-			for (let i = 0; i < tmpKeys.length; i++)
-			{
-				pValue[tmpKeys[i]] = this._interpolateTemplate(pValue[tmpKeys[i]], pVars);
-			}
-			return pValue;
-		}
-
-		return pValue;
-	}
-}
-
-module.exports = UltravisorTaskGeneratePagedOperation;