frontend-project-context 1.3.1 → 1.7.0

package/examples/README.md

@@ -8,6 +8,15 @@
 npm run context:setup -- --id my-project --name "My Project" --write --json
 ```
 
+为完全新窗口写入稳定入口并查询治理健康：
+
+```bash
+npm run context:entry -- --write --json
+npm run context:status -- --json
+```
+
+入口只拥有 `AGENTS.md` 标记区域；区域外人工内容可继续维护。首次写入会把 projection lock 从 schema 1 延迟升级为 schema 2，回退约束见根目录 `migration-manifest.json`。
+
 日常维护时生成只读变化工作单元：
 
 ```bash
@@ -24,14 +33,32 @@ npm run context:preflight -- --plan .project-context/action-plan.json --json
 采用分阶段上下文协议时，宿主必须把每份前序 Stage Receipt 与生成该 receipt 的 Stage Context Bundle 成对传入：
 
 ```bash
-npx project-context stage-context --project . --plan task-context-plan.json --stage stage-render \
+npm exec --offline -- project-context stage-context --project . --plan task-context-plan.json --stage stage-render \
   --receipt stage-understand.receipt.json --receipt-bundle stage-understand.bundle.json --json
-npx project-context integration-review --project . --plan task-context-plan.json \
+npm exec --offline -- project-context integration-review --project . --plan task-context-plan.json \
   --receipt stage-understand.receipt.json --receipt-bundle stage-understand.bundle.json --json
 ```
 
 两条命令都会重建 receipt 的输入 Bundle；缺失、重复、错配、篡改、过期 baseline、blocked bundle 或不完整依赖链均失败封闭，且不会创建 task store、读取 Git 或执行任务。
 
+如需把一次已经脱敏的目标项目观察交给人审查，先按 Evidence Input schema 1 准备项目内 JSON，再运行：
+
+```bash
+npm run context:evidence -- --input evidence-input.json --json
+```
+
+输出只到 stdout，永远标记 `human-review-required`，不会保存或上传。人工仍需检查两个自由文本 summary，再决定是否转交。
+
+Host 在产品边界外把依赖和 lockfile 固定到精确目标版本后，可生成短生命周期 assessment、单步 plan，并先 preview：
+
+```bash
+npm run context:upgrade-check -- --from-version 1.5.0 --json
+npm exec --offline -- project-context upgrade-plan --project . --assessment .project-context/upgrade-assessment.json --json
+npm exec --offline -- project-context upgrade-apply --project . --plan .project-context/migration-plan.json --json
+```
+
+只有人审查精确 plan 后才可为最后一条命令增加 `--write`。每次只执行一个产品自有迁移单元；包管理器、Git、项目测试、独立新窗口复核和临时工件清理由 Host 负责。
+
 团队和 CI 的只读 Gate：
 
 ```bash

package/examples/package.json

@@ -7,9 +7,13 @@
     "context:dashboard": "project-context dashboard --project .",
     "context:sync": "project-context sync --project .",
     "context:capabilities": "project-context capabilities --project .",
-    "context:preflight": "project-context preflight --project ."
+    "context:evidence": "project-context evidence --project .",
+    "context:status": "project-context status --project .",
+    "context:entry": "project-context publish-entry --project . --output AGENTS.md",
+    "context:preflight": "project-context preflight --project .",
+    "context:upgrade-check": "project-context upgrade-check --project ."
   },
   "devDependencies": {
-    "frontend-project-context": "1.3.1"
+    "frontend-project-context": "1.7.0"
   }
 }

package/migration-manifest.json

@@ -0,0 +1,110 @@
+{
+  "acceptanceCommands": ["npm run check", "project-context status --project . --json"],
+  "builtInMigrations": [
+    {
+      "id": "upgrade.republish-ai-entry.v1",
+      "input": {"beforeDigestRequired": true, "schemaVersions": [1, 2]},
+      "kind": "republish-ai-entry",
+      "reverseMigrationId": null,
+      "rollbackClass": "forward-only",
+      "targetType": "ai-entry",
+      "writes": true
+    },
+    {
+      "id": "upgrade.republish-projection.v1",
+      "input": {"beforeDigestRequired": true, "schemaVersions": [1, 2]},
+      "kind": "republish-projection",
+      "reverseMigrationId": null,
+      "rollbackClass": "forward-only",
+      "targetType": "projection",
+      "writes": true
+    }
+  ],
+  "consumerChanges": {
+    "actionPlan": {"reason": "Action Plan schema 1 and 2 readers remain compatible; writers remain schema 2.", "state": "preserve"},
+    "adaptiveContextBundle": {"reason": "Schema 1 Adaptive Context Bundles lack task lineage and strict withheld-delivery semantics; regenerate as schema 2.", "state": "regenerate"},
+    "capabilities": {"reason": "Consumers must branch on capabilities schema 7 and exchange protocol 7.", "state": "regenerate"},
+    "contextQuery": {"reason": "Context Query schema 1 is short-lived and must use current snapshots.", "state": "regenerate"},
+    "coverageAudit": {"reason": "Coverage Audit schema 1 is derived from the current Contract and filesystem evidence.", "state": "regenerate"},
+    "evidenceBundle": {"reason": "Evidence Bundle schema 1 remains readable and separate from upgrade results.", "state": "preserve"},
+    "evidenceInput": {"reason": "Evidence Input schema 1 remains readable and is never rewritten by upgrade.", "state": "preserve"},
+    "exchange": {"reason": "Exchange protocol capability metadata changes to version 7.", "state": "regenerate"},
+    "hostPromotionEvidence": {"reason": "Host Promotion Evidence is short-lived and remains bound to exact code, artifact, and Project Context snapshots.", "state": "regenerate"},
+    "integrationReviewBundle": {"reason": "Short-lived integration review bundles must be regenerated against current baselines.", "state": "regenerate"},
+    "reviewBundle": {"reason": "Review Bundle schema 2 remains readable but short-lived reviews must be regenerated when their baselines change.", "state": "regenerate"},
+    "routingIndex": {"reason": "Routing Index schema 1 is disposable derived data and must be rebuilt from the current Contract.", "state": "invalidate"},
+    "stageContextBundle": {"reason": "Short-lived stage context bundles must be regenerated against current receipts.", "state": "regenerate"},
+    "stageReceipt": {"reason": "Existing receipts remain evidence but do not grant next-stage or upgrade authority.", "state": "preserve"},
+    "taskContextPlan": {"reason": "Short-lived task plans must be regenerated when their project baselines change.", "state": "regenerate"}
+    ,"truthReconciliationInput": {"reason": "Schema 1 inputs lack previous-review-bound resolution attempts; regenerate as schema 2 from the current baseline.", "state": "regenerate"}
+    ,"truthReconciliationReviewBundle": {"reason": "Schema 1 reviews lack finding digests and machine-verifiable resolution outcomes; recompute as schema 2.", "state": "regenerate"}
+  },
+  "externalEffects": {"automaticUpgrade": false, "businessCode": false, "git": false, "network": false, "packageManager": false, "projectTests": false},
+  "manifestDigest": "sha256:34b1b611ebf31471f2e136eb3f84ad627df612998d0358654e7cdde4713de777",
+  "package": {"name": "frontend-project-context", "version": "1.7.0"},
+  "paths": [
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.3.1",
+      "migrationIds": ["upgrade.republish-ai-entry.v1", "upgrade.republish-projection.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.4.0",
+      "migrationIds": ["upgrade.republish-ai-entry.v1", "upgrade.republish-projection.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.5.0",
+      "migrationIds": ["upgrade.republish-ai-entry.v1", "upgrade.republish-projection.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.6.0",
+      "migrationIds": ["upgrade.republish-ai-entry.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
+    }
+  ],
+  "protocols": {
+    "actionPlan": {"readable": [1, 2], "written": 2},
+    "adaptiveContextBundle": {"readable": [2], "written": 2},
+    "contextQuery": {"readable": [2], "written": 2},
+    "coverageAudit": {"readable": [1], "written": 1},
+    "evidenceBundle": {"readable": [1], "written": 1},
+    "evidenceInput": {"readable": [1], "written": 1},
+    "exchange": {"readable": [4, 5, 6, 7], "written": 7},
+    "hostPromotionEvidence": {"readable": [1], "written": 1},
+    "integrationReviewBundle": {"readable": [1], "written": 1},
+    "reviewBundle": {"readable": [1, 2], "written": 2},
+    "routingIndex": {"readable": [1, 2], "written": 2},
+    "stageContextBundle": {"readable": [1], "written": 1},
+    "stageReceipt": {"readable": [1], "written": 1},
+    "taskContextPlan": {"readable": [1], "written": 1},
+    "truthReconciliationInput": {"readable": [2], "written": 2},
+    "truthReconciliationReviewBundle": {"readable": [2], "written": 2}
+  },
+  "renderers": {
+    "aiEntry": {"readable": [1, 2, 3], "written": 3},
+    "projection": {"readable": [1, 2, 3], "written": 3}
+  },
+  "rollback": {"automatic": false, "defaultClass": "package-only", "externalRestoreRequired": true},
+  "schemaVersion": 2,
+  "stores": {
+    "contract": {"readable": [1, 2], "written": [1, 2]},
+    "projectionLock": {"readable": [1, 2], "written": [1, 2]},
+    "proposal": {"readable": [1], "written": [1]},
+    "sourceLock": {"readable": [1], "written": [1]}
+  },
+  "upgradeFrom": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-project-context",
-  "version": "1.3.1",
+  "version": "1.7.0",
   "description": "Govern, compile, and verify project-local context for AI coding tools.",
   "private": false,
   "publishConfig": {
@@ -16,6 +16,7 @@
     "schemas/",
     "docs/",
     "examples/",
+    "migration-manifest.json",
     "CHANGELOG.md",
     "UPGRADING.md",
     "LICENSE",
@@ -26,7 +27,7 @@
   },
   "scripts": {
     "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",
+    "test": "node --test test/project-context/acceptance.test.mjs test/project-context/adaptive-context.test.mjs test/project-context/adaptive-delivery-v2.test.mjs test/project-context/assist.test.mjs test/project-context/cli.test.mjs test/project-context/dashboard.test.mjs test/project-context/evidence.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/project-context/takeover.test.mjs test/project-context/truth-reconciliation.test.mjs test/project-context/upgrade.test.mjs test/release/acceptance.test.mjs",
     "prepack": "npm run check"
   },
   "engines": {

package/schemas/action-plan.schema.json

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:action-plan:1",
+  "$id": "urn:frontend-project-context:schema:action-plan:2",
   "title": "Frontend Project Context Action Plan",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "projectId", "baselines", "actions"],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "enum": [1, 2] },
     "projectId": { "$ref": "#/$defs/id" },
     "baselines": { "$ref": "#/$defs/baselines" },
     "actions": {
@@ -21,7 +21,9 @@
           { "$ref": "#/$defs/deprecateItem" },
           { "$ref": "#/$defs/deprecateSource" },
           { "$ref": "#/$defs/requestItemApproval" },
-          { "$ref": "#/$defs/publishProjection" }
+          { "$ref": "#/$defs/publishProjection" },
+          { "$ref": "#/$defs/publishAiEntry" },
+          { "$ref": "#/$defs/removeAiEntry" }
         ]
       }
     }
@@ -226,6 +228,32 @@
         }
       }
     },
+    "entryActionInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["output"],
+      "properties": { "output": { "$ref": "#/$defs/path" } }
+    },
+    "publishAiEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "publish-ai-entry" },
+        "input": { "$ref": "#/$defs/entryActionInput" }
+      }
+    },
+    "removeAiEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "input"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "kind": { "const": "remove-ai-entry" },
+        "input": { "$ref": "#/$defs/entryActionInput" }
+      }
+    },
     "publishProjection": {
       "type": "object",
       "additionalProperties": false,

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

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:adaptive-context-bundle:2",
+  "title": "Frontend Project Context Adaptive Context Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "task", "queryDigest", "taskDigest", "level", "expansionDepth", "snapshots", "routing", "guarantees", "globalHealth", "taskHealth", "targetStates", "hydratedItems", "retainedItemIds", "deferredItems", "sources", "evidenceEdges", "readTargets", "findings", "excluded", "metrics", "budget", "delivery", "bundleDigest"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "kind": { "const": "adaptive-context-bundle" },
+    "project": { "type": "object", "additionalProperties": false, "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } },
+    "task": { "$ref": "context-query.schema.json#/properties/task" },
+    "queryDigest": { "$ref": "#/$defs/digest" },
+    "taskDigest": { "$ref": "#/$defs/digest" },
+    "previousBundleDigest": { "$ref": "#/$defs/digest" },
+    "level": { "enum": ["initial", "expanded", "complete"] },
+    "expansionDepth": { "type": "integer", "minimum": 0, "maximum": 1 },
+    "snapshots": { "$ref": "context-query.schema.json#/$defs/snapshots" },
+    "routing": { "type": "object", "additionalProperties": false, "required": ["indexDigest", "indexState"], "properties": { "indexDigest": { "$ref": "#/$defs/digest" }, "indexState": { "enum": ["current", "invalid-rebuilt-in-memory", "stale-rebuilt-in-memory", "missing-rebuilt-in-memory"] }, "rejectedDigest": { "$ref": "#/$defs/digest" } } },
+    "guarantees": { "type": "object", "additionalProperties": false, "required": ["registrationCoverage", "mandatoryCoverage", "declaredDependencyCoverage", "retrievalStatus", "semanticCompleteness", "freshness"], "properties": { "registrationCoverage": { "type": "string" }, "mandatoryCoverage": { "enum": ["complete", "blocked"] }, "declaredDependencyCoverage": { "enum": ["complete", "missing", "not-declared"] }, "retrievalStatus": { "enum": ["matched", "no-candidate", "ambiguous", "complete"] }, "semanticCompleteness": { "const": "not-claimed" }, "freshness": { "enum": ["strict-current", "snapshot-and-signal-bound"] } } },
+    "globalHealth": { "enum": ["clean", "attention", "conflict", "not-checked", "snapshot-stale"] },
+    "taskHealth": { "enum": ["ready", "needs-expansion", "blocked"] },
+    "targetStates": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["path", "state"], "properties": { "path": { "type": "string" }, "state": { "enum": ["existing", "prospective-or-deleted"] } } } },
+    "hydratedItems": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "subject", "value", "statement", "scope", "sourceIds", "overrides", "selectionReasons", "itemDigest"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["fact", "policy", "reference", "validation-description"] }, "subject": { "$ref": "#/$defs/id" }, "value": {}, "statement": { "type": "string", "minLength": 1 }, "scope": { "$ref": "#/$defs/scope" }, "sourceIds": { "$ref": "#/$defs/ids" }, "overrides": { "$ref": "#/$defs/ids" }, "verification": {}, "selectionReasons": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }, "itemDigest": { "$ref": "#/$defs/digest" } } } },
+    "retainedItemIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "deferredItems": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "subject", "scope", "sourceIds", "itemDigest", "reason"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["fact", "policy", "reference", "validation-description"] }, "subject": { "$ref": "#/$defs/id" }, "scope": { "$ref": "#/$defs/scope" }, "sourceIds": { "$ref": "#/$defs/ids" }, "itemDigest": { "$ref": "#/$defs/digest" }, "reason": { "const": "applicable-not-selected" } } } },
+    "sources": { "type": "array", "items": { "$ref": "#/$defs/sourceEvidence" } },
+    "evidenceEdges": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["itemId", "sourceId"], "properties": { "itemId": { "type": "string" }, "sourceId": { "type": "string" } } } },
+    "readTargets": { "type": "array", "items": { "$ref": "#/$defs/readTarget" } },
+    "findings": { "type": "array", "items": { "$ref": "#/$defs/finding" } },
+    "excluded": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "metrics": { "type": "object", "additionalProperties": false, "required": ["sourceDigestReads", "sourceBodyReads", "sourceIdentityReads", "hydratedItemCount", "retainedItemCount", "deferredItemCount", "hostToolCalls"], "properties": { "sourceDigestReads": { "type": "integer" }, "sourceBodyReads": { "type": "integer" }, "sourceIdentityReads": { "type": "integer" }, "hydratedItemCount": { "type": "integer" }, "retainedItemCount": { "type": "integer" }, "deferredItemCount": { "type": "integer" }, "hostToolCalls": { "const": 1 } } },
+    "budget": { "type": "object", "additionalProperties": false, "required": ["unit", "audit", "delivery", "readTargets"], "properties": { "unit": { "const": "canonical-utf8-bytes" }, "audit": { "$ref": "#/$defs/auditBudget" }, "delivery": { "$ref": "#/$defs/deliveryBudget" }, "readTargets": { "$ref": "#/$defs/readBudget" } } },
+    "delivery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "format", "mode", "itemIds", "contentDigest", "utf8Bytes"],
+      "properties": {
+        "status": { "enum": ["ready", "withheld"] },
+        "format": { "const": "project-context-markdown" },
+        "mode": { "type": ["string", "null"], "enum": ["adaptive", "complete", null] },
+        "itemIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+        "contentDigest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+        "utf8Bytes": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "bundleDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "nullableDigest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "scope": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "project" } } },
+      { "type": "object", "additionalProperties": false, "required": ["kind", "path"], "properties": { "kind": { "enum": ["path-prefix", "file"] }, "path": { "type": "string", "minLength": 1 } } }
+    ] },
+    "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 } } }
+    ] },
+    "sourceEvidence": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "locator", "sourceDigest", "freshness"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "type": "string", "minLength": 1 }, "locator": { "$ref": "#/$defs/locator" }, "sourceDigest": { "$ref": "#/$defs/digest" }, "freshness": { "enum": ["current", "drifted", "unreadable", "unverifiable-non-local"] }, "expectedDigest": { "$ref": "#/$defs/nullableDigest" }, "actualDigest": { "$ref": "#/$defs/nullableDigest" } } },
+    "readTarget": { "type": "object", "additionalProperties": false, "required": ["path", "reason"], "properties": { "path": { "type": "string", "minLength": 1 }, "reason": { "enum": ["task-target", "host-changed-path-signal", "contract-source"] }, "sourceId": { "$ref": "#/$defs/id" } } },
+    "finding": { "type": "object", "additionalProperties": false, "required": ["code", "severity"], "properties": { "code": { "type": "string", "minLength": 1 }, "severity": { "enum": ["attention", "needs-expansion", "blocked"] }, "itemId": { "$ref": "#/$defs/id" }, "requiredItemId": { "$ref": "#/$defs/id" }, "sourceId": { "$ref": "#/$defs/id" }, "subject": { "$ref": "#/$defs/id" }, "itemIds": { "$ref": "#/$defs/ids" }, "path": { "type": "string", "minLength": 1 }, "paths": { "$ref": "#/$defs/paths" }, "expected": {}, "actual": {}, "expectedDigest": { "$ref": "#/$defs/nullableDigest" }, "actualDigest": { "$ref": "#/$defs/nullableDigest" }, "reason": { "type": "string", "minLength": 1 }, "state": { "type": "string", "minLength": 1 }, "target": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 0 }, "required": { "type": "integer", "minimum": 0 }, "conflicts": { "type": "array" }, "projectFinding": {} } },
+    "auditBudget": { "type": "object", "additionalProperties": false, "required": ["targetUtf8Bytes", "maxUtf8Bytes", "usedUtf8Bytes"], "properties": { "targetUtf8Bytes": { "type": "integer", "minimum": 1 }, "maxUtf8Bytes": { "type": "integer", "minimum": 1 }, "usedUtf8Bytes": { "type": "integer", "minimum": 1 } } },
+    "deliveryBudget": { "type": "object", "additionalProperties": false, "required": ["completeBelowUtf8Bytes", "maxUtf8Bytes", "usedUtf8Bytes"], "properties": { "completeBelowUtf8Bytes": { "type": "integer", "minimum": 1 }, "maxUtf8Bytes": { "type": "integer", "minimum": 1 }, "usedUtf8Bytes": { "type": "integer", "minimum": 0 } } },
+    "readBudget": { "type": "object", "additionalProperties": false, "required": ["target", "max", "count"], "properties": { "target": { "type": "integer", "minimum": 1 }, "max": { "type": "integer", "minimum": 1 }, "count": { "type": "integer", "minimum": 0 } } }
+  }
+}

package/schemas/capabilities.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:capabilities:1",
+  "$id": "urn:frontend-project-context:schema:capabilities:7",
   "title": "Frontend Project Context Capabilities",
   "type": "object",
   "additionalProperties": false,
@@ -18,58 +18,92 @@
     "boundaries"
   ],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 7 },
     "package": {
       "type": "object",
       "additionalProperties": false,
       "required": ["name", "version"],
       "properties": {
         "name": { "const": "frontend-project-context" },
-        "version": { "type": "string" }
+        "version": { "const": "1.7.0" }
       }
     },
-    "exchangeProtocolVersion": { "const": 1 },
+    "exchangeProtocolVersion": { "const": 7 },
     "schemas": {
       "type": "object",
       "additionalProperties": false,
       "required": [
         "actionPlan",
+        "adaptiveContextBundle",
         "assistBundle",
         "capabilities",
         "contract",
+        "contextQuery",
+        "coverageAudit",
         "dashboardViewModel",
+        "evidenceBundle",
+        "evidenceInput",
+        "hostPromotionEvidence",
         "integrationReviewBundle",
         "projectionLock",
+        "projectionLockReadable",
+        "projectionLockWritten",
         "projectionRenderer",
         "proposal",
+        "projectStatus",
+        "aiEntryRenderer",
+        "migrationManifest",
+        "migrationPlan",
         "reviewBundle",
+        "routingIndex",
         "sourceLock",
         "stageContextBundle",
         "stageReceipt",
-        "taskContextPlan"
+        "taskContextPlan",
+        "truthReconciliationInput",
+        "truthReconciliationReviewBundle",
+        "upgradeAssessment",
+        "upgradeResultBundle"
       ],
       "properties": {
-        "actionPlan": { "const": 1 },
+        "actionPlan": { "const": 2 },
+        "adaptiveContextBundle": { "const": 2 },
         "assistBundle": { "const": 1 },
-        "capabilities": { "const": 1 },
-        "contract": { "type": "integer" },
+        "capabilities": { "const": 7 },
+        "contract": { "const": 2 },
+        "contextQuery": { "const": 2 },
+        "coverageAudit": { "const": 1 },
         "dashboardViewModel": { "type": "integer" },
+        "evidenceBundle": { "const": 1 },
+        "evidenceInput": { "const": 1 },
+        "hostPromotionEvidence": { "const": 1 },
         "integrationReviewBundle": { "const": 1 },
-        "projectionLock": { "type": "integer" },
+        "projectionLock": { "const": 2 },
+        "projectionLockReadable": { "const": [1, 2] },
+        "projectionLockWritten": { "enum": [1, 2] },
         "projectionRenderer": { "type": "integer" },
-        "proposal": { "type": "integer" },
-        "reviewBundle": { "const": 1 },
-        "sourceLock": { "type": "integer" },
+        "proposal": { "const": 1 },
+        "projectStatus": { "const": 1 },
+        "aiEntryRenderer": { "const": 3 },
+        "migrationManifest": { "const": 2 },
+        "migrationPlan": { "const": 1 },
+        "reviewBundle": { "const": 2 },
+        "routingIndex": { "const": 2 },
+        "sourceLock": { "const": 1 },
         "stageContextBundle": { "const": 1 },
         "stageReceipt": { "const": 1 },
-        "taskContextPlan": { "const": 1 }
+        "taskContextPlan": { "const": 1 },
+        "truthReconciliationInput": { "const": 2 },
+        "truthReconciliationReviewBundle": { "const": 2 },
+        "upgradeAssessment": { "const": 1 },
+        "upgradeResultBundle": { "const": 1 }
       }
     },
-    "commands": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } },
+    "commands": { "type": "array", "minItems": 1, "uniqueItems": true, "allOf": [{"contains": {"const": "upgrade-check"}}, {"contains": {"const": "upgrade-plan"}}, {"contains": {"const": "upgrade-apply"}}], "items": { "type": "string" } },
     "actionKinds": {
       "type": "array",
-      "minItems": 8,
-      "maxItems": 8,
+      "minItems": 10,
+      "maxItems": 10,
       "uniqueItems": true,
       "items": {
         "enum": [
@@ -77,8 +111,10 @@
           "deprecate-item",
           "deprecate-source",
           "propose-item",
+          "publish-ai-entry",
           "publish-projection",
           "register-source",
+          "remove-ai-entry",
           "request-item-approval",
           "revise-item"
         ]
@@ -125,7 +161,12 @@
         "stagePathBodyReads",
         "applyPlan",
         "scheduler",
-        "daemon"
+        "daemon",
+        "telemetry",
+        "selfUpdate",
+        "automaticEvidenceUpload",
+        "packageManager",
+        "automaticUpgrade"
       ],
       "properties": {
         "provider": { "const": false },
@@ -139,7 +180,12 @@
         "stagePathBodyReads": { "const": false },
         "applyPlan": { "const": false },
         "scheduler": { "const": false },
-        "daemon": { "const": false }
+        "daemon": { "const": false },
+        "telemetry": { "const": false },
+        "selfUpdate": { "const": false },
+        "automaticEvidenceUpload": { "const": false },
+        "packageManager": { "const": false },
+        "automaticUpgrade": { "const": false }
       }
     }
   }

package/schemas/context-query.schema.json

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

package/schemas/coverage-audit.schema.json

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