@vev-software/atlas-contracts 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -193,17 +193,27 @@ export interface Observation {
     application?: ApplicationDetails;
     server?: ServerDetails;
     infrastructure?: InfrastructureDetails;
+    dataArea?: DataAreaDetails;
+    dataset?: DatasetDetails;
+    column?: ColumnDetails;
 }
 /**
  * The public wire format a discovery scanner emits into Atlas: a batch of raw observations that
  * the private Atlas Enterprise reconciliation engine turns into catalogue assets.
  */
+export interface ObservedRelationship {
+    fromObservedId: string;
+    toObservedId: string;
+    type: RelationshipType;
+    description?: string | null;
+}
 export interface DiscoveryObservationBatch {
     contractVersion: typeof CONTRACT_VERSION;
     kind: "discovery-observation";
     source: ObservationSource;
     observedAt: string;
     observations: Observation[];
+    relationships?: ObservedRelationship[];
 }
 /** The layout format of a `Diagram`. */
 export type DiagramFormat = "atlas-layout";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vev-software/atlas-contracts",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Public, versioned data model and interop contracts for VEV Atlas — the catalogue asset model plus manual relationships, tags and the landscape import/export document.",
   "license": "Apache-2.0",
   "type": "module",

package/schemas/v1/discovery-observation.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://contracts.vev.software/atlas/v1/discovery-observation.schema.json",
   "title": "Atlas discovery observation batch (v1)",
-  "description": "The public wire format a discovery scanner emits INTO Atlas: a batch of raw observations of an IT landscape (servers, applications, infrastructure) that the private Atlas Enterprise reconciliation engine correlates, deduplicates and turns into catalogue assets. This contract carries facts only — an observation has no Atlas 'id' and no 'lifecycle' (the reconciler assigns those), and never any analysis (no EOL/risk, no criticality, no portfolio scoring). Open so third parties can build scanners; the reconciliation logic that consumes it is the private moat and is NOT part of this repo. See handbook 11 §3, 12 §Phase A, and vev-software/atlas-enterprise#6/#9.",
+  "description": "The public wire format a discovery scanner emits INTO Atlas: a batch of raw observations of an IT landscape (servers, applications, infrastructure, and the data layer down to data-areas, datasets and columns) that the private Atlas Enterprise reconciliation engine correlates, deduplicates and turns into catalogue assets. This contract carries facts only — an observation has no Atlas 'id' and no 'lifecycle' (the reconciler assigns those), and never any analysis (no EOL/risk, no criticality, no portfolio scoring). Open so third parties can build scanners; the reconciliation logic that consumes it is the private moat and is NOT part of this repo. See handbook 11 §3, 12 §Phase A, and vev-software/atlas-enterprise#6/#9.",
   "type": "object",
   "additionalProperties": false,
   "required": ["contractVersion", "kind", "source", "observedAt", "observations"],
@@ -31,9 +31,41 @@
       "description": "The raw observations in this batch. May be empty (a scan that saw nothing new).",
       "items": { "$ref": "#/$defs/Observation" },
       "default": []
+    },
+    "relationships": {
+      "type": "array",
+      "description": "Observed relationships between the things in this batch, referenced by their observedId — e.g. a foreign key (joins-on) or data-layer containment (part-of). Optional and defaults to empty, so a scanner that emits none stays valid. Held facts only; the private reconciler resolves the observedId endpoints to catalogue assets.",
+      "items": { "$ref": "#/$defs/ObservedRelationship" },
+      "default": []
     }
   },
   "$defs": {
+    "ObservedRelationship": {
+      "type": "object",
+      "description": "A relationship between two observed things, by observedId. NOT an Atlas relationship (no asset ids); the reconciler resolves endpoints and re-expresses it in the catalogue.",
+      "additionalProperties": false,
+      "required": ["fromObservedId", "toObservedId", "type"],
+      "properties": {
+        "fromObservedId": {
+          "type": "string",
+          "description": "The referencing observation's observedId.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "toObservedId": {
+          "type": "string",
+          "description": "The referenced observation's observedId.",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "type": {
+          "type": "string",
+          "description": "The held relationship vocabulary. Mirrors relationship.schema.json.",
+          "enum": ["runs-on", "hosts", "connects-to", "depends-on", "part-of", "joins-on"]
+        },
+        "description": { "type": ["string", "null"], "maxLength": 1024 }
+      }
+    },
     "ObservationSource": {
       "type": "object",
       "description": "Which scanner produced the batch. The authoritative tenant binding is the authenticated machine-principal at ingestion (a Fabric concern), NOT this payload; 'tenantRef' is an optional, opaque hint only.",
@@ -134,6 +166,18 @@
         {
           "if": { "properties": { "kind": { "const": "infrastructure" } } },
           "then": { "properties": { "infrastructure": { "$ref": "common.schema.json#/$defs/InfrastructureDetails" } } }
+        },
+        {
+          "if": { "properties": { "kind": { "const": "data-area" } } },
+          "then": { "properties": { "dataArea": { "$ref": "common.schema.json#/$defs/DataAreaDetails" } } }
+        },
+        {
+          "if": { "properties": { "kind": { "const": "dataset" } } },
+          "then": { "properties": { "dataset": { "$ref": "common.schema.json#/$defs/DatasetDetails" } } }
+        },
+        {
+          "if": { "properties": { "kind": { "const": "column" } } },
+          "then": { "properties": { "column": { "$ref": "common.schema.json#/$defs/ColumnDetails" } } }
         }
       ]
     },