frontend-project-context 1.8.0 → 1.10.0

package/schemas/context-bundle.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:context-bundle:1",
+  "title": "Frontend Project Context Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "mode", "task", "snapshots", "semanticCompleteness", "commonItemIds", "targets", "items", "readTargets", "provenanceSources", "coverage", "authority", "gaps", "nextActions", "content", "bundleDigest"],
+  "properties": {
+    "schemaVersion": {"const": 1},
+    "kind": {"const": "context-bundle"},
+    "project": {"type": "object", "additionalProperties": false, "required": ["id", "name"], "properties": {"id": {"type": "string", "minLength": 1}, "name": {"type": "string", "minLength": 1}}},
+    "mode": {"enum": ["locate", "targeted"]},
+    "task": {"type": "object", "additionalProperties": false, "required": ["text", "paths"], "properties": {"text": {"type": "string"}, "paths": {"$ref": "#/$defs/strings"}}},
+    "snapshots": {"type": "object", "additionalProperties": false, "required": ["contract", "sourcesLock", "projectionsLock"], "properties": {"contract": {"$ref": "#/$defs/digest"}, "sourcesLock": {"$ref": "#/$defs/digest"}, "projectionsLock": {"$ref": "#/$defs/digest"}}},
+    "semanticCompleteness": {"const": "not-claimed"},
+    "commonItemIds": {"$ref": "#/$defs/strings"},
+    "targets": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "scopeCoverage", "itemIds", "scopedItemIds", "deltaItemIds"], "properties": {"path": {"type": "string"}, "scopeCoverage": {"enum": ["scoped", "project-only", "none"]}, "itemIds": {"$ref": "#/$defs/strings"}, "scopedItemIds": {"$ref": "#/$defs/strings"}, "deltaItemIds": {"$ref": "#/$defs/strings"}}}},
+    "items": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["id", "kind", "subject", "scope", "sourceIds", "statement", "value", "overrides"], "properties": {"id": {"type": "string", "minLength": 1}, "kind": {"enum": ["fact", "policy", "reference", "validation-description"]}, "subject": {"type": "string", "minLength": 1}, "scope": {"type": "object", "additionalProperties": false, "required": ["kind"], "properties": {"kind": {"enum": ["project", "path-prefix", "file"]}, "path": {"type": "string"}}}, "sourceIds": {"$ref": "#/$defs/strings"}, "statement": {"type": "string", "minLength": 1}, "value": true, "overrides": {"$ref": "#/$defs/strings"}, "verification": {"type": "object", "additionalProperties": false, "required": ["kind"], "properties": {"kind": {"enum": ["none", "file-exists", "json-value", "path-digest"]}, "source": {"type": "string"}, "expected": true}}, "consumption": {"type": "object", "additionalProperties": false, "required": ["requiredSources", "conditionalSources"], "properties": {"requiredSources": {"$ref": "#/$defs/strings"}, "conditionalSources": {"$ref": "#/$defs/strings"}}}}}},
+    "readTargets": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "role", "itemIds", "sourceIds", "reasons"], "properties": {"path": {"type": "string"}, "role": {"enum": ["required", "conditional"]}, "itemIds": {"$ref": "#/$defs/strings"}, "sourceIds": {"$ref": "#/$defs/strings"}, "reasons": {"$ref": "#/$defs/strings"}, "pointers": {"$ref": "#/$defs/strings"}}}},
+    "provenanceSources": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["sourceId", "itemIds", "kind", "locator"], "properties": {"sourceId": {"type": "string"}, "itemIds": {"$ref": "#/$defs/strings"}, "kind": {"type": "string"}, "locator": {"type": "object"}}}},
+    "coverage": {"type": "object", "additionalProperties": false, "required": ["profileItemId", "profileVersion", "registrationCoverage", "targets", "guarantee"], "properties": {"profileItemId": {"type": ["string", "null"]}, "profileVersion": {"enum": [null, 1, 2]}, "registrationCoverage": {"enum": ["not-declared", "review-required", "unresolved", "closed-for-declared-scope"]}, "targets": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "disposition", "domainId"], "properties": {"path": {"type": "string"}, "disposition": {"enum": ["contract-covered", "dynamic-investigation", "excluded-approved", "unresolved", "outside-declared-coverage"]}, "domainId": {"type": ["string", "null"]}}}}, "guarantee": {"const": "declared-scope-only-never-all-project-truth"}}},
+    "authority": {"type": "object", "additionalProperties": false, "required": ["productTaskExecution", "productBusinessCodeWrites", "hostTaskAuthority", "resolveFrom"], "properties": {"productTaskExecution": {"const": false}, "productBusinessCodeWrites": {"const": false}, "hostTaskAuthority": {"const": "external-to-project-context"}, "resolveFrom": {"const": ["current-user-request", "human-authored-project-instructions", "higher-priority-safety-constraints"]}}},
+    "gaps": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["code"], "properties": {"code": {"enum": ["target-path-not-yet-known", "project-scope-only", "no-applicable-contract-item", "registration-coverage-not-declared", "registration-coverage-review-required", "required-read-target-unavailable"]}, "path": {"type": "string"}, "sourceIds": {"$ref": "#/$defs/strings"}, "reason": {"type": "string"}, "disposition": {"enum": ["unresolved"]}}}},
+    "nextActions": {"$ref": "#/$defs/strings"},
+    "content": {"type": "string", "minLength": 1},
+    "bundleDigest": {"$ref": "#/$defs/digest"}
+  },
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "strings": {"type": "array", "uniqueItems": true, "items": {"type": "string"}}
+  }
+}

package/schemas/coverage-audit.schema.json

@@ -1,25 +1,27 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:coverage-audit:1",
+  "$id": "urn:frontend-project-context:schema:coverage-audit:2",
   "title": "Frontend Project Context Coverage Audit",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "kind", "project", "snapshots", "profile", "registrationCoverage", "categories", "guarantee", "auditDigest"],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 2 },
     "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"] },
+    "registrationCoverage": { "enum": ["not-declared", "review-required", "unresolved", "closed-for-declared-scope"] },
     "categories": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["registered", "excluded-approved", "review-required", "outside-declared-coverage"],
+      "required": ["registered", "dynamic-investigation", "excluded-approved", "review-required", "unresolved", "outside-declared-coverage"],
       "properties": {
         "registered": { "$ref": "#/$defs/candidates" },
+        "dynamic-investigation": { "$ref": "#/$defs/candidates" },
         "excluded-approved": { "$ref": "#/$defs/candidates" },
         "review-required": { "$ref": "#/$defs/candidates" },
+        "unresolved": { "$ref": "#/$defs/candidates" },
         "outside-declared-coverage": { "$ref": "#/$defs/candidates" }
       }
     },

package/schemas/evidence-bundle.schema.json

@@ -14,7 +14,7 @@
       "required": ["name", "version", "exchangeProtocolVersion"],
       "properties": {
         "name": { "const": "frontend-project-context" },
-        "version": { "const": "1.8.0" },
+        "version": { "const": "1.10.0" },
         "exchangeProtocolVersion": { "const": 6 }
       }
     },

package/schemas/initialization-instruction.schema.json

@@ -1,19 +1,19 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:initialization-instruction:1",
+  "$id": "urn:frontend-project-context:schema:initialization-instruction:2",
   "title": "Frontend Project Context Initialization Instruction",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schemaVersion", "package", "instruction", "targetRoot", "boundaries"],
+  "required": ["schemaVersion", "package", "instruction", "targetRoot", "boundaries", "entryRuleReview"],
   "properties": {
-    "schemaVersion": {"const": 1},
+    "schemaVersion": {"const": 2},
     "package": {
       "type": "object",
       "additionalProperties": false,
       "required": ["name", "version"],
       "properties": {
         "name": {"const": "frontend-project-context"},
-        "version": {"const": "1.8.0"}
+        "version": {"const": "1.10.0"}
       }
     },
     "instruction": {
@@ -22,13 +22,25 @@
       "required": ["id", "version", "packagePath", "digest", "content"],
       "properties": {
         "id": {"const": "ai-project-initialization"},
-        "version": {"const": 1},
+        "version": {"const": 2},
         "packagePath": {"const": "docs/AI-PROJECT-INITIALIZATION.md"},
         "digest": {"$ref": "#/$defs/digest"},
         "content": {"type": "string", "minLength": 1}
       }
     },
     "targetRoot": {"type": "string", "minLength": 1},
+    "entryRuleReview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "present", "allowedDispositions", "records", "automaticDeletion"],
+      "properties": {
+        "path": {"const": "AGENTS.md"},
+        "present": {"type": "boolean"},
+        "allowedDispositions": {"const": ["migrated-to-contract", "kept-in-entry-intentionally", "excluded-as-stale", "unresolved-blocker"]},
+        "records": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["id", "disposition", "rationale"], "properties": {"id": {"type": "string"}, "disposition": {"enum": ["migrated-to-contract", "kept-in-entry-intentionally", "excluded-as-stale", "unresolved-blocker"]}, "rationale": {"type": "string"}}}},
+        "automaticDeletion": {"const": false}
+      }
+    },
     "boundaries": {
       "type": "object",
       "additionalProperties": false,

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.8.0"}}},
-    "upgradeFrom": {"const": ["1.3.1", "1.4.0", "1.5.0", "1.6.0", "1.7.0"]},
+    "package": {"type": "object", "additionalProperties": false, "required": ["name", "version"], "properties": {"name": {"const": "frontend-project-context"}, "version": {"const": "1.10.0"}}},
+    "upgradeFrom": {"const": ["1.3.1", "1.4.0", "1.5.0", "1.6.0", "1.7.0", "1.8.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": 5, "maxItems": 5, "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", "1.7.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": 6, "maxItems": 6, "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", "1.7.0", "1.8.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

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

package/schemas/project-brief.schema.json

@@ -0,0 +1,400 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:project-brief:2",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "kind",
+        "project",
+        "package",
+        "connection",
+        "projectHealth",
+        "contractReadiness",
+        "findingCodes",
+        "taskStatus",
+        "tasks",
+        "nextAction",
+        "authorityGranted"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 1
+        },
+        "kind": {
+          "const": "project-brief"
+        },
+        "project": {
+          "anyOf": [
+            {
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "package": {
+          "type": "object"
+        },
+        "connection": {
+          "enum": [
+            "available",
+            "needs-governance",
+            "not-connected"
+          ]
+        },
+        "projectHealth": {
+          "type": "string",
+          "minLength": 1
+        },
+        "contractReadiness": {
+          "type": "string",
+          "minLength": 1
+        },
+        "findingCodes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "taskStatus": {
+          "const": "none"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "taskId",
+                  "title",
+                  "lifecycle",
+                  "readPaths",
+                  "writePaths",
+                  "unresolvedDecisions"
+                ],
+                "properties": {
+                  "taskId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "title": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "lifecycle": {
+                    "enum": [
+                      "active",
+                      "completed",
+                      "cancelled"
+                    ]
+                  },
+                  "readPaths": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "writePaths": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "unresolvedDecisions": {
+                    "type": "integer",
+                    "minimum": 0
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "path",
+                  "status"
+                ],
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "status": {
+                    "const": "invalid-record"
+                  },
+                  "reason": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            ]
+          }
+        },
+        "nextAction": {
+          "type": "string",
+          "minLength": 1
+        },
+        "authorityGranted": {
+          "const": false
+        }
+      }
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "kind",
+        "project",
+        "package",
+        "connection",
+        "projectHealth",
+        "contractReadiness",
+        "findingCodes",
+        "taskStatus",
+        "tasks",
+        "nextAction",
+        "authorityGranted",
+        "context",
+        "overview",
+        "presentation",
+        "delivery"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": 2
+        },
+        "kind": {
+          "const": "project-brief"
+        },
+        "project": {
+          "anyOf": [
+            {
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "package": {
+          "type": "object"
+        },
+        "connection": {
+          "enum": [
+            "available",
+            "needs-governance",
+            "not-connected"
+          ]
+        },
+        "projectHealth": {
+          "type": "string",
+          "minLength": 1
+        },
+        "contractReadiness": {
+          "type": "string",
+          "minLength": 1
+        },
+        "findingCodes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "taskStatus": {
+          "const": "none"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "taskId",
+                  "title",
+                  "lifecycle",
+                  "readPaths",
+                  "writePaths",
+                  "unresolvedDecisions",
+                  "progressSummary"
+                ],
+                "properties": {
+                  "taskId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "title": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "lifecycle": {
+                    "enum": [
+                      "active",
+                      "completed",
+                      "cancelled"
+                    ]
+                  },
+                  "readPaths": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "writePaths": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "unresolvedDecisions": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "progressSummary": {
+                    "$ref": "work-view.schema.json#/$defs/progress"
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "path",
+                  "status"
+                ],
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "status": {
+                    "const": "invalid-record"
+                  },
+                  "reason": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            ]
+          }
+        },
+        "nextAction": {
+          "type": "string",
+          "minLength": 1
+        },
+        "authorityGranted": {
+          "const": false
+        },
+        "context": {
+          "anyOf": [
+            {
+              "$ref": "context-bundle.schema.json"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "overview": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "items",
+            "scopeSummary",
+            "limitations"
+          ],
+          "properties": {
+            "items": {
+              "type": "array",
+              "maxItems": 5,
+              "items": {
+                "$ref": "work-view.schema.json#/$defs/item"
+              }
+            },
+            "scopeSummary": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "scope",
+                  "items"
+                ],
+                "properties": {
+                  "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
+                          }
+                        }
+                      }
+                    ]
+                  },
+                  "items": {
+                    "type": "integer",
+                    "minimum": 1
+                  }
+                }
+              }
+            },
+            "limitations": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        },
+        "presentation": {
+          "$ref": "work-view.schema.json#/$defs/presentation"
+        },
+        "delivery": {
+          "$ref": "work-view.schema.json#/$defs/delivery"
+        }
+      }
+    }
+  ]
+}

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": { "enum": [1, 2, 3] }, "createdFile": { "type": "boolean" }
+        "rendererVersion": { "enum": [1, 2, 3, 4, 5, 6, 7] }, "createdFile": { "type": "boolean" }
       }
     },
     "schema1": {

package/schemas/task-context-record.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:task-context-record:1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "projectId", "taskId", "title", "revision", "previousDigest", "origin", "lifecycle", "scope", "requirements", "evidence", "decisions", "progress"],
+  "properties": {
+    "schemaVersion": {"const": 1}, "kind": {"const": "task-context-record"},
+    "projectId": {"type": "string", "minLength": 1},
+    "taskId": {"$ref": "#/$defs/id"}, "title": {"type": "string", "minLength": 1},
+    "revision": {"type": "integer", "minimum": 1},
+    "previousDigest": {"anyOf": [{"type": "null"}, {"$ref": "#/$defs/digest"}]},
+    "origin": {"type": "object", "additionalProperties": false, "required": ["text"], "properties": {"text": {"type": "string", "minLength": 1}, "reference": {"type": "string", "minLength": 1}}},
+    "lifecycle": {"enum": ["active", "completed", "cancelled"]},
+    "scope": {"type": "object", "additionalProperties": false, "required": ["readPaths", "writeTargets"], "properties": {"readPaths": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/path"}}, "writeTargets": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "operation"], "properties": {"path": {"$ref": "#/$defs/path"}, "operation": {"enum": ["create", "modify", "delete"]}}}}, "workspaceLabel": {"type": "string", "minLength": 1}}},
+    "requirements": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["id", "text", "source", "appliesTo", "blocking", "evidenceIds"], "properties": {"id": {"$ref": "#/$defs/id"}, "text": {"type": "string", "minLength": 1}, "source": {"type": "string", "minLength": 1}, "appliesTo": {"$ref": "#/$defs/appliesTo"}, "blocking": {"type": "boolean"}, "evidenceIds": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/id"}}}}},
+    "evidence": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["id", "purpose", "kind", "digest", "identity"], "properties": {"id": {"$ref": "#/$defs/id"}, "purpose": {"enum": ["requirement", "design", "decision", "implementation", "reference"]}, "kind": {"enum": ["local", "inline", "external"]}, "path": {"$ref": "#/$defs/path"}, "text": {"type": "string", "minLength": 1}, "reference": {"type": "string", "minLength": 1}, "digest": {"$ref": "#/$defs/digest"}, "identity": {"enum": ["local-verified", "user-statement", "host-asserted"]}}}},
+    "decisions": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["id", "question", "appliesTo", "blocking", "status", "evidenceIds"], "properties": {"id": {"$ref": "#/$defs/id"}, "question": {"type": "string", "minLength": 1}, "appliesTo": {"$ref": "#/$defs/appliesTo"}, "blocking": {"type": "boolean"}, "status": {"enum": ["open", "confirmed"]}, "value": {"type": "string", "minLength": 1}, "evidenceIds": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/id"}}}}},
+    "progress": {"type": "object", "additionalProperties": false, "required": ["completed", "remaining", "implementation", "nextAction"], "properties": {"completed": {"type": "array", "items": {"type": "string", "minLength": 1}}, "remaining": {"type": "array", "items": {"type": "string", "minLength": 1}}, "implementation": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "operation", "status", "digest"], "properties": {"path": {"$ref": "#/$defs/path"}, "operation": {"enum": ["create", "modify", "delete"]}, "status": {"const": "completed"}, "digest": {"$ref": "#/$defs/digest"}}}}, "nextAction": {"type": "string", "minLength": 1}}}
+  },
+  "$defs": {
+    "id": {"type": "string", "maxLength": 64, "pattern": "^[a-z0-9]+([.-][a-z0-9]+)*$"},
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "path": {"type": "string", "minLength": 1},
+    "appliesTo": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"enum": ["investigate", "design", "implement"]}}
+  }
+}

package/schemas/task-handoff-input.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:task-handoff-input:1",
+  "type": "object", "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "intent", "consumerRunId"],
+  "oneOf": [{"required": ["recordPath"], "not": {"required": ["record"]}}, {"required": ["record"], "not": {"required": ["recordPath"]}}],
+  "properties": {
+    "schemaVersion": {"const": 1}, "kind": {"const": "task-handoff-input"},
+    "recordPath": {"type": "string", "pattern": "^\\.project-context-tasks/[a-z0-9][a-z0-9.-]*\\.json$"},
+    "record": {"$ref": "task-context-record.schema.json"},
+    "intent": {"enum": ["investigate", "design", "implement"]},
+    "consumerRunId": {"type": "string", "minLength": 1},
+    "consumption": {"type": "object", "additionalProperties": false, "required": ["contextBundleDigest", "consumerRunId", "readTargets", "evidenceIds", "conditional"], "properties": {
+      "contextBundleDigest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+      "taskId": {"$ref": "task-context-record.schema.json#/$defs/id"},
+      "requirementsDigest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+      "consumerRunId": {"type": "string", "minLength": 1},
+      "readTargets": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "digest"], "properties": {"path": {"type": "string"}, "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}}}},
+      "evidenceIds": {"type": "array", "uniqueItems": true, "items": {"type": "string"}},
+      "conditional": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["path", "decision", "reason"], "properties": {"path": {"type": "string"}, "decision": {"enum": ["read", "not-applicable"]}, "reason": {"type": "string", "minLength": 1}, "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}}, "allOf": [{"if": {"properties": {"decision": {"const": "read"}}}, "then": {"required": ["digest"]}, "else": {"not": {"required": ["digest"]}}}]}}
+    }}
+  }
+}