frontend-project-context 1.7.0 → 1.9.1

package/docs/assets/product-sharing-01-overview.svg

@@ -0,0 +1,32 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="520" viewBox="0 0 1200 520" role="img" aria-labelledby="title desc">
+  <title id="title">从分散知识到统一项目上下文</title>
+  <desc id="desc">分散的文档、配置和人工决定经过 Frontend Project Context，变成同一份可信上下文，供不同 AI 工具使用。</desc>
+  <defs>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%"><feDropShadow dx="0" dy="8" stdDeviation="12" flood-color="#0f172a" flood-opacity=".12"/></filter>
+    <marker id="arrow" markerWidth="12" markerHeight="12" refX="10" refY="6" orient="auto"><path d="M0,0 L12,6 L0,12 Z" fill="#64748b"/></marker>
+  </defs>
+  <rect width="1200" height="520" rx="28" fill="#f8fafc"/>
+  <text x="600" y="54" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="28" font-weight="700" fill="#0f172a">把“到处找规则”变成“从同一份上下文开工”</text>
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" filter="url(#shadow)">
+    <rect x="60" y="105" width="260" height="74" rx="16" fill="#fff"/><circle cx="98" cy="142" r="20" fill="#dbeafe"/><path d="M89 132h18v21H89zM93 127h10l4 5H89z" fill="#2563eb"/><text x="132" y="150" font-size="21" fill="#1e293b">设计与业务文档</text>
+    <rect x="60" y="205" width="260" height="74" rx="16" fill="#fff"/><circle cx="98" cy="242" r="20" fill="#fef3c7"/><path d="M86 237h24v13H86zM90 232h16v5H90z" fill="#d97706"/><text x="132" y="250" font-size="21" fill="#1e293b">配置与代码事实</text>
+    <rect x="60" y="305" width="260" height="74" rx="16" fill="#fff"/><circle cx="98" cy="342" r="20" fill="#ede9fe"/><path d="M88 342l7 7 14-17" fill="none" stroke="#7c3aed" stroke-width="5" stroke-linecap="round"/><text x="132" y="350" font-size="21" fill="#1e293b">团队的人工决定</text>
+  </g>
+  <path d="M350 242H438" stroke="#64748b" stroke-width="4" marker-end="url(#arrow)"/>
+  <g filter="url(#shadow)" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif">
+    <rect x="465" y="130" width="300" height="225" rx="28" fill="#1d4ed8"/>
+    <circle cx="615" cy="198" r="38" fill="#60a5fa"/><path d="M597 198h36M615 180v36" stroke="#fff" stroke-width="6" stroke-linecap="round"/>
+    <text x="615" y="270" text-anchor="middle" font-size="22" font-weight="700" fill="#fff">Frontend Project Context</text>
+    <text x="615" y="308" text-anchor="middle" font-size="20" fill="#dbeafe">统一、筛选、追溯、检查</text>
+  </g>
+  <path d="M792 242H866" stroke="#64748b" stroke-width="4" marker-end="url(#arrow)"/>
+  <g filter="url(#shadow)" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif">
+    <rect x="895" y="112" width="245" height="260" rx="26" fill="#fff"/>
+    <rect x="930" y="143" width="175" height="72" rx="14" fill="#ecfdf5"/><circle cx="966" cy="179" r="18" fill="#10b981"/><text x="966" y="186" text-anchor="middle" font-size="18" font-weight="700" fill="#fff">AI</text><text x="995" y="186" font-size="19" fill="#14532d">工具 A</text>
+    <rect x="930" y="228" width="175" height="72" rx="14" fill="#eff6ff"/><circle cx="966" cy="264" r="18" fill="#3b82f6"/><text x="966" y="271" text-anchor="middle" font-size="18" font-weight="700" fill="#fff">AI</text><text x="995" y="271" font-size="19" fill="#1e3a8a">工具 B</text>
+    <text x="1018" y="337" text-anchor="middle" font-size="18" fill="#475569">同一份项目上下文</text>
+  </g>
+  <text x="190" y="425" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="18" fill="#64748b">分散、难找、可能过期</text>
+  <text x="615" y="425" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="18" fill="#64748b">人工确认后才生效</text>
+  <text x="1018" y="425" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="18" fill="#64748b">换工具不再重新解释</text>
+</svg>

package/docs/assets/product-sharing-02-how-it-works.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="430" viewBox="0 0 1200 430" role="img" aria-labelledby="title desc">
+  <title id="title">Frontend Project Context 的四步工作方式</title>
+  <desc id="desc">从找到可靠来源，经过人工确认，按任务选择内容，到变化时提醒复核。</desc>
+  <defs><marker id="arrow" markerWidth="12" markerHeight="12" refX="10" refY="6" orient="auto"><path d="M0,0 L12,6 L0,12 Z" fill="#94a3b8"/></marker></defs>
+  <rect width="1200" height="430" rx="28" fill="#0f172a"/>
+  <text x="600" y="58" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="28" font-weight="700" fill="#fff">只需要理解四个动作</text>
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif">
+    <g><rect x="55" y="112" width="235" height="220" rx="24" fill="#fff"/><circle cx="172" cy="168" r="34" fill="#dbeafe"/><text x="172" y="179" text-anchor="middle" font-size="30" font-weight="700" fill="#2563eb">1</text><text x="172" y="231" text-anchor="middle" font-size="24" font-weight="700" fill="#0f172a">找来源</text><text x="172" y="270" text-anchor="middle" font-size="18" fill="#64748b">知道信息从哪来</text><text x="172" y="299" text-anchor="middle" font-size="18" fill="#64748b">不把传言当规则</text></g>
+    <path d="M300 222H332" stroke="#94a3b8" stroke-width="4" marker-end="url(#arrow)"/>
+    <g><rect x="345" y="112" width="235" height="220" rx="24" fill="#fff"/><circle cx="462" cy="168" r="34" fill="#dcfce7"/><text x="462" y="179" text-anchor="middle" font-size="30" font-weight="700" fill="#16a34a">2</text><text x="462" y="231" text-anchor="middle" font-size="24" font-weight="700" fill="#0f172a">人确认</text><text x="462" y="270" text-anchor="middle" font-size="18" fill="#64748b">AI 可以提议</text><text x="462" y="299" text-anchor="middle" font-size="18" fill="#64748b">人决定是否生效</text></g>
+    <path d="M590 222H622" stroke="#94a3b8" stroke-width="4" marker-end="url(#arrow)"/>
+    <g><rect x="635" y="112" width="235" height="220" rx="24" fill="#fff"/><circle cx="752" cy="168" r="34" fill="#fef3c7"/><text x="752" y="179" text-anchor="middle" font-size="30" font-weight="700" fill="#d97706">3</text><text x="752" y="231" text-anchor="middle" font-size="24" font-weight="700" fill="#0f172a">按任务给</text><text x="752" y="270" text-anchor="middle" font-size="18" fill="#64748b">只给当前需要的</text><text x="752" y="299" text-anchor="middle" font-size="18" fill="#64748b">不用每次读全部</text></g>
+    <path d="M880 222H912" stroke="#94a3b8" stroke-width="4" marker-end="url(#arrow)"/>
+    <g><rect x="925" y="112" width="220" height="220" rx="24" fill="#fff"/><circle cx="1035" cy="168" r="34" fill="#fee2e2"/><text x="1035" y="179" text-anchor="middle" font-size="30" font-weight="700" fill="#dc2626">4</text><text x="1035" y="231" text-anchor="middle" font-size="24" font-weight="700" fill="#0f172a">变了提醒</text><text x="1035" y="270" text-anchor="middle" font-size="18" fill="#64748b">规则过期时报告</text><text x="1035" y="299" text-anchor="middle" font-size="18" fill="#64748b">不自动猜测修复</text></g>
+  </g>
+  <text x="600" y="385" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="20" fill="#cbd5e1">核心原则：上下文属于项目和团队，人保留最终决定权</text>
+</svg>

package/docs/assets/product-sharing-03-example.svg

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="500" viewBox="0 0 1200 500" role="img" aria-labelledby="title desc">
+  <title id="title">不同模块获得不同的精准上下文</title>
+  <desc id="desc">全局规则适用于整个项目，航班规则只传递给航班任务，酒店规则只传递给酒店任务。</desc>
+  <defs><marker id="blueArrow" markerWidth="12" markerHeight="12" refX="10" refY="6" orient="auto"><path d="M0,0 L12,6 L0,12 Z" fill="#3b82f6"/></marker><marker id="greenArrow" markerWidth="12" markerHeight="12" refX="10" refY="6" orient="auto"><path d="M0,0 L12,6 L0,12 Z" fill="#10b981"/></marker></defs>
+  <rect width="1200" height="500" rx="28" fill="#f8fafc"/>
+  <text x="600" y="52" text-anchor="middle" font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif" font-size="28" font-weight="700" fill="#0f172a">不是给得越多越好，而是给得越准越好</text>
+  <g font-family="-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC',sans-serif">
+    <rect x="55" y="98" width="290" height="92" rx="20" fill="#0f172a"/><text x="200" y="137" text-anchor="middle" font-size="22" font-weight="700" fill="#fff">全项目共同规则</text><text x="200" y="169" text-anchor="middle" font-size="17" fill="#cbd5e1">例：接口错误处理原则</text>
+    <rect x="55" y="226" width="290" height="92" rx="20" fill="#dbeafe"/><text x="200" y="265" text-anchor="middle" font-size="22" font-weight="700" fill="#1d4ed8">航班模块规则</text><text x="200" y="297" text-anchor="middle" font-size="17" fill="#1e40af">例：统一价格明细</text>
+    <rect x="55" y="354" width="290" height="92" rx="20" fill="#d1fae5"/><text x="200" y="393" text-anchor="middle" font-size="22" font-weight="700" fill="#047857">酒店模块规则</text><text x="200" y="425" text-anchor="middle" font-size="17" fill="#065f46">例：房型和入住人校验</text>
+    <rect x="515" y="130" width="280" height="250" rx="28" fill="#fff" stroke="#cbd5e1" stroke-width="2"/><circle cx="655" cy="202" r="42" fill="#2563eb"/><text x="655" y="212" text-anchor="middle" font-size="24" font-weight="700" fill="#fff">AI</text><text x="655" y="276" text-anchor="middle" font-size="24" font-weight="700" fill="#0f172a">当前任务</text><text x="655" y="315" text-anchor="middle" font-size="20" fill="#475569">修改航班价格页面</text><rect x="570" y="338" width="170" height="28" rx="14" fill="#eff6ff"/><text x="655" y="358" text-anchor="middle" font-size="15" fill="#1d4ed8">目标：src/flight</text>
+    <path d="M355 144C430 144 430 190 500 190" fill="none" stroke="#64748b" stroke-width="4" marker-end="url(#blueArrow)"/>
+    <path d="M355 272C430 272 430 250 500 250" fill="none" stroke="#3b82f6" stroke-width="6" marker-end="url(#blueArrow)"/>
+    <path d="M355 400C440 400 438 334 500 322" fill="none" stroke="#cbd5e1" stroke-width="4" stroke-dasharray="9 9"/>
+    <circle cx="468" cy="340" r="15" fill="#fff" stroke="#ef4444" stroke-width="3"/><path d="M461 333l14 14M475 333l-14 14" stroke="#ef4444" stroke-width="3"/>
+    <rect x="875" y="150" width="270" height="210" rx="26" fill="#eff6ff" stroke="#93c5fd" stroke-width="2"/><text x="1010" y="198" text-anchor="middle" font-size="23" font-weight="700" fill="#1e3a8a">AI 本次拿到</text><text x="915" y="247" font-size="19" fill="#1e3a8a">✓ 全项目共同规则</text><text x="915" y="286" font-size="19" fill="#1e3a8a">✓ 航班模块规则</text><text x="915" y="325" font-size="19" fill="#64748b">— 不带入酒店规则</text>
+    <path d="M810 255H855" stroke="#10b981" stroke-width="5" marker-end="url(#greenArrow)"/>
+  </g>
+</svg>

package/examples/README.md

@@ -2,10 +2,10 @@
 
 包实际发布后，把 [package.json](./package.json) 中的脚本和 devDependency 合并到项目，并把 [project-context-check.yml](./project-context-check.yml) 复制到 `.github/workflows/project-context-check.yml`。
 
-维护者首次初始化：
+维护者首次初始化前先读取包内唯一指令；后续命令由该指令和一次集中语义确认驱动：
 
 ```bash
-npm run context:setup -- --id my-project --name "My Project" --write --json
+npm exec --offline -- project-context instructions --project . --prompt
 ```
 
 为完全新窗口写入稳定入口并查询治理健康：

package/examples/package.json

@@ -14,6 +14,6 @@
     "context:upgrade-check": "project-context upgrade-check --project ."
   },
   "devDependencies": {
-    "frontend-project-context": "1.7.0"
+    "frontend-project-context": "1.9.1"
   }
 }

package/migration-manifest.json

@@ -23,14 +23,17 @@
   "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"},
+    "capabilities": {"reason": "Consumers must branch on capabilities schema 9 and exchange protocol 9.", "state": "regenerate"},
+    "contextBundle": {"reason": "Context Bundle schema 1 is short-lived and must be regenerated from the current Contract and exact task paths.", "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"},
+    "coverageAudit": {"reason": "Coverage Audit schema 2 is derived from the current Contract and declared coverage profile.", "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"},
+    "exchange": {"reason": "Exchange protocol capability metadata changes to version 9.", "state": "regenerate"},
     "hostPromotionEvidence": {"reason": "Host Promotion Evidence is short-lived and remains bound to exact code, artifact, and Project Context snapshots.", "state": "regenerate"},
+    "initializationInstruction": {"reason": "Schema 2 adds concentrated human entry rule dispositions and remains package-derived.", "state": "regenerate"},
     "integrationReviewBundle": {"reason": "Short-lived integration review bundles must be regenerated against current baselines.", "state": "regenerate"},
+    "projectStatus": {"reason": "Schema 2 separates governance health from Contract readiness and task-context routing.", "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"},
@@ -40,8 +43,8 @@
     ,"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"},
+  "manifestDigest": "sha256:8b1a6bce6ac179591b122593c062cf6d0f80680da1eca5aba663e3273bbd1e56",
+  "package": {"name": "frontend-project-context", "version": "1.9.1"},
   "paths": [
     {
       "acceptance": ["project-context-clean", "target-renderers-current"],
@@ -74,18 +77,45 @@
       "migrationIds": ["upgrade.republish-ai-entry.v1"],
       "requiresHumanReview": false,
       "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.7.0",
+      "migrationIds": ["upgrade.republish-ai-entry.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.8.0",
+      "migrationIds": ["upgrade.republish-ai-entry.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.9.0",
+      "migrationIds": [],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
     }
   ],
   "protocols": {
     "actionPlan": {"readable": [1, 2], "written": 2},
     "adaptiveContextBundle": {"readable": [2], "written": 2},
+    "contextBundle": {"readable": [1], "written": 1},
     "contextQuery": {"readable": [2], "written": 2},
-    "coverageAudit": {"readable": [1], "written": 1},
+    "coverageAudit": {"readable": [1, 2], "written": 2},
     "evidenceBundle": {"readable": [1], "written": 1},
     "evidenceInput": {"readable": [1], "written": 1},
-    "exchange": {"readable": [4, 5, 6, 7], "written": 7},
+    "exchange": {"readable": [4, 5, 6, 7, 8, 9], "written": 9},
     "hostPromotionEvidence": {"readable": [1], "written": 1},
+    "initializationInstruction": {"readable": [1, 2], "written": 2},
     "integrationReviewBundle": {"readable": [1], "written": 1},
+    "projectStatus": {"readable": [1, 2], "written": 2},
     "reviewBundle": {"readable": [1, 2], "written": 2},
     "routingIndex": {"readable": [1, 2], "written": 2},
     "stageContextBundle": {"readable": [1], "written": 1},
@@ -95,16 +125,16 @@
     "truthReconciliationReviewBundle": {"readable": [2], "written": 2}
   },
   "renderers": {
-    "aiEntry": {"readable": [1, 2, 3], "written": 3},
+    "aiEntry": {"readable": [1, 2, 3, 4, 5], "written": 5},
     "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]},
+    "contract": {"readable": [1, 2, 3], "written": [1, 2, 3]},
     "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"]
+  "upgradeFrom": ["1.3.1", "1.4.0", "1.5.0", "1.6.0", "1.7.0", "1.8.0", "1.9.0"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-project-context",
-  "version": "1.7.0",
+  "version": "1.9.1",
   "description": "Govern, compile, and verify project-local context for AI coding tools.",
   "private": false,
   "publishConfig": {
@@ -27,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/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",
+    "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/onboarding-closure.test.mjs test/project-context/source-lifecycle.test.mjs test/project-context/task-context.test.mjs test/project-context/task-context-consumption.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/capabilities.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:capabilities:7",
+  "$id": "urn:frontend-project-context:schema:capabilities:9",
   "title": "Frontend Project Context Capabilities",
   "type": "object",
   "additionalProperties": false,
@@ -12,23 +12,24 @@
     "commands",
     "actionKinds",
     "contextBudget",
+    "initializationInstruction",
     "initialization",
     "initialized",
     "project",
     "boundaries"
   ],
   "properties": {
-    "schemaVersion": { "const": 7 },
+    "schemaVersion": { "const": 9 },
     "package": {
       "type": "object",
       "additionalProperties": false,
       "required": ["name", "version"],
       "properties": {
         "name": { "const": "frontend-project-context" },
-        "version": { "const": "1.7.0" }
+        "version": { "const": "1.9.1" }
       }
     },
-    "exchangeProtocolVersion": { "const": 7 },
+    "exchangeProtocolVersion": { "const": 9 },
     "schemas": {
       "type": "object",
       "additionalProperties": false,
@@ -38,6 +39,8 @@
         "assistBundle",
         "capabilities",
         "contract",
+        "contractReadable",
+        "contextBundle",
         "contextQuery",
         "coverageAudit",
         "dashboardViewModel",
@@ -45,6 +48,7 @@
         "evidenceInput",
         "hostPromotionEvidence",
         "integrationReviewBundle",
+        "initializationInstruction",
         "projectionLock",
         "projectionLockReadable",
         "projectionLockWritten",
@@ -69,22 +73,25 @@
         "actionPlan": { "const": 2 },
         "adaptiveContextBundle": { "const": 2 },
         "assistBundle": { "const": 1 },
-        "capabilities": { "const": 7 },
-        "contract": { "const": 2 },
+        "capabilities": { "const": 9 },
+        "contract": { "const": 3 },
+        "contractReadable": { "const": [1, 2, 3] },
+        "contextBundle": { "const": 1 },
         "contextQuery": { "const": 2 },
-        "coverageAudit": { "const": 1 },
+        "coverageAudit": { "const": 2 },
         "dashboardViewModel": { "type": "integer" },
         "evidenceBundle": { "const": 1 },
         "evidenceInput": { "const": 1 },
         "hostPromotionEvidence": { "const": 1 },
         "integrationReviewBundle": { "const": 1 },
+        "initializationInstruction": { "const": 2 },
         "projectionLock": { "const": 2 },
         "projectionLockReadable": { "const": [1, 2] },
         "projectionLockWritten": { "enum": [1, 2] },
         "projectionRenderer": { "type": "integer" },
         "proposal": { "const": 1 },
-        "projectStatus": { "const": 1 },
-        "aiEntryRenderer": { "const": 3 },
+        "projectStatus": { "const": 2 },
+        "aiEntryRenderer": { "const": 5 },
         "migrationManifest": { "const": 2 },
         "migrationPlan": { "const": 1 },
         "reviewBundle": { "const": 2 },
@@ -99,7 +106,7 @@
         "upgradeResultBundle": { "const": 1 }
       }
     },
-    "commands": { "type": "array", "minItems": 1, "uniqueItems": true, "allOf": [{"contains": {"const": "upgrade-check"}}, {"contains": {"const": "upgrade-plan"}}, {"contains": {"const": "upgrade-apply"}}], "items": { "type": "string" } },
+    "commands": { "type": "array", "minItems": 1, "uniqueItems": true, "allOf": [{"contains": {"const": "instructions"}}, {"contains": {"const": "upgrade-check"}}, {"contains": {"const": "upgrade-plan"}}, {"contains": {"const": "upgrade-apply"}}], "items": { "type": "string" } },
     "actionKinds": {
       "type": "array",
       "minItems": 10,
@@ -130,6 +137,18 @@
         "callerMustProvideLimit": { "const": true }
       }
     },
+    "initializationInstruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "packagePath", "digest", "command"],
+      "properties": {
+        "id": {"const": "ai-project-initialization"},
+        "version": {"const": 2},
+        "packagePath": {"const": "docs/AI-PROJECT-INITIALIZATION.md"},
+        "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+        "command": {"const": "project-context instructions --project PATH [--json | --prompt]"}
+      }
+    },
     "initialization": { "enum": ["uninitialized", "partial", "initialized"] },
     "initialized": { "type": "boolean" },
     "project": {

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.7.0" },
+        "version": { "const": "1.9.1" },
         "exchangeProtocolVersion": { "const": 6 }
       }
     },

package/schemas/initialization-instruction.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$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", "entryRuleReview"],
+  "properties": {
+    "schemaVersion": {"const": 2},
+    "package": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {"const": "frontend-project-context"},
+        "version": {"const": "1.9.1"}
+      }
+    },
+    "instruction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "packagePath", "digest", "content"],
+      "properties": {
+        "id": {"const": "ai-project-initialization"},
+        "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,
+      "required": ["provider", "agentRuntime", "git", "network", "dependencyInstallation", "automaticApproval", "businessCodeWrites", "taskExecution", "stagePathBodyReads", "applyPlan", "scheduler", "daemon", "telemetry", "selfUpdate", "automaticEvidenceUpload", "packageManager", "automaticUpgrade"],
+      "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},
+        "telemetry": {"const": false},
+        "selfUpdate": {"const": false},
+        "automaticEvidenceUpload": {"const": false},
+        "packageManager": {"const": false},
+        "automaticUpgrade": {"const": false}
+      }
+    }
+  },
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"}
+  }
+}

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.7.0"}}},
-    "upgradeFrom": {"const": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]},
+    "package": {"type": "object", "additionalProperties": false, "required": ["name", "version"], "properties": {"name": {"const": "frontend-project-context"}, "version": {"const": "1.9.1"}}},
+    "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": 4, "maxItems": 4, "items": {"type": "object", "additionalProperties": false, "required": ["fromVersion", "classification", "migrationIds", "requiresHumanReview", "rollbackClass", "acceptance"], "properties": {"fromVersion": {"enum": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]}, "classification": {"enum": ["package-only", "republish-ai-entry", "republish-projection", "built-in-store-migration", "invalidate-ephemeral-protocol"]}, "migrationIds": {"$ref": "#/$defs/strings"}, "requiresHumanReview": {"type": "boolean"}, "rollbackClass": {"$ref": "#/$defs/rollbackClass"}, "acceptance": {"$ref": "#/$defs/strings"}}}},
+    "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

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

package/schemas/project-status.schema.json

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:frontend-project-context:schema:project-status:1",
+  "$id": "urn:frontend-project-context:schema:project-status:2",
   "title": "Frontend Project Context Project Status",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schemaVersion", "package", "initialization", "project", "snapshots", "health", "entry", "summary", "findingCodes", "sourceIds", "itemIds", "projectionPaths", "readTargets", "workUnits", "nextActions", "boundaries"],
+  "required": ["schemaVersion", "package", "initialization", "project", "snapshots", "health", "entry", "contractReadiness", "summary", "findingCodes", "sourceIds", "itemIds", "projectionPaths", "readTargets", "workUnits", "nextActions", "boundaries"],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 2 },
     "package": {
       "type": "object",
       "additionalProperties": false,
@@ -36,6 +36,7 @@
         "rendererVersion": { "type": ["integer", "null"] }
       }
     },
+    "contractReadiness": {"enum": ["not-initialized", "contract-incomplete", "contract-ready"]},
     "summary": {
       "type": "object",
       "additionalProperties": false,
@@ -56,7 +57,7 @@
     "nextActions": {
       "type": "array",
       "uniqueItems": true,
-      "items": { "enum": ["run-setup-preview", "run-sync", "review-pending", "review-source-change", "review-projection", "publish-ai-entry", "resolve-conflict", "ready-for-task"] }
+      "items": { "enum": ["read-initialization-instructions", "complete-onboarding", "compile-task-context", "run-sync", "review-pending", "review-source-change", "review-projection", "publish-ai-entry", "resolve-conflict"] }
     },
     "boundaries": { "type": "object", "additionalProperties": { "const": false } }
   },

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] }, "createdFile": { "type": "boolean" }
       }
     },
     "schema1": {