@vev-software/atlas-contracts 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -60,6 +60,7 @@ export interface Asset {
     kind: AssetKind;
     name: string;
     lifecycle: Lifecycle;
+    inUsePeriod?: InUsePeriod | null;
     description?: string | null;
     tags?: Tag[];
     application?: ApplicationDetails;
@@ -105,6 +106,7 @@ export interface ImportAsset {
     kind: AssetKind;
     name: string;
     lifecycle: Lifecycle;
+    inUsePeriod?: InUsePeriod | null;
     description?: string | null;
     tags?: Tag[];
     application?: ApplicationDetails;
@@ -504,3 +506,12 @@ export interface TargetArchitectureDocument {
     versions: TargetVersion[];
     transitions?: TargetTransition[];
 }
+/** Calendar dates (YYYY-MM-DD), start inclusive/end exclusive; omitted/null means unknown. */
+export interface InUsePeriod {
+    plannedStart?: string | null;
+    plannedEnd?: string | null;
+    actualStart?: string | null;
+    actualEnd?: string | null;
+}
+/** Validate dates and pair ordering. Does not infer lifecycle or replace raw JSON Schema validation. */
+export declare function validateInUsePeriod(period?: InUsePeriod | null): string[];

package/dist/index.js

@@ -48,3 +48,31 @@ export function validateLandscapeDigestV2(digest) {
     }
     return errors;
 }
+/** Validate dates and pair ordering. Does not infer lifecycle or replace raw JSON Schema validation. */
+export function validateInUsePeriod(period) {
+    if (period == null)
+        return [];
+    const errors = [];
+    const valid = (value) => {
+        if (!/^[0-9]{4}-[0-9]{2}-[0-9]{2}$/.test(value))
+            return false;
+        const year = Number(value.slice(0, 4));
+        const month = Number(value.slice(5, 7));
+        const day = Number(value.slice(8, 10));
+        const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+        const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+        return year >= 1 && month >= 1 && month <= 12 && day >= 1 && day <= days[month - 1];
+    };
+    for (const key of ["plannedStart", "plannedEnd", "actualStart", "actualEnd"]) {
+        const value = period[key];
+        if (value != null && (typeof value !== "string" || !valid(value)))
+            errors.push(`${key} must be a valid YYYY-MM-DD date.`);
+    }
+    for (const prefix of ["planned", "actual"]) {
+        const start = period[`${prefix}Start`];
+        const end = period[`${prefix}End`];
+        if (typeof start === "string" && typeof end === "string" && valid(start) && valid(end) && start > end)
+            errors.push(`${prefix}Start must be on or before ${prefix}End.`);
+    }
+    return errors;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vev-software/atlas-contracts",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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",
@@ -16,7 +16,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "npm run build && tsc --ignoreConfig --noEmit --strict --target ES2022 --module nodenext test/landscape-digest-v2.types.ts && node --test test/*.test.mjs",
+    "test": "npm run build && tsc --ignoreConfig --noEmit --strict --target ES2022 --module nodenext test/landscape-digest-v2.types.ts test/in-use-period.types.ts && node --test test/*.test.mjs",
     "prepack": "node scripts/prepack.mjs"
   },
   "devDependencies": {

package/schemas/v1/asset.schema.json

@@ -24,6 +24,7 @@
       "maxLength": 4096
     },
     "lifecycle": { "$ref": "common.schema.json#/$defs/Lifecycle" },
+    "inUsePeriod": { "oneOf": [{ "type": "null" }, { "$ref": "common.schema.json#/$defs/InUsePeriod" }] },
     "tags": {
       "type": "array",
       "items": { "$ref": "common.schema.json#/$defs/Tag" },

package/schemas/v1/common.schema.json

@@ -4,6 +4,17 @@
   "title": "Atlas contracts — common types (v1)",
   "description": "Shared catalogue vocabulary for the Atlas asset model. Catalogue concepts only: no integration-criticality, EOL risk, portfolio scoring or AI review (those work with the data and live in the private Atlas core). See handbook 11 §1.",
   "$defs": {
+    "InUsePeriod": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Planned and actual calendar-date periods, start inclusive and end exclusive. Missing/null dates are unknown. Same-day boundaries are allowed. Validate start <= end separately for each pair; no cross-pair or lifecycle constraint.",
+      "properties": {
+        "plannedStart": { "type": ["string", "null"], "format": "date", "pattern": "^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+        "plannedEnd": { "type": ["string", "null"], "format": "date", "pattern": "^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+        "actualStart": { "type": ["string", "null"], "format": "date", "pattern": "^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+        "actualEnd": { "type": ["string", "null"], "format": "date", "pattern": "^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$" }
+      }
+    },
     "AssetKind": {
       "type": "string",
       "description": "The kind of asset held in the catalogue. The data-layer kinds (data-area, dataset, column) model the data architecture beneath a system, down to the column. The AI kinds (ai-service, ai-model) catalogue AI platforms and models as first-class assets.",

package/schemas/v1/import.schema.json

@@ -50,6 +50,7 @@
         "name": { "type": "string", "minLength": 1, "maxLength": 256 },
         "description": { "type": ["string", "null"], "maxLength": 4096 },
         "lifecycle": { "$ref": "common.schema.json#/$defs/Lifecycle" },
+        "inUsePeriod": { "oneOf": [{ "type": "null" }, { "$ref": "common.schema.json#/$defs/InUsePeriod" }] },
         "tags": {
           "type": "array",
           "items": { "$ref": "common.schema.json#/$defs/Tag" },