frontend-project-context 1.3.1 → 1.7.0

package/schemas/evidence-bundle.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:evidence-bundle:1",
+  "title": "Frontend Project Context Evidence Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "product", "capability", "result", "environment", "expected", "observed", "errorCodes", "reproduction", "artifacts", "redactions", "projectContext", "transfer", "boundaries", "bundleDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "target-project-evidence" },
+    "product": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version", "exchangeProtocolVersion"],
+      "properties": {
+        "name": { "const": "frontend-project-context" },
+        "version": { "const": "1.7.0" },
+        "exchangeProtocolVersion": { "const": 6 }
+      }
+    },
+    "capability": { "enum": ["setup", "takeover", "maintenance", "staged-context", "upgrade", "other-protocol"] },
+    "result": { "$ref": "evidence-input.schema.json#/$defs/result" },
+    "environment": { "$ref": "evidence-input.schema.json#/properties/environment" },
+    "expected": { "$ref": "evidence-input.schema.json#/$defs/observation" },
+    "observed": { "$ref": "evidence-input.schema.json#/$defs/observation" },
+    "errorCodes": { "$ref": "evidence-input.schema.json#/$defs/codes" },
+    "reproduction": { "$ref": "evidence-input.schema.json#/properties/reproduction" },
+    "artifacts": { "$ref": "evidence-input.schema.json#/properties/artifacts" },
+    "redactions": { "$ref": "evidence-input.schema.json#/properties/redactions" },
+    "projectContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["initialization", "health", "entryState", "findingCodes", "schemas"],
+      "properties": {
+        "initialization": { "enum": ["uninitialized", "partial", "invalid", "initialized"] },
+        "health": { "enum": ["uninitialized", "partial", "invalid", "attention", "clean", "conflict"] },
+        "entryState": { "enum": ["absent", "current", "stale", "conflict"] },
+        "findingCodes": { "$ref": "evidence-input.schema.json#/$defs/codes" },
+        "schemas": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["contract", "sourcesLock", "projectionsLock"],
+          "properties": {
+            "contract": { "const": 2 },
+            "sourcesLock": { "const": 1 },
+            "projectionsLock": { "const": 2 }
+          }
+        }
+      }
+    },
+    "transfer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "automaticUpload", "destination"],
+      "properties": {
+        "state": { "const": "human-review-required" },
+        "automaticUpload": { "const": false },
+        "destination": { "type": "null" }
+      }
+    },
+    "boundaries": { "$ref": "capabilities.schema.json#/properties/boundaries" },
+    "bundleDigest": { "$ref": "evidence-input.schema.json#/$defs/digest" }
+  }
+}

package/schemas/evidence-input.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:evidence-input:1",
+  "title": "Frontend Project Context Evidence Input",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "capability", "result", "environment", "expected", "observed", "errorCodes", "reproduction", "artifacts", "redactions"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "capability": { "enum": ["setup", "takeover", "maintenance", "staged-context", "upgrade", "other-protocol"] },
+    "result": { "$ref": "#/$defs/result" },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runtime", "runtimeMajor", "packageManager", "projectShape"],
+      "properties": {
+        "runtime": { "enum": ["node", "other", "redacted"] },
+        "runtimeMajor": { "type": "integer", "minimum": 0, "maximum": 999 },
+        "packageManager": { "enum": ["npm", "pnpm", "yarn", "bun", "other", "redacted"] },
+        "projectShape": { "enum": ["single", "monorepo", "multi-context", "redacted"] }
+      }
+    },
+    "expected": { "$ref": "#/$defs/observation" },
+    "observed": { "$ref": "#/$defs/observation" },
+    "errorCodes": { "$ref": "#/$defs/codes" },
+    "reproduction": {
+      "type": "array",
+      "maxItems": 20,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["operation", "outcome", "findingCodes"],
+        "properties": {
+          "operation": { "enum": ["capabilities", "status", "setup-preview", "sync", "check", "context", "preflight", "stage-context", "integration-review", "publish-entry-preview", "remove-entry-preview", "upgrade-baseline", "other-protocol"] },
+          "outcome": { "$ref": "#/$defs/result" },
+          "findingCodes": { "$ref": "#/$defs/codes" }
+        }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "maxItems": 32,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "digest"],
+        "properties": {
+          "kind": { "$ref": "#/$defs/id" },
+          "digest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    },
+    "redactions": {
+      "type": "array",
+      "maxItems": 32,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["field", "method"],
+        "properties": {
+          "field": { "type": "string", "pattern": "^[a-z][A-Za-z0-9]*(\\.[a-z][A-Za-z0-9]*)*$" },
+          "method": { "enum": ["removed", "generalized", "hashed", "redacted", "not-collected"] }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+([.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "result": { "enum": ["passed", "degraded", "blocked", "failed"] },
+    "codes": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/id" } },
+    "observation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "summary"],
+      "properties": {
+        "code": { "$ref": "#/$defs/id" },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "^[^\\r\\n\\u2028\\u2029]+$" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:migration-manifest:2",
+  "title": "Frontend Project Context Migration Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "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.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": 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"},
+    "rollback": {"type": "object", "additionalProperties": false, "required": ["defaultClass", "externalRestoreRequired", "automatic"], "properties": {"defaultClass": {"$ref": "#/$defs/rollbackClass"}, "externalRestoreRequired": {"type": "boolean"}, "automatic": {"const": false}}},
+    "externalEffects": {"type": "object", "additionalProperties": false, "required": ["packageManager", "network", "git", "projectTests", "businessCode", "automaticUpgrade"], "properties": {"packageManager": {"const": false}, "network": {"const": false}, "git": {"const": false}, "projectTests": {"const": false}, "businessCode": {"const": false}, "automaticUpgrade": {"const": false}}},
+    "manifestDigest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}
+  },
+  "$defs": {
+    "strings": {"type": "array", "uniqueItems": true, "items": {"type": "string"}},
+    "rollbackClass": {"enum": ["package-only", "reversible-data", "forward-only"]},
+    "versionMatrix": {"type": "object", "additionalProperties": false, "required": ["readable", "written"], "properties": {"readable": {"type": "array", "uniqueItems": true, "items": {"type": "integer", "minimum": 1}}, "written": {"type": "array", "uniqueItems": true, "items": {"type": "integer", "minimum": 1}}}},
+    "versionTarget": {"type": "object", "additionalProperties": false, "required": ["readable", "written"], "properties": {"readable": {"type": "array", "uniqueItems": true, "items": {"type": "integer", "minimum": 1}}, "written": {"type": "integer", "minimum": 1}}}
+  }
+}

package/schemas/migration-plan.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:migration-plan:1",
+  "title": "Frontend Project Context Migration Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "fromVersion", "targetVersion", "manifestDigest", "assessmentDigest", "snapshots", "targetDigests", "nextAction", "remainingMigrationIds", "acceptance", "rollback", "requiresHumanReview", "authority", "planDigest"],
+  "properties": {
+    "schemaVersion": {"const": 1},
+    "kind": {"const": "target-upgrade-plan"},
+    "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"}]},
+    "targetDigests": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "beforeDigest"], "properties": {"path": {"$ref": "#/$defs/path"}, "beforeDigest": {"anyOf": [{"type": "null"}, {"$ref": "#/$defs/digest"}]}}}},
+    "nextAction": {"$ref": "#/$defs/action"},
+    "remainingMigrationIds": {"$ref": "#/$defs/strings"},
+    "acceptance": {"type": "object", "additionalProperties": false, "required": ["core", "hostRequired"], "properties": {"core": {"$ref": "#/$defs/strings"}, "hostRequired": {"$ref": "#/$defs/strings"}}},
+    "rollback": {"type": "object", "additionalProperties": false, "required": ["class", "reverseMigrationId", "externalRestoreRequired"], "properties": {"class": {"enum": ["package-only", "reversible-data", "forward-only"]}, "reverseMigrationId": {"type": ["string", "null"]}, "externalRestoreRequired": {"type": "boolean"}}},
+    "requiresHumanReview": {"type": "boolean"},
+    "authority": {"const": "human-explicit-write-required"},
+    "planDigest": {"$ref": "#/$defs/digest"}
+  },
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "strings": {"type": "array", "uniqueItems": true, "items": {"type": "string"}},
+    "snapshots": {"type": "object", "additionalProperties": false, "required": ["contract", "sourcesLock", "projectionsLock"], "properties": {"contract": {"$ref": "#/$defs/digest"}, "sourcesLock": {"$ref": "#/$defs/digest"}, "projectionsLock": {"$ref": "#/$defs/digest"}}},
+    "path": {"type": "string", "minLength": 1, "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\).+$"},
+    "action": {"type": "object", "additionalProperties": false, "required": ["id", "kind", "migrationId", "targets", "writes", "semanticImpact"], "properties": {"id": {"type": "string"}, "kind": {"enum": ["verify-complete", "republish-ai-entry", "republish-projection", "built-in-store-migration", "invalidate-ephemeral-protocol"]}, "migrationId": {"type": ["string", "null"]}, "targets": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/path"}}, "writes": {"type": "boolean"}, "semanticImpact": {"enum": ["none", "managed-rendering", "store-structure", "protocol-artifact-invalidation"]}}}
+  }
+}

package/schemas/project-status.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:project-status:1",
+  "title": "Frontend Project Context Project Status",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "package", "initialization", "project", "snapshots", "health", "entry", "summary", "findingCodes", "sourceIds", "itemIds", "projectionPaths", "readTargets", "workUnits", "nextActions", "boundaries"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "package": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": { "name": { "const": "frontend-project-context" }, "version": { "type": "string" } }
+    },
+    "initialization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "present", "missing"],
+      "properties": {
+        "state": { "enum": ["uninitialized", "partial", "invalid", "initialized"] },
+        "present": { "$ref": "#/$defs/strings" },
+        "missing": { "$ref": "#/$defs/strings" }
+      }
+    },
+    "project": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/project" }] },
+    "snapshots": { "anyOf": [{ "type": "null" }, { "$ref": "#/$defs/snapshots" }] },
+    "health": { "enum": ["uninitialized", "partial", "invalid", "attention", "clean", "conflict"] },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "path", "rendererVersion"],
+      "properties": {
+        "state": { "enum": ["absent", "current", "stale", "conflict"] },
+        "path": { "type": ["string", "null"] },
+        "rendererVersion": { "type": ["integer", "null"] }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["findings", "changedSources", "pendingItems", "affectedProjections"],
+      "properties": {
+        "findings": { "type": "integer", "minimum": 0 },
+        "changedSources": { "type": "integer", "minimum": 0 },
+        "pendingItems": { "type": "integer", "minimum": 0 },
+        "affectedProjections": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "findingCodes": { "$ref": "#/$defs/strings" },
+    "sourceIds": { "$ref": "#/$defs/strings" },
+    "itemIds": { "$ref": "#/$defs/strings" },
+    "projectionPaths": { "$ref": "#/$defs/strings" },
+    "readTargets": { "type": "array", "items": { "type": "object" } },
+    "workUnits": { "type": "array", "items": { "type": "object" } },
+    "nextActions": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "enum": ["run-setup-preview", "run-sync", "review-pending", "review-source-change", "review-projection", "publish-ai-entry", "resolve-conflict", "ready-for-task"] }
+    },
+    "boundaries": { "type": "object", "additionalProperties": { "const": false } }
+  },
+  "$defs": {
+    "strings": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "project": {
+      "type": "object", "additionalProperties": false, "required": ["id", "name"],
+      "properties": { "id": { "type": "string" }, "name": { "type": "string" } }
+    },
+    "snapshots": {
+      "type": "object", "additionalProperties": false, "required": ["contract", "sourcesLock", "projectionsLock"],
+      "properties": { "contract": { "$ref": "#/$defs/digest" }, "sourcesLock": { "$ref": "#/$defs/digest" }, "projectionsLock": { "$ref": "#/$defs/digest" } }
+    }
+  }
+}

package/schemas/projection-lock.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:projection-lock:2",
+  "title": "Frontend Project Context Projection Lock",
+  "oneOf": [
+    { "$ref": "#/$defs/schema1" },
+    { "$ref": "#/$defs/schema2" }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "fileEntry1": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "target", "paths", "contractDigest", "bundleDigest", "contentDigest", "itemIds", "rendererVersion"],
+      "properties": {
+        "path": { "type": "string" }, "target": { "enum": ["agents", "ruler"] }, "paths": { "type": "array", "items": { "type": "string" } },
+        "contractDigest": { "$ref": "#/$defs/digest" }, "bundleDigest": { "$ref": "#/$defs/digest" }, "contentDigest": { "$ref": "#/$defs/digest" },
+        "itemIds": { "type": "array", "items": { "type": "string" } }, "rendererVersion": { "enum": [1, 2, 3] }
+      }
+    },
+    "fileEntry2": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "target", "ownership", "paths", "contractDigest", "bundleDigest", "contentDigest", "itemIds", "rendererVersion"],
+      "properties": {
+        "path": { "type": "string" }, "target": { "enum": ["agents", "ruler"] }, "ownership": { "const": "file" },
+        "paths": { "type": "array", "items": { "type": "string" } }, "contractDigest": { "$ref": "#/$defs/digest" },
+        "bundleDigest": { "$ref": "#/$defs/digest" }, "contentDigest": { "$ref": "#/$defs/digest" },
+        "itemIds": { "type": "array", "items": { "type": "string" } }, "rendererVersion": { "enum": [1, 2, 3] }
+      }
+    },
+    "regionEntry": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "target", "ownership", "regionId", "regionDigest", "rendererVersion", "createdFile"],
+      "properties": {
+        "path": { "type": "string" }, "target": { "const": "ai-entry" }, "ownership": { "const": "region" },
+        "regionId": { "const": "project-context-ai-entry" }, "regionDigest": { "$ref": "#/$defs/digest" },
+        "rendererVersion": { "enum": [1, 2, 3] }, "createdFile": { "type": "boolean" }
+      }
+    },
+    "schema1": {
+      "type": "object", "additionalProperties": false, "required": ["schemaVersion", "projections"],
+      "properties": { "schemaVersion": { "const": 1 }, "projections": { "type": "array", "items": { "$ref": "#/$defs/fileEntry1" } } }
+    },
+    "schema2": {
+      "type": "object", "additionalProperties": false, "required": ["schemaVersion", "projections"],
+      "properties": { "schemaVersion": { "const": 2 }, "projections": { "type": "array", "items": { "oneOf": [{ "$ref": "#/$defs/fileEntry2" }, { "$ref": "#/$defs/regionEntry" }] } } }
+    }
+  }
+}

package/schemas/review-bundle.schema.json

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:review-bundle:1",
+  "$id": "urn:frontend-project-context:schema:review-bundle:2",
   "title": "Frontend Project Context Review Bundle",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "projectId", "planDigest", "baselines", "status", "summary", "actions", "groups", "findings", "invocations"],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 2 },
     "projectId": { "$ref": "#/$defs/id" },
     "planDigest": { "$ref": "#/$defs/digest" },
     "baselines": { "$ref": "#/$defs/baselines" },
@@ -84,7 +84,7 @@
       }
     },
     "actionKind": {
-      "enum": ["accept-source-change", "deprecate-item", "deprecate-source", "propose-item", "publish-projection", "register-source", "request-item-approval", "revise-item"]
+      "enum": ["accept-source-change", "deprecate-item", "deprecate-source", "propose-item", "publish-ai-entry", "publish-projection", "register-source", "remove-ai-entry", "request-item-approval", "revise-item"]
     },
     "invocation": {
       "type": "object",

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"] } } }
+  }
+}