model-eol 0.5.2 → 0.6.0

package/lib/validate-feed.mjs

@@ -9,8 +9,9 @@ export const MAX_TIMEOUT_MS = 3600000
 const CONTROL_CHARACTER_PATTERN = /[\u0000-\u001f\u007f-\u009f]/
 const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/
 const DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/
-const DATE_PRECISIONS = new Set(['exact', 'earliest'])
+const DATE_PRECISIONS = new Set(['exact', 'earliest', 'tentative'])
 const DISTRIBUTION_STATUSES = new Set(['active', 'legacy', 'extended-access', 'retired'])
+const RESERVED_DISTRIBUTION_VIAS = new Set(['publisher', 'publisher-fallback'])
 
 export const assertIsoDate = (value, label = 'date') => {
   if (typeof value !== 'string' || !DATE_PATTERN.test(value)) {
@@ -181,7 +182,13 @@ export const validateFeed = feed => {
     const shutdownValid = checkDate(model.shutdown, `${at}.shutdown`)
     if (announcedValid && shutdownValid) validDates.push({ at, announced: model.announced, shutdown: model.shutdown })
     if (model.date_precision !== undefined) {
-      if (typeof model.date_precision !== 'string' || !DATE_PRECISIONS.has(model.date_precision)) fail(`${at}.date_precision`, 'must be exact or earliest')
+      if (typeof model.date_precision !== 'string' || !DATE_PRECISIONS.has(model.date_precision)) fail(`${at}.date_precision`, 'must be exact, earliest, or tentative')
+    }
+    if (model.date_precision === 'tentative' && model.announced !== undefined) {
+      fail(`${at}.announced`, 'must be absent when date_precision is tentative')
+    }
+    if (model.date_precision === 'tentative' && model.shutdown === undefined) {
+      fail(`${at}.shutdown`, 'is required when date_precision is tentative')
     }
     if (model.replacement !== undefined) checkIdentifier(model.replacement, `${at}.replacement`)
     if (model.replacement_options !== undefined) {
@@ -210,6 +217,9 @@ export const validateFeed = feed => {
           if (!checkObjectKeys(distribution, dAt, new Set(['via', 'announced', 'shutdown', 'date_precision', 'status', 'source']))) continue
           if (!checkString(distribution.via, `${dAt}.via`, MAX_IDENTIFIER_LENGTH) || !distribution.via) fail(`${dAt}.via`, 'must be a non-empty string')
           if (typeof distribution.via === 'string' && distribution.via.length > 0) {
+            if (RESERVED_DISTRIBUTION_VIAS.has(distribution.via.toLowerCase())) {
+              fail(`${dAt}.via`, 'must not use a reserved publisher clock name')
+            }
             const previous = seenDistributionVias.get(distribution.via)
             if (previous) fail(`${dAt}.via`, `duplicate distributor via "${distribution.via}" also used at ${previous}`)
             else seenDistributionVias.set(distribution.via, `${dAt}.via`)
@@ -217,8 +227,17 @@ export const validateFeed = feed => {
           const distributionAnnounced = checkDate(distribution.announced, `${dAt}.announced`)
           const distributionShutdown = checkDate(distribution.shutdown, `${dAt}.shutdown`)
           if (distributionAnnounced && distributionShutdown && distribution.shutdown < distribution.announced) fail(dAt, 'shutdown precedes announced')
-          if (distribution.date_precision !== undefined && (typeof distribution.date_precision !== 'string' || !DATE_PRECISIONS.has(distribution.date_precision))) fail(`${dAt}.date_precision`, 'must be exact or earliest')
+          if (distribution.date_precision !== undefined && (typeof distribution.date_precision !== 'string' || !DATE_PRECISIONS.has(distribution.date_precision))) fail(`${dAt}.date_precision`, 'must be exact, earliest, or tentative')
           if (distribution.status !== undefined && (typeof distribution.status !== 'string' || !DISTRIBUTION_STATUSES.has(distribution.status))) fail(`${dAt}.status`, 'has an unsupported status')
+          if (distribution.date_precision === 'tentative' && distribution.announced !== undefined) {
+            fail(`${dAt}.announced`, 'must be absent when date_precision is tentative')
+          }
+          if (distribution.date_precision === 'tentative' && distribution.shutdown === undefined) {
+            fail(`${dAt}.shutdown`, 'is required when date_precision is tentative')
+          }
+          if (distribution.date_precision === 'tentative' && distribution.status === 'retired') {
+            fail(`${dAt}.status`, 'must not be retired when date_precision is tentative')
+          }
           checkUrl(distribution.source, `${dAt}.source`)
           if ((distribution.announced || distribution.shutdown) && !(distribution.source || model.source || feed.source)) fail(dAt, 'dated distribution needs a source')
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "model-eol",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "AI model deprecation feeds with a zero-dependency checker, inventory CLI, and migration bot.",
   "type": "module",
   "bin": {

package/schema/model-eol.bot-config.schema.json

@@ -54,6 +54,13 @@
       },
       "default": { "models": [], "paths": [] }
     },
+    "waivers": {
+      "type": "array",
+      "maxItems": 500,
+      "items": { "$ref": "#/definitions/waiver" },
+      "default": [],
+      "description": "Owned, expiring exceptions that remain visible in reports while active."
+    },
     "overrides": {
       "type": "array",
       "items": { "$ref": "#/definitions/pathOverride" },
@@ -120,6 +127,7 @@
     "via": null,
     "feeds": { "allow_vendored_fallback": false },
     "ignore": { "models": [], "paths": [] },
+    "waivers": [],
     "overrides": [],
     "routes": [],
     "issues": { "enabled": true },
@@ -144,6 +152,24 @@
         "paths": { "$ref": "#/definitions/stringArray" }
       }
     },
+    "waiver": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["model", "reason", "owner", "expires"],
+      "properties": {
+        "model": { "type": "string", "minLength": 1 },
+        "paths": { "$ref": "#/definitions/stringArray" },
+        "via": { "type": "string", "minLength": 1 },
+        "reason": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "owner": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "expires": { "type": "string", "format": "date" }
+      }
+    },
+    "waivers": {
+      "type": "array",
+      "maxItems": 500,
+      "items": { "$ref": "#/definitions/waiver" }
+    },
     "pathOverride": {
       "type": "object",
       "additionalProperties": false,
@@ -153,7 +179,8 @@
         "days": { "type": "integer", "minimum": 0 },
         "scope": { "enum": ["direct", "all"] },
         "via": { "type": ["string", "null"], "minLength": 1 },
-        "ignore": { "$ref": "#/definitions/ignore" }
+        "ignore": { "$ref": "#/definitions/ignore" },
+        "waivers": { "$ref": "#/definitions/waivers" }
       }
     },
     "referenceRoute": {

package/schema/model-eol.check.schema.json

@@ -32,7 +32,7 @@
         "confidence": { "$ref": "https://thossullivan.github.io/model-eol/schema/0.1/model-eol.inventory.schema.json#/definitions/confidence" },
         "status": { "$ref": "https://thossullivan.github.io/model-eol/schema/0.1/model-eol.inventory.schema.json#/definitions/status" },
         "shutdown": { "type": ["string", "null"], "format": "date" },
-        "date_precision": { "enum": ["exact", "earliest", null] },
+        "date_precision": { "enum": ["exact", "earliest", "tentative", null] },
         "distribution_status": { "enum": ["active", "legacy", "extended-access", "retired", null] },
         "via": { "type": ["string", "null"], "minLength": 1 },
         "days": { "type": ["integer", "null"] },
@@ -47,6 +47,7 @@
         "threshold_days": { "type": "integer", "minimum": 0 },
         "effective_scope": { "enum": ["all", "direct"] },
         "requested_via": { "type": ["string", "null"], "minLength": 1 },
+        "waiver": { "$ref": "https://thossullivan.github.io/model-eol/schema/0.1/model-eol.inventory.schema.json#/definitions/waiver" },
         "policy_provenance": { "$ref": "https://thossullivan.github.io/model-eol/schema/0.1/model-eol.inventory.schema.json#/definitions/policyProvenance" },
         "mapped_from": { "type": "string", "minLength": 1 }
       },

package/schema/model-eol.inventory.schema.json

@@ -60,7 +60,7 @@
         "evidence": { "type": "string", "minLength": 1 },
         "status": { "$ref": "#/definitions/status" },
         "shutdown": { "type": ["string", "null"], "format": "date" },
-        "date_precision": { "enum": ["exact", "earliest", null] },
+        "date_precision": { "enum": ["exact", "earliest", "tentative", null] },
         "distribution_status": { "enum": ["active", "legacy", "extended-access", "retired", null] },
         "via": { "type": ["string", "null"], "minLength": 1 },
         "requested_via": { "type": ["string", "null"], "minLength": 1 },
@@ -77,6 +77,7 @@
           "items": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" }
         },
         "replacement_note": { "type": "string", "minLength": 1 },
+        "waiver": { "$ref": "#/definitions/waiver" },
         "source": { "type": ["string", "null"], "format": "uri" },
         "policy": {
           "type": ["object", "null"],
@@ -147,6 +148,17 @@
         "route_index": { "type": ["integer", "null"], "minimum": 0 }
       },
       "additionalProperties": false
+    },
+    "waiver": {
+      "type": ["object", "null"],
+      "required": ["reason", "owner", "expires", "active"],
+      "properties": {
+        "reason": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "owner": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "expires": { "type": "string", "format": "date" },
+        "active": { "type": "boolean" }
+      },
+      "additionalProperties": false
     }
   }
 }

package/schema/model-eol.plan.schema.json

@@ -36,6 +36,7 @@
         "effective_scope": { "enum": ["all", "direct"] },
         "policy_provenance": { "$ref": "#/definitions/policyProvenance" },
         "mapped_from": { "type": "string", "minLength": 1 },
+        "waiver": { "$ref": "#/definitions/waiver" },
         "sources": { "type": "array", "items": { "type": "string" } },
         "notes": { "type": ["string", "null"] }
       },
@@ -69,6 +70,7 @@
         },
         "replacement_note": { "type": "string" },
         "provider": { "type": "string" },
+        "waiver": { "$ref": "#/definitions/waiver" },
         "reason": { "type": "string", "minLength": 1 },
         "sources": { "type": "array", "items": { "type": "string" } },
         "notes": { "type": ["string", "null"] }
@@ -99,6 +101,17 @@
         "route_index": { "type": ["integer", "null"], "minimum": 0 }
       },
       "additionalProperties": false
+    },
+    "waiver": {
+      "type": ["object", "null"],
+      "required": ["reason", "owner", "expires", "active"],
+      "properties": {
+        "reason": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "owner": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "expires": { "type": "string", "format": "date" },
+        "active": { "type": "boolean" }
+      },
+      "additionalProperties": false
     }
   }
 }

package/schema/model-eol.schema.json

@@ -40,7 +40,7 @@
         },
         "announced": { "$ref": "#/definitions/isoDate" },
         "shutdown": { "$ref": "#/definitions/isoDate" },
-        "date_precision": { "enum": ["exact", "earliest"] },
+        "date_precision": { "enum": ["exact", "earliest", "tentative"] },
         "replacement": { "type": "string", "maxLength": 256, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$" },
         "replacement_options": {
           "type": "array",
@@ -59,7 +59,7 @@
               "via": { "type": "string", "minLength": 1 },
               "announced": { "$ref": "#/definitions/isoDate" },
               "shutdown": { "$ref": "#/definitions/isoDate" },
-              "date_precision": { "enum": ["exact", "earliest"] },
+              "date_precision": { "enum": ["exact", "earliest", "tentative"] },
               "status": { "enum": ["active", "legacy", "extended-access", "retired"] },
               "source": { "type": "string", "format": "uri" }
             },