@jevitate/cli 0.23.0 → 0.25.0

package/contracts/jevitate-catalog/v1/schemas/personas.schema.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://jevitate.com/schemas/catalog/v1/personas.schema.json",
+  "title": "Jevitate personas.json v1",
+  "oneOf": [
+    {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "anyOf": [
+          {
+            "required": [
+              "id"
+            ]
+          },
+          {
+            "required": [
+              "name"
+            ]
+          }
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+          },
+          "name": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 2000
+          },
+          "role": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "storageState": {
+            "type": "string",
+            "maxLength": 1000
+          },
+          "login": {
+            "type": "object"
+          },
+          "approval": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "contentHash",
+              "at"
+            ],
+            "properties": {
+              "contentHash": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              },
+              "at": {
+                "type": "string",
+                "minLength": 1
+              },
+              "provenance": {
+                "type": "object"
+              },
+              "acceptedFindings": {
+                "type": "object"
+              }
+            }
+          },
+          "extensions": {
+            "type": "object",
+            "maxProperties": 16
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "personas"
+      ],
+      "properties": {
+        "personas": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "anyOf": [
+              {
+                "required": [
+                  "id"
+                ]
+              },
+              {
+                "required": [
+                  "name"
+                ]
+              }
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+              },
+              "name": {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+              },
+              "description": {
+                "type": "string",
+                "maxLength": 2000
+              },
+              "role": {
+                "type": "string",
+                "maxLength": 200
+              },
+              "storageState": {
+                "type": "string",
+                "maxLength": 1000
+              },
+              "login": {
+                "type": "object"
+              },
+              "approval": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "contentHash",
+                  "at"
+                ],
+                "properties": {
+                  "contentHash": {
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{64}$"
+                  },
+                  "at": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "provenance": {
+                    "type": "object"
+                  },
+                  "acceptedFindings": {
+                    "type": "object"
+                  }
+                }
+              },
+              "extensions": {
+                "type": "object",
+                "maxProperties": 16
+              }
+            },
+            "additionalProperties": true
+          }
+        }
+      }
+    },
+    {
+      "type": "object",
+      "propertyNames": {
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$"
+      },
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "type": "string",
+            "minLength": 1
+          },
+          {
+            "type": "object",
+            "properties": {
+              "description": {
+                "type": "string",
+                "maxLength": 2000
+              },
+              "role": {
+                "type": "string",
+                "maxLength": 200
+              },
+              "storageState": {
+                "type": "string",
+                "maxLength": 1000
+              },
+              "login": {
+                "type": "object"
+              },
+              "approval": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "contentHash",
+                  "at"
+                ],
+                "properties": {
+                  "contentHash": {
+                    "type": "string",
+                    "pattern": "^[0-9a-f]{64}$"
+                  },
+                  "at": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "provenance": {
+                    "type": "object"
+                  },
+                  "acceptedFindings": {
+                    "type": "object"
+                  }
+                }
+              },
+              "extensions": {
+                "type": "object",
+                "maxProperties": 16
+              }
+            },
+            "additionalProperties": true
+          }
+        ]
+      }
+    }
+  ]
+}

package/contracts/jevitate-catalog/v2/README.md

@@ -0,0 +1,18 @@
+# Jevitate repository catalog contract v2
+
+This immutable contract release defines the git-backed `.jevitate/` files shared with consumers.
+The JSON Schemas are closed where the runtime schemas are closed. The repository-catalog compatibility
+exception for legacy persona descriptive keys remains: they participate in the persona approval hash.
+
+New approval hashes use `jevitate-content-hash-v2` and the vectors in
+`approval-hash-vectors.json`: object keys sort lexicographically by unsigned UTF-16 code units;
+arrays retain order and the encoded JSON has no insignificant whitespace. This writer is not readable
+by consumers of the v1 contract, so it is published as contract major 2. Readers may also recognize
+existing v1 approvals (JavaScript `localeCompare`) during migration, but never write a new v1
+approval. Session paths and login settings are operational and excluded from persona approval hashes.
+A consumer must still run Jevitate's semantic reference and approval checks; JSON Schema validation
+alone is insufficient. The immutable v1.0.0 contract remains available at the sibling `v1/` path.
+
+The manifest records the source repository, the full source commit and the package version at that
+commit. Publication is intentionally two commits: first commit source and generator changes, then
+run the generator with that commit's SHA and commit the regenerated immutable contract.

package/contracts/jevitate-catalog/v2/approval-hash-vectors.json

@@ -0,0 +1,75 @@
+{
+  "algorithm": "jevitate-content-hash-v2",
+  "canonicalization": "UTF-8 JSON; arrays retain order; object keys sort lexicographically by unsigned UTF-16 code units; no whitespace",
+  "vectors": [
+    {
+      "kind": "persona",
+      "input": {
+        "id": "owner",
+        "description": "Owns the product",
+        "role": "owner",
+        "extensions": {
+          "journeeze": {
+            "tier": "private"
+          }
+        }
+      },
+      "canonical": "{\"description\":\"Owns the product\",\"extensions\":{\"journeeze\":{\"tier\":\"private\"}},\"id\":\"owner\",\"role\":\"owner\"}",
+      "sha256": "601ca6c440f5d6d9c4a3bad5cab5b2c4a03e7ae170b49d28333e0a2762ba019e"
+    },
+    {
+      "kind": "job",
+      "input": {
+        "id": "review-work",
+        "trigger": "work is ready",
+        "motivation": "review it",
+        "outcome": "ship with confidence",
+        "personas": [
+          "owner"
+        ]
+      },
+      "canonical": "{\"id\":\"review-work\",\"motivation\":\"review it\",\"outcome\":\"ship with confidence\",\"personas\":[\"owner\"],\"trigger\":\"work is ready\"}",
+      "sha256": "2d15af87ec10aa0aad33dbc79a20ae761f35eff0ba4db3f099b43c91303463a6"
+    },
+    {
+      "kind": "unicode-order",
+      "input": {
+        "z": 1,
+        "ä": 2,
+        "a": 3,
+        "Å": 4
+      },
+      "canonical": "{\"a\":3,\"z\":1,\"Å\":4,\"ä\":2}",
+      "sha256": "3db95dddd935182a5f842fc08fd53436fbaeac1cfb62e933441643c1920312be"
+    },
+    {
+      "kind": "unicode-code-unit-order",
+      "input": {
+        "": 1,
+        "𐀀": 2,
+        "é": 3,
+        "é": 4
+      },
+      "canonical": "{\"é\":3,\"é\":4,\"𐀀\":2,\"\":1}",
+      "sha256": "e41f068bae10d342a86d2a4354424df7bd5c5b2b216f2a8742a6a02928f5acd2"
+    },
+    {
+      "kind": "journey-review",
+      "input": {
+        "metadata": {
+          "id": "review-work",
+          "name": "Review work",
+          "params": [],
+          "createdAtIso": "2026-10-24T00:00:00.000Z"
+        },
+        "recording": {
+          "version": "1.0.0",
+          "site": "http://localhost",
+          "pages": []
+        }
+      },
+      "canonical": "{\"metadata\":{\"createdAtIso\":\"2026-10-24T00:00:00.000Z\",\"id\":\"review-work\",\"name\":\"Review work\",\"params\":[]},\"recording\":{\"pages\":[],\"site\":\"http://localhost\",\"version\":\"1.0.0\"}}",
+      "sha256": "9eeb671979a5ab132877b7a8a4724f62432cac92174e017bcc0cc65870c0388e"
+    }
+  ]
+}

package/contracts/jevitate-catalog/v2/fixtures/invalid/jobs-unknown-field.json

@@ -0,0 +1,12 @@
+[
+  {
+    "id": "review-work",
+    "trigger": "work is ready",
+    "motivation": "review it",
+    "outcome": "ship with confidence",
+    "personas": [
+      "owner"
+    ],
+    "typo": true
+  }
+]

package/contracts/jevitate-catalog/v2/fixtures/invalid/journey-unknown-field.json

@@ -0,0 +1,15 @@
+{
+  "metadata": {
+    "id": "review-work",
+    "name": "Review work",
+    "promoted": false,
+    "params": [],
+    "createdAtIso": "2026-10-24T00:00:00.000Z"
+  },
+  "recording": {
+    "version": "1.0.0",
+    "site": "http://localhost",
+    "pages": []
+  },
+  "typo": true
+}

package/contracts/jevitate-catalog/v2/fixtures/valid/jobs.json

@@ -0,0 +1,11 @@
+[
+  {
+    "id": "review-work",
+    "trigger": "work is ready",
+    "motivation": "review it",
+    "outcome": "ship with confidence",
+    "personas": [
+      "owner"
+    ]
+  }
+]

package/contracts/jevitate-catalog/v2/fixtures/valid/journey.json

@@ -0,0 +1,14 @@
+{
+  "metadata": {
+    "id": "review-work",
+    "name": "Review work",
+    "promoted": false,
+    "params": [],
+    "createdAtIso": "2026-10-24T00:00:00.000Z"
+  },
+  "recording": {
+    "version": "1.0.0",
+    "site": "http://localhost",
+    "pages": []
+  }
+}

package/contracts/jevitate-catalog/v2/fixtures/valid/personas.json

@@ -0,0 +1,7 @@
+[
+  {
+    "id": "owner",
+    "description": "Owns the product",
+    "role": "owner"
+  }
+]

package/contracts/jevitate-catalog/v2/manifest.json

@@ -0,0 +1,78 @@
+{
+  "kind": "jevitate.catalog-contract",
+  "version": "2.0.0",
+  "package": "@jevitate/cli",
+  "source": {
+    "repository": "https://github.com/matt-cochran/jevitate.git",
+    "commit": "58ef64ab8c1e628bc25b3dab973b23b5b69a4488",
+    "packageVersionAtCommit": "0.23.0"
+  },
+  "compatibility": {
+    "repositoryCatalogMajor": 1,
+    "approvalHash": "jevitate-content-hash-v2",
+    "readsApprovalHashes": [
+      "jevitate-content-hash-v2",
+      "jevitate-content-hash-v1"
+    ]
+  },
+  "exceptions": [
+    "personas.v1.legacy-descriptive-keys"
+  ],
+  "files": [
+    {
+      "path": "README.md",
+      "bytes": 1394,
+      "sha256": "91f185e0eb2b81daf94d4cb30709bc63c1aa2c989556a97c95d1cea878fc1055"
+    },
+    {
+      "path": "approval-hash-vectors.json",
+      "bytes": 2450,
+      "sha256": "eff8769d651e6c9c665498006d739918a1702a485209e6bede1315f83e6bf711"
+    },
+    {
+      "path": "fixtures/invalid/jobs-unknown-field.json",
+      "bytes": 195,
+      "sha256": "119291e1f011ff538623c1c238591d5ee333088a2a7d7d2dee5e403ecaecf8f1"
+    },
+    {
+      "path": "fixtures/invalid/journey-unknown-field.json",
+      "bytes": 274,
+      "sha256": "823c9b86784dfb6cedafa7690f745ad51693f8fbbde046f44dc408255032c4ae"
+    },
+    {
+      "path": "fixtures/valid/jobs.json",
+      "bytes": 177,
+      "sha256": "f041e58590631c0ea23ecc20fc8a03f606e606331afe6c664eb241341dd4b126"
+    },
+    {
+      "path": "fixtures/valid/journey.json",
+      "bytes": 258,
+      "sha256": "33a9c9a2fb1e839e4f2bf7155b9da71d7cdbace5029f7542f85e79cd65ee0197"
+    },
+    {
+      "path": "fixtures/valid/personas.json",
+      "bytes": 90,
+      "sha256": "396b6916bed042307ab890855ae2dee661e7a79303befb55e33d3c5698c7f9ff"
+    },
+    {
+      "path": "schemas/job.schema.json",
+      "bytes": 15411,
+      "sha256": "2f4608dc6b58494f9e52935b3f5c7037de7d3768cfb334ab5a1cc550861d5eeb"
+    },
+    {
+      "path": "schemas/jobs.schema.json",
+      "bytes": 555,
+      "sha256": "bcd91a8002c24de12c696c31628719e079ffcf821ca48db2b1013660abf509b0"
+    },
+    {
+      "path": "schemas/journey.schema.json",
+      "bytes": 362358,
+      "sha256": "521e0f150967b10e5cc4547cc1401238478b4e2fe04dfb8febaa8dba27ae7f04"
+    },
+    {
+      "path": "schemas/personas.schema.json",
+      "bytes": 5708,
+      "sha256": "74cb8dc071545458823fd164d444c33f161eee8c3fed85e5b3f8d05cd6430afb"
+    }
+  ]
+}