create-yss-spec 2.1.2 → 2.1.4

package/template/scripts/verify-openapi-json-handoff-scenarios

@@ -0,0 +1,270 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "digest"
+require "json"
+require "tmpdir"
+require "yaml"
+
+# This validates the YAML-to-JSON handoff contract rather than invoking
+# Redocly or any frontend generator. These fixtures prove that a JSON
+# derivative preserves the frozen OpenAPI semantics and can be handed to an
+# implementation repository as unchanged bytes.
+module OpenapiJsonHandoff
+  module_function
+
+  def validate!(source_yaml:, source_json:, materialized_json:, handoff:, **_unused)
+    validate_source_paths!(handoff)
+    assert!(handoff.fetch("freeze_status") == "approved", "OpenAPI Freeze 未批准")
+    assert!(handoff.fetch("export_status") == "exported", "JSON 导出未完成")
+    assert!(!handoff.fetch("freeze_record").to_s.empty?, "缺少 OpenAPI Freeze 记录")
+    assert!(!handoff.fetch("export_record").to_s.empty?, "缺少 OpenAPI JSON 派生记录")
+
+    yaml_documents = YAML.load_stream(File.binread(source_yaml).force_encoding("UTF-8"))
+    assert!(yaml_documents.length == 1, "YAML 必须是单一 document")
+    assert!(yaml_documents.first.is_a?(Hash) && yaml_documents.first["openapi"] == "3.1.0", "YAML 必须是 OAS 3.1")
+
+    json_document = JSON.parse(File.binread(source_json))
+    assert!(json_document["openapi"] == "3.1.0", "JSON 必须是 OAS 3.1")
+    validate_operation_contract!(yaml_documents.first, json_document)
+    validate_json_refs!(json_document)
+    assert!(Digest::SHA256.file(source_yaml).hexdigest == handoff.fetch("yaml_sha256"), "YAML SHA-256 不匹配")
+    assert!(Digest::SHA256.file(source_json).hexdigest == handoff.fetch("json_sha256"), "JSON SHA-256 不匹配")
+    assert!(Digest::SHA256.file(materialized_json).hexdigest == handoff.fetch("json_sha256"), "前端物化 JSON 与导出记录不一致")
+
+    bundle_command = handoff.fetch("bundle_command")
+    %w[pnpm\ exec\ redocly\ bundle --ext\ json --component-renaming-conflicts-severity=error].each do |marker|
+      assert!(bundle_command.include?(marker), "bundle 命令缺少 #{marker}")
+    end
+    assert!(bundle_command.include?(handoff.fetch("source_yaml")), "bundle 命令未使用冻结 YAML")
+    assert!(bundle_command.include?(handoff.fetch("source_json")), "bundle 命令未写入记录的 JSON")
+    assert!(!bundle_command.match?(/(?:\bmvn\b|smart[ _-]?doc)/i), "bundle 命令包含已移除的 Maven OpenAPI 链路")
+
+  end
+
+  def validate_operation_contract!(yaml_document, json_document)
+    yaml_operations = operation_contracts(yaml_document)
+    json_operations = operation_contracts(json_document)
+    assert!(!yaml_operations.empty?, "YAML 缺少可生成客户端的操作")
+    assert!(yaml_operations == json_operations, "JSON 未保留 YAML 的路径、方法、operationId、请求或响应契约")
+    ids = yaml_operations.values.map { |contract| contract.fetch("operationId") }
+    assert!(ids.all? { |operation_id| operation_id.is_a?(String) && !operation_id.empty? }, "operationId 必须为非空字符串")
+    assert!(ids.uniq.length == ids.length, "operationId 必须唯一")
+  end
+
+  def operation_contracts(document)
+    methods = %w[get put post delete options head patch trace]
+    paths = document.fetch("paths", {})
+    paths.each_with_object({}) do |(path, path_item), operations|
+      next unless path_item.is_a?(Hash)
+
+      path_item.each do |method, operation|
+        next unless methods.include?(method.to_s.downcase) && operation.is_a?(Hash)
+
+        operations["#{method.to_s.upcase} #{path}"] = {
+          "operationId" => operation["operationId"],
+          "parameters" => operation.fetch("parameters", []),
+          "requestBody" => operation["requestBody"],
+          "responses" => operation.fetch("responses", {})
+        }
+      end
+    end
+  end
+
+  def validate_json_refs!(document)
+    refs = []
+    collect_refs(document, refs)
+    refs.each do |ref|
+      assert!(ref.start_with?("#/"), "JSON 不得包含外部或远程 $ref: #{ref}")
+      resolve_json_pointer!(document, ref)
+    end
+  end
+
+  def collect_refs(value, refs)
+    case value
+    when Hash
+      refs << value["$ref"] if value["$ref"].is_a?(String)
+      value.each_value { |child| collect_refs(child, refs) }
+    when Array
+      value.each { |child| collect_refs(child, refs) }
+    end
+  end
+
+  def resolve_json_pointer!(document, ref)
+    ref.delete_prefix("#/").split("/").reduce(document) do |node, segment|
+      key = segment.gsub("~1", "/").gsub("~0", "~")
+      assert!(node.is_a?(Hash) && node.key?(key), "JSON $ref 无法解析: #{ref}")
+      node.fetch(key)
+    end
+  end
+
+  def validate_source_paths!(handoff)
+    yaml_path = handoff.fetch("source_yaml")
+    json_path = handoff.fetch("source_json")
+    match = %r{\Adocs/\.scratch/([^/]+)/api/([^/]+)\.yaml\z}.match(yaml_path)
+    assert!(!match.nil? && match[1] == match[2], "冻结 YAML 路径不符合 feature 约定")
+    assert!(json_path == "docs/.scratch/#{match[1]}/api/#{match[2]}.json", "JSON 必须与冻结 YAML 同 feature 同目录")
+  end
+
+  def assert!(condition, message)
+    raise ArgumentError, message unless condition
+  end
+end
+
+def build_context(root)
+  feature = "order"
+  api_dir = File.join(root, "docs", ".scratch", feature, "api")
+  frontend_dir = File.join(root, "frontend", "openapi")
+  Dir.mkdir(File.join(root, "docs"))
+  Dir.mkdir(File.join(root, "docs", ".scratch"))
+  Dir.mkdir(File.join(root, "docs", ".scratch", feature))
+  Dir.mkdir(api_dir)
+  Dir.mkdir(File.join(root, "frontend"))
+  Dir.mkdir(frontend_dir)
+
+  source_yaml = File.join(api_dir, "#{feature}.yaml")
+  source_json = File.join(api_dir, "#{feature}.json")
+  materialized_json = File.join(frontend_dir, "openapi.json")
+  File.write(source_yaml, <<~YAML)
+    openapi: 3.1.0
+    info:
+      title: Order API
+      version: 1.0.0
+    paths:
+      /api/v1/orders/{orderId}:
+        get:
+          operationId: getOrder
+          parameters:
+            - name: orderId
+              in: path
+              required: true
+              schema:
+                type: string
+          responses:
+            '200':
+              description: success
+              content:
+                application/json:
+                  schema:
+                    $ref: '#/components/schemas/Order'
+    components:
+      schemas:
+        Order:
+          type: object
+          required: [id]
+          properties:
+            id:
+              type: string
+  YAML
+  json_document = {
+    "openapi" => "3.1.0",
+    "info" => { "title" => "Order API", "version" => "1.0.0" },
+    "paths" => {
+      "/api/v1/orders/{orderId}" => {
+        "get" => {
+          "operationId" => "getOrder",
+          "parameters" => [{ "name" => "orderId", "in" => "path", "required" => true, "schema" => { "type" => "string" } }],
+          "responses" => {
+            "200" => {
+              "description" => "success",
+              "content" => { "application/json" => { "schema" => { "$ref" => "#/components/schemas/Order" } } }
+            }
+          }
+        }
+      }
+    },
+    "components" => {
+      "schemas" => {
+        "Order" => {
+          "type" => "object",
+          "required" => ["id"],
+          "properties" => { "id" => { "type" => "string" } }
+        }
+      }
+    }
+  }
+  File.write(source_json, JSON.generate(json_document))
+  File.binwrite(materialized_json, File.binread(source_json))
+
+  source_yaml_path = "docs/.scratch/#{feature}/api/#{feature}.yaml"
+  source_json_path = "docs/.scratch/#{feature}/api/#{feature}.json"
+  handoff = {
+    "freeze_status" => "approved",
+    "export_status" => "exported",
+    "freeze_record" => "docs/.scratch/#{feature}/api/#{feature}-freeze.md",
+    "export_record" => "docs/.scratch/#{feature}/api/#{feature}-json-export.md",
+    "source_yaml" => source_yaml_path,
+    "source_json" => source_json_path,
+    "yaml_sha256" => Digest::SHA256.file(source_yaml).hexdigest,
+    "json_sha256" => Digest::SHA256.file(source_json).hexdigest,
+    "bundle_command" => "pnpm exec redocly bundle #{source_yaml_path} --output #{source_json_path} --ext json --component-renaming-conflicts-severity=error"
+  }
+  {
+    source_yaml: source_yaml,
+    source_json: source_json,
+    materialized_json: materialized_json,
+    handoff: handoff
+  }
+end
+
+def expect_rejected(label)
+  yield
+  raise "负向场景未被阻断: #{label}"
+rescue ArgumentError
+  true
+end
+
+Dir.mktmpdir("openapi-handoff-") do |root|
+  context = build_context(root)
+  OpenapiJsonHandoff.validate!(**context)
+
+  expect_rejected("Draft 不能导出") do
+    OpenapiJsonHandoff.validate!(**context.merge(handoff: context.fetch(:handoff).merge("freeze_status" => "draft")))
+  end
+
+  expect_rejected("Maven 链路不能作为导出命令") do
+    OpenapiJsonHandoff.validate!(**context.merge(handoff: context.fetch(:handoff).merge("bundle_command" => "mvn package")))
+  end
+
+  expect_rejected("运行时 URL 不能替代治理 JSON") do
+    OpenapiJsonHandoff.validate!(**context.merge(handoff: context.fetch(:handoff).merge("source_json" => "https://example.invalid/openapi.json")))
+  end
+
+  original_json = File.binread(context.fetch(:source_json))
+
+  changed_operation = JSON.parse(original_json)
+  changed_operation.fetch("paths").fetch("/api/v1/orders/{orderId}").fetch("get")["operationId"] = "getOtherOrder"
+  File.write(context.fetch(:source_json), JSON.generate(changed_operation))
+  expect_rejected("JSON 必须保留冻结 YAML 的 operationId") do
+    OpenapiJsonHandoff.validate!(**context.merge(handoff: context.fetch(:handoff).merge("json_sha256" => Digest::SHA256.file(context.fetch(:source_json)).hexdigest)))
+  end
+
+  invalid_ref = JSON.parse(original_json)
+  invalid_ref.fetch("paths").fetch("/api/v1/orders/{orderId}").fetch("get").fetch("responses").fetch("200").fetch("content").fetch("application/json").fetch("schema")["$ref"] = "#/components/schemas/Missing"
+  File.write(context.fetch(:source_json), JSON.generate(invalid_ref))
+  expect_rejected("JSON $ref 必须可解析") do
+    OpenapiJsonHandoff.validate!(**context.merge(handoff: context.fetch(:handoff).merge("json_sha256" => Digest::SHA256.file(context.fetch(:source_json)).hexdigest)))
+  end
+
+  changed_response = JSON.parse(original_json)
+  changed_response.fetch("paths").fetch("/api/v1/orders/{orderId}").fetch("get").fetch("responses").fetch("200").fetch("content").fetch("application/json").fetch("schema")["$ref"] = "#/components/schemas/ChangedOrder"
+  changed_response.fetch("components").fetch("schemas")["ChangedOrder"] = { "type" => "string" }
+  File.write(context.fetch(:source_json), JSON.generate(changed_response))
+  expect_rejected("JSON 必须保留冻结 YAML 的请求和响应契约") do
+    OpenapiJsonHandoff.validate!(**context.merge(handoff: context.fetch(:handoff).merge("json_sha256" => Digest::SHA256.file(context.fetch(:source_json)).hexdigest)))
+  end
+
+  File.binwrite(context.fetch(:source_json), original_json)
+  File.write(context.fetch(:materialized_json), "{\"openapi\":\"3.1.0\",\"paths\":{\"/tampered\":{}}}")
+  expect_rejected("前端 JSON 被手改") do
+    OpenapiJsonHandoff.validate!(**context)
+  end
+
+  File.binwrite(context.fetch(:materialized_json), original_json)
+  File.write(context.fetch(:source_json), "{\"openapi\":\"3.1.0\",\"paths\":{\"/tampered-source\":{}}}")
+  expect_rejected("治理 JSON 被手改") do
+    OpenapiJsonHandoff.validate!(**context)
+  end
+end
+
+puts "OpenAPI YAML-first JSON handoff scenarios passed"

package/template/scripts/verify-openapi-yaml-first-scenarios

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "json"
+require "pathname"
+require "yaml"
+
+ROOT = Pathname.new(__dir__).join("..").realpath
+PROJECTION_ROOTS = %w[
+  .agents/skills
+  .claude/skills
+  .codex/skills
+  .hermes/skills
+  .pi/skills
+  .qoder/skills
+  .trae/skills
+].freeze
+
+failures = []
+
+template_path = ROOT.join("docs/templates/openapi-spec-template.yaml")
+documents = YAML.load_stream(template_path.read)
+failures << "OpenAPI YAML 模板必须是单一 YAML document" unless documents.length == 1
+document = documents.first
+unless document.is_a?(Hash) && document["openapi"] == "3.1.0"
+  failures << "OpenAPI YAML 模板必须是 OAS 3.1 文档"
+end
+%w[pipeline stage status owner].each do |field|
+  failures << "OpenAPI YAML 模板不得把生命周期元数据写入根字段: #{field}" if document.is_a?(Hash) && document.key?(field)
+end
+
+PROJECTION_ROOTS.each do |root|
+  failures << "已移除的 yss-openapi 仍存在: #{root}/yss-openapi" if ROOT.join(root, "yss-openapi").exist?
+end
+
+lock = JSON.parse(ROOT.join("skills-lock.json").read)
+if lock.dig("skills", "shared", "yss-openapi")
+  failures << "skills-lock.json 仍登记 yss-openapi"
+end
+
+public_skills = JSON.parse(ROOT.join("yss-public-skills.json").read)
+if public_skills.fetch("skills").include?("yss-openapi")
+  failures << "yss-public-skills.json 仍公开 yss-openapi"
+end
+
+router = ROOT.join(".agents/skills/yss-router/references/router-contract.yaml").read
+removed_skill_pattern = /(?<![a-z0-9-])yss-openapi(?![a-z0-9-])/
+failures << "Router 仍路由到 yss-openapi" if router.match?(removed_skill_pattern)
+failures << "Router 脚手架合同仍允许旧 OpenAPI 基线" if router.include?("smart_doc_baseline")
+unless router.include?("api-integration:\n    when_regeneration: [yss-openapi-governance]")
+  failures << "Router 未将客户端重新生成路由到 yss-openapi-governance"
+end
+
+lifecycle_contract = ROOT.join(".agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml").read
+failures << "Lifecycle 脚手架合同仍允许旧 OpenAPI 基线" if lifecycle_contract.include?("smart_doc_baseline")
+lifecycle_skill = ROOT.join(".agents/skills/yss-product-lifecycle/SKILL.md").read
+failures << "Lifecycle 说明仍保留旧 OpenAPI 基线" if lifecycle_skill.match?(/smart[ -]?doc/i)
+implementation_routing_template = ROOT.join("docs/templates/implementation-routing-template.md").read
+failures << "实现路由模板仍保留旧 OpenAPI 基线" if implementation_routing_template.match?(/smart[ -]?doc/i)
+
+scaffold_pom = ROOT.join(".agents/skills/yss-ddd-scaffold-generator/assets/templates/pom/bootstrap-pom.xml.template").read
+failures << "后端脚手架仍包含 smart-doc Maven 插件" if scaffold_pom.include?("smart-doc-maven-plugin")
+failures << "后端脚手架仍保留 smart-doc 配置模板" if ROOT.join(".agents/skills/yss-ddd-scaffold-generator/assets/templates/config/smart-doc.json.template").exist?
+
+scaffold_generator = ROOT.join(".agents/skills/yss-ddd-scaffold-generator/scripts/generate_scaffold.py").read
+failures << "后端脚手架生成器仍生成 smart-doc 配置" if scaffold_generator.include?("smart-doc.json") || scaffold_generator.include?("smart-doc-maven-plugin")
+
+governance = ROOT.join(".agents/skills/yss-openapi-governance/SKILL.md").read
+%w[YAML-first 唯一权威 redocly\ bundle --ext\ json operationId].each do |marker|
+  failures << "OpenAPI Governance 缺少 YAML-first JSON 派生规则: #{marker}" unless governance.include?(marker)
+end
+failures << "OpenAPI Governance 仍依赖 smart-doc" if governance.include?("smart-doc")
+%w[pnpm\ generate:api orval.config unsafeDisableValidation].each do |marker|
+  failures << "OpenAPI Governance 越界到前端代码生成或 Orval 配置: #{marker}" if governance.include?(marker)
+end
+
+api_integration = ROOT.join(".agents/skills/yss-api-integration/SKILL.md").read
+%w[冻结的\ OpenAPI\ YAML redocly\ bundle 原样物化 既有前端代码生成流程].each do |marker|
+  failures << "API Integration 缺少冻结 JSON 的下游交接规则: #{marker}" unless api_integration.include?(marker)
+end
+failures << "API Integration 仍引用 yss-openapi" if api_integration.match?(removed_skill_pattern)
+%w[docs/.scratch/<feature>/api/<feature>.json SHA-256 受控交接].each do |marker|
+  failures << "API Integration 未绑定治理 JSON 派生物: #{marker}" unless api_integration.include?(marker)
+end
+%w[orval.config unsafeDisableValidation].each do |marker|
+  failures << "API Integration 越界要求修改或核验 Orval 配置: #{marker}" if api_integration.include?(marker)
+end
+
+frontend_scaffold = ROOT.join(".agents/skills/yss-frontend-scaffold-generator/SKILL.md").read
+failures << "前端脚手架仍接受任意 openapi_source" if frontend_scaffold.include?("openapi_source")
+%w[OpenAPI\ Freeze\ 记录 OpenAPI\ JSON\ 派生记录 SHA-256 openapi/openapi.json 既有前端代码生成流程].each do |marker|
+  failures << "前端脚手架未绑定冻结 JSON 交接: #{marker}" unless frontend_scaffold.include?(marker)
+end
+%w[配置并读取实际\ `orval.config.*` unsafeDisableValidation].each do |marker|
+  failures << "前端脚手架越界修改或核验既有 Orval 配置: #{marker}" if frontend_scaffold.include?(marker)
+end
+
+export_record = ROOT.join("docs/api/templates/openapi-json-export-record-template.md")
+failures << "缺少 OpenAPI JSON 派生记录模板" unless export_record.file?
+if export_record.file?
+  export_record_text = export_record.read
+  %w[Orval\ 输入路径 orval.config unsafeDisableValidation pnpm\ generate:api].each do |marker|
+    failures << "JSON 派生记录越界记录前端 Orval 配置或执行: #{marker}" if export_record_text.include?(marker)
+  end
+end
+
+freeze_record = ROOT.join("docs/api/templates/openapi-freeze-record-template.md")
+%w[orval.config unsafeDisableValidation].each do |marker|
+  failures << "OpenAPI Freeze 记录越界规定 Orval 配置: #{marker}" if freeze_record.read.include?(marker)
+end
+
+draft_checklist = ROOT.join("docs/api/templates/openapi-draft-review-checklist.md")
+failures << "Draft 评审清单越界要求 Orval 输入路径" if draft_checklist.read.include?("Orval 输入路径")
+
+unless failures.empty?
+  warn failures.join("\n")
+  exit 1
+end
+
+puts "OpenAPI YAML-first 场景验证通过"

package/template/scripts/verify-template

@@ -4,7 +4,13 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT_DIR"
 
+# Ruby inherits US-ASCII under a C locale on some macOS installations. Keep
+# all verification scripts UTF-8 capable because the template contains Chinese
+# documentation and skill metadata.
+export RUBYOPT="${RUBYOPT:+$RUBYOPT }-EUTF-8:UTF-8"
+
 ruby <<'RUBY'
+# encoding: UTF-8
 require "pathname"
 require "yaml"
 
@@ -23,6 +29,9 @@ required_files=(
   "AGENTS.md"
   "CONTEXT.md"
   "skills-lock.json"
+  "docs/process/lifecycle-registry.yaml"
+  "docs/process/lifecycle-registry-baseline.json"
+  "docs/process/schemas/lifecycle-registry.schema.json"
   "docs/process/lifecycle-artifact-map.md"
   "docs/process/harness-process-tailoring.md"
   "docs/templates/local-parent-ticket-template.md"
@@ -33,11 +42,17 @@ required_files=(
   "scripts/update-skill-lock"
   "scripts/implementation-path-policy.rb"
   "scripts/verify-lifecycle-scenarios"
+  "scripts/generate-lifecycle-artifacts"
+  "scripts/verify-lifecycle-registry"
+  "scripts/test-lifecycle-registry.rb"
+  "scripts/verify-governance-release"
   "scripts/verify-implementation-path-scenarios"
   "scripts/verify-scaffold-generator-scenarios"
   "scripts/verify-prototype-backend-scaffold-scenarios"
   "scripts/verify-matt-yss-integration-scenarios"
   "scripts/verify-yss-ui-scenarios"
+  "scripts/verify-openapi-yaml-first-scenarios"
+  "scripts/verify-openapi-json-handoff-scenarios"
 )
 
 required_skills=(
@@ -84,6 +99,7 @@ for skill_name in "${required_skills[@]}"; do
 done
 
 ruby <<'RUBY'
+# encoding: UTF-8
 require "json"
 require "pathname"
 require "yaml"
@@ -113,21 +129,31 @@ lock.fetch("skills", {}).fetch("shared", {}).each do |skill_name, metadata|
 end
 
 openapi_path = root.join("docs/templates/openapi-spec-template.yaml")
-openapi_text = openapi_path.read.sub(/\A---\n.*?\n---\n/m, "")
-YAML.safe_load(openapi_text, permitted_classes: [], aliases: true)
+documents = YAML.load_stream(openapi_path.binread.force_encoding("UTF-8"))
+unless documents.length == 1 && documents.first.is_a?(Hash) && documents.first["openapi"] == "3.1.0"
+  warn "docs/templates/openapi-spec-template.yaml 必须是单一 OAS 3.1 YAML document"
+  exit 1
+end
 RUBY
 
 scripts/sync-skills --check
 scripts/update-skill-lock --check
+scripts/verify-lifecycle-registry
 scripts/verify-lifecycle-scenarios
+scripts/verify-governance-release
 scripts/verify-implementation-path-scenarios
 scripts/verify-scaffold-generator-scenarios
 scripts/verify-prototype-backend-scaffold-scenarios
 ruby scripts/verify-matt-yss-integration-scenarios
 scripts/verify-yss-router-scenarios
 scripts/verify-yss-ui-scenarios
+scripts/verify-openapi-yaml-first-scenarios
+scripts/verify-openapi-json-handoff-scenarios
+ruby scripts/test-lifecycle-registry.rb
+ruby scripts/test-export-yss-skills.rb
 
 ruby <<'RUBY'
+# encoding: UTF-8
 require "pathname"
 require "json"
 
@@ -153,7 +179,8 @@ obsolete_names = [
   "obsidian-vault",
   "writing-great-skills",
   "code-review-process",
-  "yss-domain-modeling"
+  "yss-domain-modeling",
+  "yss-openapi"
 ].freeze
 
 agent_roots.each do |agent_root|
@@ -225,8 +252,8 @@ unless legacy_hits.empty?
   exit 1
 end
 
-unless root.join("AGENTS.md").read.include?("正文统一使用简体中文") &&
-       root.join("CONTEXT.md").read.include?("统一使用简体中文")
+unless root.join("AGENTS.md").binread.force_encoding("UTF-8").include?("正文统一使用简体中文") &&
+       root.join("CONTEXT.md").binread.force_encoding("UTF-8").include?("统一使用简体中文")
   abort("AGENTS.md 与 CONTEXT.md 必须共同声明落地文档使用简体中文")
 end
 
@@ -258,6 +285,11 @@ ruby -c scripts/sync-skills >/dev/null
 ruby -c scripts/update-skill-lock >/dev/null
 ruby -c scripts/implementation-path-policy.rb >/dev/null
 ruby -c scripts/verify-lifecycle-scenarios >/dev/null
+ruby -c scripts/lifecycle-registry.rb >/dev/null
+ruby -c scripts/generate-lifecycle-artifacts >/dev/null
+ruby -c scripts/verify-lifecycle-registry >/dev/null
+ruby -c scripts/test-lifecycle-registry.rb >/dev/null
+ruby -c scripts/verify-governance-release >/dev/null
 ruby -c scripts/verify-prototype-backend-scaffold-scenarios >/dev/null
 ruby -c scripts/verify-matt-yss-integration-scenarios >/dev/null
 ruby -c scripts/verify-yss-ui-scenarios >/dev/null

package/template/scripts/verify-yss-router-scenarios

@@ -38,7 +38,7 @@ def routing_input_violations(contract, input)
   contract.fetch("exclusive_flags").each do |left, right|
     violations << "#{left}/#{right}" unless flags[left] != flags[right]
   end
-  violations
+  violations.uniq
 end
 
 def active_impacts(input)
@@ -49,7 +49,8 @@ base_input = {
   "slice_id" => "order-create",
   "impact_flags" => {
     "ui_impact" => true, "api_impact" => true, "no_api_impact" => false,
-    "data_impact" => false, "backend_impact" => false, "cross_repo" => false
+    "data_impact" => false, "backend_impact" => false, "cross_repo" => false,
+    "existing_frozen_baseline" => false
   },
   "lifecycle" => {}, "implementation" => {}, "acceptance" => {}
 }
@@ -60,6 +61,16 @@ failures << "Invalid lifecycle input type was accepted" if routing_input_violati
 both_api_modes = base_input["impact_flags"].merge("api_impact" => true, "no_api_impact" => true)
 failures << "API/no-API exclusivity was not enforced" if routing_input_violations(CONTRACT, base_input.merge("impact_flags" => both_api_modes)).empty?
 
+legacy_posture_key = %w[security permission posture].join("_")
+failures << "Router 输入仍要求已废弃的专项输入" if CONTRACT.fetch("routing_input_required").include?(legacy_posture_key)
+failures << "Router 仍声明已废弃的专项合同" if CONTRACT.key?(legacy_posture_key)
+legacy_impact_flags = CONTRACT.fetch("impact_flags_required").select do |flag|
+  %w[permission security].any? { |prefix| flag.start_with?("#{prefix}_") }
+end
+failures << "Router 仍要求安全 / 权限派生旗标" unless (CONTRACT.fetch("impact_flags_required") & legacy_impact_flags).empty?
+explicit_authorization_input = base_input.merge("acceptance" => {"behavior" => "角色授权规则变化"})
+failures << "显式权限行为无法按普通输入进入 Router" unless routing_input_violations(CONTRACT, explicit_authorization_input).empty?
+
 common_ready = CONTRACT.dig("readiness", "common").to_h { |key| [key, true] }
 ui_ready = CONTRACT.dig("readiness", "ui_impact").to_h { |key| [key, true] }
 api_ready = CONTRACT.dig("readiness", "api_impact").to_h { |key| [key, true] }
@@ -504,14 +515,26 @@ backend_skill_mutation["backend"]["required_skills"].delete("mapstruct")
 failures << "Backend contract accepted incomplete skill closure" unless slice_contract_decision_violations(CONTRACT, backend_input, backend_evidence, backend_skill_mutation, backend_expected_skills).include?("backend.required_skills")
 failures << "Backend contract accepted omitted skill closure" if slice_contract_decision_violations(CONTRACT, backend_input, backend_evidence, backend_slice, []).empty?
 
+component_route_examples = {
+  "Current-user" => {"impact" => "current-user-context", "skills" => ["yss-userinfo"]},
+  "Audit" => {"impact" => "audit-event", "skills" => ["yss-audit-log", "yss-userinfo", "yss-dto"]},
+  "Encryption" => {"impact" => "encryption-or-signing", "skills" => ["yss-security-algorithm", "yss-exception"]}
+}
+component_route_examples.each do |label, example|
+  candidate = Marshal.load(Marshal.dump(backend_slice))
+  candidate["backend"]["component_impacts"] = [example.fetch("impact")]
+  required_skills = dependency_closure(CONTRACT, backend_expected_skills + example.fetch("skills"), {})
+  candidate["backend"]["required_skills"] = required_skills
+  candidate["common"]["required_skills"] = required_skills
+  failures << "#{label} component route was rejected" unless slice_contract_decision_violations(
+    CONTRACT, backend_input, backend_evidence, candidate, required_skills
+  ).empty?
+end
 component_slice = Marshal.load(Marshal.dump(backend_slice))
 component_slice["backend"]["component_impacts"] = ["current-user-context"]
 component_skills = dependency_closure(CONTRACT, backend_expected_skills + ["yss-userinfo"], {})
 component_slice["backend"]["required_skills"] = component_skills
 component_slice["common"]["required_skills"] = component_skills
-failures << "Current-user component route was rejected" unless slice_contract_decision_violations(
-  CONTRACT, backend_input, backend_evidence, component_slice, component_skills
-).empty?
 unknown_component = Marshal.load(Marshal.dump(component_slice))
 unknown_component["backend"]["component_impacts"] = ["unknown-component"]
 unless slice_contract_decision_violations(CONTRACT, backend_input, backend_evidence, unknown_component, component_skills).include?("backend.component_impacts")
@@ -730,6 +753,17 @@ mutations = {
   "drift" => valid_result.merge("status" => "drift"),
   "violation" => valid_result.merge("status" => "violation")
 }
+
+valid_deferred = valid_result.merge(
+  "status" => "seam-deferred",
+  "seam_deferred" => [{
+    "risk" => "temporary adapter", "owner" => "team", "follow_up_ticket" => "T-2",
+    "verification_plan" => "contract test", "target_version_or_release_date" => "2026-09-01"
+  }]
+)
+unless execution_violations(CONTRACT, valid_deferred, *valid_args).empty?
+  failures << "Valid seam-deferred result was rejected"
+end
 mutations.each do |expected, result|
   blocker = expected.sub(/-(empty|command|contract-version|status|shape|work-unit|missing|implemented-with-seam|not-applicable-reason|identity|area)$/, "")
   actual = execution_violations(CONTRACT, result, *valid_args)
@@ -870,15 +904,9 @@ end
 
 scaffold_pom_template = ROOT.join(".agents/skills/yss-ddd-scaffold-generator/assets/templates/pom/bootstrap-pom.xml.template")
 scaffold_pom_body = scaffold_pom_template.read
-smart_doc_plugin_versions = scaffold_pom_body.scan(/<artifactId>smart-doc-maven-plugin<\/artifactId>\s*<version>([^<]+)<\/version>/).flatten
-failures << "smart-doc Maven plugin version must be fixed at yss-4.0.0" unless smart_doc_plugin_versions == ["yss-4.0.0"]
-smart_doc_template = ROOT.join(".agents/skills/yss-ddd-scaffold-generator/assets/templates/config/smart-doc.json.template")
-smart_doc_body = smart_doc_template.file? ? smart_doc_template.read : ""
-%w[allInOne outPath packageFilters componentType].each do |marker|
-  failures << "smart-doc template missing #{marker}" unless smart_doc_body.include?("\"#{marker}\"")
-end
-failures << "smart-doc packageFilters must use the supported single-star regex" unless smart_doc_body.include?("\"packageFilters\": \"{{base_package}}.*\"")
-failures << "smart-doc template contains environment secret settings" if smart_doc_body.match?(/appToken|openUrl|debugEnvUrl|serverUrl/)
+failures << "后端脚手架不得保留旧 OpenAPI Maven 插件" if scaffold_pom_body.include?("smart-doc-maven-plugin")
+legacy_openapi_template = ROOT.join(".agents/skills/yss-ddd-scaffold-generator/assets/templates/config/smart-doc.json.template")
+failures << "后端脚手架不得保留旧 OpenAPI 配置模板" if legacy_openapi_template.exist?
 
 %w[
   yss-domain/SKILL.md