fix(core): deep merge workflow metadata

Author: rafaelscosta

.aiox-core/core/orchestration/context-manager.js

@@ -16,6 +16,25 @@
 
 const fs = require('fs-extra');
 const path = require('path');
+const { isPlainObject } = require('../config/merge-utils');
+
+function mergeMetadata(target, source) {
+  const base = isPlainObject(target) ? target : {};
+
+  if (!isPlainObject(source)) {
+    return { ...base };
+  }
+
+  const result = { ...base };
+
+  for (const [key, value] of Object.entries(source)) {
+    result[key] = isPlainObject(value) && isPlainObject(result[key])
+      ? mergeMetadata(result[key], value)
+      : value;
+  }
+
+  return result;
+}
 
 /**
  * Manages workflow execution context and state persistence
@@ -225,7 +244,7 @@ class ContextManager {
    */
   async updateMetadata(metadata) {
     const state = await this.loadState();
-    state.metadata = { ...state.metadata, ...metadata };
+    state.metadata = mergeMetadata(state.metadata, metadata);
     this._stateCache = state;
     await this._saveState();
   }

.aiox-core/install-manifest.yaml

@@ -8,7 +8,7 @@
 # - File types for categorization
 #
 version: 5.1.15
-generated_at: "2026-05-08T04:49:28.006Z"
+generated_at: "2026-05-08T05:02:45.794Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1111
 files:
@@ -845,9 +845,9 @@ files:
     type: core
     size: 12722
   - path: core/orchestration/context-manager.js
-    hash: sha256:7bf273723a2c08cb84e670b9d4c55aacec51819b1fbd5f3b0c46c4ccfa2ec192
+    hash: sha256:134ab455731f9435292da7e37e911000d11860c0d8044948e5f9dcd3460b7cd0
     type: core
-    size: 16842
+    size: 17299
   - path: core/orchestration/dashboard-integration.js
     hash: sha256:8f2dd7d3885a9eaf58957505d312923e149f2771ae3ca0cda879631683f826c9
     type: core

tests/core/orchestration/context-manager.test.js

@@ -567,6 +567,45 @@ describe('ContextManager', () => {
       expect(manager._stateCache.metadata.projectRoot).toBe('/outro/caminho');
     });
 
+    test('preserva metadados aninhados ao aplicar merge profundo', async () => {
+      await manager.updateMetadata({
+        observability: {
+          attempts: {
+            total: 1,
+            lastPhase: 'planning',
+          },
+          tags: ['initial'],
+          nullable: 'keep',
+        },
+      });
+
+      await manager.updateMetadata({
+        observability: {
+          attempts: {
+            failed: 1,
+          },
+          lastError: {
+            code: 'EACCES',
+          },
+          tags: ['latest'],
+          nullable: null,
+        },
+      });
+
+      expect(manager._stateCache.metadata.observability).toEqual({
+        attempts: {
+          total: 1,
+          lastPhase: 'planning',
+          failed: 1,
+        },
+        lastError: {
+          code: 'EACCES',
+        },
+        tags: ['latest'],
+        nullable: null,
+      });
+    });
+
     test('persiste estado no disco', async () => {
       await manager.updateMetadata({ foo: 'bar' });