miravo 0.1.4 → 1.0.5

package/README.md

@@ -87,24 +87,29 @@ miravo start --content-dir ./my-content
 
 Start the simulation engine with an embedded MQTT broker.
 
-| Option                        | Description                                                                   |
-| ----------------------------- | ----------------------------------------------------------------------------- |
-| `--template <id\|name\|path>` | Template to run (env: `MIRAVO_TEMPLATE`)                                      |
-| `--content-dir <path>`        | User content root with `/templates` and `/models` (env: `MIRAVO_CONTENT_DIR`) |
-| `--models-dir <path>`         | Additional `.twin.yaml` model directory                                       |
-| `--speed <multiplier>`        | Time multiplier (default: `1`)                                                |
-| `--seed <number>`             | Deterministic RNG seed                                                        |
-| `--tick <ms>`                 | Tick interval in ms (default: `1000`)                                         |
-| `--port <number>`             | MQTT port (default: `1883`, env: `MIRAVO_MQTT_PORT`)                          |
-| `--mqtt-host <host>`          | MQTT bind host (default: `127.0.0.1`, env: `MIRAVO_MQTT_HOST`)                |
-| `--mqtt-mode <mode>`          | `embedded` or `external` (env: `MIRAVO_MQTT_MODE`)                            |
-| `--mqtt-url <url>`            | External broker URL (env: `MIRAVO_MQTT_URL`)                                  |
-| `--mqtt-username <user>`      | External broker username (env: `MIRAVO_MQTT_USERNAME`)                        |
-| `--mqtt-password <pass>`      | External broker password (env: `MIRAVO_MQTT_PASSWORD`)                        |
-| `--health-host <host>`        | Health server host (default: `0.0.0.0`, env: `MIRAVO_HEALTH_HOST`)            |
-| `--health-port <number>`      | Health server port (default: `8080`, env: `MIRAVO_HEALTH_PORT`)               |
-| `--dry-run`                   | Validate and print summary without starting                                   |
-| `--summary-interval <s>`      | Seconds between periodic summaries (default: `5`)                             |
+| Option                           | Description                                                                   |
+| -------------------------------- | ----------------------------------------------------------------------------- |
+| `-t, --template <id\|name\|path>`| Template to run (env: `MIRAVO_TEMPLATE`)                                      |
+| `-n, --name <name>`              | Simulation name for control topics (env: `MIRAVO_NAME`)                       |
+| `--content-dir <path>`           | User content root with `/templates` and `/models` (env: `MIRAVO_CONTENT_DIR`) |
+| `--models-dir <path>`            | Additional `.twin.yaml` model directory                                       |
+| `-s, --speed <multiplier>`       | Time multiplier (default: `1`)                                                |
+| `--seed <number>`                | Deterministic RNG seed                                                        |
+| `--tick <ms>`                    | Tick interval in ms (default: `1000`)                                         |
+| `-p, --mqtt-port <number>`       | MQTT port (default: `1883`, env: `MIRAVO_MQTT_PORT`)                          |
+| `--mqtt-host <host>`             | MQTT bind host (default: `127.0.0.1`, env: `MIRAVO_MQTT_HOST`)               |
+| `--mqtt-mode <mode>`             | `embedded` or `external` (env: `MIRAVO_MQTT_MODE`)                            |
+| `--mqtt-url <url>`               | External broker URL (env: `MIRAVO_MQTT_URL`)                                  |
+| `--mqtt-username <user>`         | External broker username (env: `MIRAVO_MQTT_USERNAME`)                        |
+| `--mqtt-password <pass>`         | External broker password (env: `MIRAVO_MQTT_PASSWORD`)                        |
+| `--no-mqtt`                      | Disable MQTT broker                                                           |
+| `--opcua`                        | Enable OPC UA server                                                          |
+| `--opcua-port <number>`          | OPC UA port (default: `4840`, env: `MIRAVO_OPCUA_PORT`)                       |
+| `--opcua-host <host>`            | OPC UA bind host (default: `0.0.0.0`, env: `MIRAVO_OPCUA_HOST`)              |
+| `--health-host <host>`           | Health server host (default: `0.0.0.0`, env: `MIRAVO_HEALTH_HOST`)            |
+| `--health-port <number>`         | Health server port (default: `8080`, env: `MIRAVO_HEALTH_PORT`)               |
+| `-d, --dry-run`                  | Validate and print summary without starting                                   |
+| `--summary-interval <s>`         | Seconds between periodic summaries (default: `5`)                             |
 
 ### `miravo templates list`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miravo",
-  "version": "0.1.4",
+  "version": "1.0.5",
   "type": "module",
   "description": "Digital twin engine for Industrial IoT simulation",
   "license": "Apache-2.0",
@@ -31,9 +31,10 @@
   ],
   "dependencies": {
     "@clack/prompts": "^1.1.0",
-    "@miravo/core": "0.1.4",
-    "@miravo/mqtt": "0.1.4",
-    "@miravo/shared": "0.1.4",
+    "@miravo/core": "1.0.5",
+    "@miravo/mqtt": "1.0.5",
+    "@miravo/opcua": "1.0.5",
+    "@miravo/shared": "1.0.5",
     "commander": "^13.0.0",
     "consola": "^3.4.0",
     "mqtt": "^5.15.0"

package/src/commands/start.ts

@@ -12,11 +12,13 @@ import {
   validateFullTemplate,
 } from "@miravo/core";
 import { MQTTAdapter } from "@miravo/mqtt";
+import { OPCUAAdapter } from "@miravo/opcua";
 import type { DigitalTwinModel, DiscoveredTemplate, MiravoTemplate } from "@miravo/shared";
 import {
   ConfigNotFoundError,
   ConfigValidationError,
   DEFAULT_MQTT_PORT,
+  DEFAULT_OPCUA_PORT,
   DEFAULT_TICK_INTERVAL_MS,
   DEFAULT_TIME_MULTIPLIER,
   MIRAVO_VERSION,
@@ -24,7 +26,7 @@ import {
   SimulationNameSchema,
 } from "@miravo/shared";
 import type { Command } from "commander";
-import { box, colors } from "consola/utils";
+import { box, colors, stripAnsi } from "consola/utils";
 import { startHealthServer } from "../lib/health-server.ts";
 import {
   parseDurationMs,
@@ -53,6 +55,7 @@ import {
   isPlain,
   lifecycleLog,
   mqttLog,
+  opcuaLog,
   setRuntimeLogContext,
   writeOutput,
 } from "../logger.ts";
@@ -66,12 +69,16 @@ interface StartOptions {
   readonly speed?: number;
   readonly seed?: number;
   readonly tick?: number;
-  readonly port?: number;
+  readonly mqttPort?: number;
   readonly mqttHost?: string;
   readonly mqttMode?: string;
   readonly mqttUrl?: string;
   readonly mqttUsername?: string;
   readonly mqttPassword?: string;
+  readonly mqtt?: boolean;
+  readonly opcuaPort?: number;
+  readonly opcuaHost?: string;
+  readonly opcua?: boolean;
   readonly healthHost?: string;
   readonly healthPort?: number;
   readonly dryRun?: boolean;
@@ -99,9 +106,9 @@ export function registerStartCommand(program: Command): void {
   program
     .command("start")
     .description("Start the digital twin simulation")
-    .option("--name <name>", "Simulation name for control topics (env: MIRAVO_NAME)")
+    .option("-n, --name <name>", "Simulation name for control topics (env: MIRAVO_NAME)")
     .option(
-      "--template <id|name|path>",
+      "-t, --template <id|name|path>",
       "Template identifier, display name, or .miravo.yaml path (env: MIRAVO_TEMPLATE)",
     )
     .option("--models-dir <path>", "Additional directory to search for .twin.yaml models")
@@ -109,26 +116,27 @@ export function registerStartCommand(program: Command): void {
       "--content-dir <path>",
       "User content root with /templates and /models (env: MIRAVO_CONTENT_DIR)",
     )
-    .option("--speed <multiplier>", "Time multiplier override (default: 1)", parsePositiveFloat)
+    .option("-s, --speed <multiplier>", "Time multiplier (default: 1)", parsePositiveFloat)
     .option("--seed <number>", "RNG seed for deterministic simulation", parseNonNegativeInt)
+    .option("--tick <ms>", "Tick interval in milliseconds (default: 1000)", parseDurationMs)
     .option(
-      "--tick <ms>",
-      "Tick interval override in milliseconds (default: 1000)",
-      parseDurationMs,
-    )
-    .option(
-      "--port <number>",
-      "MQTT broker port override (default: 1883, env: MIRAVO_MQTT_PORT)",
+      "-p, --mqtt-port <number>",
+      "MQTT broker port (default: 1883, env: MIRAVO_MQTT_PORT)",
       parsePort,
     )
-    .option(
-      "--mqtt-host <host>",
-      "Embedded MQTT bind host override (default: 127.0.0.1, env: MIRAVO_MQTT_HOST)",
-    )
-    .option("--mqtt-mode <mode>", "MQTT mode override: embedded | external (env: MIRAVO_MQTT_MODE)")
+    .option("--mqtt-host <host>", "MQTT bind host (default: 127.0.0.1, env: MIRAVO_MQTT_HOST)")
+    .option("--mqtt-mode <mode>", "MQTT mode: embedded | external (env: MIRAVO_MQTT_MODE)")
     .option("--mqtt-url <url>", "External MQTT broker URL (env: MIRAVO_MQTT_URL)")
     .option("--mqtt-username <username>", "External MQTT username (env: MIRAVO_MQTT_USERNAME)")
     .option("--mqtt-password <password>", "External MQTT password (env: MIRAVO_MQTT_PASSWORD)")
+    .option("--no-mqtt", "Disable MQTT broker")
+    .option("--opcua", "Enable OPC UA server")
+    .option(
+      "--opcua-port <number>",
+      "OPC UA server port (default: 4840, env: MIRAVO_OPCUA_PORT)",
+      parsePort,
+    )
+    .option("--opcua-host <host>", "OPC UA server bind host (env: MIRAVO_OPCUA_HOST)")
     .option(
       "--health-host <host>",
       "Health server host (default: 0.0.0.0, env: MIRAVO_HEALTH_HOST)",
@@ -138,7 +146,7 @@ export function registerStartCommand(program: Command): void {
       "Health server port (default: 8080, env: MIRAVO_HEALTH_PORT)",
       parsePort,
     )
-    .option("--dry-run", "Validate config and print summary without starting")
+    .option("-d, --dry-run", "Validate config and print summary without starting")
     .option(
       "--summary-interval <seconds>",
       "Seconds between periodic summary lines (default: 5)",
@@ -155,50 +163,115 @@ export function registerStartCommand(program: Command): void {
 
 async function startAction(options: StartOptions): Promise<void> {
   let runtimeLogContextSet = false;
+  /** Adapter stop functions accumulated during setup. Drained on partial startup failure. */
+  const pendingAdapterStops: Array<() => Promise<void>> = [];
   try {
     const catalog = createCatalog(options.contentDir);
 
     // Resolve env-var fallbacks for common options
     const templateOption = options.template ?? Bun.env["MIRAVO_TEMPLATE"];
     const simulationNameEnv = Bun.env["MIRAVO_NAME"];
-    const portEnv = Bun.env["MIRAVO_MQTT_PORT"];
-    const mqttHost = options.mqttHost ?? Bun.env["MIRAVO_MQTT_HOST"];
-    const mqttMode = parseMqttModeOption(options.mqttMode ?? Bun.env["MIRAVO_MQTT_MODE"]);
-    const mqttUrl = options.mqttUrl ?? Bun.env["MIRAVO_MQTT_URL"];
-    const mqttUsername = options.mqttUsername ?? Bun.env["MIRAVO_MQTT_USERNAME"];
-    const mqttPassword = options.mqttPassword ?? Bun.env["MIRAVO_MQTT_PASSWORD"];
-    const healthHost = options.healthHost ?? Bun.env["MIRAVO_HEALTH_HOST"] ?? "0.0.0.0";
-    const healthPortEnv = Bun.env["MIRAVO_HEALTH_PORT"];
-    const mqttOverrides: MqttRunOverrides = {
-      ...(mqttMode !== undefined ? { mode: mqttMode } : {}),
-      ...(mqttHost !== undefined && mqttHost.length > 0 ? { host: mqttHost } : {}),
-      ...(mqttUrl !== undefined && mqttUrl.length > 0 ? { url: mqttUrl } : {}),
-      ...(mqttUsername !== undefined && mqttUsername.length > 0 ? { username: mqttUsername } : {}),
-      ...(mqttPassword !== undefined && mqttPassword.length > 0 ? { password: mqttPassword } : {}),
-    };
-    let portOption = options.port;
-    if (portOption === undefined && portEnv) {
-      try {
-        portOption = parsePort(portEnv);
-      } catch {
-        throw new ConfigValidationError({
-          message: `Invalid MIRAVO_MQTT_PORT environment variable: "${portEnv}".`,
-          fix: "Set MIRAVO_MQTT_PORT to a valid port number between 1 and 65535 (for example, 1883).",
-        });
+    // Protocol selection: CLI flags decide which protocols run
+    const mqttEnabled = options.mqtt !== false; // --no-mqtt disables
+    const opcuaEnabled = options.opcua === true; // --opcua enables
+
+    // Warn on ignored protocol-specific flags
+    if (!mqttEnabled) {
+      if (options.mqttPort !== undefined) {
+        configLog.warn("--mqtt-port ignored because MQTT is disabled.");
+      }
+      if (options.mqttHost !== undefined) {
+        configLog.warn("--mqtt-host ignored because MQTT is disabled.");
+      }
+      if (options.mqttMode !== undefined) {
+        configLog.warn("--mqtt-mode ignored because MQTT is disabled.");
       }
     }
+    if (!opcuaEnabled) {
+      if (options.opcuaPort !== undefined) {
+        configLog.warn(
+          "--opcua-port ignored because OPC UA is not enabled. Use --opcua to enable it.",
+        );
+      }
+      if (options.opcuaHost !== undefined) {
+        configLog.warn(
+          "--opcua-host ignored because OPC UA is not enabled. Use --opcua to enable it.",
+        );
+      }
+    }
+
+    const healthHost = options.healthHost ?? Bun.env["MIRAVO_HEALTH_HOST"] ?? "0.0.0.0";
+    const healthPortEnv = Bun.env["MIRAVO_HEALTH_PORT"];
     if (healthHost.trim().length === 0) {
       throw new ConfigValidationError({
         message: "Invalid health server host: value is empty.",
         fix: "Set --health-host / MIRAVO_HEALTH_HOST to a valid host (for example, 0.0.0.0).",
       });
     }
-    if (mqttHost !== undefined && mqttHost.trim().length === 0) {
-      throw new ConfigValidationError({
-        message: "Invalid MQTT bind host: value is empty.",
-        fix: "Set --mqtt-host / MIRAVO_MQTT_HOST to a valid host (for example, 127.0.0.1 or 0.0.0.0).",
-      });
+
+    // MQTT env overrides — only parsed when MQTT is enabled
+    let portOption = options.mqttPort;
+    let mqttOverrides: MqttRunOverrides = {};
+    if (mqttEnabled) {
+      const portEnv = Bun.env["MIRAVO_MQTT_PORT"];
+      const mqttHost = options.mqttHost ?? Bun.env["MIRAVO_MQTT_HOST"];
+      const mqttMode = parseMqttModeOption(options.mqttMode ?? Bun.env["MIRAVO_MQTT_MODE"]);
+      const mqttUrl = options.mqttUrl ?? Bun.env["MIRAVO_MQTT_URL"];
+      const mqttUsername = options.mqttUsername ?? Bun.env["MIRAVO_MQTT_USERNAME"];
+      const mqttPassword = options.mqttPassword ?? Bun.env["MIRAVO_MQTT_PASSWORD"];
+      mqttOverrides = {
+        ...(mqttMode !== undefined ? { mode: mqttMode } : {}),
+        ...(mqttHost !== undefined && mqttHost.length > 0 ? { host: mqttHost } : {}),
+        ...(mqttUrl !== undefined && mqttUrl.length > 0 ? { url: mqttUrl } : {}),
+        ...(mqttUsername !== undefined && mqttUsername.length > 0
+          ? { username: mqttUsername }
+          : {}),
+        ...(mqttPassword !== undefined && mqttPassword.length > 0
+          ? { password: mqttPassword }
+          : {}),
+      };
+      if (portOption === undefined && portEnv) {
+        try {
+          portOption = parsePort(portEnv);
+        } catch {
+          throw new ConfigValidationError({
+            message: `Invalid MIRAVO_MQTT_PORT environment variable: "${portEnv}".`,
+            fix: "Set MIRAVO_MQTT_PORT to a valid port number between 1 and 65535 (for example, 1883).",
+          });
+        }
+      }
+      if (mqttHost !== undefined && mqttHost.trim().length === 0) {
+        throw new ConfigValidationError({
+          message: "Invalid MQTT bind host: value is empty.",
+          fix: "Set --mqtt-host / MIRAVO_MQTT_HOST to a valid host (for example, 127.0.0.1 or 0.0.0.0).",
+        });
+      }
     }
+
+    // OPC UA env overrides — only parsed when OPC UA is enabled
+    let opcuaPort: number | undefined = options.opcuaPort;
+    let opcuaHost: string | undefined;
+    if (opcuaEnabled) {
+      const opcuaPortEnv = Bun.env["MIRAVO_OPCUA_PORT"];
+      if (opcuaPort === undefined && opcuaPortEnv) {
+        try {
+          opcuaPort = parsePort(opcuaPortEnv);
+        } catch {
+          throw new ConfigValidationError({
+            message: `Invalid MIRAVO_OPCUA_PORT environment variable: "${opcuaPortEnv}".`,
+            fix: "Set MIRAVO_OPCUA_PORT to a valid port number between 1 and 65535 (for example, 4840).",
+          });
+        }
+      }
+      opcuaHost = options.opcuaHost ?? Bun.env["MIRAVO_OPCUA_HOST"] ?? undefined;
+      if (opcuaHost !== undefined && opcuaHost.trim().length === 0) {
+        throw new ConfigValidationError({
+          message: "Invalid OPC UA bind host: value is empty.",
+          fix: "Set --opcua-host / MIRAVO_OPCUA_HOST to a valid host (for example, 0.0.0.0).",
+        });
+      }
+    }
+
     let healthPort = options.healthPort;
     if (healthPort === undefined && healthPortEnv) {
       try {
@@ -251,15 +324,18 @@ async function startAction(options: StartOptions): Promise<void> {
       simulationName,
     );
 
-    // Step 5: Start MQTT adapter
-    const mqttStartResult = await startMQTTAdapter(
-      engine,
-      template,
-      portOption,
-      mqttOverrides,
-      simulationName,
-    );
+    // Step 5: Start MQTT adapter (unless --no-mqtt)
+    const mqttStartResult = mqttEnabled
+      ? await startMQTTAdapter(engine, template, portOption, mqttOverrides, simulationName)
+      : null;
     const adapter = mqttStartResult?.adapter ?? null;
+    if (adapter) pendingAdapterStops.push(() => adapter.stop());
+
+    // Step 5a: Start OPC UA adapter (only when --opcua)
+    const opcuaResult = opcuaEnabled
+      ? await startOPCUAAdapter(engine, template, opcuaPort, opcuaHost, simulationName)
+      : null;
+    if (opcuaResult) pendingAdapterStops.push(() => opcuaResult.adapter.stop());
 
     // Step 5b: Wire control plane
     let controlPlane: ControlPlane | null = null;
@@ -291,6 +367,8 @@ async function startAction(options: StartOptions): Promise<void> {
         port: healthPort,
         mqttEnabled: adapter !== null,
         isMqttConnected: () => (adapter ? adapter.getMetrics().connected : false),
+        opcuaEnabled: opcuaResult !== null,
+        isOpcuaConnected: () => (opcuaResult ? opcuaResult.adapter.getMetrics().connected : false),
         getLastTickProgressAt: () => lastTickProgressAt,
       });
       controlLog.info(`Health server active on ${healthServer.endpoint}`);
@@ -310,6 +388,7 @@ async function startAction(options: StartOptions): Promise<void> {
       seed,
       seedExplicit,
       mqttStartResult?.endpoint ?? null,
+      opcuaResult?.endpoint ?? null,
       simulationName,
       runId,
       healthServer.endpoint,
@@ -351,8 +430,12 @@ async function startAction(options: StartOptions): Promise<void> {
       runtimeLogContextSet = false;
       throw error;
     }
+    // Engine running — shutdown handlers now own adapter lifecycle
+    pendingAdapterStops.length = 0;
     engineLog.success("Simulation started.");
   } catch (error) {
+    // Stop adapters started before engine/shutdown handlers took ownership
+    await Promise.allSettled(pendingAdapterStops.map((fn) => fn()));
     if (runtimeLogContextSet) {
       clearRuntimeLogContext();
       runtimeLogContextSet = false;
@@ -757,12 +840,59 @@ async function startMQTTAdapter(
     const message = error instanceof Error ? error.message : String(error);
     const isPortConflict = message.includes("EADDRINUSE") || message.includes("in use");
     const fix = isPortConflict
-      ? `Port ${port} is in use. Use '--port ${port + 1}' or set protocols.mqtt.port in template.`
+      ? `Port ${port} is in use. Use '--mqtt-port ${port + 1}' or set protocols.mqtt.port in template.`
       : "Check the MQTT configuration in your template file.";
     throw new MiravoError(`MQTT adapter failed to start: ${message}`, fix);
   }
 }
 
+// ---------------------------------------------------------------------------
+// Step 5a: OPC UA adapter
+// ---------------------------------------------------------------------------
+
+async function startOPCUAAdapter(
+  engine: Engine,
+  template: MiravoTemplate,
+  portOverride: number | undefined,
+  hostOverride: string | undefined,
+  simulationName: string,
+): Promise<{ adapter: OPCUAAdapter; endpoint: string } | null> {
+  const opcuaConfig = template.protocols?.opcua;
+
+  const port = portOverride ?? opcuaConfig?.port ?? DEFAULT_OPCUA_PORT;
+  const host = hostOverride ?? opcuaConfig?.host ?? "0.0.0.0";
+
+  opcuaLog.debug(`Starting OPC UA adapter on opc.tcp://${host}:${port}`);
+
+  const opcuaAdapter = new OPCUAAdapter(engine.bus);
+
+  try {
+    const resolvedConfig = {
+      name: "opcua" as const,
+      enabled: true,
+      port,
+      host,
+      security: opcuaConfig?.security ?? "none",
+      simulationName,
+      ...(opcuaConfig?.buildInfo ? { buildInfo: opcuaConfig.buildInfo } : {}),
+    };
+
+    await opcuaAdapter.start(resolvedConfig);
+    engine.registerAdapter(opcuaAdapter);
+
+    const endpoint = `opc.tcp://${host === "0.0.0.0" ? "localhost" : host}:${port}`;
+    opcuaLog.ready(`OPC UA server: ${colors.cyan(endpoint)}`);
+    return { adapter: opcuaAdapter, endpoint };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const isPortConflict = message.includes("EADDRINUSE") || message.includes("in use");
+    const fix = isPortConflict
+      ? `Port ${port} is in use. Use '--opcua-port ${port + 1}'.`
+      : "Check the OPC UA port/network settings and retry.";
+    throw new MiravoError(`OPC UA adapter failed to start: ${message}`, fix);
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Step 6: Startup banner
 // ---------------------------------------------------------------------------
@@ -773,32 +903,55 @@ function printStartupBanner(
   seed: number,
   seedExplicit: boolean,
   mqttEndpoint: string | null,
+  opcuaEndpoint: string | null,
   simulationName: string,
   runId: string,
   healthEndpoint: string,
 ): void {
   const state = engine.getState();
-  const modelSummary =
-    state.models
-      .map((m) => `${colors.bold(m.name)} ${colors.dim(`(${m.sensorCount} sensors)`)}`)
-      .join(", ") || colors.dim("(none)");
+
+  // Build model summary: one model per line for readability
+  const modelLines = state.models.map(
+    (m) => `${colors.bold(m.name)} ${colors.dim(`(${m.sensorCount} sensors)`)}`,
+  );
+  const modelCount = `${colors.bold(String(state.models.length))} ${colors.dim("models")}`;
 
   const seedValue = seedExplicit
     ? colors.bold(String(seed))
     : `${colors.bold(String(seed))} ${colors.gray("(random — add seed to config to reproduce)")}`;
 
-  const content = formatKeyValue([
+  const mqttValue = mqttEndpoint ? colors.cyan(mqttEndpoint) : colors.dim("disabled");
+  const opcuaValue = opcuaEndpoint ? colors.cyan(opcuaEndpoint) : colors.dim("disabled");
+
+  const allEntries: ReadonlyArray<readonly [string, string]> = [
     [colors.dim("Simulation"), colors.bold(simulationName)],
     [colors.dim("Run ID"), colors.bold(runId)],
     [colors.dim("Template"), templatePath],
-    [colors.dim("Models"), modelSummary],
+    [colors.dim("Models"), modelCount],
     [colors.dim("Instances"), colors.bold(String(state.instances.length))],
-    [colors.dim("MQTT"), mqttEndpoint ? colors.cyan(mqttEndpoint) : colors.dim("disabled")],
+    [colors.dim("MQTT"), mqttValue],
+    [colors.dim("OPC UA"), opcuaValue],
     [colors.dim("Health"), colors.cyan(`${healthEndpoint}/healthz`)],
     [colors.dim("Tick interval"), colors.bold(`${state.config.tickIntervalMs}ms`)],
     [colors.dim("Time multiplier"), colors.bold(`${state.config.timeMultiplier}x`)],
     [colors.dim("Seed"), seedValue],
-  ]);
+  ];
+
+  const kvBlock = formatKeyValue(allEntries);
+
+  // Compute the value column offset used by formatKeyValue so model detail
+  // lines align with the value of the "Models" row.
+  const maxKeyWidth = Math.max(...allEntries.map(([key]) => stripAnsi(key).length));
+  const valueIndent = 4 + maxKeyWidth + 3; // "    " + key + ":" + padding(2) + " "
+
+  // Inject per-model detail lines right after the "Models" row
+  const kvLines = kvBlock.split("\n");
+  const modelsIdx = kvLines.findIndex((line) => stripAnsi(line).includes("Models:"));
+  if (modelsIdx !== -1 && modelLines.length > 0) {
+    const detailLines = modelLines.map((line) => `${"".padEnd(valueIndent)}${line}`);
+    kvLines.splice(modelsIdx + 1, 0, ...detailLines);
+  }
+  const content = kvLines.join("\n");
 
   const header = `${colors.cyan(colors.bold("Miravo"))} ${colors.dim(`v${MIRAVO_VERSION}`)}`;
 
@@ -856,7 +1009,7 @@ function subscribeToEvents(engine: Engine, errorContextCounts: Map<string, numbe
   };
 
   const onFaultCleared = (event: { instanceId: string; fault: string }): void => {
-    faultLog.success(`${event.instanceId} ${event.fault} cleared`);
+    faultLog.debug(`${event.instanceId} ${event.fault} cleared`);
   };
 
   const onError = (event: { context: string; error: Error }): void => {
@@ -918,14 +1071,25 @@ function startPeriodicSummary(
 
     const sep = colors.dim(" · ");
 
-    let mqttStatus: string;
+    const protocolParts: string[] = [];
+
     if (mqttAdapter) {
       const errCount = mqttAdapter.metrics.errorsCount;
       const errStr =
         errCount === 0 ? colors.green(formatCount(errCount)) : colors.yellow(formatCount(errCount));
-      mqttStatus = `MQTT: ${colors.bold(formatCount(mqttAdapter.metrics.messagesPublished))} published${sep}${errStr} errors`;
-    } else {
-      mqttStatus = colors.dim("MQTT: not connected");
+      protocolParts.push(
+        `MQTT: ${colors.bold(formatCount(mqttAdapter.metrics.messagesPublished))} published${sep}${errStr} errors`,
+      );
+    }
+
+    const opcuaAdapter = metrics.adapters.find((a) => a.name === "opcua");
+    if (opcuaAdapter) {
+      const errCount = opcuaAdapter.metrics.errorsCount;
+      const errStr =
+        errCount === 0 ? colors.green(formatCount(errCount)) : colors.yellow(formatCount(errCount));
+      protocolParts.push(
+        `OPC UA: ${colors.bold(formatCount(opcuaAdapter.metrics.messagesPublished))} updates${sep}${errStr} errors`,
+      );
     }
 
     const tps =
@@ -933,8 +1097,10 @@ function startPeriodicSummary(
         ? `${colors.bold(core.actualTicksPerSecond.toFixed(1))} tps`
         : "";
 
+    const protocolSuffix = protocolParts.length > 0 ? `${sep}${protocolParts.join(sep)}` : "";
+
     engineLog.info(
-      `tick #${colors.bold(formatCount(core.tickCount))}${sep}${colors.bold(formatCount(core.instanceCount))} instances${sep}${colors.bold(formatCount(core.unsEntryCount))} UNS topics${sep}sim: ${colors.bold(core.simulationTimeSeconds.toFixed(1))}s${sep}${tps}${tps ? sep : ""}${mqttStatus}`,
+      `tick #${colors.bold(formatCount(core.tickCount))}${sep}${colors.bold(formatCount(core.instanceCount))} instances${sep}${colors.bold(formatCount(core.unsEntryCount))} UNS topics${sep}sim: ${colors.bold(core.simulationTimeSeconds.toFixed(1))}s${sep}${tps}${tps ? sep : ""}${protocolSuffix}`,
     );
   }, intervalSeconds * 1_000);
 }

package/src/commands/status.ts

@@ -523,6 +523,26 @@ function renderOverview(metrics: MetricsSnapshot, state: StateSnapshot): void {
     );
   }
 
+  // OPC UA
+  const opcuaAdapter = metrics.adapters.find((a) => a.name === "opcua");
+  if (opcuaAdapter) {
+    const connStr = opcuaAdapter.metrics.connected
+      ? colors.green("connected")
+      : colors.red("disconnected");
+    const errStr =
+      opcuaAdapter.metrics.errorsCount > 0
+        ? colors.yellow(String(opcuaAdapter.metrics.errorsCount))
+        : colors.green("0");
+    writeOutput(
+      formatKeyValue([
+        [
+          colors.dim("OPC UA"),
+          `${connStr}${sep}${formatCount(opcuaAdapter.metrics.messagesPublished)} updates${sep}${errStr} errors`,
+        ],
+      ]),
+    );
+  }
+
   // Errors
   if (
     core.engineErrorsCount > 0 ||

package/src/lib/health-server.test.ts

@@ -65,6 +65,8 @@ interface StartServerOptions {
   readonly tickIntervalMs?: number;
   readonly mqttEnabled: boolean;
   readonly isMqttConnected: () => boolean;
+  readonly opcuaEnabled?: boolean;
+  readonly isOpcuaConnected?: () => boolean;
 }
 
 function startTestServer(options: StartServerOptions, handles: Array<{ stop: () => void }>) {
@@ -75,6 +77,8 @@ function startTestServer(options: StartServerOptions, handles: Array<{ stop: ()
     port: 0,
     mqttEnabled: options.mqttEnabled,
     isMqttConnected: options.isMqttConnected,
+    opcuaEnabled: options.opcuaEnabled ?? false,
+    isOpcuaConnected: options.isOpcuaConnected ?? (() => false),
     getLastTickProgressAt: () => mock.getLastTickProgressAt(),
   });
   handles.push(handle);
@@ -133,6 +137,40 @@ describe("health server", () => {
     expect(ready.status).toBe(200);
   });
 
+  test("/readyz returns 503 when opcua is enabled but disconnected", async () => {
+    const { baseUrl } = startTestServer(
+      {
+        state: "running",
+        mqttEnabled: false,
+        isMqttConnected: () => false,
+        opcuaEnabled: true,
+        isOpcuaConnected: () => false,
+      },
+      handles,
+    );
+
+    const ready = await fetch(`${baseUrl}/readyz`);
+    expect(ready.status).toBe(503);
+    const body = (await ready.json()) as { reason?: string };
+    expect(body.reason).toBe("opcua disconnected");
+  });
+
+  test("/readyz ignores opcua when opcua is disabled", async () => {
+    const { baseUrl } = startTestServer(
+      {
+        state: "running",
+        mqttEnabled: false,
+        isMqttConnected: () => false,
+        opcuaEnabled: false,
+        isOpcuaConnected: () => false,
+      },
+      handles,
+    );
+
+    const ready = await fetch(`${baseUrl}/readyz`);
+    expect(ready.status).toBe(200);
+  });
+
   test("/healthz returns 503 when state is stopped", async () => {
     const { baseUrl } = startTestServer(
       { state: "stopped", mqttEnabled: false, isMqttConnected: () => false },

package/src/lib/health-server.ts

@@ -11,6 +11,8 @@ interface HealthServerOptions {
   readonly port: number;
   readonly mqttEnabled: boolean;
   readonly isMqttConnected: () => boolean;
+  readonly opcuaEnabled: boolean;
+  readonly isOpcuaConnected: () => boolean;
   readonly getLastTickProgressAt: () => number;
 }
 
@@ -30,6 +32,8 @@ interface HealthResponseBody {
   readonly tickCount: number;
   readonly mqttEnabled: boolean;
   readonly mqttConnected: boolean | null;
+  readonly opcuaEnabled: boolean;
+  readonly opcuaConnected: boolean | null;
   readonly stalled: boolean;
   readonly reason?: string;
 }
@@ -62,6 +66,8 @@ function readinessStatus(input: {
   readonly stalled: boolean;
   readonly mqttEnabled: boolean;
   readonly mqttConnected: boolean;
+  readonly opcuaEnabled: boolean;
+  readonly opcuaConnected: boolean;
 }): HealthServerStatus {
   if (input.core.state !== "running") {
     return { status: "fail", reason: `engine state is "${input.core.state}"` };
@@ -72,6 +78,9 @@ function readinessStatus(input: {
   if (input.mqttEnabled && !input.mqttConnected) {
     return { status: "fail", reason: "mqtt disconnected" };
   }
+  if (input.opcuaEnabled && !input.opcuaConnected) {
+    return { status: "fail", reason: "opcua disconnected" };
+  }
   return { status: "ok" };
 }
 
@@ -79,10 +88,19 @@ function readinessStatus(input: {
  * Start a lightweight HTTP health server for container probes.
  *
  * - `/healthz`: liveness (process/tick loop health)
- * - `/readyz`: readiness (engine running + MQTT connected when enabled)
+ * - `/readyz`: readiness (engine running + adapters connected when enabled)
  */
 function startHealthServer(options: HealthServerOptions): HealthServerHandle {
-  const { engine, host, port, mqttEnabled, isMqttConnected, getLastTickProgressAt } = options;
+  const {
+    engine,
+    host,
+    port,
+    mqttEnabled,
+    isMqttConnected,
+    opcuaEnabled,
+    isOpcuaConnected,
+    getLastTickProgressAt,
+  } = options;
 
   const server = Bun.serve({
     hostname: host,
@@ -101,11 +119,14 @@ function startHealthServer(options: HealthServerOptions): HealthServerHandle {
         now - lastTickProgressAt > stallThresholdMs;
 
       const mqttConnected = mqttEnabled ? isMqttConnected() : false;
+      const opcuaConnected = opcuaEnabled ? isOpcuaConnected() : false;
       const bodyBase = {
         simulationState: metrics.core.state,
         tickCount: metrics.core.tickCount,
         mqttEnabled,
         mqttConnected: mqttEnabled ? mqttConnected : null,
+        opcuaEnabled,
+        opcuaConnected: opcuaEnabled ? opcuaConnected : null,
         stalled,
       } as const;
 
@@ -127,6 +148,8 @@ function startHealthServer(options: HealthServerOptions): HealthServerHandle {
           stalled,
           mqttEnabled,
           mqttConnected,
+          opcuaEnabled,
+          opcuaConnected,
         });
         return toJsonResponse(
           {

package/src/lib/shutdown.ts

@@ -119,37 +119,86 @@ function printShutdownSummary(
 
   const { core, fleet, adapters } = metrics;
   const mqttAdapter = adapters.find((a) => a.name === "mqtt");
+  const opcuaAdapter = adapters.find((a) => a.name === "opcua");
 
   const sep = colors.dim(" \u00B7 ");
   const lines: string[] = [];
 
+  // --- Core stats ---
   lines.push(
-    `${colors.bold(formatDuration(core.uptimeMs))}${sep}${colors.bold(formatCount(core.tickCount))} ticks${sep}${colors.bold(formatCount(core.instanceCount))} instances${sep}${colors.bold(formatCount(core.unsEntryCount))} UNS topics`,
+    `${colors.bold(formatDuration(core.uptimeMs))}${sep}${colors.bold(formatCount(core.tickCount))} ticks${sep}${colors.bold(String(core.actualTicksPerSecond.toFixed(1)))} ticks/s`,
+  );
+  lines.push(
+    `${colors.bold(formatCount(core.instanceCount))} instances${sep}${colors.bold(formatCount(core.unsEntryCount))} UNS topics`,
   );
 
+  // --- Protocol adapters ---
   if (mqttAdapter) {
-    const errCount = mqttAdapter.metrics.errorsCount;
+    const m = mqttAdapter.metrics;
+    const errStr =
+      m.errorsCount === 0
+        ? colors.green(formatCount(m.errorsCount))
+        : colors.yellow(formatCount(m.errorsCount));
+    lines.push(
+      `MQTT: ${colors.bold(formatCount(m.messagesPublished))} published${sep}${errStr} errors`,
+    );
+  }
+  if (opcuaAdapter) {
+    const m = opcuaAdapter.metrics;
     const errStr =
-      errCount === 0 ? colors.green(formatCount(errCount)) : colors.yellow(formatCount(errCount));
+      m.errorsCount === 0
+        ? colors.green(formatCount(m.errorsCount))
+        : colors.yellow(formatCount(m.errorsCount));
     lines.push(
-      `MQTT: ${colors.bold(formatCount(mqttAdapter.metrics.messagesPublished))} published${sep}${errStr} errors`,
+      `OPC UA: ${colors.bold(formatCount(m.messagesPublished))} updates${sep}${errStr} errors`,
     );
   }
 
+  // --- Fleet health ---
+  const healthParts: string[] = [];
   if (fleet.activeFaultCount > 0) {
-    lines.push(`Active faults at shutdown: ${colors.yellow(String(fleet.activeFaultCount))}`);
+    healthParts.push(`${colors.yellow(String(fleet.activeFaultCount))} active faults`);
+  }
+  if (core.quarantinedInstanceCount > 0) {
+    healthParts.push(
+      `${colors.yellow(String(core.quarantinedInstanceCount))} quarantined instances`,
+    );
+  }
+  if (core.tickOverrunsCount > 0) {
+    healthParts.push(`${colors.yellow(formatCount(core.tickOverrunsCount))} tick overruns`);
+  }
+  if (core.circuitBreakerTripsCount > 0) {
+    healthParts.push(
+      `${colors.yellow(formatCount(core.circuitBreakerTripsCount))} circuit breaker trips`,
+    );
+  }
+  if (healthParts.length > 0) {
+    lines.push(healthParts.join(sep));
+  }
+
+  // --- Lifecycle breakdown ---
+  const lifecycleEntries = Object.entries(fleet.lifecycleBreakdown).filter(
+    ([, count]) => count > 0,
+  );
+  if (lifecycleEntries.length > 0) {
+    const parts = lifecycleEntries.map(
+      ([stage, count]) => `${colors.bold(String(count))} ${stage}`,
+    );
+    lines.push(`Lifecycle: ${parts.join(sep)}`);
   }
 
+  // --- Seed ---
   const seedLine = seedExplicit
     ? `Seed: ${colors.bold(String(seed))}`
     : `Seed: ${colors.bold(String(seed))} ${colors.gray("(add seed to config to reproduce)")}`;
   lines.push(seedLine);
 
+  // --- Top error contexts ---
   if (errorContextCounts && errorContextCounts.size > 0) {
     const topContexts = [...errorContextCounts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5);
     lines.push("Top error contexts:");
     for (const [context, count] of topContexts) {
-      lines.push(`  ${context} ${colors.dim("·")} ${colors.bold(formatCount(count))}`);
+      lines.push(`  ${context} ${colors.dim("\u00B7")} ${colors.bold(formatCount(count))}`);
     }
   }
 

package/src/logger.test.ts

@@ -43,13 +43,13 @@ async function captureConsoleLogs<T>(
 describe("configureLogger", () => {
   test("--silent trumps --verbose", () => {
     configureLogger({ verbose: true, silent: true });
-    expect(logger.level).toBe(1);
+    expect(logger.level).toBe(0);
     expect(isSilent()).toBe(true);
   });
 
   test("--silent sets output suppressed", () => {
     configureLogger({ silent: true });
-    expect(logger.level).toBe(1);
+    expect(logger.level).toBe(0);
     expect(isSilent()).toBe(true);
   });
 

package/src/logger.ts

@@ -12,6 +12,7 @@ export type LogFormat = "pretty" | "json";
 const TAG_COLORS: Readonly<Record<string, (s: string) => string>> = {
   engine: colors.cyan,
   mqtt: colors.green,
+  opcua: colors.green,
   config: colors.yellow,
   lifecycle: colors.magenta,
   fault: colors.red,
@@ -43,6 +44,7 @@ interface ReporterLogObject {
 const fancyReporters = [...logger.options.reporters];
 const prettyReporter = {
   log(logObj: ReporterLogObject, ctx: unknown) {
+    if (logObj.level === 1 && !_verbose) return;
     if (logObj.args.length > 0 && typeof logObj.args[0] === "string") {
       logObj.args[0] = ` ${logObj.args[0]}`;
     }
@@ -81,12 +83,13 @@ function levelToString(level: number): "trace" | "debug" | "info" | "warn" | "er
   if (level === 4) return "debug";
   if (level === 3) return "info";
   if (level === 2) return "warn";
-  if (level === 1) return "error";
+  if (level === 1) return "warn";
   return "fatal";
 }
 
 const jsonReporter = {
   log(logObj: ReporterLogObject) {
+    if (logObj.level === 1 && !_verbose) return;
     const errorArg = logObj.args.find((arg) => arg instanceof Error);
     const metadataArg = logObj.args.find(
       (arg) => typeof arg === "object" && arg !== null && !(arg instanceof Error),
@@ -137,6 +140,9 @@ export const lifecycleLog: ConsolaInstance = logger.withTag("lifecycle");
 /** Fault trigger and clear events. */
 export const faultLog: ConsolaInstance = logger.withTag("fault");
 
+/** OPC UA adapter connection and server events. */
+export const opcuaLog: ConsolaInstance = logger.withTag("opcua");
+
 /** Control plane status and command routing events. */
 export const controlLog: ConsolaInstance = logger.withTag("control");
 
@@ -145,6 +151,7 @@ const allLoggers: ConsolaInstance[] = [
   logger,
   engineLog,
   mqttLog,
+  opcuaLog,
   configLog,
   lifecycleLog,
   faultLog,
@@ -168,6 +175,7 @@ export interface LoggerOptions {
 
 let _outputSuppressed = false;
 let _plainOutput = false;
+let _verbose = false;
 let _locked = false;
 let _logFormat: LogFormat = "pretty";
 const runtimeLogContext: { simulationName: string | undefined; runId: string | undefined } = {
@@ -197,7 +205,7 @@ export function clearRuntimeLogContext(): void {
  * Set the global log level based on CLI flags.
  * --silent trumps --verbose when both are provided.
  *
- * Levels: 1 = errors/fatals only, 3 = info (default), 4 = debug.
+ * Levels: 0 = errors/fatals only, 3 = info (default), 4 = debug.
  */
 export function configureLogger(opts: LoggerOptions): void {
   if (_locked) return;
@@ -205,9 +213,11 @@ export function configureLogger(opts: LoggerOptions): void {
   applyLogReporter(_logFormat);
   _plainOutput = opts.plain ?? false;
 
+  _verbose = opts.verbose ?? false;
+
   let level: number;
   if (opts.silent) {
-    level = 1;
+    level = 0;
     _outputSuppressed = true;
   } else if (opts.verbose) {
     level = 4;