create-yss-spec 3.5.3 → 3.5.5

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

@@ -98,6 +98,7 @@ evidence:
     description: 聚合、Entity、Value Object、不变量、状态机、一致性、Gateway 与 API 隔离的结构化评审结果。
   - id: evidence.stage-decision-package
     name: 阶段决策包验证证据
+    public_name: 方案决策包验证证据
     description: 阶段决策包的 Schema、引用、语义一致性、影响传播和下游消费验证结果。
   - id: evidence.maintenance-intensity-checkpoint
     name: 模板维护强度 checkpoint
@@ -338,6 +339,10 @@ artifacts:
     name: 复盘记录
     stage: stage.verification-release-retrospective
     trigger: 发布后或阶段性完成后满足复盘触发条件。
+  - id: artifact.business-ticket-set
+    name: 业务 Ticket 集
+    stage: stage.spec-architecture
+    trigger: Spec 同步起草、Design 校准和战略业务正式化；不依赖实现工程，不授予实现资格。
 
 work_units:
   - id: work-unit.maintenance-research
@@ -423,23 +428,23 @@ work_units:
     completion: 必填字段、引用、影响面和下游消费验证通过；批准门禁完成。
     public_name: 方案决策包综合
     public_input: Plan、业务边界与规则设计以及产品经理负责的商业约束输入。
-    public_output: 带版本、digest、证据和下游映射的方案决策包。
+    public_output: 汇总规划结论、业务边界和商业约束，形成带版本、内容摘要、证据及后续 Spec 使用关系的方案决策包。
   - id: work-unit.spec-synthesis
     name: Spec 综合
     scope: project-instance
     input: 已确认的 Plan 记录和测试 seam。
-    output: Spec、产品总体设计和功能架构。
-    completion: Spec 内容完整并进入 ready-for-human；下游推进仍需 gate.spec-baseline-approved。
+    output: Spec、产品总体设计、功能架构及业务 Ticket 草案集合。
+    completion: Spec 和业务 Ticket 草案可审查，FR/AC 覆盖与依赖可读取；进入 ready-for-human，下游推进仍需 gate.spec-baseline-approved。
   - id: work-unit.prototype-design-v2
     name: 原型设计与验证
     scope: project-instance
     input: Spec、产品设计影响和状态矩阵。
     output: 交互说明、低保真、状态矩阵、H1/H2 原型交付物、统一 Design QA、档位验证证据与前端实现交接事项。
-    completion: 低保真评审、schema v4 原型交付物验证和用户确认门禁均通过；Visual Baseline Bundle 和生产组件待验事项已交接到前端实现计划。
+    completion: 低保真评审、schema v4 原型交付物验证和用户确认门禁均通过；Visual Baseline Bundle 和生产组件待验事项已交接到前端实现计划。 同步校准业务 Ticket，复用稳定 ID，随后进入业务正式化。
   - id: work-unit.technical-analysis
     name: 技术分析与契约冻结
     scope: project-instance
-    input: Spec、原型、API/数据/工程影响面；新建后端的架构与平台候选，或既有工程当前登记的架构与平台配置。
+    input: 已正式化业务 Ticket 集及 Spec、原型、API/数据/工程影响面；新建后端的架构与平台候选，或既有工程当前登记的架构与平台配置。
     output: 新建后端的 DDD / MVC 与精确 Spring Boot 版本用户决定，或既有工程复用核验；OpenAPI、数据架构、按确认架构形成的 DDD / MVC 技术设计合同、工程基线、架构审查和 Slice 合同草案。
     completion: 新建后端的 gate.backend-architecture-platform-approved 已通过，既有工程已核验复用并记录该门禁不适用；命中契约已冻结；无 API 影响有可读记录；所有后端交付均有批准且当前的 Technical Design；数据影响为真时数据架构已批准，否则有可核验的不适用记录；架构、规则与场景承接无未解释冲突；gate.engineering-contract-approved 通过。
   - id: work-unit.implementation-repository-preparation
@@ -457,7 +462,7 @@ work_units:
   - id: work-unit.ticket-decomposition
     name: 垂直切片 Ticket 正式化
     scope: project-instance
-    input: 冻结 Spec、设计、契约和阻塞关系。
+    input: 已正式化业务 Ticket、冻结 Spec、设计、契约、当前实现仓库准备和阻塞关系。
     output: 更新既有功能父 Ticket 的关联、形成垂直切片和批准的 Slice Implementation Contract。
     completion: 切片可独立验证；生命周期复算后才能 ready-for-agent。
   - id: work-unit.slice-implementation
@@ -490,6 +495,12 @@ work_units:
     input: 已审查候选、发布窗口和回滚点。
     output: 发布/回滚证据和复盘记录。
     completion: 人工发布裁决、fresh verification 和治理回流均完成。
+  - id: work-unit.business-ticket-formalization
+    name: 业务 Ticket 正式化
+    scope: project-instance
+    input: 当前 Spec、适用的产品设计批准、业务 Ticket 草案集合和独立专业审查。
+    output: 可追溯 FR/AC、规则、场景与设计的业务 Ticket 集；保持 ready-for-human。
+    completion: 当前业务覆盖完整，无阻断未决项；既有批准或授权延续有效，专业审查当前。战略交接或技术分析可继续，不授予 ready-for-agent。
 checks:
   - id: check.frontend-delivery-inputs-verified
     name: 前端联合输入核验
@@ -514,6 +525,7 @@ checks:
       - evidence.approval-record
   - id: check.stage-decision-package-approved
     name: 阶段决策包评审
+    public_name: 方案决策包评审
     stage: stage.plan
     trigger: Plan 到 Spec 入口需要稳定的阶段决策合同。
     evidence:

package/template/.template-spec/process/plan-spec-quality.md

@@ -0,0 +1,69 @@
+# Plan / Spec 内容诊断
+
+本说明持有可选创作格式 `content_profile: plan-spec-v1` 与只读诊断用法。生命周期阶段、门禁、批准及工作单元仍引用 [生命周期注册表](lifecycle-registry.yaml)，中文写作仍引用 [文档规范](document-writing.md)。本工具不修改文档、状态、批准或就绪结果，不输出流转许可。
+
+## 起草与单一事实来源
+
+Plan 使用 [权威 Plan 模板](../plan/templates/plan-template.md)，Spec 使用 [权威 Spec 模板](../templates/spec-template.md)，常规入口与 `to-spec` 共用它们。Plan 负责战略决策，Spec 定义可观察行为；技术架构、OpenAPI Freeze、切片实现由现有下游阶段承接。
+
+新文档默认带 `content_profile`；它不是生命周期 schema 或批准状态。既有文档无需批量迁移，历史批准、交接快照与 YAML 合同保持兼容。明确选择的存量功能可以改用新格式，实质变化按原有用户决定协议处理。
+
+已有决策包时，成功标准的指标定义、基线或未知原因、目标及确认状态、观测窗口、数据来源、验证方式和补齐动作写入现有 `success_criteria[].statement`，Plan 使用 `success-criterion.*` 的权威引用表。关键取舍复用 `decision.*`，无需新 schema，也不凑固定数量候选。该 statement 的内容完整性由人工审阅；工具只核验引用。未命中决策包的轻量场景使用 Plan 直接填写表。
+
+## 可机械读取的约定
+
+正式条目放在 Markdown 根层级表中，第一列表头为 `ID`，位于模板的“功能需求”“非功能需求”“验收标准”“未决项”“成功标准”章节内（支持章节数字前缀）。表头使用模板原文；一张表对应一类条目。代码块、引用块、列表内示例，以及“示例 / example”标题下的表不会计入正式条目。未支持的表达会报告未评估，不根据关键词数量推断覆盖率。
+
+- FR / NFR / AC ID 在同一功能内稳定，重排不重新编号，删除后不复用。Q 为当前文档的未决项 ID，SC 为轻量成功标准 ID。工具只识别显式基线，无法证明全部历史中从未复用 ID。
+- 需求的“验收引用”填 AC ID；AC 的“需求引用”反向填 FR/NFR ID。多个 ID 可用逗号分隔。验收待补时填写 `待补 Q-001`，未决项登记负责人、补齐动作、时点、接收方和影响依据；工具报告“未评估验收覆盖”，是否可延期仍由现有门禁决定。
+- NFR 可用数值及单位，也可用定性判断依据；测试、检查、分析、演示都是合法方法。未知目标保持候选状态并关联 Q，工具不判断目标是否合理。
+- 没有适用约束的条件章节写 `not-applicable：具体原因`。不保留空白占位行。确定性诊断只检查支持的章节和字段，其他条件项由人工核对。
+
+“来源引用”“数据来源”“权威引用”使用项目根相对路径和定位器：
+
+```text
+docs/input.md :: id:rule.submit
+docs/input.md :: heading:原始需求
+contracts/decision.yaml :: id:success-criterion.attachments
+[S1](docs/input.md)
+[输入](docs/input.md#heading:原始需求)
+```
+
+多个来源用 `；` 分隔。Markdown `id:` 匹配根层级表第一列已有 ID，`heading:` 精确匹配实际标题文字，不生成锚点。YAML/JSON 的 `id:` 匹配已有对象 `id` 字段或映射键，匹配多处即歧义。Markdown 链接以明确 locator / 标签定位，普通网页 slug 不自动推断。链接仅用于读取，不执行内容。来源文件最多 8 MiB、UTF-8、真实路径须在项目根内；外部 URL 不联网，提示补充本地证据快照。不递归追踪来源中的更多链接，不扫描整个仓库猜关联。
+
+## 命令与报告
+
+```bash
+node scripts/inspect-plan-spec check --root . --plan docs/feature/plan.md --spec docs/feature/spec.md --json
+node scripts/inspect-plan-spec check --root . --spec docs/feature/spec.md --slice docs/feature/slice.yaml
+node scripts/inspect-plan-spec diff --root . --before docs/baseline/spec.md --after docs/feature/spec.md --json
+```
+
+`check` 至少指定 Plan、Spec 之一，`--slice` 可重复且需要 `--spec`。默认向 stdout 输出文本；`--json` 输出 JSON。文本和 JSON 绑定相同工具版本与所有实际读取文件的 SHA-256，报告包含发现、位置、条目 ID、恢复建议、未评估项和人工审阅范围。无发现只表示支持范围内未发现机械问题。
+
+| 退出码 | 含义 |
+|---|---|
+| 0 | 诊断执行完成，可有重复 ID、断链、内容缺漏等发现 |
+| 2 | 输入缺失 / 不可读、解析未完成或输入在读取期间漂移；需恢复并重跑 |
+
+主要规则：`DUPLICATE_ID`、`INVALID_ID`、`DANGLING_REFERENCE`、`REFERENCE_KIND`、`REFERENCE_MISMATCH`、`AC_MISSING`、`REQUIREMENT_MISSING`、`REQUIRED_FIELD`、`PLACEHOLDER`、`UNKNOWN_TARGET`、`UNKNOWN_BASELINE`、`TARGET_STATUS`、`NA_REASON`、`SOURCE_FORMAT`、`SOURCE_LOCATOR`、`INPUT_UNREADABLE`、`PARSE_ERROR`、`INPUT_DRIFT`。缺少结构的章节使用 `SECTION_MISSING` / `SECTION_UNPARSED`，旧格式使用 `LEGACY_OR_UNKNOWN_PROFILE` 标记部分未评估。
+
+问题真实性、方案优劣、目标合理性、验收场景充分性、原规则保真与语义等价均为人工审查事项。全文正文、风险和非目标仍必须审阅，不能只读结构化表。输入新鲜度是本次读取前后字节与真实路径一致，不等于未来仍有效。
+
+## 差异与下游追溯
+
+`diff` 按稳定 ID 展示新增、修改、删除及引用字段变化；ID 重复时该条目无法唯一比较。原始差异同时提供共同前缀 / 后缀字节数、被替换字节和新增字节的 Base64，结合旧基线可精确还原新文件；章节正文、换行、重排和格式变化不会丢失。它不声称文本变化一定改变语义。旧基线缺失显示“无法比较旧内容”，不得用空文档冒充旧版本。
+
+章节缺失、表头无法识别或格式未支持时，差异状态为 `partially-compared`，明确列出未评估范围；提取缺口不能直接解释为新增或删除，受影响条目标记 `unassessed`。仍保留完整原始字节差异。显式 Slice YAML 解析失败与其他输入解析失败一样返回 `2`；YAML 可解析但 schema 不支持时，保留未评估说明。
+
+Spec Delta 仍只处理既有冻结基线的适用高风险变化，引用 FR/NFR/AC 与旧 / 新文件。新增 diff 不扩大 Delta 适用范围，不自动延续批准或缩小验证。
+
+可选 `--slice` 读取既有 Slice schema v3 的 `acceptance.<ID>.source` 与 `locator`（AC ID 或 `id:AC-001`），沿 `verification.*.acceptance_refs` 和 `work_units.*.acceptance_refs` 生成追溯视图。该视图展示验证命令和预期证据引用，不执行命令、不核验批准或证据结果，也不替代 Slice schema 检查。未映射需求、失效定位、缺验证映射和未提供的依赖显示缺口；不得解释为“未受影响”。没有第二份手工追溯合同。
+
+## 样本、分发与回退
+
+[贯穿案例](../templates/examples/lifecycle-writing-examples.md) 关联三类虚构固定样本及预登记反例。确定性 fixture 仅证明诊断行为；人工填写、审阅时间、澄清轮次、遗漏、返工和 Token 必须有实际记录才统计。未取得人工反馈时，效果保持待验证；不恢复已取消的跨平台 Agent 评测。
+
+解析采用 [unified](https://github.com/unifiedjs/unified)、[remark-parse](https://github.com/remarkjs/remark/tree/main/packages/remark-parse)、[remark-gfm](https://github.com/remarkjs/remark-gfm)；frontmatter 使用现有 YAML 工具。维护侧由 pnpm 精确锁定和 vendor 构建分发；实例运行无须安装依赖。
+
+本轮始终为独立诊断，不接入阶段阻断。回退时停用诊断调用和新模板默认入口，保留已生成文档、格式读取能力及证据；不回写历史资产或恢复过期批准。升级门禁须另立变更。

package/template/.template-spec/process/project-ci.md

@@ -0,0 +1,21 @@
+# 项目治理 CI 与恢复预检
+
+此入口适用于 `project-instance`。初始化、同步仅分发工具，不自动写 `.github`；业务构建仍使用实现仓库的工作流。远端分支保护由维护者配置，不由本工具更改。
+
+```sh
+node scripts/project-ci plan --provider github --root . --branch main > /tmp/yss-ci-plan.json
+node scripts/project-ci apply --root . --plan /tmp/yss-ci-plan.json
+node scripts/project-ci check --root . --json
+node scripts/project-ci check --root . --base <PR基线的40位提交> --json
+node scripts/lifecycle-status --root . --checkpoint docs/.scratch/feature/checkpoint.yaml --preflight
+```
+
+计划列出目标分支、范围、文件内容、输入摘要和冲突。仅显式 apply 写入独立工作流、接入配置和托管凭据；保留其他工作流。输出文件已被手工修改、计划过期或同名文件未托管时拒绝覆盖。中断后执行 `node scripts/project-ci apply --root . --recover`，按事务日志恢复旧字节；遇到后续人工修改时停止并保留现场。重复 apply 无变化；tracker 或工具输入变化后须重新 plan。
+
+范围来自 `.template-spec/agents/issue-tracker.md` 的 `tracker.root`，可用重复的 `--additional-path <根相对路径>` 显式补充。接入配置只登记范围与分支，不复制阶段状态。完整检查范围内已登记记录及其本地引用闭包；草案允许缺少未来阶段产物。当前批准、完成、流转和 `ready-for-agent` 声明必须具有可校验的依据。当前流转由 `stage_trace.completed_work_unit` 与 `next_work_unit` 交给现有流转校验器核验。只安装当前阶段能力即可；命中未来阶段检查但工具尚未安装时报告能力缺失，显式补齐后重验。
+
+报告包含实际校验命令、输入引用及摘要、退出码、耗时、日志、未知资产和诊断。命令来自固定校验入口；不会执行 checkpoint/合同中自由填写的业务命令。普通状态查询仍只读状态；只有 `--preflight` 执行当前校验。运行中、失败或未知任务不能当成完成或自动重复派发；任务结果确认后由主控恢复。
+
+GitHub 工作流运行于 PR、计划中目标分支 push、手动执行，固定汇总检查名 `YSS governance`，日志以 artifact 保留。PR 对照目标基线检查范围缩小、checkpoint 删除和批准依据删除。删除或归档必须先形成可审阅的显式处置，不能靠删除记录使检查变绿。维护者可在远端将 `YSS governance` 设为 required check；本地通过不代表远端已配置。
+
+`project-ci` 与恢复预检：0=适用检查通过或计划/应用成功；1=检查失败或计划冲突；2=输入、能力或执行异常。JSON 的 `status` 和诊断必须一起读取。查询工具的 0 只表示诊断执行完成，不能替代批准、执行授权或发布结论。`--history` 仅供历史记录只读兼容，CI、当前流转和恢复预检不使用历史结果放行。

package/template/.template-spec/process/reading-policy.yaml

@@ -0,0 +1,4 @@
+# 实际人工阅读试验通过前，新实例保持手动；存量实例由 contract plan-enable/apply-enable 显式登记。
+schema_version: 1
+mode: manual
+checkpoints: []

package/template/.template-spec/process/schemas/approval-record.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/approval-record.schema.json",
+  "title": "YSS standalone approval record v1",
+  "type": "object",
+  "required": ["schema_version", "gate_id", "decision", "actor_kind", "role_id", "runtime_id", "principal_ref"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "gate_id": {"type": "string", "minLength": 1},
+    "decision": {"enum": ["approved", "rejected", "vetoed"]},
+    "actor_kind": {"enum": ["digital-human", "biological-human", "orchestrator"]},
+    "role_id": {"type": "string", "minLength": 1},
+    "runtime_id": {"type": "string", "minLength": 1},
+    "principal_ref": {"type": "string", "minLength": 1},
+    "subject_ref": {"type": ["string", "null"]},
+    "subject_digest": {"type": ["string", "null"], "pattern": "^(sha256:)?[a-f0-9]{64}$"},
+    "approval_scope": {"type": "array", "items": {"type": "string", "minLength": 1}, "uniqueItems": true},
+    "biological_veto": {"type": "boolean"},
+    "evidence_refs": {"type": "array"},
+    "countersigner_role_ids": {"type": "array", "items": {"type": "string", "minLength": 1}}
+  },
+  "$comment": "Preserves the existing extensible record contract. Role, subject freshness, source and approval semantics are checked by approval-record.mjs."
+}

package/template/.template-spec/process/schemas/business-tickets-v1.schema.json

@@ -0,0 +1,449 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "business-tickets-v1",
+  "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schema_version": {
+          "const": 1
+        },
+        "kind": {
+          "const": "business-ticket"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^BT-[A-Za-z0-9][A-Za-z0-9._-]*$"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v[1-9][0-9]*$"
+        },
+        "status": {
+          "enum": [
+            "draft",
+            "ready-for-human"
+          ]
+        },
+        "spec": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "version": {
+              "type": "string",
+              "pattern": "^v[1-9][0-9]*$"
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "locator": {
+              "type": "string",
+              "minLength": 1
+            },
+            "locator_kind": {
+              "enum": [
+                "id",
+                "heading"
+              ]
+            }
+          },
+          "required": [
+            "ref",
+            "version",
+            "digest"
+          ]
+        },
+        "requirement_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "acceptance_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 0,
+          "uniqueItems": true
+        },
+        "source_refs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "version": {
+                "type": "string",
+                "pattern": "^v[1-9][0-9]*$"
+              },
+              "digest": {
+                "type": "string",
+                "pattern": "^sha256:[a-f0-9]{64}$"
+              },
+              "locator": {
+                "type": "string",
+                "minLength": 1
+              },
+              "locator_kind": {
+                "enum": [
+                  "id",
+                  "heading"
+                ]
+              }
+            },
+            "required": [
+              "ref",
+              "version",
+              "digest"
+            ]
+          },
+          "minItems": 0,
+          "uniqueItems": true
+        },
+        "open_questions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "question": {
+                "type": "string",
+                "minLength": 1
+              },
+              "owner": {
+                "type": "string",
+                "minLength": 1
+              },
+              "resolve_by": {
+                "type": "string",
+                "minLength": 1
+              },
+              "blocking": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "id",
+              "question",
+              "owner",
+              "resolve_by",
+              "blocking"
+            ]
+          },
+          "minItems": 0,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "schema_version",
+        "kind",
+        "id",
+        "version",
+        "status",
+        "spec",
+        "requirement_refs",
+        "acceptance_refs",
+        "dependencies",
+        "source_refs",
+        "open_questions"
+      ]
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schema_version": {
+          "const": 1
+        },
+        "kind": {
+          "const": "business-ticket-set"
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v[1-9][0-9]*$"
+        },
+        "status": {
+          "enum": [
+            "draft",
+            "ready-for-human"
+          ]
+        },
+        "spec": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "version": {
+              "type": "string",
+              "pattern": "^v[1-9][0-9]*$"
+            },
+            "digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "locator": {
+              "type": "string",
+              "minLength": 1
+            },
+            "locator_kind": {
+              "enum": [
+                "id",
+                "heading"
+              ]
+            }
+          },
+          "required": [
+            "ref",
+            "version",
+            "digest"
+          ]
+        },
+        "tickets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "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}$"
+              }
+            },
+            "required": [
+              "id",
+              "ref",
+              "version",
+              "digest"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "coverage_deferred": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "reason": {
+                "type": "string",
+                "minLength": 1
+              },
+              "risk": {
+                "type": "string",
+                "minLength": 1
+              },
+              "owner": {
+                "type": "string",
+                "minLength": 1
+              },
+              "target_version": {
+                "type": "string",
+                "minLength": 1
+              },
+              "followup_ticket_ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "verification_plan": {
+                "type": "string",
+                "minLength": 1
+              },
+              "decision": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "version": {
+                    "type": "string",
+                    "pattern": "^v[1-9][0-9]*$"
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^sha256:[a-f0-9]{64}$"
+                  },
+                  "locator": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "locator_kind": {
+                    "enum": [
+                      "id",
+                      "heading"
+                    ]
+                  }
+                },
+                "required": [
+                  "ref",
+                  "version",
+                  "digest"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "reason",
+              "risk",
+              "owner",
+              "target_version",
+              "followup_ticket_ref",
+              "verification_plan"
+            ]
+          },
+          "minItems": 0,
+          "uniqueItems": true
+        },
+        "review_ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "required": [
+        "schema_version",
+        "kind",
+        "id",
+        "version",
+        "status",
+        "spec",
+        "tickets",
+        "coverage_deferred"
+      ]
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schema_version": {
+          "const": 1
+        },
+        "kind": {
+          "const": "business-ticket-review"
+        },
+        "result": {
+          "enum": [
+            "passed",
+            "blocked"
+          ]
+        },
+        "subject_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "subject_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "reviewer": {
+          "type": "string",
+          "minLength": 1
+        },
+        "drafter": {
+          "type": "string",
+          "minLength": 1
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "version": {
+                "type": "string",
+                "pattern": "^v[1-9][0-9]*$"
+              },
+              "digest": {
+                "type": "string",
+                "pattern": "^sha256:[a-f0-9]{64}$"
+              },
+              "locator": {
+                "type": "string",
+                "minLength": 1
+              },
+              "locator_kind": {
+                "enum": [
+                  "id",
+                  "heading"
+                ]
+              }
+            },
+            "required": [
+              "ref",
+              "version",
+              "digest"
+            ]
+          },
+          "minItems": 1,
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "schema_version",
+        "kind",
+        "result",
+        "subject_ref",
+        "subject_digest",
+        "reviewer",
+        "drafter",
+        "evidence"
+      ]
+    }
+  ]
+}