@enterpriseai/cli 3.10.0 → 3.11.1

package/resources/gofer/references/platform/eai-service-patterns.md

@@ -31,6 +31,13 @@ patterns in `eai-app-template/docs/platform/eai-service-patterns.md`.
 
 ## Storage Backend Rules
 
+Keep Object Type identifiers in their correct layer. Configuration/model
+`name` is PascalCase; the exact stored `slug` is the lowercase
+kebab-case identifier used by relationship targets, runtime `target_type`,
+resource commands, paths, and governed v4 fields. Resolve same-manifest model
+name shorthand through the declared slug before publication. Never normalize
+or rename a historical stored slug.
+
 - `postgresql`: canonical structured resource storage.
 - `documentdb`: document-model persistence when the data genuinely needs it.
 - `blob`: large files or file-like resources behind API-mediated access.

package/resources/gofer/schemas/object-type-identifier-audit-v1.schema.json

@@ -0,0 +1,207 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:eai:schema:object-type-identifier-audit:v1",
+  "title": "EAI Object Type Identifier Audit",
+  "description": "Read-only findings and regional inventory reports for eai.object-type-routing/v1.",
+  "oneOf": [{ "$ref": "#/$defs/IdentifierFinding" }, { "$ref": "#/$defs/InventoryRun" }],
+  "$defs": {
+    "Digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "JsonScalar": {
+      "type": ["string", "number", "integer", "boolean", "null"]
+    },
+    "SourceLocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "file", "line"],
+      "properties": {
+        "kind": { "const": "source" },
+        "file": { "type": "string", "minLength": 1 },
+        "line": { "type": "integer", "minimum": 1 },
+        "column": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "PersistedLocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "tenantRef", "recordRef"],
+      "properties": {
+        "kind": { "const": "persisted" },
+        "tenantRef": { "type": "string", "minLength": 1 },
+        "recordRef": { "type": "string", "minLength": 1 }
+      }
+    },
+    "InventoryLocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "environment", "region"],
+      "properties": {
+        "kind": { "const": "inventory" },
+        "environment": { "enum": ["dev", "test", "prod"] },
+        "region": { "enum": ["ae", "cc", "gwc"] }
+      }
+    },
+    "IdentifierFinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contractVersion",
+        "rule",
+        "classification",
+        "severity",
+        "location",
+        "field",
+        "offendingValue",
+        "remediation"
+      ],
+      "properties": {
+        "contractVersion": { "const": "eai.object-type-routing/v1" },
+        "rule": {
+          "enum": [
+            "OBJECT_TYPE_NAME_NON_CANONICAL",
+            "OBJECT_TYPE_SLUG_MISSING",
+            "OBJECT_TYPE_SLUG_NON_CANONICAL",
+            "OBJECT_TYPE_SLUG_DERIVATION_MISMATCH",
+            "OBJECT_TYPE_DIRECT_ROUTE_CONSTRUCTION",
+            "OBJECT_TYPE_INVENTORY_INCOMPLETE"
+          ]
+        },
+        "classification": {
+          "enum": ["blocking_source_drift", "report_only_persisted_legacy_drift", "activation_blocker"]
+        },
+        "severity": { "enum": ["error", "warning", "info"] },
+        "location": {
+          "oneOf": [
+            { "$ref": "#/$defs/SourceLocation" },
+            { "$ref": "#/$defs/PersistedLocation" },
+            { "$ref": "#/$defs/InventoryLocation" }
+          ]
+        },
+        "field": { "type": ["string", "null"] },
+        "offendingValue": { "$ref": "#/$defs/JsonScalar" },
+        "expectedValue": {
+          "oneOf": [{ "$ref": "#/$defs/JsonScalar" }, { "type": "object" }]
+        },
+        "remediation": { "type": "string", "minLength": 1 }
+      }
+    },
+    "PaginationEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pageCount", "recordCount", "terminal"],
+      "properties": {
+        "pageCount": { "type": "integer", "minimum": 0 },
+        "recordCount": { "type": "integer", "minimum": 0 },
+        "terminal": { "const": true }
+      }
+    },
+    "ObjectTypePaginationEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tenantRef", "pageCount", "recordCount", "terminal"],
+      "properties": {
+        "tenantRef": { "type": "string", "minLength": 1 },
+        "pageCount": { "type": "integer", "minimum": 0 },
+        "recordCount": { "type": "integer", "minimum": 0 },
+        "terminal": { "const": true }
+      }
+    },
+    "InventoryRun": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "contractVersion",
+        "status",
+        "writeAttemptCount",
+        "environment",
+        "region",
+        "snapshotStartedAt",
+        "snapshotCompletedAt",
+        "releaseOwnerUserRef",
+        "identityKind",
+        "roleVisibilityComplete",
+        "snapshotBasis",
+        "sourceEndpoints",
+        "tenantSetDigestAlgorithm",
+        "expectedActiveTenantCount",
+        "scannedTenantCount",
+        "expectedTenantSetDigest",
+        "scannedTenantSetDigest",
+        "prePostUniverseStable",
+        "tenantPagination",
+        "objectTypePagination",
+        "objectTypePageCount",
+        "objectTypeRecordCount",
+        "sourceErrorCount",
+        "findingsSummary",
+        "findings",
+        "digestAlgorithm",
+        "digest"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "eai.object-type-routing.inventory/v1" },
+        "contractVersion": { "const": "eai.object-type-routing/v1" },
+        "status": { "enum": ["complete", "incomplete"] },
+        "writeAttemptCount": { "type": "integer", "const": 0 },
+        "environment": { "enum": ["dev", "test", "prod"] },
+        "region": { "enum": ["ae", "cc", "gwc"] },
+        "snapshotStartedAt": { "type": "string", "format": "date-time" },
+        "snapshotCompletedAt": { "type": "string", "format": "date-time" },
+        "releaseOwnerUserRef": { "type": "string", "minLength": 1 },
+        "identityKind": { "const": "USER" },
+        "roleVisibilityComplete": { "type": "boolean" },
+        "snapshotBasis": { "enum": ["server_snapshot", "stable_pre_post_enumeration"] },
+        "sourceEndpoints": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["tenants", "objectTypes"],
+          "properties": {
+            "tenants": { "type": "string", "pattern": "^GET /v4/platform/tenants" },
+            "objectTypes": { "type": "string", "pattern": "^GET /v4/data/resources/object-types" }
+          }
+        },
+        "tenantSetDigestAlgorithm": { "const": "HMAC-SHA256" },
+        "expectedActiveTenantCount": { "type": "integer", "minimum": 0 },
+        "scannedTenantCount": { "type": "integer", "minimum": 0 },
+        "expectedTenantSetDigest": { "$ref": "#/$defs/Digest" },
+        "scannedTenantSetDigest": { "$ref": "#/$defs/Digest" },
+        "preTenantSetDigest": { "$ref": "#/$defs/Digest" },
+        "postTenantSetDigest": { "$ref": "#/$defs/Digest" },
+        "prePostUniverseStable": { "type": "boolean" },
+        "tenantPagination": { "$ref": "#/$defs/PaginationEvidence" },
+        "objectTypePagination": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ObjectTypePaginationEvidence" }
+        },
+        "objectTypePageCount": { "type": "integer", "minimum": 0 },
+        "objectTypeRecordCount": { "type": "integer", "minimum": 0 },
+        "sourceErrorCount": { "type": "integer", "minimum": 0 },
+        "findingsSummary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["blocking_source_drift", "report_only_persisted_legacy_drift", "activation_blocker"],
+          "properties": {
+            "blocking_source_drift": { "type": "integer", "minimum": 0 },
+            "report_only_persisted_legacy_drift": { "type": "integer", "minimum": 0 },
+            "activation_blocker": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "findings": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/IdentifierFinding" }
+        },
+        "digestAlgorithm": { "const": "SHA-256/RFC8785" },
+        "digest": { "$ref": "#/$defs/Digest" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "snapshotBasis": { "const": "stable_pre_post_enumeration" } } },
+          "then": { "required": ["preTenantSetDigest", "postTenantSetDigest"] }
+        }
+      ]
+    }
+  }
+}

package/resources/gofer/schemas/object-type-routing-phase-bundle-v1.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:eai:schema:object-type-routing-phase-bundle:v1",
+  "title": "EAI Object Type Routing Phase Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "repository", "phase", "baselineSha", "semantics", "entries", "rootDigest"],
+  "properties": {
+    "schemaVersion": { "const": "eai.object-type-routing.phase-bundle/v1" },
+    "repository": { "type": "string", "minLength": 1 },
+    "phase": { "enum": ["P0", "A0", "P1", "A1"] },
+    "baselineSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "semantics": { "const": "cumulative_from_baseline" },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "kind", "mode", "deleted", "contentBase64", "contentDigest", "entryDigest"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+          },
+          "kind": { "enum": ["file", "symlink", "deletion"] },
+          "mode": { "enum": ["100644", "100755", "120000"] },
+          "deleted": { "type": "boolean" },
+          "contentBase64": { "type": ["string", "null"] },
+          "contentDigest": {
+            "oneOf": [{ "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, { "type": "null" }]
+          },
+          "entryDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+        }
+      }
+    },
+    "rootDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/resources/gofer/specify-commands/6_gofer_validate.md

@@ -300,6 +300,19 @@ Validation MUST treat the closed-loop and loop audits as objective gates:
 - If the audit only reports low-severity warnings with no recommended reopen
   stage, continue but record them in the validation report.
 
+## Object Type Identifier Contract
+
+- Preserve PascalCase source/model `name` and exact lowercase kebab-case
+  transport/storage `slug` as distinct identifiers.
+- Generated `linkTypes[].targetObjectType`, runtime `target_type`, paths, and
+  governed v4 fields contain exact stored slugs.
+- Resolve same-manifest model-name shorthand through the declared slug before
+  publication; reject unresolved names instead of guessing.
+- Use the shared platform SDK for app routes. Never hand-write v4 resource
+  paths or add a local slugifier.
+- Historical stored slugs are authoritative. Never normalize, alias, or rename
+  them to match current derivation.
+
 ---
 
 # Phase A — Rubric Validation

package/resources/gofer/system-skills/6_gofer_validate/SKILL.md

@@ -324,6 +324,19 @@ Validation MUST treat the closed-loop and loop audits as objective gates:
 - If the audit only reports low-severity warnings with no recommended reopen
   stage, continue but record them in the validation report.
 
+## Object Type Identifier Contract
+
+- Preserve PascalCase source/model `name` and exact lowercase kebab-case
+  transport/storage `slug` as distinct identifiers.
+- Generated `linkTypes[].targetObjectType`, runtime `target_type`, paths, and
+  governed v4 fields contain exact stored slugs.
+- Resolve same-manifest model-name shorthand through the declared slug before
+  publication; reject unresolved names instead of guessing.
+- Use the shared platform SDK for app routes. Never hand-write v4 resource
+  paths or add a local slugifier.
+- Historical stored slugs are authoritative. Never normalize, alias, or rename
+  them to match current derivation.
+
 ---
 
 # Phase A — Rubric Validation