@aifabrix/builder 2.49.2 → 2.51.0

package/lib/schema/external-datasource.schema.json

@@ -7,12 +7,12 @@
          "key":"external-datasource-schema",
          "name":"External Data Source Configuration Schema",
          "description":"JSON schema for validating ExternalDataSource configuration files",
-     "version":"2.8.1",
+     "version":"2.9.4",
          "type":"schema",
          "category":"integration",
          "author":"AI Fabrix Team",
          "createdAt":"2024-01-01T00:00:00Z",
-         "updatedAt":"2026-06-16T00:00:00Z",
+         "updatedAt":"2026-07-18T00:00:00Z",
          "compatibility":{
             "minVersion":"1.0.0",
             "maxVersion":"3.0.0",
@@ -31,6 +31,57 @@
          "external-system.schema.json"
       ],
       "changelog":[
+         {
+            "version":"2.9.4",
+            "date":"2026-07-18T00:00:00Z",
+            "changes":[
+               "Removed root statusMaps (superseded by dimensions.*.map {dimensionValue, rawValue} only — 346 §7.1)."
+            ],
+            "breaking":true
+         },
+         {
+            "version":"2.9.3",
+            "date":"2026-07-18T00:00:00Z",
+            "changes":[
+               "Added optional dimensionBinding.map array of {dimensionValue, rawValue} for static Dimension raw→enterprise translation on normalize (346 §7.1)."
+            ],
+            "breaking":false
+         },
+         {
+            "version":"2.9.2",
+            "date":"2026-07-02T00:00:00Z",
+            "changes":[
+               "Removed webhook.eventTypeHeader and webhook.vendorDeliveryIdHeader — inbound HTTP header names belong on webhookInbound credential config only.",
+               "Retained optional webhook.eventTypePath and webhook.vendorDeliveryIdPath for payload JSONPath routing and idempotency."
+            ],
+            "breaking":false
+         },
+         {
+            "version":"2.9.1",
+            "date":"2026-07-02T00:00:00Z",
+            "changes":[
+               "Added optional webhook.eventTypeHeader, webhook.eventTypePath, webhook.vendorDeliveryIdHeader, and webhook.vendorDeliveryIdPath for manifest-driven routing and idempotency."
+            ],
+            "breaking":false
+         },
+         {
+            "version":"2.9.0",
+            "date":"2026-07-02T00:00:00Z",
+            "changes":[
+               "Added webhook object (enabled, endpointMode, events, deleteEvents, idPath) for vendor change signals.",
+               "Documented syncBridge enum (disabled|master|bidirectional) for Enterprise Synchronization Fabrix."
+            ],
+            "breaking":false
+         },
+         {
+            "version":"2.8.2",
+            "date":"2026-06-29T00:00:00Z",
+            "changes":[
+               "Documented entityType none MUST NOT bind vendor openapi (439.2); use serviceContract for HTTP facades.",
+               "Staged validator migration NONE_OPENAPI phases 1–3; JSON Schema hard gate planned for phase 3."
+            ],
+            "breaking":false
+         },
          {
             "version":"2.8.1",
             "date":"2026-06-15T00:00:00Z",
@@ -417,6 +468,68 @@
          },
          "uniqueItems":true
       },
+      "syncBridge":{
+         "type":"string",
+         "enum":[
+            "disabled",
+            "master",
+            "bidirectional"
+         ],
+         "default":"disabled",
+         "description":"Enterprise Synchronization Fabrix participation mode (454.0). Generated on supply datasource during Enterprise Knowledge compile; default disabled on vendor integrations."
+      },
+      "webhook":{
+         "type":"object",
+         "description":"Vendor webhook change-signal configuration (454.0). Webhook is trigger-only; business data comes from CIP get.",
+         "additionalProperties":false,
+         "properties":{
+            "enabled":{
+               "type":"boolean",
+               "default":false
+            },
+            "endpointMode":{
+               "type":"string",
+               "enum":[
+                  "system",
+                  "datasource",
+                  "event"
+               ],
+               "description":"Controls generated POST receiver path scope."
+            },
+            "events":{
+               "type":"array",
+               "minItems":1,
+               "items":{
+                  "type":"string",
+                  "minLength":1
+               },
+               "description":"Vendor event names that trigger SyncIntent creation."
+            },
+            "deleteEvents":{
+               "type":"array",
+               "items":{
+                  "type":"string",
+                  "minLength":1
+               },
+               "description":"Optional subset of events that signal local soft delete only (no provider delete in V1)."
+            },
+            "idPath":{
+               "type":"string",
+               "minLength":1,
+               "description":"JSONPath to extract vendor object id from webhook payload, e.g. $.objectId"
+            },
+            "eventTypePath":{
+               "type":"string",
+               "minLength":1,
+               "description":"JSONPath to vendor event type in payload when endpointMode is not event and webhook.events has multiple entries."
+            },
+            "vendorDeliveryIdPath":{
+               "type":"string",
+               "minLength":1,
+               "description":"JSONPath to vendor delivery id in payload for idempotent deduplication."
+            }
+         }
+      },
       "dimensions":{
          "type":"object",
          "description":"Canonical dimension bindings for this datasource. Keys must exist in Dimension Catalog when catalog validation runs. For recordStorage/documentStorage, at least one binding is recommended (application validator may warn if missing or empty).",
@@ -1417,6 +1530,10 @@
                "type":"boolean",
                "description":"Filterability hint for metadata-driven query planning."
             },
+            "observer":{
+               "type":"boolean",
+               "description":"When true, a committed change to this normalized first-level scalar field is eligible for Enterprise Runtime observation wake-up."
+            },
             "nullable":{
                "type":"boolean"
             },
@@ -1597,6 +1714,45 @@
                   }
                }
             },
+            {
+               "if":{
+                  "properties":{
+                     "observer":{
+                        "const":true
+                     }
+                  },
+                  "required":[
+                     "observer"
+                  ]
+               },
+               "then":{
+                  "properties":{
+                     "type":{
+                        "type":"string",
+                        "enum":[
+                           "string",
+                           "number",
+                           "integer",
+                           "boolean"
+                        ]
+                     }
+                  },
+                  "not":{
+                     "anyOf":[
+                        {
+                           "required":[
+                              "properties"
+                           ]
+                        },
+                        {
+                           "required":[
+                              "items"
+                           ]
+                        }
+                     ]
+                  }
+               }
+            },
             {
                "if":{
                   "required":[
@@ -1748,6 +1904,30 @@
                "type":"boolean",
                "default":true,
                "description":"When false, this dimension binding is not used for protection/RSS dimension enforcement or governance visibility checks. Catalog binding and metadata materialization may still apply. Use object form to disable; string shorthand bindings are always enforcement-enabled."
+            },
+            "map":{
+               "type":"array",
+               "description":"Optional raw→enterprise value map for static Dimensions. Each entry has only dimensionValue and rawValue. Datasource and field are implied by this binding. CIP normalize persists dimensionValue for ABAC/MCP.",
+               "items":{
+                  "type":"object",
+                  "additionalProperties":false,
+                  "required":[
+                     "dimensionValue",
+                     "rawValue"
+                  ],
+                  "properties":{
+                     "dimensionValue":{
+                        "type":"string",
+                        "minLength":1,
+                        "description":"Enterprise Dimension catalog value."
+                     },
+                     "rawValue":{
+                        "type":"string",
+                        "minLength":1,
+                        "description":"Connected-system token for this binding's field."
+                     }
+                  }
+               }
             }
          },
          "oneOf":[
@@ -2433,6 +2613,15 @@
             "lineage":{
                "$ref":"#/$defs/cipLineage"
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "pattern":"^[a-z0-9-_]+$",
@@ -2498,6 +2687,15 @@
             "lineage":{
                "$ref":"#/$defs/cipLineage"
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "pattern":"^[a-z0-9-_]+$",
@@ -2539,6 +2737,15 @@
                },
                "additionalProperties":false
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "description":"Optional stable step identifier."
@@ -2583,6 +2790,15 @@
             "lineage":{
                "$ref":"#/$defs/cipLineage"
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "pattern":"^[a-z0-9-_]+$",
@@ -2655,6 +2871,15 @@
             "lineage":{
                "$ref":"#/$defs/cipLineage"
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "pattern":"^[a-z0-9-_]+$",
@@ -2699,6 +2924,15 @@
             "lineage":{
                "$ref":"#/$defs/cipLineage"
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "pattern":"^[a-z0-9-_]+$",
@@ -2733,6 +2967,15 @@
             "lineage":{
                "$ref":"#/$defs/cipLineage"
             },
+            "enabled":{
+               "type":"boolean",
+               "default":true,
+               "description":"When false, the CIP executor skips this step during operation execution."
+            },
+            "order":{
+               "type":"number",
+               "description":"Optional execution order within the operation; lower values run first when any step defines order."
+            },
             "stepId":{
                "type":"string",
                "pattern":"^[a-z0-9-_]+$",