create-yss-spec 3.3.8 → 3.4.1

package/template/docs/design/tokens/variables.css

@@ -1,52 +1,54 @@
 :root {
+  --yss-card-padding: 20px;
+  --yss-control-height: 32px;
   --yss-color-primary-control: #245bdb;
   --yss-color-primary-control-hover: #2f68eb;
   --yss-color-on-primary: #ffffff;
   --yss-control-height-compact: 28px;
   --yss-card-compact-padding: 16px;
   --brand-color-primary: #3371ff;
-  --brand-color-primary-bg: #d6e4ff;
-  --brand-color-primary-bg-hover: #adc6ff;
-  --brand-color-primary-border: #85a5ff;
-  --brand-color-primary-border-hover: #597ef7;
-  --brand-color-primary-hover: #4096ff;
-  --brand-color-primary-active: #0958d9;
-  --brand-color-primary-text: #002c8c;
+  --brand-color-primary-bg: #f0f7ff;
+  --brand-color-primary-bg-hover: #d6e8ff;
+  --brand-color-primary-border: #adceff;
+  --brand-color-primary-border-hover: #85b1ff;
+  --brand-color-primary-hover: #5c92ff;
+  --brand-color-primary-active: #2152d9;
+  --brand-color-primary-text: #3371ff;
   --brand-color-success: #52c41a;
   --brand-color-success-bg: #f6ffed;
   --brand-color-success-border: #b7eb8f;
-  --brand-color-success-hover: #73d13d;
+  --brand-color-success-hover: #95de64;
   --brand-color-success-active: #389e0d;
   --brand-color-warning: #faad14;
   --brand-color-warning-bg: #fffbe6;
   --brand-color-warning-border: #ffe58f;
-  --brand-color-warning-hover: #ffc53d;
+  --brand-color-warning-hover: #ffd666;
   --brand-color-warning-active: #d48806;
   --brand-color-error: #f5222d;
-  --brand-color-error-bg: #fff2f0;
-  --brand-color-error-border: #ffccc7;
+  --brand-color-error-bg: #fff1f0;
+  --brand-color-error-border: #ffa39e;
   --brand-color-error-hover: #ff4d4f;
   --brand-color-error-active: #cf1322;
   --brand-color-info: #3371ff;
-  --brand-color-info-bg: #e6f4ff;
-  --brand-color-info-border: #91caff;
+  --brand-color-info-bg: #f0f7ff;
+  --brand-color-info-border: #adceff;
   --brand-color-link: #3371ff;
-  --brand-color-link-hover: #4096ff;
-  --brand-color-link-active: #0958d9;
+  --brand-color-link-hover: #85b1ff;
+  --brand-color-link-active: #2152d9;
   --brand-color-text: rgba(0, 0, 0, 0.88);
   --brand-color-text-secondary: rgba(0, 0, 0, 0.65);
-  --brand-color-text-tertiary: #8c8c8c;
-  --brand-color-text-quaternary: #bfbfbf;
-  --brand-color-fill: #d9d9d9;
-  --brand-color-fill-secondary: #f0f0f0;
-  --brand-color-fill-tertiary: #f5f5f5;
-  --brand-color-fill-quaternary: #fafafa;
+  --brand-color-text-tertiary: rgba(0,0,0,0.45);
+  --brand-color-text-quaternary: rgba(0,0,0,0.25);
+  --brand-color-fill: rgba(0,0,0,0.15);
+  --brand-color-fill-secondary: rgba(0,0,0,0.06);
+  --brand-color-fill-tertiary: rgba(0,0,0,0.04);
+  --brand-color-fill-quaternary: rgba(0,0,0,0.02);
   --brand-color-bg-layout: #f0f2f5;
   --brand-color-bg-container: #ffffff;
   --brand-color-bg-elevated: #ffffff;
   --brand-color-border: #d9d9d9;
   --brand-color-border-secondary: #f0f0f0;
-  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;
@@ -250,49 +252,49 @@
 }
 
 .dark {
-  --brand-color-primary: #3983dc;
-  --brand-color-primary-bg: #121e32;
-  --brand-color-primary-bg-hover: #152d4f;
-  --brand-color-primary-border: #213b5b;
-  --brand-color-primary-border-hover: #284f7e;
-  --brand-color-primary-hover: #61a1e8;
-  --brand-color-primary-active: #3169ad;
-  --brand-color-primary-text: #b5daf8;
-  --brand-color-success: #64b537;
-  --brand-color-success-bg: #192913;
-  --brand-color-success-border: #304d20;
-  --brand-color-success-hover: #87ca5c;
-  --brand-color-success-active: #518f2f;
-  --brand-color-warning: #dcaa37;
-  --brand-color-warning-bg: #312512;
-  --brand-color-warning-border: #5b4920;
-  --brand-color-warning-hover: #e8c35e;
-  --brand-color-warning-active: #ad872f;
-  --brand-color-error: #dc6966;
-  --brand-color-error-bg: #32191a;
-  --brand-color-error-border: #5b3231;
-  --brand-color-error-hover: #e89590;
-  --brand-color-error-active: #ad5553;
-  --brand-color-info: #3983dc;
-  --brand-color-info-bg: #121e32;
-  --brand-color-info-border: #213b5b;
-  --brand-color-link: #3983dc;
-  --brand-color-link-hover: #61a1e8;
-  --brand-color-link-active: #3169ad;
-  --brand-color-text: #dcdcdc;
-  --brand-color-text-secondary: #adadad;
-  --brand-color-text-tertiary: #7e7e7e;
-  --brand-color-text-quaternary: #4f4f4f;
-  --brand-color-fill: #3e3e3e;
-  --brand-color-fill-secondary: #303030;
-  --brand-color-fill-tertiary: #272727;
-  --brand-color-fill-quaternary: #1d1d1d;
-  --brand-color-bg-layout: #1d1d1d;
-  --brand-color-bg-container: #141414;
-  --brand-color-bg-elevated: #272727;
-  --brand-color-border: #3e3e3e;
-  --brand-color-border-secondary: #303030;
-  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --brand-color-primary: #3371ff;
+  --brand-color-primary-bg: #f0f7ff;
+  --brand-color-primary-bg-hover: #d6e8ff;
+  --brand-color-primary-border: #adceff;
+  --brand-color-primary-border-hover: #85b1ff;
+  --brand-color-primary-hover: #5c92ff;
+  --brand-color-primary-active: #2152d9;
+  --brand-color-primary-text: #3371ff;
+  --brand-color-success: #52c41a;
+  --brand-color-success-bg: #f6ffed;
+  --brand-color-success-border: #b7eb8f;
+  --brand-color-success-hover: #95de64;
+  --brand-color-success-active: #389e0d;
+  --brand-color-warning: #faad14;
+  --brand-color-warning-bg: #fffbe6;
+  --brand-color-warning-border: #ffe58f;
+  --brand-color-warning-hover: #ffd666;
+  --brand-color-warning-active: #d48806;
+  --brand-color-error: #f5222d;
+  --brand-color-error-bg: #fff1f0;
+  --brand-color-error-border: #ffa39e;
+  --brand-color-error-hover: #ff4d4f;
+  --brand-color-error-active: #cf1322;
+  --brand-color-info: #3371ff;
+  --brand-color-info-bg: #f0f7ff;
+  --brand-color-info-border: #adceff;
+  --brand-color-link: #3371ff;
+  --brand-color-link-hover: #85b1ff;
+  --brand-color-link-active: #2152d9;
+  --brand-color-text: rgba(0, 0, 0, 0.88);
+  --brand-color-text-secondary: rgba(0, 0, 0, 0.65);
+  --brand-color-text-tertiary: rgba(0,0,0,0.45);
+  --brand-color-text-quaternary: rgba(0,0,0,0.25);
+  --brand-color-fill: rgba(0,0,0,0.15);
+  --brand-color-fill-secondary: rgba(0,0,0,0.06);
+  --brand-color-fill-tertiary: rgba(0,0,0,0.04);
+  --brand-color-fill-quaternary: rgba(0,0,0,0.02);
+  --brand-color-bg-layout: #f0f2f5;
+  --brand-color-bg-container: #ffffff;
+  --brand-color-bg-elevated: #ffffff;
+  --brand-color-border: #d9d9d9;
+  --brand-color-border-secondary: #f0f0f0;
+  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;

package/template/docs/design/tokens/variables.dark.css

@@ -1,47 +1,47 @@
 :root {
-  --brand-color-primary: #3983dc;
-  --brand-color-primary-bg: #121e32;
-  --brand-color-primary-bg-hover: #152d4f;
-  --brand-color-primary-border: #213b5b;
-  --brand-color-primary-border-hover: #284f7e;
-  --brand-color-primary-hover: #61a1e8;
-  --brand-color-primary-active: #3169ad;
-  --brand-color-primary-text: #b5daf8;
-  --brand-color-success: #64b537;
-  --brand-color-success-bg: #192913;
-  --brand-color-success-border: #304d20;
-  --brand-color-success-hover: #87ca5c;
-  --brand-color-success-active: #518f2f;
-  --brand-color-warning: #dcaa37;
-  --brand-color-warning-bg: #312512;
-  --brand-color-warning-border: #5b4920;
-  --brand-color-warning-hover: #e8c35e;
-  --brand-color-warning-active: #ad872f;
-  --brand-color-error: #dc6966;
-  --brand-color-error-bg: #32191a;
-  --brand-color-error-border: #5b3231;
-  --brand-color-error-hover: #e89590;
-  --brand-color-error-active: #ad5553;
-  --brand-color-info: #3983dc;
-  --brand-color-info-bg: #121e32;
-  --brand-color-info-border: #213b5b;
-  --brand-color-link: #3983dc;
-  --brand-color-link-hover: #61a1e8;
-  --brand-color-link-active: #3169ad;
-  --brand-color-text: #dcdcdc;
-  --brand-color-text-secondary: #adadad;
-  --brand-color-text-tertiary: #7e7e7e;
-  --brand-color-text-quaternary: #4f4f4f;
-  --brand-color-fill: #3e3e3e;
-  --brand-color-fill-secondary: #303030;
-  --brand-color-fill-tertiary: #272727;
-  --brand-color-fill-quaternary: #1d1d1d;
-  --brand-color-bg-layout: #1d1d1d;
+  --brand-color-primary: #2e63dc;
+  --brand-color-primary-bg: #1d305b;
+  --brand-color-primary-bg-hover: #223e7e;
+  --brand-color-primary-border: #1d305b;
+  --brand-color-primary-border-hover: #223e7e;
+  --brand-color-primary-hover: #5585e8;
+  --brand-color-primary-active: #2850ad;
+  --brand-color-primary-text: #2e63dc;
+  --brand-color-success: #49aa19;
+  --brand-color-success-bg: #162312;
+  --brand-color-success-border: #274916;
+  --brand-color-success-hover: #306317;
+  --brand-color-success-active: #3c8618;
+  --brand-color-warning: #d89614;
+  --brand-color-warning-bg: #2b2111;
+  --brand-color-warning-border: #594214;
+  --brand-color-warning-hover: #7c5914;
+  --brand-color-warning-active: #aa7714;
+  --brand-color-error: #d32029;
+  --brand-color-error-bg: #2a1215;
+  --brand-color-error-border: #58181c;
+  --brand-color-error-hover: #e84749;
+  --brand-color-error-active: #a61d24;
+  --brand-color-info: #2e63dc;
+  --brand-color-info-bg: #14192c;
+  --brand-color-info-border: #1d305b;
+  --brand-color-link: #2e63dc;
+  --brand-color-link-hover: #223e7e;
+  --brand-color-link-active: #2850ad;
+  --brand-color-text: rgba(255,255,255,0.85);
+  --brand-color-text-secondary: rgba(255,255,255,0.65);
+  --brand-color-text-tertiary: rgba(255,255,255,0.45);
+  --brand-color-text-quaternary: rgba(255,255,255,0.25);
+  --brand-color-fill: rgba(255,255,255,0.18);
+  --brand-color-fill-secondary: rgba(255,255,255,0.12);
+  --brand-color-fill-tertiary: rgba(255,255,255,0.08);
+  --brand-color-fill-quaternary: rgba(255,255,255,0.04);
+  --brand-color-bg-layout: #000000;
   --brand-color-bg-container: #141414;
-  --brand-color-bg-elevated: #272727;
-  --brand-color-border: #3e3e3e;
+  --brand-color-bg-elevated: #1f1f1f;
+  --brand-color-border: #424242;
   --brand-color-border-secondary: #303030;
-  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+  --brand-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif;
   --brand-font-family-code: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
   --brand-font-size: 14px;
   --brand-font-size-sm: 12px;

package/template/docs/process/delivery-preflight.md

@@ -55,7 +55,7 @@
 工程接入技能在既有 Java/Maven 跨仓接入前运行 `prepare`，补证后重跑。两个导出 CLI 已在外层、任何导出写入之前复验 `export`。v5 的既有 UI 战略导出与包含既有架构身份 v2 的后端导出必须提供 `--preflight-input`；旧路径可选，原批准规则仍独立有效。以下命令中的清单必须绑定对应源文件及其当前摘要：
 
 ```sh
-scripts/strategic-handoff export --source-root /governance/source --handoff docs/handoff.yaml --output /delivery/strategy-v1 --preflight-input /inputs/strategic-preflight.json
+scripts/strategic-handoff finalize --source-root /governance/source --handoff docs/handoff.yaml --preflight-input /inputs/strategic-preflight.json
 scripts/backend-delivery export --source-root /governance/backend --delivery docs/backend-delivery.yaml --output /delivery/backend-v1 --preflight-input /inputs/backend-preflight.json
 ```
 

package/template/docs/process/frontend-backend-delivery.md

@@ -6,7 +6,7 @@
 
 战略方维护业务规则、Spec、页面流程和视觉基线；后端维护 API 及后端交付；前端维护工程设计、页面和验收证据；统一管理方维护基线引用、跨仓切片与业务验收汇总。
 
-前端消费需求可在上游设计时提前反馈。Handoff v4/v5 导入后的 Frontend Strategic Preflight 可在后端交付前完成战略输入、Context、相应 UI 基线和源规则追踪核验，并允许起草前端工程设计与实现计划；它固定返回 `ready_for_agent: false`。仅当 Backend/API/Data 影响命中时，最终接收才等待后端交付；UI-only 路径使用有依据的 `backend-not-applicable`。Slice Contract 获准前均不得写代码。
+前端消费需求可在上游设计时提前反馈。新 Handoff v5 交付目录导入后生成 Import Receipt v3；历史裸 v4/v5 包继续生成 v2。Frontend Strategic Preflight 可在后端交付前完成战略输入、Context、相应 UI 基线和源规则追踪核验，并允许起草前端工程设计与实现计划；它固定返回 `ready_for_agent: false`。仅当 Backend/API/Data 影响命中时，最终接收才等待后端交付；UI-only 路径使用有依据的 `backend-not-applicable`。Slice Contract 获准前均不得写代码。
 
 ## 后端导出与前端导入
 
@@ -36,6 +36,7 @@ Handoff v4/v5 先生成 `frontend-strategic-preflight-draft.json`；补齐正式
 |---|---|---|---|
 | Handoff v3（历史） | 原历史路径 | Acceptance v1，要求后端交付 | `visual_case_ids` |
 | Handoff v4 | Preflight v1 | Acceptance v2 | `visual_case_ids` |
+| Handoff v5 delivery | Preflight v2 | Acceptance v3 | `ui_baseline_kind`、`ui_baseline_ref`、source delivery record |
 | Handoff v5 | Preflight v2 | Acceptance v3 | `baseline_case_ids` |
 
 v5 的预检和接收都声明 `ui_baseline_kind`，必须与战略包一致。原型分支继续原视觉/原型要求；既有 UI 分支使用 [existing-ui-baseline v1](existing-ui-baseline.md)，只允许无 UI/交互/状态/权限体验改动并已取得当前基线确认的工程。真实截图不得自行升级为原型批准。

package/template/docs/process/lifecycle-registry-baseline.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "registry_id": "yss.lifecycle",
-  "semantic_sha256": "38ec430630bbaee2c94f5d0d3dcd31f1d5481482b8cec52e44e983e4af6b638e",
+  "semantic_sha256": "5ec72f7acca16869cb25c1089f925c5a60c1dd376b4fc4799b09f5678ae065c3",
   "published_ids": [
     "artifact.architecture-review",
     "artifact.data-architecture",

package/template/docs/process/lifecycle-registry.yaml

@@ -419,17 +419,17 @@ work_units:
     scope: project-instance
     input: Spec、原型、API/数据/工程影响面。
     output: OpenAPI、数据架构、按确认架构形成的 DDD / MVC 技术设计合同、工程基线、架构审查和 Slice 合同草案。
-    completion: 命中契约已冻结；无 API 影响有可读记录；命中技术设计影响时架构已确认、规则与场景承接无未解释冲突；工程基线通过。
+    completion: 命中契约已冻结；无 API 影响有可读记录；所有后端交付均有批准且当前的 Technical Design；数据影响为真时数据架构已批准，否则有可核验的不适用记录；架构、规则与场景承接无未解释冲突；gate.engineering-contract-approved 通过。
   - id: work-unit.implementation-repository-preparation
     name: 实现仓库准备
     scope: project-instance
-    input: 工程影响面、工程基线、逐项目用户决定、实现仓库位置；新建工程还需批准且当前的 Project Scaffold Contract。
-    output: 已有工程的 Repository Onboarding Result，或新工程的 Scaffold Manifest 与 Scaffold Verification；并汇总 Implementation Repository Preparation Result。
-    completion: 每个命中的交付面均为 existing-and-onboarded 或 initialized-and-verified，未命中的交付面有带原因的 not-applicable；聚合结果当前且证据可读。
+    input: 已完成的技术分析执行结果、Context reconciliation、战略交接消费结果、工程合同批准、工程影响面和实现仓库位置；新建后端还需批准且当前并绑定设计前置的 Project Scaffold Contract v4。
+    output: 已有工程的 Repository Onboarding Result，或新工程的 Scaffold Manifest v4 与 Scaffold Verification；并汇总 Implementation Repository Preparation Result v2。
+    completion: 每个后端项目均携带技术/数据设计门禁结果；新生成只接受 v4；历史 v3 仅在机械骨架未修改、设计补齐和恢复批准均通过时对账复用；检测到提前业务实现时保持 blocked。每个命中的交付面均为 existing-and-onboarded 或 initialized-and-verified，未命中的交付面有带原因的 not-applicable；聚合结果当前且证据可读。
   - id: work-unit.service-project-initialization
     name: 独立服务项目初始化
     scope: project-instance
-    input: 逐项目批准的架构决策、schema v3 初始化合同、战略上下文交接及目标/skillUtils 写范围。
+    input: 逐项目批准的架构决策、Technical Design、Data Architecture Decision、工程合同批准、schema v4 初始化合同、战略上下文交接及目标/skillUtils 写范围。
     output: 独立 Git project-instance、锁定 skillUtils、唯一根 CONTEXT、架构身份、Manifest 和验证证据；父项目仅保留引用。
     completion: 当前合同与交接摘要一致，真实 Wrapper 三命令通过后仅 empty-scaffold-verified；首切片仍须独立批准和验证。
   - id: work-unit.ticket-decomposition

package/template/docs/process/schemas/api-contract-decision.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.example/schemas/api-contract-decision.schema.json",
+  "title": "YSS API Contract Decision v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "decision_id", "decision_version", "status", "current_version", "impact", "assessment_ref", "assessment_digest", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "api-contract-decision" },
+    "decision_id": { "type": "string", "minLength": 1 },
+    "decision_version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+    "status": { "const": "approved" },
+    "current_version": { "const": true },
+    "impact": { "enum": ["required", "not-applicable"] },
+    "assessment_ref": { "type": "string", "minLength": 1 },
+    "assessment_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+    "reason": { "type": "string", "minLength": 1 },
+    "openapi": { "$ref": "#/$defs/versionedArtifact" },
+    "validation_record": { "$ref": "#/$defs/artifact" },
+    "draft_review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "digest", "result", "blocking_findings", "draft_ref", "draft_digest", "evidence_refs"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "result": { "const": "approved" },
+        "blocking_findings": { "type": "array", "maxItems": 0 },
+        "draft_ref": { "type": "string", "minLength": 1 },
+        "draft_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "freeze": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "frozen_at", "draft_ref", "draft_digest"],
+      "properties": {
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "frozen_at": { "type": "string", "format": "date-time" },
+        "draft_ref": { "type": "string", "minLength": 1 },
+        "draft_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  },
+  "allOf": [
+    { "if": { "properties": { "impact": { "const": "required" } } }, "then": { "required": ["openapi", "validation_record", "draft_review", "freeze"] } },
+    { "if": { "properties": { "impact": { "const": "not-applicable" } } }, "then": { "required": ["reason"], "not": { "anyOf": [{ "required": ["openapi"] }, { "required": ["validation_record"] }, { "required": ["draft_review"] }, { "required": ["freeze"] }] } } }
+  ],
+  "$defs": {
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "digest"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "versionedArtifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "ref", "version", "digest"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "ref": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  }
+}

package/template/docs/process/schemas/data-architecture-decision.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.example/schemas/data-architecture-decision.schema.json",
+  "title": "YSS Data Architecture Decision v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "decision_id", "decision_version", "status", "current_version", "impact", "assessment_ref", "assessment_digest", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "data-architecture-decision" },
+    "decision_id": { "type": "string", "pattern": "^data-architecture\\.[a-z0-9][a-z0-9-]*$" },
+    "decision_version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+    "status": { "const": "approved" },
+    "current_version": { "const": true },
+    "impact": { "enum": ["required", "not-applicable"] },
+    "assessment_ref": { "type": "string", "minLength": 1 },
+    "assessment_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "data_architecture_ref": { "type": "string", "minLength": 1 },
+    "data_architecture_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "review_evidence_refs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "reason": { "type": "string", "minLength": 1 },
+    "evidence_refs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "impact": { "const": "required" } }, "required": ["impact"] },
+      "then": { "required": ["data_architecture_ref", "data_architecture_digest", "review_evidence_refs"], "not": { "required": ["reason"] } }
+    },
+    {
+      "if": { "properties": { "impact": { "const": "not-applicable" } }, "required": ["impact"] },
+      "then": { "required": ["reason"], "not": { "anyOf": [{ "required": ["data_architecture_ref"] }, { "required": ["data_architecture_digest"] }, { "required": ["review_evidence_refs"] }] } }
+    }
+  ]
+}

package/template/docs/process/schemas/implementation-repository-preparation-result.schema.json

@@ -1,38 +1,94 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://yss.example/schemas/implementation-repository-preparation-result.schema.json",
-  "title": "Implementation Repository Preparation Result",
+  "title": "Implementation Repository Preparation Result v2",
   "type": "object",
   "additionalProperties": false,
   "required": ["schema_version", "kind", "result", "current_version", "projects", "evidence_refs"],
   "properties": {
-    "schema_version": { "const": 1 },
+    "schema_version": { "const": 2 },
     "kind": { "const": "implementation-repository-preparation-result" },
     "result": { "const": "completed" },
     "current_version": { "const": true },
-    "projects": {
-      "type": "array",
-      "minItems": 2,
-      "items": {
-        "type": "object",
-        "required": ["project_id", "delivery_role", "status"],
-        "properties": {
-          "project_id": { "type": "string", "minLength": 1 },
-          "delivery_role": { "enum": ["backend", "frontend"] },
-          "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
-          "reason": { "type": "string" },
-          "repository_ref": { "type": "string" },
-          "project_root": { "type": "string" },
-          "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
-          "onboarding_result": { "type": "object" },
-          "scaffold_contract": { "type": "object" },
-          "scaffold_manifest_ref": { "type": "string" },
-          "scaffold_verification": { "type": "object" },
-          "template_available": { "type": "boolean" },
-          "architecture_family": { "type": "string" }
-        }
+    "projects": { "type": "array", "minItems": 2, "items": { "$ref": "#/$defs/project" } },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  },
+  "$defs": {
+    "artifactBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "version", "digest"],
+      "properties": {
+        "ref": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^v[1-9][0-9]*$" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "impact": { "enum": ["required", "not-applicable"] }
       }
     },
-    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+    "designPrerequisites": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["technical_design", "data_architecture_decision", "api_contract_decision", "engineering_contract_approval_ref"],
+      "properties": {
+        "technical_design": { "$ref": "#/$defs/artifactBinding" },
+        "data_architecture_decision": { "$ref": "#/$defs/artifactBinding" },
+        "api_contract_decision": { "$ref": "#/$defs/artifactBinding" },
+        "engineering_contract_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
+    "legacyReconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "status", "manifest_ref", "manifest_digest", "ownership_check_ref", "ownership_state", "premature_implementation", "recovery_approval_ref"],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "status": { "const": "approved" },
+        "manifest_ref": { "type": "string", "minLength": 1 },
+        "manifest_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "ownership_check_ref": { "type": "string", "minLength": 1 },
+        "ownership_state": { "const": "unchanged-mechanical-scaffold" },
+        "premature_implementation": { "const": false },
+        "recovery_approval_ref": { "type": "string", "minLength": 1 }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_id", "delivery_role", "status"],
+      "properties": {
+        "project_id": { "type": "string", "minLength": 1 },
+        "delivery_role": { "enum": ["backend", "frontend"] },
+        "status": { "enum": ["existing-and-onboarded", "initialized-and-verified", "not-applicable"] },
+        "reason": { "type": "string", "minLength": 1 },
+        "repository_ref": { "type": "string", "minLength": 1 },
+        "project_root": { "type": "string", "minLength": 1 },
+        "repository_scope": { "enum": ["external-repository", "harness-apps", "git-submodule"] },
+        "onboarding_result": { "type": "object" },
+        "scaffold_contract": {
+          "type": "object",
+          "required": ["schema_version", "status", "persisted", "current_version"],
+          "properties": {
+            "schema_version": { "enum": [3, 4] },
+            "status": { "const": "approved" },
+            "persisted": { "const": true },
+            "current_version": { "const": true }
+          }
+        },
+        "scaffold_manifest_ref": { "type": "string", "minLength": 1 },
+        "scaffold_verification": { "type": "object" },
+        "template_available": { "type": "boolean" },
+        "architecture_family": { "type": "string", "minLength": 1 },
+        "design_prerequisites": { "$ref": "#/$defs/designPrerequisites" },
+        "legacy_reconciliation": { "$ref": "#/$defs/legacyReconciliation" }
+      },
+      "allOf": [
+        { "if": { "properties": { "status": { "const": "not-applicable" } }, "required": ["status"] }, "then": { "required": ["reason"] } },
+        { "if": { "properties": { "status": { "enum": ["existing-and-onboarded", "initialized-and-verified"] } }, "required": ["status"] }, "then": { "required": ["repository_ref", "project_root", "repository_scope"] } },
+        { "if": { "properties": { "status": { "const": "existing-and-onboarded" } }, "required": ["status"] }, "then": { "required": ["onboarding_result"] } },
+        { "if": { "properties": { "status": { "const": "initialized-and-verified" } }, "required": ["status"] }, "then": { "required": ["scaffold_contract", "scaffold_manifest_ref", "scaffold_verification"] } },
+        { "if": { "properties": { "delivery_role": { "const": "backend" }, "status": { "enum": ["existing-and-onboarded", "initialized-and-verified"] } }, "required": ["delivery_role", "status"] }, "then": { "required": ["architecture_family", "design_prerequisites"] } },
+        { "if": { "properties": { "delivery_role": { "const": "backend" }, "status": { "const": "initialized-and-verified" }, "scaffold_contract": { "properties": { "schema_version": { "const": 3 } }, "required": ["schema_version"] } }, "required": ["delivery_role", "status", "scaffold_contract"] }, "then": { "required": ["legacy_reconciliation"] } }
+      ]
+    }
   }
 }