miravo 0.2.3 → 0.4.0

package/console-dist/favicon.svg

@@ -0,0 +1,37 @@
+<svg width="64" height="64" viewBox="0 0 64 64" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <!-- Subtle mirror gradient -->
+    <linearGradient id="mirror" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#f6d28a"/>
+      <stop offset="50%" stop-color="#e5a218"/>
+      <stop offset="100%" stop-color="#c58514"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Left M shape -->
+  <path d="M10 12 L30 12 L21 28 L10 28 Z"
+        fill="#e5a218"
+        stroke="#e5a218"
+        stroke-width="1.2"
+        stroke-linejoin="round"/>
+  <path d="M10 28 L21 28 L21 52 L10 48 Z"
+        fill="#e5a218"
+        stroke="#e5a218"
+        stroke-width="1.2"
+        stroke-linejoin="round"/>
+
+  <!-- Right mirrored M -->
+  <path d="M54 12 L34 12 L43 28 L54 28 Z"
+        fill="#e5a218"
+        stroke="#e5a218"
+        stroke-width="1.2"
+        stroke-linejoin="round"/>
+  <path d="M54 28 L43 28 L43 52 L54 48 Z"
+        fill="#e5a218"
+        stroke="#e5a218"
+        stroke-width="1.2"
+        stroke-linejoin="round"/>
+
+  <!-- Mirror axis (thin + subtle reflective feel) -->
+  <rect x="31.5" y="10" width="1" height="44" rx="0.5" fill="url(#mirror)" opacity="0.9"/>
+</svg>

package/console-dist/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Miravo</title>
+    <script type="module" crossorigin src="/assets/index-hUJSpKtB.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C3XMYq26.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miravo",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "type": "module",
   "description": "Industrial environment platform with canonical asset models and MQTT + OPC UA protocol adapters",
   "license": "Apache-2.0",
@@ -27,21 +27,24 @@
     "miravo": "./src/index.ts"
   },
   "files": [
-    "src/"
+    "src/",
+    "console-dist/"
   ],
   "dependencies": {
     "@clack/prompts": "^1.1.0",
-    "@miravo/core": "0.2.3",
-    "@miravo/mqtt": "0.2.3",
-    "@miravo/opcua": "0.2.3",
-    "@miravo/shared": "0.2.3",
+    "@miravo/core": "0.4.0",
+    "@miravo/mqtt": "0.4.0",
+    "@miravo/opcua": "0.4.0",
+    "@miravo/shared": "0.4.0",
     "commander": "^13.0.0",
     "consola": "^3.4.0",
-    "mqtt": "^5.15.0"
+    "mqtt": "^5.15.0",
+    "yaml": "^2.8.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@miravo/console": "0.0.0",
     "node-opcua-client": "^2.163.1",
-    "node-opcua-variant": "^2.163.0",
-    "yaml": "^2.8.1"
+    "node-opcua-variant": "^2.163.0"
   }
 }

package/src/__tests__/integration/executable-methods-runner.ts

@@ -9,6 +9,7 @@ import { MQTTAdapter } from "@miravo/mqtt";
 import { OPCUAAdapter } from "@miravo/opcua";
 import type { MiravoTemplate, TwinModel } from "@miravo/shared";
 import { startAdminServer } from "../../lib/admin-server.ts";
+import { buildUNSBasePath, forEachTwin } from "../../lib/template-utils.ts";
 
 interface RunnerArgs {
   readonly template: string;
@@ -18,6 +19,10 @@ interface RunnerArgs {
   readonly rbeDeadband: number;
 }
 
+interface ReadyHealthPayload {
+  readonly status?: unknown;
+}
+
 function parseArgs(argv: readonly string[]): RunnerArgs {
   const values = new Map<string, string>();
   for (let index = 0; index < argv.length; index += 2) {
@@ -57,20 +62,6 @@ function resolveSimulationName(template: MiravoTemplate): string {
   return namespace.prefix.toLowerCase();
 }
 
-function buildUNSBasePath(template: MiravoTemplate, areaName: string, lineName: string): string {
-  const segments: string[] = [];
-  const namespace = template.namespace;
-  if (namespace !== undefined) {
-    if ("enterprise" in namespace) {
-      segments.push(namespace.enterprise, namespace.site);
-    } else {
-      segments.push(namespace.prefix);
-    }
-  }
-  segments.push(areaName, lineName);
-  return segments.join("/");
-}
-
 async function loadModels(
   template: MiravoTemplate,
   modelsDir: string,
@@ -83,13 +74,9 @@ async function loadModels(
   }
 
   const referencedModelNames = new Set<string>();
-  for (const area of template.areas) {
-    for (const line of area.lines) {
-      for (const twin of line.twins) {
-        referencedModelNames.add(twin.model);
-      }
-    }
-  }
+  forEachTwin(template, (_area, _line, twin) => {
+    referencedModelNames.add(twin.model);
+  });
 
   for (const modelName of referencedModelNames) {
     if (models.has(modelName)) {
@@ -103,6 +90,26 @@ async function loadModels(
   return models;
 }
 
+async function waitForAdminReady(adminUrl: string, timeoutMs: number): Promise<void> {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const response = await fetch(new URL("/readyz", `${adminUrl}/`));
+      if (response.status === 200) {
+        const payload = (await response.json()) as ReadyHealthPayload;
+        if (payload.status === "ok") {
+          return;
+        }
+      }
+    } catch {
+      // Admin server can still be binding or the engine may not be running yet.
+    }
+    await Bun.sleep(25);
+  }
+
+  throw new Error(`Smoke runtime did not report ready within ${timeoutMs}ms.`);
+}
+
 async function main(): Promise<void> {
   const args = parseArgs(process.argv.slice(2));
   const template = await loadTemplate(args.template);
@@ -127,17 +134,14 @@ async function main(): Promise<void> {
     engine.runtime.registerModel(model);
   }
 
-  for (const area of template.areas) {
-    for (const line of area.lines) {
-      for (const twin of line.twins) {
-        engine.runtime.spawn(twin.model, twin.count, {
-          variation: twin.variation,
-          unsBasePath: buildUNSBasePath(template, area.name, line.name),
-          ...(twin.parameters !== undefined ? { parameterOverrides: twin.parameters } : {}),
-        });
-      }
-    }
-  }
+  forEachTwin(template, (area, line, twin) => {
+    engine.runtime.spawn(twin.model, twin.count, {
+      variation: twin.variation,
+      unsBasePath: buildUNSBasePath(template, area.name, line.name),
+      ...(twin.parameters !== undefined ? { parameterOverrides: twin.parameters } : {}),
+      ...(twin.starting_hours !== undefined ? { startingHours: twin.starting_hours } : {}),
+    });
+  });
 
   const mqttAdapter = new MQTTAdapter(engine.bus);
   await mqttAdapter.start({
@@ -184,19 +188,23 @@ async function main(): Promise<void> {
 
   const adminServer = startAdminServer({
     engine,
-    host: "127.0.0.1",
-    port: 0,
-    tickIntervalMs,
-    mqttEnabled: true,
-    isMqttConnected: () => mqttAdapter.getMetrics().connected,
-    opcuaEnabled: true,
-    isOpcuaConnected: () => opcuaAdapter.getMetrics().connected,
-    getLastTickProgressAt: () => lastTickProgressAt,
+    network: { host: "127.0.0.1", port: 0, tickIntervalMs },
+    protocols: {
+      getLastTickProgressAt: () => lastTickProgressAt,
+    },
+    ws: {
+      bus: engine.bus,
+      getEngineState: () => engine.getMetrics().core.state,
+      getTickInfo: () => ({
+        tick: engine.getMetrics().core.tickCount,
+        simulationTime: engine.getMetrics().core.simulationTimeSeconds,
+        instanceCount: engine.getMetrics().core.instanceCount,
+      }),
+    },
   });
 
-  engine.start();
-
-  await Bun.sleep(Math.max(250, tickIntervalMs * 3));
+  await engine.start();
+  await waitForAdminReady(adminServer.endpoint, Math.max(5_000, tickIntervalMs * 20));
 
   const [instanceId, instance] = [...engine.runtime.getInstances()][0] ?? [];
   if (!instanceId || !instance) {
@@ -237,10 +245,10 @@ async function main(): Promise<void> {
     process.exit(0);
   };
 
-  process.on("SIGINT", () => {
+  process.once("SIGINT", () => {
     void shutdown();
   });
-  process.on("SIGTERM", () => {
+  process.once("SIGTERM", () => {
     void shutdown();
   });