ultravisor 1.0.3 → 1.0.4

package/.claude/launch.json

@@ -0,0 +1,11 @@
+{
+	"version": "0.0.1",
+	"configurations": [
+		{
+			"name": "ultravisor-dev",
+			"runtimeExecutable": "node",
+			"runtimeArgs": ["source/cli/Ultravisor-Run.cjs", "start", "--config", ".claude/ultravisor-dev-config.json"],
+			"port": 54321
+		}
+	]
+}

package/.claude/ultravisor-dev-config.json

@@ -0,0 +1,3 @@
+{
+	"UltravisorWebInterfacePath": "webinterface/dist"
+}

package/.ultravisor.json

@@ -0,0 +1,426 @@
+{
+	"UltravisorAPIServerPort": 54321,
+	"UltravisorFileStorePath": "/Users/stevenvelozo/Code/retold/modules/apps/ultravisor/dist/ultravisor_datastore",
+	"UltravisorStagingRoot": "/Users/stevenvelozo/Code/retold/modules/apps/ultravisor/dist/ultravisor_staging",
+	"UltravisorTickIntervalMilliseconds": 60000,
+	"UltravisorCommandTimeoutMilliseconds": 300000,
+	"UltravisorCommandMaxBufferBytes": 10485760,
+	"UltravisorWebInterfacePath": "/Users/stevenvelozo/Code/retold/modules/apps/ultravisor/webinterface/dist",
+	"NodeTemplates": {},
+	"Operations": {
+		"OPR-0003": {
+			"Name": "Example: File Processor",
+			"Description": "Search and replace pipeline with user input, looping, and file I/O.",
+			"Graph": {
+				"Nodes": [
+					{
+						"Hash": "fp-start",
+						"Type": "start",
+						"X": 50,
+						"Y": 200,
+						"Width": 140,
+						"Height": 80,
+						"Title": "Start",
+						"Ports": [
+							{
+								"Hash": "fp-start-out",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "Out"
+							}
+						],
+						"Data": {}
+					},
+					{
+						"Hash": "fp-input",
+						"Type": "value-input",
+						"X": 280,
+						"Y": 180,
+						"Width": 220,
+						"Height": 100,
+						"Title": "Enter File Path",
+						"Ports": [
+							{
+								"Hash": "fp-input-req",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "RequestInput"
+							},
+							{
+								"Hash": "fp-input-done",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "ValueInputComplete"
+							},
+							{
+								"Hash": "fp-input-filepath",
+								"Direction": "output",
+								"Side": "right-top",
+								"Label": "InputFilePath"
+							}
+						],
+						"Data": {
+							"PromptMessage": "Enter a file path and name",
+							"OutputAddress": "Operation.InputFilePath"
+						}
+					},
+					{
+						"Hash": "fp-read",
+						"Type": "read-file",
+						"X": 590,
+						"Y": 180,
+						"Width": 200,
+						"Height": 100,
+						"Title": "Load File",
+						"Ports": [
+							{
+								"Hash": "fp-read-begin",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "BeginRead"
+							},
+							{
+								"Hash": "fp-read-filepath",
+								"Direction": "input",
+								"Side": "left-top",
+								"Label": "FilePath"
+							},
+							{
+								"Hash": "fp-read-done",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "ReadComplete"
+							},
+							{
+								"Hash": "fp-read-content",
+								"Direction": "output",
+								"Side": "right-top",
+								"Label": "FileContent"
+							},
+							{
+								"Hash": "fp-read-err",
+								"Direction": "output",
+								"Side": "bottom",
+								"Label": "Error"
+							}
+						],
+						"Data": {
+							"FilePath": "{~D:Record.Operation.InputFilePath~}",
+							"Encoding": "utf8"
+						}
+					},
+					{
+						"Hash": "fp-error",
+						"Type": "error-message",
+						"X": 590,
+						"Y": 420,
+						"Width": 220,
+						"Height": 80,
+						"Title": "Read Error",
+						"Ports": [
+							{
+								"Hash": "fp-error-in",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "Trigger"
+							},
+							{
+								"Hash": "fp-error-done",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "Complete"
+							}
+						],
+						"Data": {
+							"MessageTemplate": "Failed to read file: {~D:Record.Operation.InputFilePath~}"
+						}
+					},
+					{
+						"Hash": "fp-split",
+						"Type": "split-execute",
+						"X": 890,
+						"Y": 160,
+						"Width": 240,
+						"Height": 120,
+						"Title": "Split Lines",
+						"Ports": [
+							{
+								"Hash": "fp-split-begin",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "PerformSplit"
+							},
+							{
+								"Hash": "fp-split-step",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "StepComplete"
+							},
+							{
+								"Hash": "fp-split-inputstr",
+								"Direction": "input",
+								"Side": "left-top",
+								"Label": "InputString"
+							},
+							{
+								"Hash": "fp-split-token",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "TokenDataSent"
+							},
+							{
+								"Hash": "fp-split-alldone",
+								"Direction": "output",
+								"Side": "right-bottom",
+								"Label": "CompletedAllSubtasks"
+							}
+						],
+						"Data": {
+							"InputString": "{~D:Record.TaskOutput.fp-read.FileContent~}",
+							"SplitDelimiter": "\n"
+						}
+					},
+					{
+						"Hash": "fp-replace",
+						"Type": "replace-string",
+						"X": 1230,
+						"Y": 160,
+						"Width": 220,
+						"Height": 100,
+						"Title": "Replace John with Jane",
+						"Ports": [
+							{
+								"Hash": "fp-replace-in",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "Replace"
+							},
+							{
+								"Hash": "fp-replace-done",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "ReplaceComplete"
+							},
+							{
+								"Hash": "fp-replace-result",
+								"Direction": "output",
+								"Side": "right-top",
+								"Label": "ReplacedString"
+							}
+						],
+						"Data": {
+							"InputString": "{~D:Record.TaskOutput.fp-split.CurrentToken~}",
+							"SearchString": "John",
+							"ReplaceString": "Jane"
+						}
+					},
+					{
+						"Hash": "fp-append",
+						"Type": "string-appender",
+						"X": 1540,
+						"Y": 160,
+						"Width": 220,
+						"Height": 100,
+						"Title": "Append Line",
+						"Ports": [
+							{
+								"Hash": "fp-append-in",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "Append"
+							},
+							{
+								"Hash": "fp-append-inputstr",
+								"Direction": "input",
+								"Side": "left-top",
+								"Label": "InputString"
+							},
+							{
+								"Hash": "fp-append-done",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "Completed"
+							}
+						],
+						"Data": {
+							"InputString": "{~D:Record.TaskOutput.fp-replace.ReplacedString~}",
+							"OutputAddress": "Operation.OutputFileContents",
+							"AppendNewline": true
+						}
+					},
+					{
+						"Hash": "fp-write",
+						"Type": "write-file",
+						"X": 1230,
+						"Y": 420,
+						"Width": 220,
+						"Height": 80,
+						"Title": "Save File",
+						"Ports": [
+							{
+								"Hash": "fp-write-begin",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "BeginWrite"
+							},
+							{
+								"Hash": "fp-write-done",
+								"Direction": "output",
+								"Side": "right",
+								"Label": "WriteComplete"
+							},
+							{
+								"Hash": "fp-write-err",
+								"Direction": "output",
+								"Side": "bottom",
+								"Label": "Error"
+							}
+						],
+						"Data": {
+							"FilePath": "{~D:Record.Operation.InputFilePath~}.ultracopy",
+							"Content": "{~D:Record.Operation.OutputFileContents~}",
+							"Encoding": "utf8"
+						}
+					},
+					{
+						"Hash": "fp-end",
+						"Type": "end",
+						"X": 1540,
+						"Y": 420,
+						"Width": 140,
+						"Height": 80,
+						"Title": "End",
+						"Ports": [
+							{
+								"Hash": "fp-end-in",
+								"Direction": "input",
+								"Side": "left-bottom",
+								"Label": "In"
+							}
+						],
+						"Data": {}
+					}
+				],
+				"Connections": [
+					{
+						"Hash": "fp-ev1",
+						"SourceNodeHash": "fp-start",
+						"SourcePortHash": "fp-start-out",
+						"TargetNodeHash": "fp-input",
+						"TargetPortHash": "fp-input-req",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev2",
+						"SourceNodeHash": "fp-input",
+						"SourcePortHash": "fp-input-done",
+						"TargetNodeHash": "fp-read",
+						"TargetPortHash": "fp-read-begin",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev3",
+						"SourceNodeHash": "fp-read",
+						"SourcePortHash": "fp-read-done",
+						"TargetNodeHash": "fp-split",
+						"TargetPortHash": "fp-split-begin",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev4",
+						"SourceNodeHash": "fp-read",
+						"SourcePortHash": "fp-read-err",
+						"TargetNodeHash": "fp-error",
+						"TargetPortHash": "fp-error-in",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev5",
+						"SourceNodeHash": "fp-error",
+						"SourcePortHash": "fp-error-done",
+						"TargetNodeHash": "fp-end",
+						"TargetPortHash": "fp-end-in",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev6",
+						"SourceNodeHash": "fp-split",
+						"SourcePortHash": "fp-split-token",
+						"TargetNodeHash": "fp-replace",
+						"TargetPortHash": "fp-replace-in",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev7",
+						"SourceNodeHash": "fp-replace",
+						"SourcePortHash": "fp-replace-done",
+						"TargetNodeHash": "fp-append",
+						"TargetPortHash": "fp-append-in",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev8",
+						"SourceNodeHash": "fp-append",
+						"SourcePortHash": "fp-append-done",
+						"TargetNodeHash": "fp-split",
+						"TargetPortHash": "fp-split-step",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev9",
+						"SourceNodeHash": "fp-split",
+						"SourcePortHash": "fp-split-alldone",
+						"TargetNodeHash": "fp-write",
+						"TargetPortHash": "fp-write-begin",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-ev10",
+						"SourceNodeHash": "fp-write",
+						"SourcePortHash": "fp-write-done",
+						"TargetNodeHash": "fp-end",
+						"TargetPortHash": "fp-end-in",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-st1",
+						"SourceNodeHash": "fp-input",
+						"SourcePortHash": "fp-input-filepath",
+						"TargetNodeHash": "fp-read",
+						"TargetPortHash": "fp-read-filepath",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-st2",
+						"SourceNodeHash": "fp-read",
+						"SourcePortHash": "fp-read-content",
+						"TargetNodeHash": "fp-split",
+						"TargetPortHash": "fp-split-inputstr",
+						"Data": {}
+					},
+					{
+						"Hash": "fp-st3",
+						"SourceNodeHash": "fp-replace",
+						"SourcePortHash": "fp-replace-result",
+						"TargetNodeHash": "fp-append",
+						"TargetPortHash": "fp-append-inputstr",
+						"Data": {}
+					}
+				],
+				"ViewState": {
+					"PanX": 0,
+					"PanY": 0,
+					"Zoom": 1,
+					"SelectedNodeHash": null,
+					"SelectedConnectionHash": null
+				}
+			},
+			"Hash": "OPR-0003",
+			"CreatedAt": "2026-03-09T00:54:04.820Z",
+			"UpdatedAt": "2026-03-09T00:54:04.820Z"
+		}
+	},
+	"GlobalState": {},
+	"OperationCounter": 3,
+	"TemplateCounters": {}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ultravisor",
-    "version": "1.0.3",
+    "version": "1.0.4",
     "description": "Cyclic process execution with ai integration.",
     "main": "source/Ultravisor.js",
     "bin": {
@@ -8,9 +8,9 @@
     },
     "scripts": {
         "start": "node source/cli/Ultravisor-Run.cjs",
-        "test": "npx mocha -u tdd -R spec",
+        "test": "npx quack test",
         "tests": "npx mocha -u tdd --exit -R spec --grep",
-        "coverage": "npx nyc --reporter=lcov --reporter=text-lcov npx mocha -- -u tdd -R spec",
+        "coverage": "npx quack coverage",
         "build": "npx quack build",
         "docs": "npx quack prepare-docs ./docs -d ./modules",
         "docs-serve": "npx quack docs-serve ./docs"
@@ -27,14 +27,15 @@
     "homepage": "https://github.com/stevenvelozo/ultravisor#readme",
     "dependencies": {
         "cron": "^4.4.0",
-        "orator": "^6.0.3",
+        "orator": "^6.0.4",
         "orator-serviceserver-restify": "^2.0.9",
-        "pict": "^1.0.355",
+        "pict": "^1.0.357",
         "pict-service-commandlineutility": "^1.0.19",
         "pict-serviceproviderbase": "^1.0.4"
     },
     "devDependencies": {
-        "quackage": "^1.0.58"
+        "puppeteer": "^24.38.0",
+        "quackage": "^1.0.64"
     },
     "mocha": {
         "diff": true,

package/source/Ultravisor.cjs

@@ -1,5 +1,24 @@
 module.exports = (
 	{
-		Operation: require(`./services/Ultravisor-Operation.cjs`),
-		Task: require(`./services/Ultravisor-Task.cjs`),
-	});
+		TaskTypeBase: require('./services/tasks/Ultravisor-TaskType-Base.cjs'),
+		TaskTypeRegistry: require('./services/Ultravisor-TaskTypeRegistry.cjs'),
+		StateManager: require('./services/Ultravisor-StateManager.cjs'),
+		ExecutionEngine: require('./services/Ultravisor-ExecutionEngine.cjs'),
+		ExecutionManifest: require('./services/Ultravisor-ExecutionManifest.cjs'),
+		HypervisorState: require('./services/Ultravisor-Hypervisor-State.cjs'),
+		Hypervisor: require('./services/Ultravisor-Hypervisor.cjs'),
+
+		// Task type classes
+		TaskTypes:
+		{
+			ReadFile: require('./services/tasks/file-io/Ultravisor-TaskType-ReadFile.cjs'),
+			WriteFile: require('./services/tasks/file-io/Ultravisor-TaskType-WriteFile.cjs'),
+			SetValues: require('./services/tasks/data/Ultravisor-TaskType-SetValues.cjs'),
+			ReplaceString: require('./services/tasks/data/Ultravisor-TaskType-ReplaceString.cjs'),
+			StringAppender: require('./services/tasks/data/Ultravisor-TaskType-StringAppender.cjs'),
+			IfConditional: require('./services/tasks/control/Ultravisor-TaskType-IfConditional.cjs'),
+			SplitExecute: require('./services/tasks/control/Ultravisor-TaskType-SplitExecute.cjs'),
+			ValueInput: require('./services/tasks/interaction/Ultravisor-TaskType-ValueInput.cjs'),
+			ErrorMessage: require('./services/tasks/interaction/Ultravisor-TaskType-ErrorMessage.cjs')
+		}
+	});

package/source/cli/Ultravisor-CLIProgram.cjs

@@ -2,24 +2,22 @@ const libCLIProgram = require('pict-service-commandlineutility');
 const libFS = require('fs');
 const libPath = require('path');
 
-const libServiceHypervisor = require(`../services/Ultravisor-Hypervisor.cjs`);
-const libServiceHypervisorState = require(`../services/Ultravisor-Hypervisor-State.cjs`);
+const libServiceHypervisor = require('../services/Ultravisor-Hypervisor.cjs');
+const libServiceHypervisorState = require('../services/Ultravisor-Hypervisor-State.cjs');
 
-const libServiceHypervisorEventBase = require(`../services/Ultravisor-Hypervisor-Event-Base.cjs`);
-const libServiceHypervisorEventCron = require(`../services/events/Ultravisor-Hypervisor-Event-Cron.cjs`);
-const libServiceHypervisorEventSolver = require(`../services/events/Ultravisor-Hypervisor-Event-Solver.cjs`);
+const libServiceHypervisorEventBase = require('../services/Ultravisor-Hypervisor-Event-Base.cjs');
+const libServiceHypervisorEventCron = require('../services/events/Ultravisor-Hypervisor-Event-Cron.cjs');
 
-const libServiceOperation = require(`../services/Ultravisor-Operation.cjs`);
-const libServiceOperationManifest = require(`../services/Ultravisor-Operation-Manifest.cjs`);
-
-const libServiceTask = require(`../services/Ultravisor-Task.cjs`);
+const libServiceTaskTypeRegistry = require('../services/Ultravisor-TaskTypeRegistry.cjs');
+const libServiceStateManager = require('../services/Ultravisor-StateManager.cjs');
+const libServiceExecutionEngine = require('../services/Ultravisor-ExecutionEngine.cjs');
+const libServiceExecutionManifest = require('../services/Ultravisor-ExecutionManifest.cjs');
 
 // TODO: Remove this when Restify is fixed.
 process.removeAllListeners('warning')
 
-const libWebServerAPIServer = require(`../web_server/Ultravisor-API-Server.cjs`);
+const libWebServerAPIServer = require('../web_server/Ultravisor-API-Server.cjs');
 
-// TODO: Add a way to do this cleanly from the pict-service-commandlineutility package itself, maybe via a "pre-initialization" function or something like that?
 // Check for an optional --config / -c command line parameter to load a config file
 let _ConfigFileOverride = false;
 for (let i = 0; i < process.argv.length; i++)
@@ -59,7 +57,7 @@ let _Ultravisor_Pict = new libCLIProgram(
 
 		"Command": "ultravisor",
 
-		"DefaultProgramConfiguration": require(`../config/Ultravisor-Default-Command-Configuration.cjs`),
+		"DefaultProgramConfiguration": require('../config/Ultravisor-Default-Command-Configuration.cjs'),
 
 		"ProgramConfigurationFileName": ".ultravisor.json",
 
@@ -85,8 +83,6 @@ let _Ultravisor_Pict = new libCLIProgram(
 	]);
 
 // Register --config / -c as a known global option so Commander doesn't reject it.
-// The actual file loading happens in the pre-initialization block above; this just
-// prevents Commander from throwing "unknown option '--config'".
 _Ultravisor_Pict.CommandLineUtility.command.option('-c, --config <path>', 'Load configuration from a JSON file');
 
 // If a config file override was passed via --config / -c, apply it on top of the gathered config
@@ -100,18 +96,34 @@ _Ultravisor_Pict.instantiateServiceProvider('FilePersistence');
 // Instantiate the data generation service
 _Ultravisor_Pict.instantiateServiceProvider('DataGeneration');
 
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Hypervisor', libServiceHypervisor);
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Hypervisor-State', libServiceHypervisorState);
+// --- Core services ---
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorHypervisor', libServiceHypervisor);
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorHypervisorState', libServiceHypervisorState);
+
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorHypervisorEventBase', libServiceHypervisorEventBase);
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorHypervisorEventCron', libServiceHypervisorEventCron);
+
+// --- New engine services ---
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorTaskTypeRegistry', libServiceTaskTypeRegistry);
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorStateManager', libServiceStateManager);
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorExecutionEngine', libServiceExecutionEngine);
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorExecutionManifest', libServiceExecutionManifest);
 
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Hypervisor-Event-Base', libServiceHypervisorEventBase);
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Hypervisor-Event-Cron', libServiceHypervisorEventCron);
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Hypervisor-Event-Solver', libServiceHypervisorEventSolver);
+// Register built-in task types
+let tmpRegistry = Object.values(_Ultravisor_Pict.fable.servicesMap['UltravisorTaskTypeRegistry'])[0];
+if (tmpRegistry)
+{
+	tmpRegistry.registerBuiltInTaskTypes();
+}
 
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Operation', libServiceOperation);
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Operation-Manifest', libServiceOperationManifest);
+_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('UltravisorAPIServer', libWebServerAPIServer);
 
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-Task', libServiceTask);
+// ── Service name aliases ────────────────────────────────
+// Some CLI commands access services by hyphenated names via this.fable['Name'].
+// Bridge the camelCase registration to hyphenated access.
+let _Fable = _Ultravisor_Pict.fable;
 
-_Ultravisor_Pict.fable.addAndInstantiateServiceTypeIfNotExists('Ultravisor-API-Server', libWebServerAPIServer);
+_Fable['Ultravisor-Hypervisor'] = Object.values(_Fable.servicesMap['UltravisorHypervisor'])[0];
+_Fable['Ultravisor-API-Server'] = Object.values(_Fable.servicesMap['UltravisorAPIServer'])[0];
 
 module.exports = _Ultravisor_Pict;