@vev-software/atlas-contracts 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,38 @@
+# @vev-software/atlas-contracts
+
+Public, versioned **data model and interop contracts** for VEV Atlas — the portability and
+interoperability surface that the Atlas runtime and third-party importers/exporters all build
+against, without reaching into anyone's internals.
+
+```sh
+npm i @vev-software/atlas-contracts
+```
+
+```ts
+import type { LandscapeDocument, Asset } from "@vev-software/atlas-contracts";
+```
+
+## What's inside
+
+- **Asset data model** — the catalogue of systems, applications, servers and infrastructure,
+  plus the manual **relationships** and **tags** that connect and classify them.
+- **Landscape import/export document** — the schema that carries a whole landscape across a
+  boundary (customer-owned export; community importers/exporters).
+- **Authoritative JSON Schemas** — shipped under `schemas/` in the package, so you can validate
+  payloads against the exact same contracts the TypeScript types describe.
+
+Ships type declarations (`dist/index.d.ts`) and ESM; no runtime dependencies.
+
+## Versioning
+
+[SemVer](https://semver.org), derived from the git tag (`vX.Y.Z`) at release. Pre-1.0, the v1
+contract evolves additively across minor/patch versions.
+
+## Links
+
+- **Source & issues:** https://github.com/Vev-software/atlas-contracts
+- **.NET SDK (NuGet):** [`Vev.Atlas.Contracts`](https://www.nuget.org/packages/Vev.Atlas.Contracts)
+
+## Licence
+
+[Apache-2.0](https://github.com/Vev-software/atlas-contracts/blob/main/LICENSE).

package/dist/index.d.ts

@@ -193,6 +193,9 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vev-software/atlas-contracts",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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"],
@@ -134,6 +134,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" } } }
         }
       ]
     },