frontend-project-context 1.6.0 → 1.7.0

package/schemas/capabilities.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:capabilities:4",
+  "$id": "urn:frontend-project-context:schema:capabilities:7",
   "title": "Frontend Project Context Capabilities",
   "type": "object",
   "additionalProperties": false,
@@ -18,28 +18,32 @@
     "boundaries"
   ],
   "properties": {
-    "schemaVersion": { "const": 4 },
+    "schemaVersion": { "const": 7 },
     "package": {
       "type": "object",
       "additionalProperties": false,
       "required": ["name", "version"],
       "properties": {
         "name": { "const": "frontend-project-context" },
-        "version": { "const": "1.6.0" }
+        "version": { "const": "1.7.0" }
       }
     },
-    "exchangeProtocolVersion": { "const": 4 },
+    "exchangeProtocolVersion": { "const": 7 },
     "schemas": {
       "type": "object",
       "additionalProperties": false,
       "required": [
         "actionPlan",
+        "adaptiveContextBundle",
         "assistBundle",
         "capabilities",
         "contract",
+        "contextQuery",
+        "coverageAudit",
         "dashboardViewModel",
         "evidenceBundle",
         "evidenceInput",
+        "hostPromotionEvidence",
         "integrationReviewBundle",
         "projectionLock",
         "projectionLockReadable",
@@ -51,21 +55,28 @@
         "migrationManifest",
         "migrationPlan",
         "reviewBundle",
+        "routingIndex",
         "sourceLock",
         "stageContextBundle",
         "stageReceipt",
         "taskContextPlan",
+        "truthReconciliationInput",
+        "truthReconciliationReviewBundle",
         "upgradeAssessment",
         "upgradeResultBundle"
       ],
       "properties": {
         "actionPlan": { "const": 2 },
+        "adaptiveContextBundle": { "const": 2 },
         "assistBundle": { "const": 1 },
-        "capabilities": { "const": 4 },
+        "capabilities": { "const": 7 },
         "contract": { "const": 2 },
+        "contextQuery": { "const": 2 },
+        "coverageAudit": { "const": 1 },
         "dashboardViewModel": { "type": "integer" },
         "evidenceBundle": { "const": 1 },
         "evidenceInput": { "const": 1 },
+        "hostPromotionEvidence": { "const": 1 },
         "integrationReviewBundle": { "const": 1 },
         "projectionLock": { "const": 2 },
         "projectionLockReadable": { "const": [1, 2] },
@@ -73,14 +84,17 @@
         "projectionRenderer": { "type": "integer" },
         "proposal": { "const": 1 },
         "projectStatus": { "const": 1 },
-        "aiEntryRenderer": { "const": 1 },
+        "aiEntryRenderer": { "const": 3 },
         "migrationManifest": { "const": 2 },
         "migrationPlan": { "const": 1 },
         "reviewBundle": { "const": 2 },
+        "routingIndex": { "const": 2 },
         "sourceLock": { "const": 1 },
         "stageContextBundle": { "const": 1 },
         "stageReceipt": { "const": 1 },
         "taskContextPlan": { "const": 1 },
+        "truthReconciliationInput": { "const": 2 },
+        "truthReconciliationReviewBundle": { "const": 2 },
         "upgradeAssessment": { "const": 1 },
         "upgradeResultBundle": { "const": 1 }
       }

package/schemas/context-query.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:context-query:2",
+  "title": "Frontend Project Context Query",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "projectId", "snapshots", "task", "level", "freshness", "budget", "expansion"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "kind": { "const": "context-query" },
+    "projectId": { "$ref": "#/$defs/id" },
+    "snapshots": { "$ref": "#/$defs/snapshots" },
+    "task": {
+      "type": "object", "additionalProperties": false,
+      "required": ["text", "paths", "topics", "itemIds", "changedPaths"],
+      "properties": {
+        "text": { "type": "string", "minLength": 1 },
+        "paths": { "$ref": "#/$defs/nonEmptyPaths" },
+        "topics": { "$ref": "#/$defs/texts" },
+        "itemIds": { "$ref": "#/$defs/ids" },
+        "changedPaths": { "$ref": "#/$defs/paths" }
+      }
+    },
+    "level": { "enum": ["initial", "expanded", "complete"] },
+    "freshness": { "enum": ["snapshot-and-signal-bound", "strict-current"] },
+    "budget": {
+      "type": "object", "additionalProperties": false, "required": ["audit", "delivery", "readTargets"],
+      "properties": {
+        "audit": { "$ref": "#/$defs/auditBudget" },
+        "delivery": { "$ref": "#/$defs/deliveryBudget" },
+        "readTargets": { "$ref": "#/$defs/readBudget" }
+      }
+    },
+    "expansion": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["previousBundleDigest", "requestedItemIds", "requestedSubjects", "requestedSourceIds"],
+          "properties": {
+            "previousBundleDigest": { "$ref": "#/$defs/digest" },
+            "requestedItemIds": { "$ref": "#/$defs/ids" },
+            "requestedSubjects": { "$ref": "#/$defs/ids" },
+            "requestedSourceIds": { "$ref": "#/$defs/ids" }
+          }
+        }
+      ]
+    }
+  },
+  "allOf": [
+    { "if": { "properties": { "level": { "const": "expanded" } } }, "then": { "properties": { "expansion": { "type": "object" } } } },
+    { "if": { "properties": { "level": { "enum": ["initial", "complete"] } } }, "then": { "properties": { "expansion": { "type": "null" } } } }
+  ],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "nonEmptyPaths": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "texts": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "snapshots": {
+      "type": "object", "additionalProperties": false, "required": ["contract", "sourcesLock", "projectionsLock"],
+      "properties": { "contract": { "$ref": "#/$defs/digest" }, "sourcesLock": { "$ref": "#/$defs/digest" }, "projectionsLock": { "$ref": "#/$defs/digest" } }
+    },
+    "auditBudget": { "type": "object", "additionalProperties": false, "required": ["targetUtf8Bytes", "maxUtf8Bytes"], "properties": { "targetUtf8Bytes": { "type": "integer", "minimum": 1 }, "maxUtf8Bytes": { "type": "integer", "minimum": 1 } } },
+    "deliveryBudget": { "type": "object", "additionalProperties": false, "required": ["completeBelowUtf8Bytes", "maxUtf8Bytes"], "properties": { "completeBelowUtf8Bytes": { "type": "integer", "minimum": 1 }, "maxUtf8Bytes": { "type": "integer", "minimum": 1 } } },
+    "readBudget": { "type": "object", "additionalProperties": false, "required": ["target", "max"], "properties": { "target": { "type": "integer", "minimum": 1 }, "max": { "type": "integer", "minimum": 1 } } }
+  }
+}

package/schemas/coverage-audit.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:coverage-audit:1",
+  "title": "Frontend Project Context Coverage Audit",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "snapshots", "profile", "registrationCoverage", "categories", "guarantee", "auditDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "coverage-audit" },
+    "project": { "type": "object", "additionalProperties": false, "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } },
+    "snapshots": { "$ref": "context-query.schema.json#/$defs/snapshots" },
+    "profile": { "type": ["object", "null"] },
+    "registrationCoverage": { "enum": ["not-declared", "review-required", "closed-for-declared-scope"] },
+    "categories": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["registered", "excluded-approved", "review-required", "outside-declared-coverage"],
+      "properties": {
+        "registered": { "$ref": "#/$defs/candidates" },
+        "excluded-approved": { "$ref": "#/$defs/candidates" },
+        "review-required": { "$ref": "#/$defs/candidates" },
+        "outside-declared-coverage": { "$ref": "#/$defs/candidates" }
+      }
+    },
+    "guarantee": { "const": "declared-scope-only-never-all-project-truth" },
+    "auditDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  },
+  "$defs": {
+    "candidates": { "type": "array", "items": { "type": "object", "required": ["path", "origin"], "properties": { "path": { "type": "string" }, "origin": { "type": "string" }, "proposedSourceId": { "type": "string" } } } }
+  }
+}

package/schemas/evidence-bundle.schema.json

@@ -14,8 +14,8 @@
       "required": ["name", "version", "exchangeProtocolVersion"],
       "properties": {
         "name": { "const": "frontend-project-context" },
-        "version": { "const": "1.6.0" },
-        "exchangeProtocolVersion": { "const": 3 }
+        "version": { "const": "1.7.0" },
+        "exchangeProtocolVersion": { "const": 6 }
       }
     },
     "capability": { "enum": ["setup", "takeover", "maintenance", "staged-context", "upgrade", "other-protocol"] },

package/schemas/host-promotion-evidence.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:host-promotion-evidence:1",
+  "title": "Frontend Project Context Host Promotion Evidence",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "taskId", "stage", "baseRevision", "candidateRevision", "codeSnapshotDigest", "sourceSnapshotDigest", "artifactDigest", "changedPaths", "projectSnapshots", "acceptanceSuiteDigest", "verificationResults"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "host-promotion-evidence" },
+    "taskId": { "$ref": "#/$defs/id" },
+    "stage": { "enum": ["qa", "preproduction", "production", "withdrawn", "rollback"] },
+    "baseRevision": { "$ref": "#/$defs/text" },
+    "candidateRevision": { "$ref": "#/$defs/text" },
+    "codeSnapshotDigest": { "$ref": "#/$defs/digest" },
+    "sourceSnapshotDigest": { "$ref": "#/$defs/digest" },
+    "artifactDigest": { "$ref": "#/$defs/digest" },
+    "changedPaths": { "$ref": "#/$defs/paths" },
+    "projectSnapshots": { "$ref": "#/$defs/snapshots" },
+    "acceptanceSuiteDigest": { "$ref": "#/$defs/digest" },
+    "verificationResults": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/verification" } },
+    "integration": { "type": "boolean", "default": false },
+    "equivalentToCodeSnapshotDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "snapshots": { "type": "object", "additionalProperties": false, "required": ["contract", "sourcesLock", "projectionsLock"], "properties": { "contract": { "$ref": "#/$defs/digest" }, "sourcesLock": { "$ref": "#/$defs/digest" }, "projectionsLock": { "$ref": "#/$defs/digest" } } },
+    "verification": { "type": "object", "additionalProperties": false, "required": ["id", "status"], "properties": { "id": { "$ref": "#/$defs/id" }, "status": { "enum": ["passed", "failed", "skipped", "observed"] } } }
+  }
+}

package/schemas/migration-manifest.schema.json

@@ -7,12 +7,12 @@
   "required": ["schemaVersion", "package", "upgradeFrom", "stores", "renderers", "protocols", "paths", "builtInMigrations", "consumerChanges", "acceptanceCommands", "rollback", "externalEffects", "manifestDigest"],
   "properties": {
     "schemaVersion": {"const": 2},
-    "package": {"type": "object", "additionalProperties": false, "required": ["name", "version"], "properties": {"name": {"const": "frontend-project-context"}, "version": {"const": "1.6.0"}}},
-    "upgradeFrom": {"const": ["1.3.1", "1.4.0", "1.5.0"]},
+    "package": {"type": "object", "additionalProperties": false, "required": ["name", "version"], "properties": {"name": {"const": "frontend-project-context"}, "version": {"const": "1.7.0"}}},
+    "upgradeFrom": {"const": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]},
     "stores": {"type": "object", "additionalProperties": false, "required": ["contract", "projectionLock", "proposal", "sourceLock"], "properties": {"contract": {"$ref": "#/$defs/versionMatrix"}, "projectionLock": {"$ref": "#/$defs/versionMatrix"}, "proposal": {"$ref": "#/$defs/versionMatrix"}, "sourceLock": {"$ref": "#/$defs/versionMatrix"}}},
     "renderers": {"type": "object", "additionalProperties": false, "required": ["aiEntry", "projection"], "properties": {"aiEntry": {"$ref": "#/$defs/versionTarget"}, "projection": {"$ref": "#/$defs/versionTarget"}}},
     "protocols": {"type": "object", "additionalProperties": {"$ref": "#/$defs/versionTarget"}},
-    "paths": {"type": "array", "minItems": 3, "maxItems": 3, "items": {"type": "object", "additionalProperties": false, "required": ["fromVersion", "classification", "migrationIds", "requiresHumanReview", "rollbackClass", "acceptance"], "properties": {"fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0"]}, "classification": {"enum": ["package-only", "republish-ai-entry", "republish-projection", "built-in-store-migration", "invalidate-ephemeral-protocol"]}, "migrationIds": {"$ref": "#/$defs/strings"}, "requiresHumanReview": {"type": "boolean"}, "rollbackClass": {"$ref": "#/$defs/rollbackClass"}, "acceptance": {"$ref": "#/$defs/strings"}}}},
+    "paths": {"type": "array", "minItems": 4, "maxItems": 4, "items": {"type": "object", "additionalProperties": false, "required": ["fromVersion", "classification", "migrationIds", "requiresHumanReview", "rollbackClass", "acceptance"], "properties": {"fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]}, "classification": {"enum": ["package-only", "republish-ai-entry", "republish-projection", "built-in-store-migration", "invalidate-ephemeral-protocol"]}, "migrationIds": {"$ref": "#/$defs/strings"}, "requiresHumanReview": {"type": "boolean"}, "rollbackClass": {"$ref": "#/$defs/rollbackClass"}, "acceptance": {"$ref": "#/$defs/strings"}}}},
     "builtInMigrations": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["id", "kind", "input", "targetType", "writes", "rollbackClass", "reverseMigrationId"], "properties": {"id": {"type": "string"}, "kind": {"enum": ["package-only", "republish-ai-entry", "republish-projection", "built-in-store-migration", "invalidate-ephemeral-protocol"]}, "input": {"type": "object", "additionalProperties": false, "required": ["schemaVersions", "beforeDigestRequired"], "properties": {"schemaVersions": {"type": "array", "items": {"type": "integer", "minimum": 1}}, "beforeDigestRequired": {"type": "boolean"}}}, "targetType": {"enum": ["none", "ai-entry", "projection", "store", "ephemeral-protocol"]}, "writes": {"type": "boolean"}, "rollbackClass": {"$ref": "#/$defs/rollbackClass"}, "reverseMigrationId": {"type": ["string", "null"]}}}},
     "consumerChanges": {"type": "object", "additionalProperties": {"type": "object", "additionalProperties": false, "required": ["state", "reason"], "properties": {"state": {"enum": ["preserve", "regenerate", "invalidate"]}, "reason": {"type": "string"}}}},
     "acceptanceCommands": {"$ref": "#/$defs/strings"},

package/schemas/migration-plan.schema.json

@@ -8,8 +8,8 @@
   "properties": {
     "schemaVersion": {"const": 1},
     "kind": {"const": "target-upgrade-plan"},
-    "fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0"]},
-    "targetVersion": {"const": "1.6.0"},
+    "fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]},
+    "targetVersion": {"const": "1.7.0"},
     "manifestDigest": {"$ref": "#/$defs/digest"},
     "assessmentDigest": {"$ref": "#/$defs/digest"},
     "snapshots": {"anyOf": [{"type": "null"}, {"$ref": "#/$defs/snapshots"}]},

package/schemas/projection-lock.schema.json

@@ -33,7 +33,7 @@
       "properties": {
         "path": { "type": "string" }, "target": { "const": "ai-entry" }, "ownership": { "const": "region" },
         "regionId": { "const": "project-context-ai-entry" }, "regionDigest": { "$ref": "#/$defs/digest" },
-        "rendererVersion": { "const": 1 }, "createdFile": { "type": "boolean" }
+        "rendererVersion": { "enum": [1, 2, 3] }, "createdFile": { "type": "boolean" }
       }
     },
     "schema1": {

package/schemas/routing-index.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:routing-index:2",
+  "title": "Frontend Project Context Routing Index",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "projectId", "selectorVersion", "snapshots", "items", "sources", "indexDigest"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "kind": { "const": "routing-index" },
+    "projectId": { "type": "string" },
+    "selectorVersion": { "const": 2 },
+    "snapshots": { "$ref": "context-query.schema.json#/$defs/snapshots" },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "subject", "scope", "sourceIds", "terms", "itemDigest"],
+        "properties": {
+          "id": { "type": "string" },
+          "kind": { "enum": ["fact", "policy", "reference", "validation-description"] },
+          "subject": { "type": "string" },
+          "scope": { "$ref": "#/$defs/scope" },
+          "sourceIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+          "terms": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+          "itemDigest": { "type": "string" }
+        }
+      }
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "locator", "itemIds", "sourceDigest"],
+        "properties": {
+          "id": { "type": "string" },
+          "kind": { "type": "string" },
+          "locator": { "$ref": "#/$defs/locator" },
+          "itemIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+          "sourceDigest": { "type": "string" }
+        }
+      }
+    },
+    "indexDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  },
+  "$defs": {
+    "scope": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "project" } } },
+      { "type": "object", "additionalProperties": false, "required": ["kind", "path"], "properties": { "kind": { "enum": ["path-prefix", "file"] }, "path": { "type": "string", "minLength": 1 } } }
+    ] },
+    "locator": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["path"], "properties": { "path": { "type": "string", "minLength": 1 }, "pointer": { "type": "string" } } },
+      { "type": "object", "additionalProperties": false, "required": ["reference"], "properties": { "reference": { "type": "string", "minLength": 1 } } }
+    ] }
+  }
+}

package/schemas/truth-reconciliation-input.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:truth-reconciliation-input:2",
+  "title": "Frontend Project Context Truth Reconciliation Input",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "projectId", "current", "task", "candidates", "globalFindings", "resolutionAttempt"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "kind": { "const": "truth-reconciliation-input" },
+    "projectId": { "$ref": "#/$defs/id" },
+    "current": { "$ref": "#/$defs/current" },
+    "task": { "$ref": "#/$defs/task" },
+    "candidates": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/candidate" } },
+    "globalFindings": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/globalFinding" } },
+    "resolutionAttempt": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/resolutionAttempt" }] }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "snapshots": { "type": "object", "additionalProperties": false, "required": ["contract", "sourcesLock", "projectionsLock"], "properties": { "contract": { "$ref": "#/$defs/digest" }, "sourcesLock": { "$ref": "#/$defs/digest" }, "projectionsLock": { "$ref": "#/$defs/digest" } } },
+    "scope": {
+      "oneOf": [
+        { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "project" } } },
+        { "type": "object", "additionalProperties": false, "required": ["kind", "path"], "properties": { "kind": { "enum": ["path-prefix", "file"] }, "path": { "type": "string", "minLength": 1 } } }
+      ]
+    },
+    "scopes": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/scope" } },
+    "itemKind": { "enum": ["fact", "policy", "reference", "validation-description"] },
+    "classification": { "enum": ["duplicate", "compatible-compose", "scope-split", "supersede", "semantic-conflict", "implementation-only"] },
+    "current": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["revision", "projectSnapshots", "sources", "items"],
+      "properties": {
+        "revision": { "$ref": "#/$defs/text" },
+        "projectSnapshots": { "$ref": "#/$defs/snapshots" },
+        "sources": {
+          "type": "array", "uniqueItems": true,
+          "items": { "type": "object", "additionalProperties": false, "required": ["id", "digest"], "properties": { "id": { "$ref": "#/$defs/id" }, "digest": { "$ref": "#/$defs/digest" } } }
+        },
+        "items": {
+          "type": "array", "uniqueItems": true,
+          "items": { "type": "object", "additionalProperties": false, "required": ["id", "digest", "subject", "kind", "scope"], "properties": { "id": { "$ref": "#/$defs/id" }, "digest": { "$ref": "#/$defs/digest" }, "subject": { "$ref": "#/$defs/id" }, "kind": { "$ref": "#/$defs/itemKind" }, "scope": { "$ref": "#/$defs/scope" } } }
+        }
+      }
+    },
+    "task": { "type": "object", "additionalProperties": false, "required": ["id", "paths"], "properties": { "id": { "$ref": "#/$defs/id" }, "paths": { "$ref": "#/$defs/paths" } } },
+    "sourceChange": { "type": "object", "additionalProperties": false, "required": ["sourceId", "expectedDigest", "candidateDigest", "affectedItemIds", "subjects", "scopes", "classification"], "properties": { "sourceId": { "$ref": "#/$defs/id" }, "expectedDigest": { "$ref": "#/$defs/digest" }, "candidateDigest": { "$ref": "#/$defs/digest" }, "affectedItemIds": { "$ref": "#/$defs/ids" }, "subjects": { "$ref": "#/$defs/ids" }, "scopes": { "$ref": "#/$defs/scopes" }, "classification": { "$ref": "#/$defs/classification" } } },
+    "itemChange": { "type": "object", "additionalProperties": false, "required": ["itemId", "expectedDigest", "candidateDigest", "sourceIds", "subject", "kind", "scope", "classification"], "properties": { "itemId": { "$ref": "#/$defs/id" }, "expectedDigest": { "$ref": "#/$defs/digest" }, "candidateDigest": { "$ref": "#/$defs/digest" }, "sourceIds": { "$ref": "#/$defs/ids" }, "subject": { "$ref": "#/$defs/id" }, "kind": { "$ref": "#/$defs/itemKind" }, "scope": { "$ref": "#/$defs/scope" }, "classification": { "$ref": "#/$defs/classification" } } },
+    "candidate": { "type": "object", "additionalProperties": false, "required": ["id", "taskId", "lifecycle", "targetStage", "baseRevision", "expectedProjectSnapshots", "currentCodeSnapshotDigest", "currentSourceSnapshotDigest", "currentArtifactDigest", "currentAcceptanceSuiteDigest", "changedPaths", "sourceChanges", "itemChanges", "decisionCandidateIds", "promotionEvidence"], "properties": { "id": { "$ref": "#/$defs/id" }, "taskId": { "$ref": "#/$defs/id" }, "lifecycle": { "enum": ["active", "released", "withdrawn", "rolled-back"] }, "targetStage": { "enum": ["development", "qa", "preproduction", "production"] }, "baseRevision": { "$ref": "#/$defs/text" }, "expectedProjectSnapshots": { "$ref": "#/$defs/snapshots" }, "currentCodeSnapshotDigest": { "$ref": "#/$defs/digest" }, "currentSourceSnapshotDigest": { "$ref": "#/$defs/digest" }, "currentArtifactDigest": { "$ref": "#/$defs/digest" }, "currentAcceptanceSuiteDigest": { "$ref": "#/$defs/digest" }, "changedPaths": { "$ref": "#/$defs/paths" }, "sourceChanges": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/sourceChange" } }, "itemChanges": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/itemChange" } }, "decisionCandidateIds": { "$ref": "#/$defs/ids" }, "promotionEvidence": { "type": "array", "uniqueItems": true, "items": { "$ref": "host-promotion-evidence.schema.json" } } } },
+    "globalFinding": { "type": "object", "additionalProperties": false, "required": ["code", "severity", "sourceIds", "itemIds", "subjects", "scopes", "itemKinds"], "properties": { "code": { "$ref": "#/$defs/id" }, "severity": { "enum": ["attention", "conflict", "blocked"] }, "sourceIds": { "$ref": "#/$defs/ids" }, "itemIds": { "$ref": "#/$defs/ids" }, "subjects": { "$ref": "#/$defs/ids" }, "scopes": { "$ref": "#/$defs/scopes" }, "itemKinds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/itemKind" } } } },
+    "resolutionKind": { "enum": ["keep-current-baseline", "accept-branch-change", "compose-compatible-changes", "split-scope-or-override", "replace-or-deprecate-source", "fix-source-and-rerun", "refresh-promotion-evidence", "defer-scoped-conflict", "external-implementation-fix-required"] },
+    "resolutionDecision": { "type": "object", "additionalProperties": false, "required": ["findingDigest", "resolutionKind", "humanInputs"], "properties": { "findingDigest": { "$ref": "#/$defs/digest" }, "resolutionKind": { "$ref": "#/$defs/resolutionKind" }, "humanInputs": { "type": "object" }, "externalAction": { "type": "object", "additionalProperties": false, "required": ["kind", "completed", "evidenceDigests"], "properties": { "kind": { "$ref": "#/$defs/text" }, "completed": { "type": "boolean" }, "evidenceDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/digest" } } } } } },
+    "resolutionAttempt": { "type": "object", "additionalProperties": false, "required": ["previousReviewDigest", "decisions", "projectContextStatus"], "properties": { "previousReviewDigest": { "$ref": "#/$defs/digest" }, "decisions": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/resolutionDecision" } }, "projectContextStatus": { "enum": ["clean", "attention", "conflict", "invalid", "partial"] } } }
+  }
+}

package/schemas/truth-reconciliation-review-bundle.schema.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:truth-reconciliation-review-bundle:2",
+  "title": "Frontend Project Context Truth Reconciliation Review Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "current", "task", "inputDigest", "summary", "candidateOutcomes", "collisionGroups", "findings", "resolutionOutcomes", "guarantees", "boundaries", "bundleDigest"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "kind": { "const": "truth-reconciliation-review-bundle" },
+    "project": { "$ref": "#/$defs/project" },
+    "current": { "$ref": "#/$defs/current" },
+    "task": { "$ref": "#/$defs/task" },
+    "inputDigest": { "$ref": "#/$defs/digest" },
+    "summary": { "$ref": "#/$defs/summary" },
+    "candidateOutcomes": { "type": "array", "items": { "$ref": "#/$defs/candidateOutcome" } },
+    "collisionGroups": { "type": "array", "items": { "$ref": "#/$defs/collisionGroup" } },
+    "findings": { "type": "array", "items": { "$ref": "#/$defs/finding" } },
+    "resolutionOutcomes": { "type": "array", "items": { "$ref": "#/$defs/resolutionOutcome" } },
+    "guarantees": { "$ref": "#/$defs/guarantees" },
+    "boundaries": { "$ref": "#/$defs/boundaries" },
+    "bundleDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "nullableDigest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+    "nullableText": { "oneOf": [{ "$ref": "#/$defs/text" }, { "type": "null" }] },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "scope": {
+      "oneOf": [
+        { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "project" } } },
+        { "type": "object", "additionalProperties": false, "required": ["kind", "path"], "properties": { "kind": { "enum": ["path-prefix", "file"] }, "path": { "type": "string", "minLength": 1 } } }
+      ]
+    },
+    "scopes": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/scope" } },
+    "snapshots": {
+      "type": "object", "additionalProperties": false,
+      "required": ["contract", "sourcesLock", "projectionsLock"],
+      "properties": { "contract": { "$ref": "#/$defs/digest" }, "sourcesLock": { "$ref": "#/$defs/digest" }, "projectionsLock": { "$ref": "#/$defs/digest" } }
+    },
+    "project": {
+      "type": "object", "additionalProperties": false, "required": ["id", "name"],
+      "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "$ref": "#/$defs/text" } }
+    },
+    "current": {
+      "type": "object", "additionalProperties": false, "required": ["revision", "projectSnapshots"],
+      "properties": { "revision": { "$ref": "#/$defs/text" }, "projectSnapshots": { "$ref": "#/$defs/snapshots" } }
+    },
+    "task": {
+      "type": "object", "additionalProperties": false, "required": ["id", "paths"],
+      "properties": { "id": { "$ref": "#/$defs/id" }, "paths": { "$ref": "#/$defs/paths" } }
+    },
+    "summary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["candidates", "eligibleCandidates", "collisionGroups", "findings", "taskHealth", "globalHealth", "existingDelivery"],
+      "properties": {
+        "candidates": { "type": "integer", "minimum": 0 },
+        "eligibleCandidates": { "type": "integer", "minimum": 0 },
+        "collisionGroups": { "type": "integer", "minimum": 0 },
+        "findings": { "type": "integer", "minimum": 0 },
+        "taskHealth": { "enum": ["ready", "blocked"] },
+        "globalHealth": { "enum": ["clean", "attention"] },
+        "existingDelivery": { "const": "not-blocked" }
+      }
+    },
+    "promotionEvidence": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assurance", "currentEvidenceCount", "staleEvidenceCount", "localQaReusable", "integrationVerified"],
+      "properties": {
+        "assurance": { "const": "host-asserted" },
+        "currentEvidenceCount": { "type": "integer", "minimum": 0 },
+        "staleEvidenceCount": { "type": "integer", "minimum": 0 },
+        "localQaReusable": { "type": "boolean" },
+        "integrationVerified": { "type": "boolean" }
+      }
+    },
+    "candidateOutcome": {
+      "type": "object", "additionalProperties": false,
+      "required": ["candidateId", "lifecycle", "baseline", "promotionEvidence", "decisionCandidates", "eligibleForReconciliation"],
+      "properties": {
+        "candidateId": { "$ref": "#/$defs/id" },
+        "lifecycle": { "enum": ["active", "released", "withdrawn", "rolled-back"] },
+        "baseline": { "enum": ["current", "stale"] },
+        "promotionEvidence": { "$ref": "#/$defs/promotionEvidence" },
+        "decisionCandidates": { "enum": ["authority-free-candidates", "discarded-not-promoted"] },
+        "eligibleForReconciliation": { "type": "boolean" }
+      }
+    },
+    "resolutionKind": { "enum": ["keep-current-baseline", "accept-branch-change", "compose-compatible-changes", "split-scope-or-override", "replace-or-deprecate-source", "fix-source-and-rerun", "refresh-promotion-evidence", "defer-scoped-conflict", "external-implementation-fix-required"] },
+    "collisionGroup": {
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "key", "classification", "candidateIds", "candidateDigests", "affectedSourceIds", "affectedItemIds", "affectedSubjects", "affectedScopes", "resolutionKinds", "promoted"],
+      "properties": {
+        "kind": { "enum": ["source", "item", "subject"] },
+        "key": { "$ref": "#/$defs/id" },
+        "classification": { "enum": ["duplicate", "compatible-compose", "scope-split", "supersede", "semantic-conflict", "implementation-only"] },
+        "candidateIds": { "$ref": "#/$defs/ids" },
+        "candidateDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/digest" } },
+        "affectedSourceIds": { "$ref": "#/$defs/ids" },
+        "affectedItemIds": { "$ref": "#/$defs/ids" },
+        "affectedSubjects": { "$ref": "#/$defs/ids" },
+        "affectedScopes": { "$ref": "#/$defs/scopes" },
+        "resolutionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/resolutionKind" } },
+        "promoted": { "const": false }
+      }
+    },
+    "baseline": {
+      "type": "object", "additionalProperties": false,
+      "required": ["expectedDigest", "actualDigest", "expectedLabel", "actualLabel"],
+      "properties": { "expectedDigest": { "$ref": "#/$defs/nullableDigest" }, "actualDigest": { "$ref": "#/$defs/nullableDigest" }, "expectedLabel": { "$ref": "#/$defs/nullableText" }, "actualLabel": { "$ref": "#/$defs/nullableText" } }
+    },
+    "invocation": {
+      "type": "object", "additionalProperties": false, "required": ["command", "args"],
+      "properties": { "command": { "$ref": "#/$defs/id" }, "args": { "type": "array", "items": { "type": "string" } } }
+    },
+    "externalAction": { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "type": "string" }, "affectedSourceIds": { "$ref": "#/$defs/ids" }, "affectedItemIds": { "$ref": "#/$defs/ids" }, "affectedPaths": { "$ref": "#/$defs/paths" } } },
+    "recoveryPreview": { "type": "object", "additionalProperties": false, "required": ["resolutionKind"], "properties": { "resolutionKind": { "$ref": "#/$defs/resolutionKind" }, "invocation": { "$ref": "#/$defs/invocation" }, "externalAction": { "$ref": "#/$defs/externalAction" }, "requiredHumanInputs": { "type": "array", "items": { "type": "string" } } } },
+    "resolutionContract": { "type": "object", "additionalProperties": false, "required": ["resolutionState", "resolutionKinds", "requiredHumanInputs", "nextActions", "requiredPostResolutionEvidence", "completionCriteria", "recomputeFromCurrentBaseline"], "properties": { "resolutionState": { "enum": ["needs-human-decision", "contract-action-required", "external-fix-required", "revalidation-required", "resolved", "deferred-open"] }, "resolutionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/resolutionKind" } }, "requiredHumanInputs": { "type": "array", "uniqueItems": true, "items": { "type": "string" } }, "nextActions": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/recoveryPreview" } }, "requiredPostResolutionEvidence": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }, "completionCriteria": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }, "recomputeFromCurrentBaseline": { "const": true } } },
+    "finding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["code", "severity", "affectedSourceIds", "affectedItemIds", "affectedSubjects", "affectedScopes", "baseline", "blocksTask", "blocksExistingDelivery", "resolutionKinds", "recoveryPreviews", "humanRoles", "validateAfterResolution", "recomputeFromCurrentBaseline", "findingDigest", "resolutionContract"],
+      "properties": {
+        "code": { "$ref": "#/$defs/id" },
+        "severity": { "enum": ["attention", "conflict", "blocked"] },
+        "affectedSourceIds": { "$ref": "#/$defs/ids" },
+        "affectedItemIds": { "$ref": "#/$defs/ids" },
+        "affectedSubjects": { "$ref": "#/$defs/ids" },
+        "affectedScopes": { "$ref": "#/$defs/scopes" },
+        "baseline": { "$ref": "#/$defs/baseline" },
+        "blocksTask": { "type": "boolean" },
+        "blocksExistingDelivery": { "const": false },
+        "resolutionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/resolutionKind" } },
+        "recoveryPreviews": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/recoveryPreview" } },
+        "humanRoles": { "$ref": "#/$defs/ids" },
+        "validateAfterResolution": { "$ref": "#/$defs/ids" },
+        "recomputeFromCurrentBaseline": { "const": true },
+        "findingDigest": { "$ref": "#/$defs/digest" },
+        "resolutionContract": { "$ref": "#/$defs/resolutionContract" }
+      }
+    },
+    "resolutionOutcome": { "type": "object", "additionalProperties": false, "required": ["findingDigest", "resolutionKind", "resolutionState", "outcome", "completionCriteriaMet", "recomputedFromCurrentBaseline"], "properties": { "findingDigest": { "$ref": "#/$defs/digest" }, "resolutionKind": { "$ref": "#/$defs/resolutionKind" }, "resolutionState": { "enum": ["revalidation-required", "external-fix-required", "resolved", "deferred-open"] }, "outcome": { "enum": ["open", "deferred", "resolved", "rejected"] }, "completionCriteriaMet": { "type": "array", "uniqueItems": true, "items": { "type": "string" } }, "recomputedFromCurrentBaseline": { "const": true } } },
+    "guarantees": {
+      "type": "object", "additionalProperties": false, "required": ["projectContextVerified", "hostAsserted", "humanDecided"],
+      "properties": { "projectContextVerified": { "$ref": "#/$defs/ids" }, "hostAsserted": { "$ref": "#/$defs/ids" }, "humanDecided": { "$ref": "#/$defs/ids" } }
+    },
+    "boundaries": {
+      "type": "object", "additionalProperties": false,
+      "required": ["readOnly", "git", "ciClient", "network", "provider", "taskExecution", "automaticApproval", "automaticPromotion", "persistentQueue", "blocksExistingDelivery"],
+      "properties": { "readOnly": { "const": true }, "git": { "const": false }, "ciClient": { "const": false }, "network": { "const": false }, "provider": { "const": false }, "taskExecution": { "const": false }, "automaticApproval": { "const": false }, "automaticPromotion": { "const": false }, "persistentQueue": { "const": false }, "blocksExistingDelivery": { "const": false } }
+    }
+  }
+}

package/schemas/upgrade-assessment.schema.json

@@ -9,8 +9,8 @@
     "schemaVersion": {"const": 1},
     "kind": {"const": "upgrade-assessment"},
     "product": {"type": "object", "additionalProperties": false, "required": ["name"], "properties": {"name": {"const": "frontend-project-context"}}},
-    "fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0"]},
-    "targetVersion": {"const": "1.6.0"},
+    "fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]},
+    "targetVersion": {"const": "1.7.0"},
     "fromVersionEvidence": {"const": "host-asserted"},
     "manifestSchemaVersion": {"const": 2},
     "manifestDigest": {"$ref": "#/$defs/digest"},