ultravisor 1.0.3 → 1.0.8

package/operation-library/csv-data-analysis.json

@@ -0,0 +1,228 @@
+{
+	"Name": "CSV Data Analysis",
+	"Description": "Reads two CSV files (sales report and product catalog), parses both, transforms sales data, intersects by product ID, computes a histogram of sales by category, and writes results to JSON. Demonstrates parse-csv, csv-transform, comprehension-intersect, histogram, set-values, read-file, and write-json.",
+	"Tags": ["data-pipeline", "csv", "analysis", "histogram"],
+	"Author": "Ultravisor",
+	"Version": "1.0.0",
+	"Graph": {
+		"Nodes": [
+			{
+				"Hash": "da-start",
+				"Type": "start",
+				"X": 50,
+				"Y": 200,
+				"Width": 140,
+				"Height": 80,
+				"Title": "Start",
+				"Ports": [
+					{ "Hash": "da-start-out", "Direction": "output", "Side": "right-bottom", "Label": "Out" }
+				],
+				"Data": {}
+			},
+			{
+				"Hash": "da-init",
+				"Type": "set-values",
+				"X": 250,
+				"Y": 180,
+				"Width": 220,
+				"Height": 100,
+				"Title": "Set File Paths",
+				"Ports": [
+					{ "Hash": "da-init-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-init-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "da-init-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" }
+				],
+				"Data": {
+					"Values": [
+						{ "Address": "Operation.SalesFile", "Value": "sales-report.csv" },
+						{ "Address": "Operation.ProductFile", "Value": "product-catalog.csv" },
+						{ "Address": "Operation.MatchField", "Value": "ProductID" }
+					]
+				}
+			},
+			{
+				"Hash": "da-read-sales",
+				"Type": "read-file",
+				"X": 520,
+				"Y": 180,
+				"Width": 240,
+				"Height": 120,
+				"Title": "Read Sales CSV",
+				"Ports": [
+					{ "Hash": "da-read-sales-ei-BeginRead", "Direction": "input", "Side": "left-bottom", "Label": "BeginRead" },
+					{ "Hash": "da-read-sales-eo-ReadComplete", "Direction": "output", "Side": "right-bottom", "Label": "ReadComplete" },
+					{ "Hash": "da-read-sales-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-read-sales-so-FileContent", "Direction": "output", "Side": "right-top", "Label": "FileContent" },
+					{ "Hash": "da-read-sales-so-BytesRead", "Direction": "output", "Side": "right-top", "Label": "BytesRead" }
+				],
+				"Data": { "FilePath": "{~D:Record.Operation.SalesFile~}", "Encoding": "utf8" }
+			},
+			{
+				"Hash": "da-parse-sales",
+				"Type": "parse-csv",
+				"X": 810,
+				"Y": 180,
+				"Width": 240,
+				"Height": 120,
+				"Title": "Parse Sales CSV",
+				"Ports": [
+					{ "Hash": "da-parse-sales-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-parse-sales-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "da-parse-sales-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-parse-sales-so-Records", "Direction": "output", "Side": "right-top", "Label": "Records" }
+				],
+				"Data": { "SourceAddress": "TaskOutput.da-read-sales.FileContent", "Delimiter": ",", "HasHeaders": true, "Destination": "Operation.SalesRecords" }
+			},
+			{
+				"Hash": "da-transform",
+				"Type": "csv-transform",
+				"X": 1100,
+				"Y": 180,
+				"Width": 230,
+				"Height": 120,
+				"Title": "Transform Sales Data",
+				"Ports": [
+					{ "Hash": "da-transform-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-transform-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "da-transform-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-transform-so-Records", "Direction": "output", "Side": "right-top", "Label": "Records" }
+				],
+				"Data": { "SourceAddress": "Operation.SalesRecords", "Destination": "Operation.TransformedSales" }
+			},
+			{
+				"Hash": "da-read-prods",
+				"Type": "read-file",
+				"X": 1380,
+				"Y": 180,
+				"Width": 240,
+				"Height": 120,
+				"Title": "Read Products CSV",
+				"Ports": [
+					{ "Hash": "da-read-prods-ei-BeginRead", "Direction": "input", "Side": "left-bottom", "Label": "BeginRead" },
+					{ "Hash": "da-read-prods-eo-ReadComplete", "Direction": "output", "Side": "right-bottom", "Label": "ReadComplete" },
+					{ "Hash": "da-read-prods-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-read-prods-so-FileContent", "Direction": "output", "Side": "right-top", "Label": "FileContent" },
+					{ "Hash": "da-read-prods-so-BytesRead", "Direction": "output", "Side": "right-top", "Label": "BytesRead" }
+				],
+				"Data": { "FilePath": "{~D:Record.Operation.ProductFile~}", "Encoding": "utf8" }
+			},
+			{
+				"Hash": "da-parse-prods",
+				"Type": "parse-csv",
+				"X": 1660,
+				"Y": 180,
+				"Width": 240,
+				"Height": 120,
+				"Title": "Parse Products CSV",
+				"Ports": [
+					{ "Hash": "da-parse-prods-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-parse-prods-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "da-parse-prods-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-parse-prods-so-Records", "Direction": "output", "Side": "right-top", "Label": "Records" }
+				],
+				"Data": { "SourceAddress": "TaskOutput.da-read-prods.FileContent", "Delimiter": ",", "HasHeaders": true, "Destination": "Operation.ProductRecords" }
+			},
+			{
+				"Hash": "da-intersect",
+				"Type": "comprehension-intersect",
+				"X": 1940,
+				"Y": 180,
+				"Width": 240,
+				"Height": 120,
+				"Title": "Intersect by Product ID",
+				"Ports": [
+					{ "Hash": "da-intersect-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-intersect-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "da-intersect-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-intersect-so-Result", "Direction": "output", "Side": "right-top", "Label": "Result" }
+				],
+				"Data": { "SourceAddressA": "Operation.TransformedSales", "SourceAddressB": "Operation.ProductRecords", "MatchField": "{~D:Record.Operation.MatchField~}", "Destination": "Operation.JoinedData" }
+			},
+			{
+				"Hash": "da-histogram",
+				"Type": "histogram",
+				"X": 2220,
+				"Y": 180,
+				"Width": 230,
+				"Height": 120,
+				"Title": "Histogram by Category",
+				"Ports": [
+					{ "Hash": "da-histogram-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-histogram-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "da-histogram-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-histogram-so-Stats", "Direction": "output", "Side": "right-top", "Label": "Stats" }
+				],
+				"Data": { "SourceAddress": "Operation.JoinedData", "Field": "Category", "Bins": 10, "Destination": "Operation.CategoryStats" }
+			},
+			{
+				"Hash": "da-write",
+				"Type": "write-json",
+				"X": 2500,
+				"Y": 180,
+				"Width": 220,
+				"Height": 120,
+				"Title": "Write Analysis JSON",
+				"Ports": [
+					{ "Hash": "da-write-ei-BeginWrite", "Direction": "input", "Side": "left-bottom", "Label": "BeginWrite" },
+					{ "Hash": "da-write-eo-WriteComplete", "Direction": "output", "Side": "right-bottom", "Label": "WriteComplete" },
+					{ "Hash": "da-write-eo-Error", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "da-write-so-BytesWritten", "Direction": "output", "Side": "right-top", "Label": "BytesWritten" }
+				],
+				"Data": { "File": "analysis-results.json", "Address": "Operation.CategoryStats" }
+			},
+			{
+				"Hash": "da-err",
+				"Type": "error-message",
+				"X": 1660,
+				"Y": 400,
+				"Width": 220,
+				"Height": 80,
+				"Title": "Pipeline Error",
+				"Ports": [
+					{ "Hash": "da-err-ei-Execute", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "da-err-eo-Complete", "Direction": "output", "Side": "right-bottom", "Label": "Complete" }
+				],
+				"Data": { "MessageTemplate": "Analysis pipeline failed" }
+			},
+			{
+				"Hash": "da-end",
+				"Type": "end",
+				"X": 2760,
+				"Y": 240,
+				"Width": 140,
+				"Height": 80,
+				"Title": "End",
+				"Ports": [
+					{ "Hash": "da-end-in", "Direction": "input", "Side": "left-bottom", "Label": "In" }
+				],
+				"Data": {}
+			}
+		],
+		"Connections": [
+			{ "Hash": "da-c1", "SourceNodeHash": "da-start", "SourcePortHash": "da-start-out", "TargetNodeHash": "da-init", "TargetPortHash": "da-init-ei-Execute", "Data": {} },
+			{ "Hash": "da-c2", "SourceNodeHash": "da-init", "SourcePortHash": "da-init-eo-Complete", "TargetNodeHash": "da-read-sales", "TargetPortHash": "da-read-sales-ei-BeginRead", "Data": {} },
+			{ "Hash": "da-c3", "SourceNodeHash": "da-read-sales", "SourcePortHash": "da-read-sales-eo-ReadComplete", "TargetNodeHash": "da-parse-sales", "TargetPortHash": "da-parse-sales-ei-Execute", "Data": {} },
+			{ "Hash": "da-c4", "SourceNodeHash": "da-parse-sales", "SourcePortHash": "da-parse-sales-eo-Complete", "TargetNodeHash": "da-transform", "TargetPortHash": "da-transform-ei-Execute", "Data": {} },
+			{ "Hash": "da-c5", "SourceNodeHash": "da-transform", "SourcePortHash": "da-transform-eo-Complete", "TargetNodeHash": "da-read-prods", "TargetPortHash": "da-read-prods-ei-BeginRead", "Data": {} },
+			{ "Hash": "da-c6", "SourceNodeHash": "da-read-prods", "SourcePortHash": "da-read-prods-eo-ReadComplete", "TargetNodeHash": "da-parse-prods", "TargetPortHash": "da-parse-prods-ei-Execute", "Data": {} },
+			{ "Hash": "da-c7", "SourceNodeHash": "da-parse-prods", "SourcePortHash": "da-parse-prods-eo-Complete", "TargetNodeHash": "da-intersect", "TargetPortHash": "da-intersect-ei-Execute", "Data": {} },
+			{ "Hash": "da-c8", "SourceNodeHash": "da-intersect", "SourcePortHash": "da-intersect-eo-Complete", "TargetNodeHash": "da-histogram", "TargetPortHash": "da-histogram-ei-Execute", "Data": {} },
+			{ "Hash": "da-c9", "SourceNodeHash": "da-histogram", "SourcePortHash": "da-histogram-eo-Complete", "TargetNodeHash": "da-write", "TargetPortHash": "da-write-ei-BeginWrite", "Data": {} },
+			{ "Hash": "da-c10", "SourceNodeHash": "da-write", "SourcePortHash": "da-write-eo-WriteComplete", "TargetNodeHash": "da-end", "TargetPortHash": "da-end-in", "Data": {} },
+			{ "Hash": "da-c11", "SourceNodeHash": "da-read-sales", "SourcePortHash": "da-read-sales-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c12", "SourceNodeHash": "da-read-prods", "SourcePortHash": "da-read-prods-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c13", "SourceNodeHash": "da-init", "SourcePortHash": "da-init-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c14", "SourceNodeHash": "da-parse-sales", "SourcePortHash": "da-parse-sales-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c15", "SourceNodeHash": "da-transform", "SourcePortHash": "da-transform-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c16", "SourceNodeHash": "da-parse-prods", "SourcePortHash": "da-parse-prods-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c17", "SourceNodeHash": "da-intersect", "SourcePortHash": "da-intersect-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c18", "SourceNodeHash": "da-histogram", "SourcePortHash": "da-histogram-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c19", "SourceNodeHash": "da-write", "SourcePortHash": "da-write-eo-Error", "TargetNodeHash": "da-err", "TargetPortHash": "da-err-ei-Execute", "Data": {} },
+			{ "Hash": "da-c20", "SourceNodeHash": "da-err", "SourcePortHash": "da-err-eo-Complete", "TargetNodeHash": "da-end", "TargetPortHash": "da-end-in", "Data": {} }
+		],
+		"ViewState": { "PanX": 0, "PanY": 0, "Zoom": 1, "SelectedNodeHash": null, "SelectedConnectionHash": null }
+	},
+	"SavedLayouts": [],
+	"InitialGlobalState": {},
+	"InitialOperationState": {}
+}

package/operation-library/csv-to-json.json

@@ -0,0 +1,160 @@
+{
+	"Name": "CSV to JSON Converter",
+	"Description": "Reads a CSV file, parses it into records, and writes the output as JSON. Demonstrates read-file, parse-csv, and write-json in a data pipeline.",
+	"Tags": ["data", "csv", "json", "conversion"],
+	"Author": "Ultravisor",
+	"Version": "1.0.0",
+	"Graph": {
+		"Nodes": [
+			{
+				"Hash": "csv-start",
+				"Type": "start",
+				"X": 50,
+				"Y": 200,
+				"Width": 140,
+				"Height": 80,
+				"Title": "Start",
+				"Ports": [
+					{ "Hash": "csv-start-out", "Direction": "output", "Side": "right-bottom", "Label": "Out" }
+				],
+				"Data": {}
+			},
+			{
+				"Hash": "csv-setpaths",
+				"Type": "set-values",
+				"X": 260,
+				"Y": 180,
+				"Width": 200,
+				"Height": 80,
+				"Title": "Set File Paths",
+				"Ports": [
+					{ "Hash": "csv-sp-in", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "csv-sp-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" }
+				],
+				"Data": {"Mappings": [{"Address": "Operation.InputCSV", "Value": "data.csv"}, {"Address": "Operation.OutputJSON", "Value": "data.json"}]}
+			},
+			{
+				"Hash": "csv-read",
+				"Type": "read-file",
+				"X": 530,
+				"Y": 180,
+				"Width": 200,
+				"Height": 120,
+				"Title": "Read CSV File",
+				"Ports": [
+					{ "Hash": "csv-rd-in", "Direction": "input", "Side": "left-bottom", "Label": "BeginRead" },
+					{ "Hash": "csv-rd-done", "Direction": "output", "Side": "right-bottom", "Label": "ReadComplete" },
+					{ "Hash": "csv-rd-err", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "csv-rd-so-FileContent", "Direction": "output", "Side": "right-top", "Label": "FileContent" },
+					{ "Hash": "csv-rd-so-BytesRead", "Direction": "output", "Side": "right-top", "Label": "BytesRead" }
+				],
+				"Data": {"FilePath": "{~D:Record.Operation.InputCSV~}", "Encoding": "utf8"}
+			},
+			{
+				"Hash": "csv-parse",
+				"Type": "parse-csv",
+				"X": 800,
+				"Y": 180,
+				"Width": 200,
+				"Height": 100,
+				"Title": "Parse CSV",
+				"Ports": [
+					{ "Hash": "csv-ps-in", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "csv-ps-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "csv-ps-so-Records", "Direction": "output", "Side": "right-top", "Label": "Records" }
+				],
+				"Data": {"SourceAddress": "TaskOutput.csv-read.FileContent", "Delimiter": ",", "HasHeaders": true, "Destination": "Operation.ParsedRecords"}
+			},
+			{
+				"Hash": "csv-check",
+				"Type": "if-conditional",
+				"X": 1070,
+				"Y": 160,
+				"Width": 220,
+				"Height": 100,
+				"Title": "Has Records?",
+				"Ports": [
+					{ "Hash": "csv-chk-in", "Direction": "input", "Side": "left-bottom", "Label": "Evaluate" },
+					{ "Hash": "csv-chk-true", "Direction": "output", "Side": "right-bottom", "Label": "True" },
+					{ "Hash": "csv-chk-false", "Direction": "output", "Side": "bottom", "Label": "False" },
+					{ "Hash": "csv-chk-so-Result", "Direction": "output", "Side": "right-top", "Label": "Result" }
+				],
+				"Data": {"DataAddress": "Operation.ParsedRecords", "Operator": "truthy"}
+			},
+			{
+				"Hash": "csv-write",
+				"Type": "write-json",
+				"X": 1360,
+				"Y": 140,
+				"Width": 200,
+				"Height": 100,
+				"Title": "Write JSON",
+				"Ports": [
+					{ "Hash": "csv-wj-in", "Direction": "input", "Side": "left-bottom", "Label": "Trigger" },
+					{ "Hash": "csv-wj-done", "Direction": "output", "Side": "right-bottom", "Label": "Done" },
+					{ "Hash": "csv-wj-err", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "csv-wj-so-BytesWritten", "Direction": "output", "Side": "right-top", "Label": "BytesWritten" }
+				],
+				"Data": {"File": "{~D:Record.Operation.OutputJSON~}", "Address": "Operation.ParsedRecords"}
+			},
+			{
+				"Hash": "csv-empty",
+				"Type": "error-message",
+				"X": 1070,
+				"Y": 370,
+				"Width": 220,
+				"Height": 80,
+				"Title": "No Records",
+				"Ports": [
+					{ "Hash": "csv-em-in", "Direction": "input", "Side": "left-bottom", "Label": "Trigger" },
+					{ "Hash": "csv-em-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" }
+				],
+				"Data": {"MessageTemplate": "CSV file contained no parseable records"}
+			},
+			{
+				"Hash": "csv-rderr",
+				"Type": "error-message",
+				"X": 530,
+				"Y": 370,
+				"Width": 200,
+				"Height": 80,
+				"Title": "Read Error",
+				"Ports": [
+					{ "Hash": "csv-rde-in", "Direction": "input", "Side": "left-bottom", "Label": "Trigger" },
+					{ "Hash": "csv-rde-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" }
+				],
+				"Data": {"MessageTemplate": "Could not read CSV file: {~D:Record.Operation.InputCSV~}"}
+			},
+			{
+				"Hash": "csv-end",
+				"Type": "end",
+				"X": 1630,
+				"Y": 260,
+				"Width": 140,
+				"Height": 80,
+				"Title": "End",
+				"Ports": [
+					{ "Hash": "csv-end-in", "Direction": "input", "Side": "left-bottom", "Label": "In" }
+				],
+				"Data": {}
+			}
+		],
+		"Connections": [
+			{ "Hash": "csv-c1", "SourceNodeHash": "csv-start", "SourcePortHash": "csv-start-out", "TargetNodeHash": "csv-setpaths", "TargetPortHash": "csv-sp-in", "Data": {} },
+			{ "Hash": "csv-c2", "SourceNodeHash": "csv-setpaths", "SourcePortHash": "csv-sp-done", "TargetNodeHash": "csv-read", "TargetPortHash": "csv-rd-in", "Data": {} },
+			{ "Hash": "csv-c3", "SourceNodeHash": "csv-read", "SourcePortHash": "csv-rd-done", "TargetNodeHash": "csv-parse", "TargetPortHash": "csv-ps-in", "Data": {} },
+			{ "Hash": "csv-c4", "SourceNodeHash": "csv-parse", "SourcePortHash": "csv-ps-done", "TargetNodeHash": "csv-check", "TargetPortHash": "csv-chk-in", "Data": {} },
+			{ "Hash": "csv-c5", "SourceNodeHash": "csv-check", "SourcePortHash": "csv-chk-true", "TargetNodeHash": "csv-write", "TargetPortHash": "csv-wj-in", "Data": {} },
+			{ "Hash": "csv-c6", "SourceNodeHash": "csv-write", "SourcePortHash": "csv-wj-done", "TargetNodeHash": "csv-end", "TargetPortHash": "csv-end-in", "Data": {} },
+			{ "Hash": "csv-c7", "SourceNodeHash": "csv-check", "SourcePortHash": "csv-chk-false", "TargetNodeHash": "csv-empty", "TargetPortHash": "csv-em-in", "Data": {} },
+			{ "Hash": "csv-c8", "SourceNodeHash": "csv-empty", "SourcePortHash": "csv-em-done", "TargetNodeHash": "csv-end", "TargetPortHash": "csv-end-in", "Data": {} },
+			{ "Hash": "csv-c9", "SourceNodeHash": "csv-read", "SourcePortHash": "csv-rd-err", "TargetNodeHash": "csv-rderr", "TargetPortHash": "csv-rde-in", "Data": {} },
+			{ "Hash": "csv-c10", "SourceNodeHash": "csv-rderr", "SourcePortHash": "csv-rde-done", "TargetNodeHash": "csv-end", "TargetPortHash": "csv-end-in", "Data": {} },
+			{ "Hash": "csv-c11", "SourceNodeHash": "csv-write", "SourcePortHash": "csv-wj-err", "TargetNodeHash": "csv-end", "TargetPortHash": "csv-end-in", "Data": {} }
+		],
+		"ViewState": {"PanX": 0, "PanY": 0, "Zoom": 1, "SelectedNodeHash": null, "SelectedConnectionHash": null}
+	},
+	"SavedLayouts": [],
+	"InitialGlobalState": {},
+	"InitialOperationState": {}
+}

package/operation-library/directory-inventory.json

@@ -0,0 +1,128 @@
+{
+	"Name": "Directory Inventory",
+	"Description": "Lists files in a directory, counts them, and writes an inventory report. Demonstrates list-files, set-values, template-string, and write-file.",
+	"Tags": ["file-io", "reporting"],
+	"Author": "Ultravisor",
+	"Version": "1.0.0",
+	"Graph": {
+		"Nodes": [
+			{
+				"Hash": "inv-start",
+				"Type": "start",
+				"X": 50,
+				"Y": 200,
+				"Width": 140,
+				"Height": 80,
+				"Title": "Start",
+				"Ports": [
+					{ "Hash": "inv-start-out", "Direction": "output", "Side": "right-bottom", "Label": "Out" }
+				],
+				"Data": {}
+			},
+			{
+				"Hash": "inv-setdir",
+				"Type": "set-values",
+				"X": 260,
+				"Y": 180,
+				"Width": 200,
+				"Height": 80,
+				"Title": "Set Target Dir",
+				"Ports": [
+					{ "Hash": "inv-setdir-in", "Direction": "input", "Side": "left-bottom", "Label": "Execute" },
+					{ "Hash": "inv-setdir-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" }
+				],
+				"Data": {"Mappings": [{"Address": "Operation.TargetDir", "Value": "."}, {"Address": "Operation.ReportName", "Value": "inventory-report.txt"}]}
+			},
+			{
+				"Hash": "inv-list",
+				"Type": "list-files",
+				"X": 530,
+				"Y": 180,
+				"Width": 200,
+				"Height": 100,
+				"Title": "List Files",
+				"Ports": [
+					{ "Hash": "inv-list-in", "Direction": "input", "Side": "left-bottom", "Label": "Trigger" },
+					{ "Hash": "inv-list-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "inv-list-err", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "inv-list-so-Files", "Direction": "output", "Side": "right-top", "Label": "Files" }
+				],
+				"Data": {"Folder": "{~D:Record.Operation.TargetDir~}", "Pattern": "*", "Destination": "Operation.FileList"}
+			},
+			{
+				"Hash": "inv-template",
+				"Type": "template-string",
+				"X": 800,
+				"Y": 180,
+				"Width": 240,
+				"Height": 100,
+				"Title": "Build Report",
+				"Ports": [
+					{ "Hash": "inv-template-in", "Direction": "input", "Side": "left-bottom", "Label": "In" },
+					{ "Hash": "inv-template-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "inv-template-so-Result", "Direction": "output", "Side": "right-top", "Label": "Result" }
+				],
+				"Data": {"Template": "Directory Inventory Report\n========================\nDirectory: {~D:Record.Operation.TargetDir~}\nGenerated: {~D:Record.Operation.ReportName~}\n", "Destination": "Operation.ReportContent"}
+			},
+			{
+				"Hash": "inv-write",
+				"Type": "write-file",
+				"X": 1110,
+				"Y": 180,
+				"Width": 200,
+				"Height": 120,
+				"Title": "Save Report",
+				"Ports": [
+					{ "Hash": "inv-write-in", "Direction": "input", "Side": "left-bottom", "Label": "BeginWrite" },
+					{ "Hash": "inv-write-done", "Direction": "output", "Side": "right-bottom", "Label": "WriteComplete" },
+					{ "Hash": "inv-write-err", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "inv-write-si-Content", "Direction": "input", "Side": "left-top", "Label": "Content" },
+					{ "Hash": "inv-write-so-BytesWritten", "Direction": "output", "Side": "right-top", "Label": "BytesWritten" }
+				],
+				"Data": {"FilePath": "{~D:Record.Operation.ReportName~}", "Content": "{~D:Record.Operation.ReportContent~}", "Encoding": "utf8"}
+			},
+			{
+				"Hash": "inv-error",
+				"Type": "error-message",
+				"X": 530,
+				"Y": 380,
+				"Width": 220,
+				"Height": 80,
+				"Title": "List Error",
+				"Ports": [
+					{ "Hash": "inv-error-in", "Direction": "input", "Side": "left-bottom", "Label": "Trigger" },
+					{ "Hash": "inv-error-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" }
+				],
+				"Data": {"MessageTemplate": "Failed to list directory: {~D:Record.Operation.TargetDir~}"}
+			},
+			{
+				"Hash": "inv-end",
+				"Type": "end",
+				"X": 1380,
+				"Y": 260,
+				"Width": 140,
+				"Height": 80,
+				"Title": "End",
+				"Ports": [
+					{ "Hash": "inv-end-in", "Direction": "input", "Side": "left-bottom", "Label": "In" }
+				],
+				"Data": {}
+			}
+		],
+		"Connections": [
+			{ "Hash": "inv-c1", "SourceNodeHash": "inv-start", "SourcePortHash": "inv-start-out", "TargetNodeHash": "inv-setdir", "TargetPortHash": "inv-setdir-in", "Data": {} },
+			{ "Hash": "inv-c2", "SourceNodeHash": "inv-setdir", "SourcePortHash": "inv-setdir-done", "TargetNodeHash": "inv-list", "TargetPortHash": "inv-list-in", "Data": {} },
+			{ "Hash": "inv-c3", "SourceNodeHash": "inv-list", "SourcePortHash": "inv-list-done", "TargetNodeHash": "inv-template", "TargetPortHash": "inv-template-in", "Data": {} },
+			{ "Hash": "inv-c4", "SourceNodeHash": "inv-template", "SourcePortHash": "inv-template-done", "TargetNodeHash": "inv-write", "TargetPortHash": "inv-write-in", "Data": {} },
+			{ "Hash": "inv-c5", "SourceNodeHash": "inv-write", "SourcePortHash": "inv-write-done", "TargetNodeHash": "inv-end", "TargetPortHash": "inv-end-in", "Data": {} },
+			{ "Hash": "inv-c6", "SourceNodeHash": "inv-list", "SourcePortHash": "inv-list-err", "TargetNodeHash": "inv-error", "TargetPortHash": "inv-error-in", "Data": {} },
+			{ "Hash": "inv-c7", "SourceNodeHash": "inv-error", "SourcePortHash": "inv-error-done", "TargetNodeHash": "inv-end", "TargetPortHash": "inv-end-in", "Data": {} },
+			{ "Hash": "inv-c8", "SourceNodeHash": "inv-write", "SourcePortHash": "inv-write-err", "TargetNodeHash": "inv-end", "TargetPortHash": "inv-end-in", "Data": {} },
+			{ "Hash": "inv-sc1", "SourceNodeHash": "inv-template", "SourcePortHash": "inv-template-so-Result", "TargetNodeHash": "inv-write", "TargetPortHash": "inv-write-si-Content", "Data": {} }
+		],
+		"ViewState": {"PanX": 0, "PanY": 0, "Zoom": 1, "SelectedNodeHash": null, "SelectedConnectionHash": null}
+	},
+	"SavedLayouts": [],
+	"InitialGlobalState": {},
+	"InitialOperationState": {}
+}

package/operation-library/expression-calculator.json

@@ -0,0 +1,114 @@
+{
+	"Name": "Expression Calculator",
+	"Description": "Takes user input, evaluates a mathematical expression, and writes the result. Demonstrates value-input, expression-solver, template-string, and write-file.",
+	"Tags": ["interactive", "math", "expressions"],
+	"Author": "Ultravisor",
+	"Version": "1.0.0",
+	"Graph": {
+		"Nodes": [
+			{
+				"Hash": "ec-start",
+				"Type": "start",
+				"X": 50,
+				"Y": 200,
+				"Width": 140,
+				"Height": 80,
+				"Title": "Start",
+				"Ports": [
+					{ "Hash": "ec-start-out", "Direction": "output", "Side": "right-bottom", "Label": "Out" }
+				],
+				"Data": {}
+			},
+			{
+				"Hash": "ec-input",
+				"Type": "value-input",
+				"X": 260,
+				"Y": 180,
+				"Width": 240,
+				"Height": 120,
+				"Title": "Enter Expression",
+				"Ports": [
+					{ "Hash": "ec-inp-req", "Direction": "input", "Side": "left-bottom", "Label": "RequestInput" },
+					{ "Hash": "ec-inp-done", "Direction": "output", "Side": "right-bottom", "Label": "ValueInputComplete" },
+					{ "Hash": "ec-inp-so-InputValue", "Direction": "output", "Side": "right-top", "Label": "InputValue" }
+				],
+				"Data": { "PromptMessage": "Enter a math expression (e.g. 2+3*4)", "OutputAddress": "Operation.Expression" }
+			},
+			{
+				"Hash": "ec-solve",
+				"Type": "expression-solver",
+				"X": 580,
+				"Y": 180,
+				"Width": 220,
+				"Height": 120,
+				"Title": "Evaluate Expression",
+				"Ports": [
+					{ "Hash": "ec-slv-in", "Direction": "input", "Side": "left-bottom", "Label": "In" },
+					{ "Hash": "ec-slv-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "ec-slv-si-Expression", "Direction": "input", "Side": "left-top", "Label": "Expression" },
+					{ "Hash": "ec-slv-so-Result", "Direction": "output", "Side": "right-top", "Label": "Result" }
+				],
+				"Data": { "Expression": "{~D:Record.Operation.Expression~}", "Destination": "Operation.Result" }
+			},
+			{
+				"Hash": "ec-format",
+				"Type": "template-string",
+				"X": 870,
+				"Y": 180,
+				"Width": 220,
+				"Height": 100,
+				"Title": "Format Result",
+				"Ports": [
+					{ "Hash": "ec-fmt-in", "Direction": "input", "Side": "left-bottom", "Label": "In" },
+					{ "Hash": "ec-fmt-done", "Direction": "output", "Side": "right-bottom", "Label": "Complete" },
+					{ "Hash": "ec-fmt-so-Result", "Direction": "output", "Side": "right-top", "Label": "Result" }
+				],
+				"Data": { "Template": "Expression: {~D:Record.Operation.Expression~}\nResult: {~D:Record.Operation.Result~}\n", "Destination": "Operation.Output" }
+			},
+			{
+				"Hash": "ec-write",
+				"Type": "write-file",
+				"X": 1160,
+				"Y": 180,
+				"Width": 200,
+				"Height": 120,
+				"Title": "Save Result",
+				"Ports": [
+					{ "Hash": "ec-wr-in", "Direction": "input", "Side": "left-bottom", "Label": "BeginWrite" },
+					{ "Hash": "ec-wr-done", "Direction": "output", "Side": "right-bottom", "Label": "WriteComplete" },
+					{ "Hash": "ec-wr-err", "Direction": "output", "Side": "bottom", "Label": "Error" },
+					{ "Hash": "ec-wr-si-Content", "Direction": "input", "Side": "left-top", "Label": "Content" },
+					{ "Hash": "ec-wr-so-BytesWritten", "Direction": "output", "Side": "right-top", "Label": "BytesWritten" }
+				],
+				"Data": { "FilePath": "calc-result.txt", "Content": "{~D:Record.Operation.Output~}", "Encoding": "utf8" }
+			},
+			{
+				"Hash": "ec-end",
+				"Type": "end",
+				"X": 1430,
+				"Y": 260,
+				"Width": 140,
+				"Height": 80,
+				"Title": "End",
+				"Ports": [
+					{ "Hash": "ec-end-in", "Direction": "input", "Side": "left-bottom", "Label": "In" }
+				],
+				"Data": {}
+			}
+		],
+		"Connections": [
+			{ "Hash": "ec-c1", "SourceNodeHash": "ec-start", "SourcePortHash": "ec-start-out", "TargetNodeHash": "ec-input", "TargetPortHash": "ec-inp-req", "Data": {} },
+			{ "Hash": "ec-c2", "SourceNodeHash": "ec-input", "SourcePortHash": "ec-inp-done", "TargetNodeHash": "ec-solve", "TargetPortHash": "ec-slv-in", "Data": {} },
+			{ "Hash": "ec-c3", "SourceNodeHash": "ec-solve", "SourcePortHash": "ec-slv-done", "TargetNodeHash": "ec-format", "TargetPortHash": "ec-fmt-in", "Data": {} },
+			{ "Hash": "ec-c4", "SourceNodeHash": "ec-format", "SourcePortHash": "ec-fmt-done", "TargetNodeHash": "ec-write", "TargetPortHash": "ec-wr-in", "Data": {} },
+			{ "Hash": "ec-c5", "SourceNodeHash": "ec-write", "SourcePortHash": "ec-wr-done", "TargetNodeHash": "ec-end", "TargetPortHash": "ec-end-in", "Data": {} },
+			{ "Hash": "ec-c6", "SourceNodeHash": "ec-write", "SourcePortHash": "ec-wr-err", "TargetNodeHash": "ec-end", "TargetPortHash": "ec-end-in", "Data": {} },
+			{ "Hash": "ec-sc1", "SourceNodeHash": "ec-input", "SourcePortHash": "ec-inp-so-InputValue", "TargetNodeHash": "ec-solve", "TargetPortHash": "ec-slv-si-Expression", "Data": {} },
+			{ "Hash": "ec-sc2", "SourceNodeHash": "ec-format", "SourcePortHash": "ec-fmt-so-Result", "TargetNodeHash": "ec-write", "TargetPortHash": "ec-wr-si-Content", "Data": {} }
+		],
+		"ViewState": { "PanX": 0, "PanY": 0, "Zoom": 1, "SelectedNodeHash": null, "SelectedConnectionHash": null }
+	},
+	"SavedLayouts": [],
+	"InitialGlobalState": {},
+	"InitialOperationState": {}
+}