create-yss-spec 3.0.1 → 3.1.0

package/template/docs/process/lifecycle-artifact-map.md

@@ -27,7 +27,7 @@
 | 稳定 ID | 门禁 | 所属阶段 | 触发条件 | 前置门禁 | 必须留下的证据 |
 |---|---|---|---|---|---|
 | `gate.repository-identity-valid` | 仓库身份校验 | `stage.entry-triage` | 每次进入流程。 | 无 | `evidence.repository-identity-check` |
-| `gate.domain-strategy-approved` | DDD 战略设计批准 | `stage.discovery` | 存在 DDD 战略设计影响或需要确定领域边界、统一语言和核心规则。 | 无 | `evidence.domain-strategy-review`、`evidence.approval-record` |
+| `gate.domain-strategy-approved` | 业务边界与规则确认 | `stage.discovery` | 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。 | 无 | `evidence.domain-strategy-review`、`evidence.approval-record` |
 | `gate.stage-decision-package-approved` | 阶段决策包批准 | `stage.discovery` | Discovery 到 Spec 入口需要稳定的阶段决策合同。 | `gate.domain-strategy-approved` | `evidence.stage-decision-package`、`evidence.approval-record` |
 | `gate.spec-baseline-approved` | Spec 基线批准 | `stage.spec-architecture` | 新功能、行为变化或范围扩大进入 Spec 基线。 | 无 | `evidence.approval-record` |
 | `gate.prototype-reviewed` | 原型评审 | `stage.product-design` | 命中产品设计影响，且低保真页面、流程、状态或 API 反推需要独立评审。 | 无 | `evidence.prototype-review-result` |
@@ -48,8 +48,8 @@
 | 稳定 ID | 产物 | 所属阶段 | 触发条件 |
 |---|---|---|---|
 | `artifact.impact-assessment` | 影响面分析 | `stage.entry-triage` | 每次变更。 |
-| `artifact.domain-strategy` | DDD 战略设计 | `stage.discovery` | 新产品/模块、跨上下文功能、统一语言冲突、服务边界或核心规则变化。 |
-| `artifact.stage-decision-package` | 阶段决策包 | `stage.discovery` | Discovery 到 Spec 入口需要结构化上游决策。 |
+| `artifact.domain-strategy` | 业务边界与规则设计 | `stage.discovery` | 新产品/模块、跨责任区协作、业务词汇冲突、责任边界或关键规则变化。 |
+| `artifact.stage-decision-package` | 方案决策包 | `stage.discovery` | Discovery 到 Spec 入口需要结构化上游决策。 |
 | `artifact.discovery-record` | Discovery 记录 | `stage.discovery` | 新问题或边界不清。 |
 | `artifact.spec` | Spec | `stage.spec-architecture` | 新功能、行为变化或范围扩大。 |
 | `artifact.product-overview` | 产品总体设计 | `stage.spec-architecture` | 进入 Spec 基线。 |
@@ -78,8 +78,9 @@
 
 | 稳定 ID | 证据 | 说明 |
 |---|---|---|
+| `evidence.context-reconciliation` | Context Reconciliation 证据 | 工作单元在批准或流转前对根目录唯一 CONTEXT.md 的稳定术语回写、作用域解析和双摘要核对结果；不新增门禁。 |
 | `evidence.impact-assessment` | 影响面分析记录 | 受影响仓库、资产、风险与最近可信阶段。 |
-| `evidence.domain-strategy-review` | DDD 战略设计评审证据 | 子域、限界上下文、统一语言、Context Map、场景和不变量的结构化评审结果。 |
+| `evidence.domain-strategy-review` | 业务边界与规则评审证据 | 业务板块、业务责任区、统一业务词汇、协作与交接关系、关键场景和不可违反规则的结构化评审结果。 |
 | `evidence.tactical-design-review` | DDD 战术设计评审证据 | 聚合、Entity、Value Object、不变量、状态机、一致性、Gateway 与 API 隔离的结构化评审结果。 |
 | `evidence.stage-decision-package` | 阶段决策包验证证据 | 阶段决策包的 Schema、引用、语义一致性、影响传播和下游消费验证结果。 |
 | `evidence.maintenance-intensity-checkpoint` | 模板维护强度 checkpoint | template-source 变更的 L1 / L2 / L3 分级、触发项、最低验证证据、review 模式和升级记录。 |

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

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "registry_id": "yss.lifecycle",
-  "semantic_sha256": "6fe3accf810dda1686080f1dd32f9393b22fa006acceb89ff17cb5668a8a67a6",
+  "semantic_sha256": "f745204885a0c335b7f87dc1e1f5fd162a556b84e4543d6e1f356da41f6c081a",
   "published_ids": [
     "artifact.architecture-review",
     "artifact.data-architecture",
@@ -19,8 +19,8 @@
     "artifact.openapi-freeze-record",
     "artifact.parent-ticket",
     "artifact.product-overview",
-    "artifact.prototype-deliverable",
     "artifact.prototype-confirmation",
+    "artifact.prototype-deliverable",
     "artifact.prototype-review",
     "artifact.retrospective",
     "artifact.slice-implementation-contract",
@@ -34,6 +34,7 @@
     "evidence.approval-record",
     "evidence.browser-prototype-verification",
     "evidence.checkpoint-and-rollback",
+    "evidence.context-reconciliation",
     "evidence.contract-approval",
     "evidence.design-review-result",
     "evidence.domain-strategy-review",
@@ -81,20 +82,21 @@
     "work-unit.domain-strategy-design",
     "work-unit.entry-triage",
     "work-unit.fresh-verification",
+    "work-unit.frontend-implementation-verification",
     "work-unit.independent-review",
     "work-unit.intensity-aware-review",
     "work-unit.intensity-aware-verification",
-    "work-unit.frontend-implementation-verification",
     "work-unit.prototype-design",
     "work-unit.release-and-retrospective",
     "work-unit.release-and-rollback",
+    "work-unit.service-project-initialization",
     "work-unit.skill-projection-sync",
     "work-unit.slice-implementation",
     "work-unit.spec-synthesis",
     "work-unit.ssot-update",
     "work-unit.stage-decision",
     "work-unit.technical-analysis",
-    "work-unit.ticket-decomposition",
-    "work-unit.template-snapshot-build"
+    "work-unit.template-snapshot-build",
+    "work-unit.ticket-decomposition"
   ]
 }

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

@@ -45,12 +45,17 @@ stages:
     exit_criteria: 所有命中门禁通过，人工审查点已完成，checkpoint 可追溯。
 
 evidence:
+  - id: evidence.context-reconciliation
+    name: Context Reconciliation 证据
+    description: 工作单元在批准或流转前对根目录唯一 CONTEXT.md 的稳定术语回写、作用域解析和双摘要核对结果；不新增门禁。
   - id: evidence.impact-assessment
     name: 影响面分析记录
     description: 受影响仓库、资产、风险与最近可信阶段。
   - id: evidence.domain-strategy-review
     name: DDD 战略设计评审证据
     description: 子域、限界上下文、统一语言、Context Map、场景和不变量的结构化评审结果。
+    public_name: 业务边界与规则评审证据
+    public_description: 业务板块、业务责任区、统一业务词汇、协作与交接关系、关键场景和不可违反规则的结构化评审结果。
   - id: evidence.tactical-design-review
     name: DDD 战术设计评审证据
     description: 聚合、Entity、Value Object、不变量、状态机、一致性、Gateway 与 API 隔离的结构化评审结果。
@@ -116,6 +121,8 @@ gates:
     name: DDD 战略设计批准
     stage: stage.discovery
     trigger: 存在 DDD 战略设计影响或需要确定领域边界、统一语言和核心规则。
+    public_name: 业务边界与规则确认
+    public_trigger: 需要确定业务板块、业务责任区、统一业务词汇、协作关系或关键规则。
     evidence: [evidence.domain-strategy-review, evidence.approval-record]
   - id: gate.stage-decision-package-approved
     name: 阶段决策包批准
@@ -199,10 +206,13 @@ artifacts:
     name: DDD 战略设计
     stage: stage.discovery
     trigger: 新产品/模块、跨上下文功能、统一语言冲突、服务边界或核心规则变化。
+    public_name: 业务边界与规则设计
+    public_trigger: 新产品/模块、跨责任区协作、业务词汇冲突、责任边界或关键规则变化。
   - id: artifact.stage-decision-package
     name: 阶段决策包
     stage: stage.discovery
     trigger: Discovery 到 Spec 入口需要结构化上游决策。
+    public_name: 方案决策包
   - id: artifact.discovery-record
     name: Discovery 记录
     stage: stage.discovery
@@ -363,12 +373,18 @@ work_units:
     input: 已澄清的业务场景、领域词汇、约束和现有上下文。
     output: 子域、限界上下文、Context Map、统一语言、事件、核心领域概念候选和不变量。
     completion: 边界、语义方向、规则所有权和关键场景可审查；无未解释冲突。
+    public_name: 业务边界与协作梳理
+    public_input: 已澄清的业务故事、业务词汇、约束和现有协作关系。
+    public_output: 业务板块、业务责任区、协作与交接关系、统一业务词汇、已发生的业务事实、待确认的关键业务对象和不可违反的业务规则。
   - id: work-unit.stage-decision
     name: 阶段决策包综合
     scope: project-instance
     input: Discovery、DDD 战略设计以及产品经理负责的商业约束输入。
     output: 带版本、digest、证据和下游映射的阶段决策包。
     completion: 必填字段、引用、影响面和下游消费验证通过；批准门禁完成。
+    public_name: 方案决策包综合
+    public_input: Discovery、业务边界与规则设计以及产品经理负责的商业约束输入。
+    public_output: 带版本、digest、证据和下游映射的方案决策包。
   - id: work-unit.spec-synthesis
     name: Spec 综合
     scope: project-instance
@@ -387,6 +403,12 @@ work_units:
     input: Spec、原型、API/数据/工程影响面。
     output: OpenAPI、数据架构、Tactical DDD Check、工程基线、架构审查和 Slice 合同草案。
     completion: 命中契约已冻结；无 API 影响有可读记录；命中领域影响时战术模型无未解释冲突；工程基线通过。
+  - id: work-unit.service-project-initialization
+    name: 独立服务项目初始化
+    scope: project-instance
+    input: 逐项目批准的架构决策、schema v3 初始化合同、战略上下文交接及目标/skillUtils 写范围。
+    output: 独立 Git project-instance、锁定 skillUtils、唯一根 CONTEXT、架构身份、Manifest 和验证证据；父项目仅保留引用。
+    completion: 当前合同与交接摘要一致，真实 Wrapper 三命令通过后仅 empty-scaffold-verified；首切片仍须独立批准和验证。
   - id: work-unit.ticket-decomposition
     name: 垂直切片 Ticket 正式化
     scope: project-instance

package/template/docs/process/schemas/backend-architecture-identity.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.local/schemas/backend-architecture-identity.schema.json",
+  "title": "后端架构身份",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["architecture_family", "architecture_profile", "generator_skill", "requested_capabilities", "resolved_modules", "contract_digest", "verification_database", "production_database"],
+  "properties": {
+    "architecture_family": {"enum": ["domain-driven", "layered-mvc"]},
+    "architecture_profile": {"enum": ["target-domain-model", "layered-mvc-service", "mvc-data-analysis-v1"]},
+    "generator_skill": {"type": "string", "minLength": 1},
+    "requested_capabilities": {"type": "array", "uniqueItems": true, "items": {"type": "string"}},
+    "resolved_modules": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string"}},
+    "contract_digest": {"type": "string", "pattern": "^(sha256:)?[a-f0-9]{64}$"},
+    "verification_database": {"const": "h2"},
+    "production_database": {"const": "not-bound"}
+  },
+  "description": "各 Manifest kind、工程基线、仓库登记、Slice/work unit/Execution Result 引用此 schema；具体 Profile/生成器/模块闭包由 yss-skill-registry.yaml 定义并由 backend-architecture.mjs 校验。"
+}

package/template/docs/process/schemas/context-reconciliation.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/context-reconciliation.schema.json",
+  "title": "YSS Context Reconciliation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "repository_mode", "stage", "work_unit", "status", "context_snapshot", "changes", "unresolved_terms", "evidence_refs"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "repository_mode": { "enum": ["template-source", "project-instance"] },
+    "stage": { "type": "string", "pattern": "^stage\\.[a-z0-9][a-z0-9-]*$" },
+    "work_unit": { "type": "string", "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
+    "status": { "enum": ["reconciled", "not-applicable", "blocked"] },
+    "reason": { "type": "string", "minLength": 1 },
+    "context_snapshot": { "$ref": "#/$defs/contextSnapshot" },
+    "changes": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["added", "updated", "deprecated"],
+      "properties": {
+        "added": { "$ref": "#/$defs/termRefs" },
+        "updated": { "$ref": "#/$defs/termRefs" },
+        "deprecated": { "$ref": "#/$defs/termRefs" }
+      }
+    },
+    "unresolved_terms": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["term", "reason", "owner", "next_action"],
+        "properties": {
+          "term": { "type": "string", "minLength": 1 },
+          "reason": { "type": "string", "minLength": 1 },
+          "owner": { "type": "string", "minLength": 1 },
+          "next_action": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "evidence_refs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  },
+  "$defs": {
+    "termRefs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$" } },
+    "contextSnapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["context_ref", "context_schema_version", "document_digest", "referenced_terms_digest", "term_refs"],
+      "properties": {
+        "context_ref": { "const": "CONTEXT.md" },
+        "context_schema_version": { "const": 1 },
+        "document_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "referenced_terms_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "term_refs": { "$ref": "#/$defs/termRefs" }
+      }
+    }
+  }
+}

package/template/docs/process/schemas/digital-human-task-package.schema.json

@@ -48,6 +48,7 @@
         "gate_refs": { "type": "array", "items": { "type": "string", "minLength": 1 } }
       }
     },
+    "user_decisions": { "type": "array", "items": { "type": "object", "required": ["boundary", "subject_ref", "scope", "user_decision_ref"], "properties": { "boundary": { "type": "string" }, "subject_ref": { "type": "string" }, "scope": { "type": "array", "minItems": 1, "items": { "type": "string" } }, "user_decision_ref": { "type": "string" } }, "additionalProperties": false } },
     "inputs": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
     "allowed_read_paths": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
     "objective": { "type": "string", "minLength": 1 },
@@ -91,6 +92,15 @@
         "work_unit": { "type": "string", "minLength": 1 },
         "workflow_reference": { "type": "string", "minLength": 1 },
         "result": { "enum": ["completed", "blocked", "needs-human", "failed"] },
+        "context_reconciliation": {
+          "type": "object", "additionalProperties": false,
+          "required": ["status", "ref"],
+          "properties": {
+            "status": { "enum": ["reconciled", "not-applicable", "blocked"] },
+            "ref": { "type": "string", "minLength": 1 },
+            "reason": { "type": "string", "minLength": 1 }
+          }
+        },
         "skill": { "type": "string", "minLength": 1 },
         "changed_files": { "type": "array", "items": { "type": "string", "minLength": 1 } },
         "changed_artifacts": { "type": "array", "items": { "type": "string", "minLength": 1 } },

package/template/docs/process/schemas/frontend-implementation-evidence.schema.json

@@ -1,39 +1,72 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://yss.dev/schemas/frontend-implementation-evidence.schema.json",
+  "$id": "https://yss.dev/schemas/frontend-implementation-evidence-v2.json",
   "title": "YSS 前端实现还原证据",
   "type": "object",
-  "additionalProperties": true,
-  "required": ["schema_version", "kind", "template", "status", "prototype_ref", "spec_ref", "route_and_page_inventory"],
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "template", "status", "prototype_ref", "spec_ref", "visual_baseline", "route_and_page_inventory", "pnpm_commands"],
   "properties": {
-    "schema_version": { "const": 1 },
-    "kind": { "enum": ["plan", "verification"] },
-    "template": { "type": "boolean" },
-    "status": { "enum": ["draft", "approved", "blocked"] },
-    "prototype_ref": { "type": "string", "minLength": 1 },
-    "spec_ref": { "type": "string", "minLength": 1 },
-    "route_and_page_inventory": { "type": "array", "minItems": 1 },
-    "visual_acceptance_cases": { "type": "array", "minItems": 1 },
-    "desktop_viewport": { "type": "string", "minLength": 3 },
-    "narrow_viewport": { "type": "string", "minLength": 3 },
-    "state_cases": { "type": "array", "minItems": 1 },
-    "pnpm_commands": { "type": "array", "minItems": 1 },
-    "desktop_visual_evidence": { "type": "array", "minItems": 1 },
-    "narrow_view_visual_evidence": { "type": "array", "minItems": 1 },
-    "interaction_results": { "type": "array", "minItems": 1 },
-    "console_warning_check": { "enum": ["pass", "blocked"] },
-    "uncovered_differences": { "type": "array" },
-    "difference_owner": { "type": ["string", "null"] },
-    "independent_review": { "type": "object" }
+    "schema_version": {"const": 2},
+    "kind": {"enum": ["plan", "verification"]},
+    "template": {"type": "boolean"},
+    "status": {"enum": ["draft", "approved", "blocked", "stale"]},
+    "prototype_ref": {"type": "string", "minLength": 1},
+    "spec_ref": {"type": "string", "minLength": 1},
+    "visual_baseline": {"$ref": "#/$defs/visualBaseline"},
+    "route_and_page_inventory": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/routePage"}},
+    "baseline_case_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}},
+    "desktop_viewport": {"const": "1440x900"},
+    "narrow_viewport": {"const": "390x844"},
+    "state_cases": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "pnpm_commands": {"type": "array", "minItems": 1, "items": {"type": "string", "pattern": "^pnpm(?: |$)"}},
+    "case_results": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/caseResult"}},
+    "interaction_results": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "console_warning_check": {"enum": ["pass", "blocked"]},
+    "actual_verification": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/verification"}},
+    "uncovered_differences": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "difference_owner": {"type": ["string", "null"]},
+    "independent_review": {"$ref": "#/$defs/review"}
   },
   "allOf": [
-    {
-      "if": { "properties": { "kind": { "const": "plan" } } },
-      "then": { "required": ["visual_acceptance_cases", "desktop_viewport", "narrow_viewport", "state_cases", "pnpm_commands"] }
+    {"if": {"properties": {"kind": {"const": "plan"}}, "required": ["kind"]}, "then": {"required": ["baseline_case_ids", "desktop_viewport", "narrow_viewport", "state_cases"]}},
+    {"if": {"properties": {"kind": {"const": "verification"}}, "required": ["kind"]}, "then": {"required": ["case_results", "interaction_results", "console_warning_check", "actual_verification", "uncovered_differences", "difference_owner", "independent_review"]}}
+  ],
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^sha256:[a-f0-9]{64}$"},
+    "caseId": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
+    "visualBaseline": {
+      "type": "object", "additionalProperties": false,
+      "required": ["baseline_id", "version", "digest", "manifest_ref", "status", "case_ids"],
+      "properties": {
+        "baseline_id": {"type": "string", "pattern": "^visual-baseline\\.[a-z0-9][a-z0-9-]*$"},
+        "version": {"type": "string", "pattern": "^v[1-9][0-9]*$"},
+        "digest": {"$ref": "#/$defs/digest"}, "manifest_ref": {"type": "string", "minLength": 1}, "status": {"const": "approved"},
+        "case_ids": {"type": "array", "minItems": 2, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}}
+      }
     },
-    {
-      "if": { "properties": { "kind": { "const": "verification" } } },
-      "then": { "required": ["desktop_visual_evidence", "narrow_view_visual_evidence", "interaction_results", "console_warning_check", "pnpm_commands", "uncovered_differences", "difference_owner", "independent_review"] }
+    "routePage": {
+      "type": "object", "additionalProperties": false,
+      "required": ["route", "page", "case_ids"],
+      "properties": {"route": {"type": "string", "minLength": 1}, "page": {"type": "string", "minLength": 1}, "case_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/caseId"}}}
+    },
+    "caseResult": {
+      "type": "object", "additionalProperties": false,
+      "required": ["case_id", "baseline_image_ref", "implementation_image_ref", "diff_ref", "mask_ref", "result", "uncovered_difference", "explanation"],
+      "properties": {
+        "case_id": {"$ref": "#/$defs/caseId"}, "baseline_image_ref": {"type": "string", "minLength": 1}, "implementation_image_ref": {"type": "string", "minLength": 1},
+        "diff_ref": {"type": "string", "minLength": 1}, "mask_ref": {"type": "string", "minLength": 1}, "result": {"enum": ["pass", "blocked"]},
+        "uncovered_difference": {"type": "boolean"}, "explanation": {"type": "string"}
+      }
+    },
+    "verification": {
+      "type": "object", "additionalProperties": false,
+      "required": ["command", "exit_code", "executed_at", "evidence_ref"],
+      "properties": {"command": {"type": "string", "minLength": 1}, "exit_code": {"type": "integer"}, "executed_at": {"type": "string", "minLength": 1}, "evidence_ref": {"type": "string", "minLength": 1}}
+    },
+    "review": {
+      "type": "object", "additionalProperties": false,
+      "required": ["reviewer", "candidate_digest", "status", "findings_ref"],
+      "properties": {"reviewer": {"type": "string", "minLength": 1}, "candidate_digest": {"$ref": "#/$defs/digest"}, "status": {"enum": ["pending", "approved", "blocked"]}, "findings_ref": {"type": "string", "minLength": 1}}
     }
-  ]
+  }
 }

package/template/docs/process/schemas/lifecycle-checkpoint.schema.json

@@ -4,9 +4,10 @@
   "title": "YSS 生命周期 Checkpoint",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schema_version", "mode", "status", "stage", "artifacts", "gates", "next_work_unit", "ticket_sync", "verification", "human_review", "git_checkpoint", "blockers", "rollback"],
+  "required": ["schema_version", "repository_mode", "mode", "status", "stage", "artifacts", "gates", "context_reconciliation", "next_work_unit", "ticket_sync", "verification", "human_review", "git_checkpoint", "blockers", "rollback"],
   "properties": {
     "schema_version": { "const": 1 },
+    "repository_mode": { "enum": ["template-source", "project-instance"] },
     "mode": { "enum": ["route", "orchestrate", "resume", "audit"] },
     "status": { "enum": ["routing", "running", "paused-human-gate", "blocked", "completed"] },
     "stage": { "type": "string", "pattern": "^stage\\.[a-z0-9][a-z0-9-]*$" },
@@ -38,12 +39,25 @@
             "status": { "enum": ["not-evaluated", "blocked", "ready-for-human", "approved", "stale", "not-applicable"] },
             "reason": { "type": "string" },
             "evidence_refs": { "type": "array", "items": { "type": "string" } },
-            "approval_ref": { "type": ["string", "null"] }
+            "approval_ref": { "type": ["string", "null"] },
+            "subject_ref": { "type": "string", "minLength": 1 },
+            "approval_scope": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
           }
         }
       },
       "additionalProperties": false
     },
+    "context_reconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "ref", "evidence_refs"],
+      "properties": {
+        "status": { "enum": ["pending", "reconciled", "not-applicable", "blocked"] },
+        "ref": { "type": ["string", "null"] },
+        "reason": { "type": "string" },
+        "evidence_refs": { "type": "array", "items": { "type": "string" } }
+      }
+    },
     "next_work_unit": { "type": ["string", "null"], "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
     "phase_boundary": { "type": "object" },
     "stage_trace": { "type": "object" },

package/template/docs/process/schemas/lifecycle-registry.schema.json

@@ -27,9 +27,9 @@
   },
   "$defs": {
     "id": { "type": "string", "pattern": "^(stage|gate|artifact|work-unit|evidence)\\.[a-z0-9][a-z0-9-]*$" },
-    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 } } } },
-    "objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "stage", "trigger"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "pattern": "^stage\\." }, "trigger": { "type": "string", "minLength": 1 }, "evidence": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^evidence\\." } }, "requires_gates": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^gate\\." } } } } },
-    "workUnits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "scope", "input", "output", "completion"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "scope": { "enum": ["template-source", "project-instance"] }, "input": { "type": "string", "minLength": 1 }, "output": { "type": "string", "minLength": 1 }, "completion": { "type": "string", "minLength": 1 } } } },
-    "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "description"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 } } } }
+    "stages": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "goal", "exit_criteria"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "goal": { "type": "string", "minLength": 1 }, "exit_criteria": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_goal": { "type": "string", "minLength": 1 }, "public_exit_criteria": { "type": "string", "minLength": 1 } } } },
+    "objects": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "stage", "trigger"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "pattern": "^stage\\." }, "trigger": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_trigger": { "type": "string", "minLength": 1 }, "evidence": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^evidence\\." } }, "requires_gates": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^gate\\." } } } } },
+    "workUnits": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "scope", "input", "output", "completion"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "scope": { "enum": ["template-source", "project-instance"] }, "input": { "type": "string", "minLength": 1 }, "output": { "type": "string", "minLength": 1 }, "completion": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_input": { "type": "string", "minLength": 1 }, "public_output": { "type": "string", "minLength": 1 }, "public_completion": { "type": "string", "minLength": 1 } } } },
+    "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "name", "description"], "properties": { "id": { "$ref": "#/$defs/id" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "public_name": { "type": "string", "minLength": 1 }, "public_description": { "type": "string", "minLength": 1 } } } }
   }
 }

package/template/docs/process/schemas/scaffold-architecture-decisions.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/scaffold-architecture-decisions-v1.json",
+  "title": "YSS 后端脚手架架构选择记录",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "template", "status", "decisions"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "scaffold-architecture-decisions" },
+    "template": { "type": "boolean" },
+    "status": { "enum": ["draft", "current", "stale", "blocked"] },
+    "decisions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/decision" }
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "architecture": { "enum": ["domain-driven", "layered-mvc"] },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "decision_id", "project_id", "parent_project_id", "status",
+        "recommended_architecture", "recommendation_reasons", "confirmed_architecture",
+        "override_reason", "inheritance_mode", "inherited_from", "platform_profile",
+        "architecture_profile", "verification_database", "production_database", "requested_capabilities", "resolved_modules",
+        "resolution_version", "user_confirmation", "decision_inputs_digest"
+      ],
+      "properties": {
+        "decision_id": { "type": "string", "pattern": "^scaffold-decision\\.[a-z][a-z0-9-]*$" },
+        "project_id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "parent_project_id": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]*$" },
+        "status": { "enum": ["undecided", "recommended", "awaiting-user-decision", "user-confirmed", "lifecycle-approved", "consumed", "stale"] },
+        "recommended_architecture": { "$ref": "#/$defs/architecture" },
+        "recommendation_reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "confirmed_architecture": { "anyOf": [{ "$ref": "#/$defs/architecture" }, { "type": "null" }] },
+        "override_reason": { "type": ["string", "null"] },
+        "inheritance_mode": { "enum": ["root-default", "inherit", "override"] },
+        "inherited_from": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]*$" },
+        "platform_profile": { "const": "spring-boot-2.7-jdk8" },
+        "architecture_profile": { "enum": ["target-domain-model", "layered-mvc-service", "mvc-data-analysis-v1"] },
+        "verification_database": { "const": "h2" },
+        "production_database": { "const": "not-bound" },
+        "requested_capabilities": { "type": "array", "uniqueItems": true, "items": { "enum": ["external-integration", "published-client", "feign-client"] } },
+        "resolved_modules": { "type": "array", "minItems": 3, "uniqueItems": true, "items": { "enum": ["server", "core", "service", "repository", "adapter", "client", "feign-client", "domain", "application", "infrastructure", "bootstrap"] } },
+        "resolution_version": { "const": 1 },
+        "user_confirmation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["confirmed_by", "channel", "confirmation_ref", "confirmed_at", "normalized_text"],
+          "properties": {
+            "user_decision_ref": { "type": ["string", "null"] },
+            "decision_subject_ref": { "type": ["string", "null"] },
+            "confirmed_by": { "type": ["string", "null"] },
+            "channel": { "type": ["string", "null"] },
+            "confirmation_ref": { "type": ["string", "null"] },
+            "confirmed_at": { "type": ["string", "null"], "format": "date-time" },
+            "normalized_text": { "type": ["string", "null"] }
+          }
+        },
+        "decision_inputs_digest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}