frontend-project-context 1.0.1 → 1.3.0

package/schemas/review-bundle.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:review-bundle:1",
+  "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 },
+    "projectId": { "$ref": "#/$defs/id" },
+    "planDigest": { "$ref": "#/$defs/digest" },
+    "baselines": { "$ref": "#/$defs/baselines" },
+    "status": { "enum": ["reviewable", "blocked"] },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["actions", "reviewable", "blocked", "groups"],
+      "properties": {
+        "actions": { "type": "integer", "minimum": 1 },
+        "reviewable": { "type": "integer", "minimum": 0 },
+        "blocked": { "type": "integer", "minimum": 0 },
+        "groups": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "actions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "kind", "status", "current", "proposed", "baselines", "impact", "blockers", "humanApprovalRequired"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "kind": { "$ref": "#/$defs/actionKind" },
+          "status": { "enum": ["reviewable", "blocked"] },
+          "current": {},
+          "proposed": {},
+          "baselines": { "type": "object" },
+          "impact": {
+            "type": "object",
+            "required": ["itemIds", "sourceIds", "paths", "projectionPaths"],
+            "properties": {
+              "itemIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+              "sourceIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+              "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+              "projectionPaths": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+              "directProjectionPaths": { "type": "array", "uniqueItems": true, "items": { "type": "string" } }
+            },
+            "additionalProperties": false
+          },
+          "blockers": { "type": "array", "items": { "type": "object" } },
+          "humanApprovalRequired": { "const": true },
+          "invocation": { "$ref": "#/$defs/invocation" }
+        }
+      }
+    },
+    "groups": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "actionIds"],
+        "properties": {
+          "kind": { "enum": ["source-change", "new-or-revised-knowledge", "deprecation", "approval-request", "projection", "blocker"] },
+          "actionIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
+        }
+      }
+    },
+    "findings": { "type": "array", "items": { "type": "object" } },
+    "invocations": { "type": "array", "items": { "$ref": "#/$defs/invocationWithAction" } }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "baselines": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "sourcesLock", "projectionsLock"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/digest" },
+        "sourcesLock": { "$ref": "#/$defs/digest" },
+        "projectionsLock": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "actionKind": {
+      "enum": ["accept-source-change", "deprecate-item", "deprecate-source", "propose-item", "publish-projection", "register-source", "request-item-approval", "revise-item"]
+    },
+    "invocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command", "args"],
+      "properties": {
+        "command": { "type": "string" },
+        "args": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "invocationWithAction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["actionId", "command", "args"],
+      "properties": {
+        "actionId": { "$ref": "#/$defs/id" },
+        "command": { "type": "string" },
+        "args": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/schemas/stage-context-bundle.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:stage-context-bundle:1",
+  "title": "Frontend Project Context Stage Context Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "task", "stage", "workspace", "planDigest", "snapshots", "dependencyReceipts", "changedPaths", "contractItems", "readTargets", "findings", "excluded", "budget", "status", "bundleDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "stage-context-bundle" },
+    "project": { "$ref": "#/$defs/identity" },
+    "task": { "$ref": "#/$defs/task" },
+    "stage": { "$ref": "#/$defs/stage" },
+    "workspace": { "$ref": "#/$defs/workspace" },
+    "planDigest": { "$ref": "#/$defs/digest" },
+    "snapshots": { "$ref": "#/$defs/snapshots" },
+    "dependencyReceipts": { "type": "array", "items": { "$ref": "#/$defs/receiptSummary" } },
+    "changedPaths": { "$ref": "#/$defs/paths" },
+    "contractItems": { "type": "array", "items": { "$ref": "#/$defs/contractItem" } },
+    "readTargets": { "type": "array", "items": { "$ref": "#/$defs/readTarget" } },
+    "findings": { "type": "array", "items": { "type": "object" } },
+    "excluded": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["unit", "maxUtf8Bytes", "maxReadTargets", "usedUtf8Bytes", "readTargetCount"],
+      "properties": {
+        "unit": { "const": "canonical-utf8-bytes" },
+        "maxUtf8Bytes": { "type": "integer", "minimum": 1 },
+        "maxReadTargets": { "type": "integer", "minimum": 1 },
+        "usedUtf8Bytes": { "type": "integer", "minimum": 0 },
+        "readTargetCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "status": { "enum": ["ready", "blocked"] },
+    "bundleDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "identity": { "type": "object", "additionalProperties": false, "required": ["id", "name"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "$ref": "#/$defs/text" } } },
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "text": { "type": "string", "minLength": 1 },
+    "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" } } },
+    "task": { "type": "object", "additionalProperties": false, "required": ["id", "title", "goal"], "properties": { "id": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/text" }, "goal": { "$ref": "#/$defs/text" } } },
+    "acceptance": { "type": "object", "additionalProperties": false, "required": ["id", "text"], "properties": { "id": { "$ref": "#/$defs/id" }, "text": { "$ref": "#/$defs/text" } } },
+    "stage": { "type": "object", "additionalProperties": false, "required": ["id", "title", "objective", "acceptance", "paths"], "properties": { "id": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/text" }, "objective": { "$ref": "#/$defs/text" }, "acceptance": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/acceptance" } }, "paths": { "$ref": "#/$defs/paths" } } },
+    "workspace": { "type": "object", "additionalProperties": false, "required": ["branchLabel", "baseRevision"], "properties": { "branchLabel": { "$ref": "#/$defs/text" }, "baseRevision": { "$ref": "#/$defs/text" } } },
+    "acceptanceResult": { "type": "object", "additionalProperties": false, "required": ["id", "status", "evidence"], "properties": { "id": { "$ref": "#/$defs/id" }, "status": { "enum": ["observed", "not-observed"] }, "evidence": { "$ref": "#/$defs/paths" } } },
+    "verificationResult": { "type": "object", "additionalProperties": false, "required": ["id", "status", "summary", "evidence"], "properties": { "id": { "$ref": "#/$defs/id" }, "status": { "enum": ["passed", "failed", "observed", "skipped"] }, "summary": { "$ref": "#/$defs/text" }, "evidence": { "$ref": "#/$defs/paths" } } },
+    "receiptSummary": { "type": "object", "additionalProperties": false, "required": ["stageId", "status", "inputBundleDigest", "changedPaths", "acceptanceResults", "verificationResults", "decisions", "openIssues"], "properties": { "stageId": { "$ref": "#/$defs/id" }, "status": { "enum": ["completed", "blocked"] }, "inputBundleDigest": { "$ref": "#/$defs/digest" }, "changedPaths": { "$ref": "#/$defs/paths" }, "acceptanceResults": { "type": "array", "items": { "$ref": "#/$defs/acceptanceResult" } }, "verificationResults": { "type": "array", "items": { "$ref": "#/$defs/verificationResult" } }, "decisions": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }, "openIssues": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/text" } } } },
+    "scope": { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "enum": ["project", "path-prefix", "file"] }, "path": { "type": "string", "minLength": 1 } } },
+    "contractItem": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "subject", "value", "statement", "scope", "sourceIds"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["fact", "policy", "reference", "validation-description"] }, "subject": { "$ref": "#/$defs/id" }, "value": {}, "statement": { "$ref": "#/$defs/text" }, "scope": { "$ref": "#/$defs/scope" }, "sourceIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } } } },
+    "readTarget": { "type": "object", "additionalProperties": false, "required": ["path", "reason"], "properties": { "path": { "type": "string", "minLength": 1 }, "reason": { "enum": ["stage-scope", "host-changed-path-signal", "contract-source"] }, "sourceId": { "$ref": "#/$defs/id" } } }
+  }
+}

package/schemas/stage-receipt.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:stage-receipt:1",
+  "title": "Frontend Project Context Stage Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "projectId", "taskId", "stageId", "planDigest", "inputBundleDigest", "status", "changedPaths", "acceptanceResults", "verificationResults", "decisions", "openIssues"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "stage-receipt" },
+    "projectId": { "$ref": "#/$defs/id" },
+    "taskId": { "$ref": "#/$defs/id" },
+    "stageId": { "$ref": "#/$defs/id" },
+    "planDigest": { "$ref": "#/$defs/digest" },
+    "inputBundleDigest": { "$ref": "#/$defs/digest" },
+    "status": { "enum": ["completed", "blocked"] },
+    "changedPaths": { "$ref": "#/$defs/paths" },
+    "acceptanceResults": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "evidence"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "status": { "enum": ["observed", "not-observed"] },
+          "evidence": { "$ref": "#/$defs/paths" }
+        }
+      }
+    },
+    "verificationResults": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "summary", "evidence"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "status": { "enum": ["passed", "failed", "observed", "skipped"] },
+          "summary": { "type": "string", "minLength": 1 },
+          "evidence": { "$ref": "#/$defs/paths" }
+        }
+      }
+    },
+    "decisions": { "$ref": "#/$defs/texts" },
+    "openIssues": { "$ref": "#/$defs/texts" },
+    "nextStageId": { "$ref": "#/$defs/id" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "texts": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  }
+}

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

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:task-context-plan:1",
+  "title": "Frontend Project Context Task Context Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "projectId", "task", "workspace", "snapshots", "budget", "stages"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "task-context-plan" },
+    "projectId": { "$ref": "#/$defs/id" },
+    "task": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "title", "goal", "acceptance"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "title": { "$ref": "#/$defs/text" },
+        "goal": { "$ref": "#/$defs/text" },
+        "acceptance": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "text"],
+            "properties": { "id": { "$ref": "#/$defs/id" }, "text": { "$ref": "#/$defs/text" } }
+          }
+        }
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["branchLabel", "baseRevision"],
+      "properties": { "branchLabel": { "$ref": "#/$defs/text" }, "baseRevision": { "$ref": "#/$defs/text" } }
+    },
+    "snapshots": { "$ref": "#/$defs/snapshots" },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxUtf8Bytes", "maxReadTargets"],
+      "properties": {
+        "maxUtf8Bytes": { "type": "integer", "minimum": 1 },
+        "maxReadTargets": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "stages": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "objective", "dependsOn", "paths", "acceptanceIds"],
+        "properties": {
+          "id": { "$ref": "#/$defs/id" },
+          "title": { "$ref": "#/$defs/text" },
+          "objective": { "$ref": "#/$defs/text" },
+          "dependsOn": { "$ref": "#/$defs/ids" },
+          "paths": { "$ref": "#/$defs/paths" },
+          "acceptanceIds": { "$ref": "#/$defs/nonEmptyIds" }
+        }
+      }
+    }
+  },
+  "$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}$" },
+    "path": { "type": "string", "minLength": 1 },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "nonEmptyIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "paths": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/path" } },
+    "snapshots": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "sourcesLock", "projectionsLock"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/digest" },
+        "sourcesLock": { "$ref": "#/$defs/digest" },
+        "projectionsLock": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}