ultravisor 1.0.2 → 1.0.3

package/debug/Harness.js

@@ -1,4 +1,5 @@
-let libUltravisor = require(`../source/cli/Ultravisor-CLIProgram.cjs`);
+let libUltravisor = require(`../source/cli/Ultravisor-Run.cjs`);
+//let libUltravisor = require(`../source/cli/Ultravisor-CLIProgram.cjs`);
 
 //libUltravisor.run(['node', 'Harness.js', 'explain-config']);
 

package/docs/README.md

@@ -0,0 +1,63 @@
+# Ultravisor Overview
+
+Ultravisor is a cyclic process execution tool with AI integration. It runs commands, HTTP requests and other tasks on schedule, producing structured output manifests that track timing, success/failure and logs for every execution.
+
+## What It Does
+
+Ultravisor manages two core primitives -- **Tasks** and **Operations** -- and provides multiple ways to run them: immediately via CLI or API, or on a recurring schedule via cron expressions.
+
+**Tasks** are individual units of work: shell commands, HTTP requests or other executable actions. **Operations** compose multiple tasks into a sequential pipeline with a unified output manifest.
+
+## How It Runs
+
+Ultravisor can be used in three modes:
+
+1. **CLI** -- run individual tasks or operations from the command line
+2. **API Server** -- start a Restify-based HTTP server exposing full CRUD and execution endpoints for tasks, operations, schedules and manifests
+3. **Scheduled** -- define cron schedules that automatically execute tasks or operations at the configured intervals
+
+## Configuration
+
+Ultravisor uses a layered configuration system. The default configuration ships with the module and can be overridden by a `.ultravisor.json` file in the working directory. Tasks and operations are persisted into this same configuration file.
+
+```json
+{
+    "UltravisorAPIServerPort": 54321,
+    "UltravisorFileStorePath": "/path/to/datastore",
+    "UltravisorTickIntervalMilliseconds": 60000,
+    "Tasks": {},
+    "Operations": {}
+}
+```
+
+## Key Concepts
+
+| Concept | Description |
+|---------|-------------|
+| Task | A single executable unit (shell command, HTTP request, etc.) |
+| Operation | An ordered set of tasks executed sequentially |
+| Schedule | A cron-based trigger that runs a task or operation on a timer |
+| Manifest | The output record from executing an operation |
+| Hypervisor | The central scheduler that manages the schedule and dispatches executions |
+| State | Persistent storage of task and operation definitions in `.ultravisor.json` |
+
+## Module Dependencies
+
+Ultravisor is built on the Retold ecosystem:
+
+- **pict** / **pict-serviceproviderbase** -- service provider pattern and CLI framework
+- **pict-service-commandlineutility** -- CLI command registration
+- **orator** / **orator-serviceserver-restify** -- REST API server
+- **cron** -- cron expression scheduling
+
+## Documentation Map
+
+- [Architecture](architecture.md) -- service structure and data flow
+- [Quick Start](quickstart.md) -- get running in five minutes
+- [Tasks](features/tasks.md) -- task types, model and execution
+- [Operations](features/operations.md) -- composing tasks into pipelines
+- [Scheduling](features/scheduling.md) -- cron-based recurring execution
+- [API Server](features/api.md) -- REST endpoint reference
+- [CLI Commands](features/cli.md) -- command line interface reference
+- [Manifests](features/manifests.md) -- execution output and logging
+- [Configuration](features/configuration.md) -- configuration file format and options

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ultravisor",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "description": "Cyclic process execution with ai integration.",
     "main": "source/Ultravisor.js",
     "bin": {
@@ -27,11 +27,14 @@
     "homepage": "https://github.com/stevenvelozo/ultravisor#readme",
     "dependencies": {
         "cron": "^4.4.0",
-        "orator": "^5.0.1",
-        "orator-serviceserver-restify": "^2.0.5",
-        "pict": "^1.0.343",
-        "pict-service-commandlineutility": "^1.0.17",
-        "pict-serviceproviderbase": "^1.0.0"
+        "orator": "^6.0.3",
+        "orator-serviceserver-restify": "^2.0.9",
+        "pict": "^1.0.355",
+        "pict-service-commandlineutility": "^1.0.19",
+        "pict-serviceproviderbase": "^1.0.4"
+    },
+    "devDependencies": {
+        "quackage": "^1.0.58"
     },
     "mocha": {
         "diff": true,

package/.babelrc

@@ -1,6 +0,0 @@
-{
-    "presets": [
-        "@babel/preset-env"
-    ],
-    "sourceMaps": "both"
-}

package/.browserslistrc

@@ -1 +0,0 @@
-> 0.01%

package/.browserslistrc-BACKUP

@@ -1 +0,0 @@
-since 2018

package/.gulpfile-quackage-config.json

@@ -1,7 +0,0 @@
-{
-    "EntrypointInputSourceFile": "/Users/stevenvelozo/Code/retold/modules/utility/ultravisor/source/Ultravisor.js",
-    "LibraryObjectName": "Ultravisor",
-    "LibraryOutputFolder": "/Users/stevenvelozo/Code/retold/modules/utility/ultravisor/dist/",
-    "LibraryUniminifiedFileName": "ultravisor.compatible.js",
-    "LibraryMinifiedFileName": "ultravisor.compatible.min.js"
-}

package/.gulpfile-quackage.js

@@ -1,2 +0,0 @@
-require('/Users/stevenvelozo/Code/retold/node_modules/quackage/gulp/Quackage-Gulpfile.js');
-require('/Users/stevenvelozo/Code/retold/node_modules/quackage/gulp/Quackage-Gulpfile.js');

package/webinterface/.babelrc

@@ -1,6 +0,0 @@
-{
-	"presets": [
-		"@babel/preset-env"
-	],
-	"sourceMaps": "both"
-}

package/webinterface/.browserslistrc

@@ -1 +0,0 @@
-> 0.01%

package/webinterface/.browserslistrc-BACKUP

@@ -1 +0,0 @@
-since 2018

package/webinterface/.gulpfile-quackage-config.json

@@ -1,7 +0,0 @@
-{
-    "EntrypointInputSourceFile": "/Users/stevenvelozo/Code/retold/modules/utility/ultravisor/webinterface/source/Pict-Application-Ultravisor.js",
-    "LibraryObjectName": "UltravisorWebinterface",
-    "LibraryOutputFolder": "/Users/stevenvelozo/Code/retold/modules/utility/ultravisor/webinterface/dist/",
-    "LibraryUniminifiedFileName": "ultravisor-webinterface.compatible.js",
-    "LibraryMinifiedFileName": "ultravisor-webinterface.compatible.min.js"
-}

package/webinterface/.gulpfile-quackage.js

@@ -1,2 +0,0 @@
-require('/Users/stevenvelozo/Code/retold/modules/utility/ultravisor/webinterface/node_modules/quackage/gulp/Quackage-Gulpfile.js');
-require('/Users/stevenvelozo/Code/retold/modules/utility/ultravisor/webinterface/node_modules/quackage/gulp/Quackage-Gulpfile.js');