frontend-project-context 1.0.1 → 1.3.0

package/examples/README.md

@@ -5,7 +5,20 @@
 维护者首次初始化：
 
 ```bash
-npm run context:init -- --id my-project --name "My Project" --write
+npm run context:setup -- --id my-project --name "My Project" --write --json
+```
+
+日常维护时生成只读变化工作单元：
+
+```bash
+npm run context:sync -- --changed-path src/example.ts --json
+```
+
+外部 AI 宿主先查询机器协议，再对无权限 Action Plan 生成只读 Review Bundle：
+
+```bash
+npm run context:capabilities -- --json
+npm run context:preflight -- --plan .project-context/action-plan.json --json
 ```
 
 团队和 CI 的只读 Gate：
@@ -14,4 +27,4 @@ npm run context:init -- --id my-project --name "My Project" --write
 npm run context:check
 ```
 
-应提交 `.project-context/contract.json`、`.project-context/sources.lock.json`、`.project-context/projections.lock.json` 和团队明确采用的受管投影。不要提交 proposal、dashboard HTML、tarball、node_modules 或临时 Context Bundle。
+人工审查 setup/sync 或 Review Bundle 返回的精确 action、ID 和路径后，继续使用 approve/accept/revise/deprecate/publish 的显式写入命令。Review Bundle invocation 不含 `--write`/`--by`，不能当成授权。应提交 `.project-context/contract.json`、`.project-context/sources.lock.json`、`.project-context/projections.lock.json` 和团队明确采用的受管投影。不要提交 proposal、Action Plan、Review Bundle、Assist Bundle、dashboard HTML、tarball、node_modules 或临时 Context Bundle。

package/examples/package.json

@@ -1,11 +1,15 @@
 {
   "private": true,
   "scripts": {
+    "context:setup": "project-context setup --project .",
     "context:init": "project-context init --project .",
     "context:check": "project-context check --project .",
-    "context:dashboard": "project-context dashboard --project ."
+    "context:dashboard": "project-context dashboard --project .",
+    "context:sync": "project-context sync --project .",
+    "context:capabilities": "project-context capabilities --project .",
+    "context:preflight": "project-context preflight --project ."
   },
   "devDependencies": {
-    "frontend-project-context": "1.0.1"
+    "frontend-project-context": "1.2.0"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-project-context",
-  "version": "1.0.1",
+  "version": "1.3.0",
   "description": "Govern, compile, and verify project-local context for AI coding tools.",
   "private": false,
   "publishConfig": {
@@ -13,6 +13,7 @@
   "files": [
     "bin/",
     "src/",
+    "schemas/",
     "docs/",
     "examples/",
     "CHANGELOG.md",
@@ -24,8 +25,8 @@
     "project-context": "bin/project-context.mjs"
   },
   "scripts": {
-    "check": "node --check bin/project-context.mjs && node --test test/project-context test/release",
-    "test": "node --test test/project-context test/release",
+    "check": "node --check bin/project-context.mjs && npm test",
+    "test": "node --test test/project-context/acceptance.test.mjs test/project-context/assist.test.mjs test/project-context/cli.test.mjs test/project-context/dashboard.test.mjs test/project-context/exchange.test.mjs test/project-context/maintenance.test.mjs test/project-context/source-lifecycle.test.mjs test/project-context/task-context.test.mjs test/release/acceptance.test.mjs",
     "prepack": "npm run check"
   },
   "engines": {

package/schemas/action-plan.schema.json

@@ -0,0 +1,250 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:action-plan:1",
+  "title": "Frontend Project Context Action Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "projectId", "baselines", "actions"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "projectId": { "$ref": "#/$defs/id" },
+    "baselines": { "$ref": "#/$defs/baselines" },
+    "actions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "oneOf": [
+          { "$ref": "#/$defs/registerSource" },
+          { "$ref": "#/$defs/proposeItem" },
+          { "$ref": "#/$defs/acceptSourceChange" },
+          { "$ref": "#/$defs/reviseItem" },
+          { "$ref": "#/$defs/deprecateItem" },
+          { "$ref": "#/$defs/deprecateSource" },
+          { "$ref": "#/$defs/requestItemApproval" },
+          { "$ref": "#/$defs/publishProjection" }
+        ]
+      }
+    }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "path": { "type": "string", "minLength": 1, "not": { "pattern": "(^/|(^|[\\/])\\.\\.([\\/]|$))" } },
+    "baselines": {
+      "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": { "$ref": "#/$defs/path" }
+          }
+        }
+      ]
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": { "enum": ["none", "file-exists", "json-value", "path-digest"] },
+        "source": { "$ref": "#/$defs/id" },
+        "expected": {}
+      }
+    },
+    "itemInput": {
+      "type": "object",
+      "required": ["id", "kind", "subject", "value", "statement", "sources", "scope"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "enum": ["fact", "policy", "reference", "validation-description"] },
+        "subject": { "$ref": "#/$defs/id" },
+        "value": {},
+        "statement": { "type": "string", "minLength": 1 },
+        "sources": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+        "scope": { "$ref": "#/$defs/scope" },
+        "overrides": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+        "verification": { "$ref": "#/$defs/verification" }
+      }
+    },
+    "registerSource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "register-source" },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "kind"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "kind": { "enum": ["file", "path", "json-pointer", "human-decision", "external-reference"] },
+            "path": { "$ref": "#/$defs/path" },
+            "pointer": { "type": "string" },
+            "reference": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "proposeItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "propose-item" },
+        "input": {
+          "unevaluatedProperties": false,
+          "allOf": [
+            { "$ref": "#/$defs/itemInput" },
+            {
+              "type": "object",
+              "required": ["output"],
+              "properties": { "output": { "$ref": "#/$defs/path" } }
+            }
+          ]
+        }
+      }
+    },
+    "acceptSourceChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "accept-source-change" },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "sourceObjectDigest", "lockedDigest", "currentDigest", "affectedItems"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "sourceObjectDigest": { "$ref": "#/$defs/digest" },
+            "lockedDigest": { "$ref": "#/$defs/digest" },
+            "currentDigest": { "$ref": "#/$defs/digest" },
+            "affectedItems": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
+          }
+        }
+      }
+    },
+    "reviseItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "revise-item" },
+        "input": {
+          "unevaluatedProperties": false,
+          "allOf": [
+            { "$ref": "#/$defs/itemInput" },
+            {
+              "type": "object",
+              "required": ["expectedItemDigest"],
+              "properties": { "expectedItemDigest": { "$ref": "#/$defs/digest" } }
+            }
+          ]
+        }
+      }
+    },
+    "deprecateItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "deprecate-item" },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "expectedItemDigest", "rationale"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "expectedItemDigest": { "$ref": "#/$defs/digest" },
+            "rationale": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "deprecateSource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "deprecate-source" },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "expectedSourceDigest", "affectedItems", "rationale"],
+          "properties": {
+            "id": { "$ref": "#/$defs/id" },
+            "expectedSourceDigest": { "$ref": "#/$defs/digest" },
+            "affectedItems": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+            "rationale": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "requestItemApproval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "request-item-approval" },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode", "ids"],
+          "properties": {
+            "mode": { "enum": ["pending", "proposal"] },
+            "ids": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+            "proposal": { "$ref": "#/$defs/path" },
+            "proposalDigest": { "$ref": "#/$defs/digest" },
+            "rationale": { "type": "string" }
+          }
+        }
+      }
+    },
+    "publishProjection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "publish-projection" },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["target", "output", "paths", "expectedContentDigest"],
+          "properties": {
+            "target": { "enum": ["agents", "ruler"] },
+            "output": { "$ref": "#/$defs/path" },
+            "paths": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/path" } },
+            "expectedContentDigest": { "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/assist-bundle.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:assist-bundle:1",
+  "title": "Frontend Project Context Assist Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "mode",
+    "project",
+    "snapshots",
+    "summary",
+    "sourceChanges",
+    "affectedItems",
+    "pendingItems",
+    "pathSignals",
+    "projectionPaths",
+    "findings",
+    "readTargets",
+    "workUnits",
+    "proposal",
+    "artifacts"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "mode": { "enum": ["setup", "sync"] },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "name", "initialized"],
+      "properties": {
+        "id": { "type": "string" },
+        "name": { "type": "string" },
+        "initialized": { "type": "boolean" }
+      }
+    },
+    "snapshots": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "sourcesLock", "projectionsLock"],
+      "properties": {
+        "contract": { "$ref": "#/$defs/digest" },
+        "sourcesLock": { "$ref": "#/$defs/digest" },
+        "projectionsLock": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidateSources", "candidateItems", "changedSources", "affectedItems", "pendingItems", "affectedProjections"],
+      "properties": {
+        "candidateSources": { "type": "integer", "minimum": 0 },
+        "candidateItems": { "type": "integer", "minimum": 0 },
+        "changedSources": { "type": "integer", "minimum": 0 },
+        "affectedItems": { "type": "integer", "minimum": 0 },
+        "pendingItems": { "type": "integer", "minimum": 0 },
+        "affectedProjections": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "sourceChanges": { "type": "array", "items": { "type": "object" } },
+    "affectedItems": { "type": "array", "items": { "type": "object" } },
+    "pendingItems": { "type": "array", "items": { "type": "object" } },
+    "pathSignals": { "type": "array", "items": { "type": "object" } },
+    "projectionPaths": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/path" } },
+    "findings": { "type": "array", "items": { "type": "object" } },
+    "readTargets": { "type": "array", "items": { "type": "object" } },
+    "workUnits": { "type": "array", "items": { "type": "object" } },
+    "proposal": { "anyOf": [{ "type": "null" }, { "type": "object" }] },
+    "artifacts": { "type": "array", "items": { "type": "object" } }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "path": { "type": "string", "minLength": 1 }
+  }
+}

package/schemas/capabilities.schema.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:capabilities:1",
+  "title": "Frontend Project Context Capabilities",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "package",
+    "exchangeProtocolVersion",
+    "schemas",
+    "commands",
+    "actionKinds",
+    "contextBudget",
+    "initialization",
+    "initialized",
+    "project",
+    "boundaries"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "package": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "const": "frontend-project-context" },
+        "version": { "type": "string" }
+      }
+    },
+    "exchangeProtocolVersion": { "const": 1 },
+    "schemas": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "actionPlan",
+        "assistBundle",
+        "capabilities",
+        "contract",
+        "dashboardViewModel",
+        "integrationReviewBundle",
+        "projectionLock",
+        "projectionRenderer",
+        "proposal",
+        "reviewBundle",
+        "sourceLock",
+        "stageContextBundle",
+        "stageReceipt",
+        "taskContextPlan"
+      ],
+      "properties": {
+        "actionPlan": { "const": 1 },
+        "assistBundle": { "const": 1 },
+        "capabilities": { "const": 1 },
+        "contract": { "type": "integer" },
+        "dashboardViewModel": { "type": "integer" },
+        "integrationReviewBundle": { "const": 1 },
+        "projectionLock": { "type": "integer" },
+        "projectionRenderer": { "type": "integer" },
+        "proposal": { "type": "integer" },
+        "reviewBundle": { "const": 1 },
+        "sourceLock": { "type": "integer" },
+        "stageContextBundle": { "const": 1 },
+        "stageReceipt": { "const": 1 },
+        "taskContextPlan": { "const": 1 }
+      }
+    },
+    "commands": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } },
+    "actionKinds": {
+      "type": "array",
+      "minItems": 8,
+      "maxItems": 8,
+      "uniqueItems": true,
+      "items": {
+        "enum": [
+          "accept-source-change",
+          "deprecate-item",
+          "deprecate-source",
+          "propose-item",
+          "publish-projection",
+          "register-source",
+          "request-item-approval",
+          "revise-item"
+        ]
+      }
+    },
+    "contextBudget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["unit", "modelTokens", "callerMustProvideLimit"],
+      "properties": {
+        "unit": { "const": "canonical-utf8-bytes" },
+        "modelTokens": { "const": false },
+        "callerMustProvideLimit": { "const": true }
+      }
+    },
+    "initialization": { "enum": ["uninitialized", "partial", "initialized"] },
+    "initialized": { "type": "boolean" },
+    "project": {
+      "anyOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "name"],
+          "properties": {
+            "id": { "type": "string" },
+            "name": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "boundaries": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "provider",
+        "agentRuntime",
+        "git",
+        "network",
+        "dependencyInstallation",
+        "automaticApproval",
+        "businessCodeWrites",
+        "taskExecution",
+        "stagePathBodyReads",
+        "applyPlan",
+        "scheduler",
+        "daemon"
+      ],
+      "properties": {
+        "provider": { "const": false },
+        "agentRuntime": { "const": false },
+        "git": { "const": false },
+        "network": { "const": false },
+        "dependencyInstallation": { "const": false },
+        "automaticApproval": { "const": false },
+        "businessCodeWrites": { "const": false },
+        "taskExecution": { "const": false },
+        "stagePathBodyReads": { "const": false },
+        "applyPlan": { "const": false },
+        "scheduler": { "const": false },
+        "daemon": { "const": false }
+      }
+    }
+  }
+}

package/schemas/integration-review-bundle.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:integration-review-bundle:1",
+  "title": "Frontend Project Context Integration Review Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "task", "workspace", "planDigest", "planSnapshots", "currentSnapshots", "mainChangedPaths", "branchChangedPaths", "receipts", "contractOverlapItemIds", "decisionCandidates", "readTargets", "findings", "excluded", "status", "bundleDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "kind": { "const": "integration-review-bundle" },
+    "project": { "$ref": "#/$defs/identity" },
+    "task": { "$ref": "#/$defs/task" },
+    "workspace": { "$ref": "#/$defs/workspace" },
+    "planDigest": { "$ref": "#/$defs/digest" },
+    "planSnapshots": { "$ref": "#/$defs/snapshots" },
+    "currentSnapshots": { "$ref": "#/$defs/snapshots" },
+    "mainChangedPaths": { "$ref": "#/$defs/paths" },
+    "branchChangedPaths": { "$ref": "#/$defs/paths" },
+    "receipts": { "type": "array", "items": { "$ref": "#/$defs/receiptSummary" } },
+    "contractOverlapItemIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "decisionCandidates": { "type": "array", "items": { "$ref": "#/$defs/decisionCandidate" } },
+    "readTargets": { "type": "array", "items": { "$ref": "#/$defs/readTarget" } },
+    "findings": { "type": "array", "items": { "type": "object" } },
+    "excluded": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "status": { "enum": ["reviewable", "blocked"] },
+    "bundleDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "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" } } },
+    "identity": { "type": "object", "additionalProperties": false, "required": ["id", "name"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "$ref": "#/$defs/text" } } },
+    "task": { "type": "object", "additionalProperties": false, "required": ["id", "title", "goal"], "properties": { "id": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/text" }, "goal": { "$ref": "#/$defs/text" } } },
+    "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" } } } },
+    "decisionCandidate": { "type": "object", "additionalProperties": false, "required": ["stageId", "decision"], "properties": { "stageId": { "$ref": "#/$defs/id" }, "decision": { "$ref": "#/$defs/text" } } },
+    "readTarget": { "type": "object", "additionalProperties": false, "required": ["path", "reason"], "properties": { "path": { "type": "string", "minLength": 1 }, "reason": { "enum": ["integration-conflict", "contract-source"] }, "sourceId": { "$ref": "#/$defs/id" } } }
+  }
+}