create-yss-spec 2.1.4 → 2.1.6

package/template/.trae/skills/yss-web-controller/scripts/generate_controller.py

@@ -1,293 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-
-import argparse
-import json
-import os
-import re
-import sys
-from string import Template
-
-def to_camel_case(snake_str):
-    components = snake_str.lower().split('_')
-    return "".join(x.title() for x in components)
-
-def to_lower_camel_case(snake_str):
-    camel = to_camel_case(snake_str)
-    if not camel:
-        return ""
-    return camel[0].lower() + camel[1:]
-
-def to_kebab_case(snake_str):
-    return snake_str.lower().replace('_', '-')
-
-def package_to_path(package_name):
-    return package_name.replace(".", os.sep)
-
-def ensure_subdir(root_path, subdir_name):
-    if os.path.basename(os.path.normpath(root_path)) == subdir_name:
-        return root_path
-    return os.path.join(root_path, subdir_name)
-
-TYPE_MAPPING = {
-    "bigint": "Long",
-    "int": "Integer",
-    "integer": "Integer",
-    "smallint": "Integer",
-    "tinyint": "Integer",
-    "number": "Long",
-    "numeric": "BigDecimal",
-    "decimal": "BigDecimal",
-    "float": "Float",
-    "double": "Double",
-    "real": "Float",
-    "varchar": "String",
-    "varchar2": "String",
-    "nvarchar2": "String",
-    "char": "String",
-    "nchar": "String",
-    "text": "String",
-    "clob": "String",
-    "nclob": "String",
-    "date": "LocalDateTime",
-    "datetime": "LocalDateTime",
-    "timestamp": "LocalDateTime",
-    "timestamp with time zone": "LocalDateTime",
-    "boolean": "Boolean",
-    "bool": "Boolean",
-    "bit": "Boolean",
-    "json": "String",
-    "jsonb": "String",
-    "uuid": "String"
-}
-
-def get_java_type(sql_type):
-    sql_type = sql_type.lower()
-    # Handle types like varchar(255)
-    base_type = re.split(r'\(', sql_type)[0]
-    return TYPE_MAPPING.get(base_type, "String")
-
-def generate_fields(columns, skip_pk=False, is_cmd=False, skip_audit=True):
-    fields = []
-    for col in columns:
-        col_name = col["name"]
-        if skip_pk and col.get("primary"):
-            continue
-
-        # Skip audit columns if they are standard
-        if skip_audit and col_name.lower() in ["create_time", "update_time", "create_by", "update_by", "deleted", "version"]:
-            continue
-
-        java_type = get_java_type(col["sql_type"])
-        java_name = to_lower_camel_case(col_name)
-        comment = col.get("comment", "")
-
-        field_str = ""
-        if comment:
-            field_str += f"    /**\n     * {comment}\n     */\n"
-
-        if is_cmd:
-            if not col.get("nullable"):
-                if java_type == "String":
-                    field_str += f"    @NotBlank(message = \"{comment or java_name}不能为空\")\n"
-                else:
-                    field_str += f"    @NotNull(message = \"{comment or java_name}不能为空\")\n"
-
-        field_str += f"    private {java_type} {java_name};"
-        fields.append(field_str)
-
-    return "\n\n".join(fields)
-
-def main():
-    parser = argparse.ArgumentParser(description="Generate YSS Web Controller and DTOs")
-    parser.add_argument("--metadata-file", required=True, help="Path to metadata.json")
-    parser.add_argument("--base-package", required=True, help="Base package name")
-    parser.add_argument("--module-name", required=True, help="Module name")
-    parser.add_argument("--output-dir", default="./output", help="Output directory")
-    parser.add_argument("--domain-project-dir", help="Domain module root directory")
-    parser.add_argument("--web-project-dir", help="Web module root directory")
-    parser.add_argument("--domain-output-dir", help="Domain module output directory (for DTOs/VOs)")
-    parser.add_argument("--web-output-dir", help="Web module output directory (for Controller)")
-    parser.add_argument("--author", default="System", help="Author name")
-    parser.add_argument("--force", action="store_true", help="Overwrite existing files")
-    parser.add_argument("--domain-segment", required=True, help="Domain segment package name")
-    parser.add_argument(
-        "--application-service-package",
-        help="Application Service package; defaults to <base-package>.application.service",
-    )
-    parser.add_argument(
-        "--validation-namespace",
-        choices=("javax", "jakarta"),
-        default="javax",
-        help="Validation API namespace from the target engineering baseline",
-    )
-
-    args = parser.parse_args()
-
-    if not os.path.exists(args.metadata_file):
-        print(f"Error: Metadata file not found: {args.metadata_file}")
-        sys.exit(1)
-
-    try:
-        with open(args.metadata_file, 'r', encoding='utf-8') as f:
-            metadata = json.load(f)
-    except Exception as e:
-        print(f"Error reading metadata file: {e}")
-        sys.exit(1)
-
-    tables = metadata.get("tables", [])
-    if not tables:
-        print("Warning: No tables found in metadata.")
-        return
-
-    script_dir = os.path.dirname(os.path.abspath(__file__))
-    templates_dir = os.path.join(script_dir, "../assets/templates")
-
-    def load_tpl(name):
-        path = os.path.join(templates_dir, name)
-        if not os.path.exists(path):
-            print(f"Warning: Template not found: {path}")
-            return None
-        with open(path, 'r', encoding='utf-8') as f:
-            return f.read()
-
-    controller_tpl = load_tpl("Controller.java.template")
-    web_convertor_tpl = load_tpl("WebConvertor.java.template")
-    vo_tpl = load_tpl("domain/vo/VO.java.template")
-    add_cmd_tpl = load_tpl("domain/dto/cmd/AddCmd.java.template")
-    update_cmd_tpl = load_tpl("domain/dto/cmd/UpdateCmd.java.template")
-    page_query_tpl = load_tpl("domain/dto/query/PageQuery.java.template")
-    package_path = package_to_path(args.base_package)
-
-    if args.domain_output_dir:
-        domain_base_root = args.domain_output_dir
-    elif args.domain_project_dir:
-        domain_base_root = os.path.join(args.domain_project_dir, "src", "main", "java", package_path)
-    else:
-        domain_base_root = os.path.join(args.output_dir, package_path)
-
-    if args.web_output_dir:
-        web_base_root = args.web_output_dir
-    elif args.web_project_dir:
-        web_base_root = os.path.join(args.web_project_dir, "src", "main", "java", package_path)
-    else:
-        web_base_root = os.path.join(args.output_dir, package_path)
-
-    domain_root = ensure_subdir(domain_base_root, "client")
-    web_root = ensure_subdir(web_base_root, "rest")
-
-    for table in tables:
-        table_name = table["table_name"]
-        clean_name = to_camel_case(table_name)
-
-        domain_class = clean_name
-        domain_var = to_lower_camel_case(table_name)
-        domain_desc = table.get("table_comment") or domain_class
-        domain_desc = domain_desc.strip().replace('\n', ' ')
-        domain_pkg_name = args.domain_segment
-        domain_url_path = to_kebab_case(table_name)
-
-        domain_model_pkg = f"{args.base_package}.domain.{domain_pkg_name}.model"
-        web_convertor_pkg = f"{args.base_package}.rest.convertor"
-        application_service_pkg = (
-            args.application_service_package
-            or f"{args.base_package}.application.service"
-        )
-
-        # Field generation for DTOs
-        columns = table.get("columns", [])
-        field_declarations_vo = generate_fields(columns, skip_audit=False)
-        field_declarations_add = generate_fields(columns, skip_pk=True, is_cmd=True, skip_audit=True)
-        field_declarations_update = generate_fields(columns, skip_pk=False, is_cmd=True, skip_audit=True)
-        field_declarations_query = generate_fields(columns, skip_audit=True) # Query usually has all fields as optional filters
-
-        vo_class = f"{domain_class}VO"
-        add_cmd_class = f"{domain_class}AddCmd"
-        update_cmd_class = f"{domain_class}UpdateCmd"
-        query_class = f"{domain_class}PageQuery"
-        domain_import = f"import {domain_model_pkg}.{domain_class};"
-
-        query_call = f"{domain_var}Service.page(query)"
-        detail_call = f"{domain_var}Service.detail(id)"
-        add_call = f"{domain_var}Service.add(cmd)"
-        update_call = f"{domain_var}Service.update(cmd)"
-        delete_call = f"{domain_var}Service.delete(id)"
-
-        application_service_class = f"{domain_class}Service"
-        application_service_import = (
-            f"import {application_service_pkg}.{application_service_class};"
-        )
-        dto_imports = "\n".join([
-            f"import {args.base_package}.client.dto.cmd.{domain_class}AddCmd;",
-            f"import {args.base_package}.client.dto.cmd.{domain_class}UpdateCmd;",
-            f"import {args.base_package}.client.dto.query.{domain_class}PageQuery;",
-            f"import {args.base_package}.client.vo.{domain_class}VO;"
-        ])
-        application_service_field = (
-            f"private final {application_service_class} {domain_var}Service;"
-        )
-        web_convertor_class = f"{domain_class}WebConvertor"
-        web_convertor_import = f"import {web_convertor_pkg}.{web_convertor_class};"
-
-        ctx = {
-            "base_package": args.base_package,
-            "module_name": args.module_name,
-            "domain_class": domain_class,
-            "domain_var": domain_var,
-            "domain_desc": domain_desc,
-            "domain_url_path": domain_url_path,
-            "domain_pkg_name": domain_pkg_name,
-            "author": args.author,
-            "dto_imports": dto_imports,
-            "application_service_import": application_service_import,
-            "domain_import": domain_import,
-            "web_convertor_import": web_convertor_import,
-            "web_convertor_class": web_convertor_class,
-            "application_service_field": application_service_field,
-            "query_call": query_call,
-            "detail_call": detail_call,
-            "add_call": add_call,
-            "update_call": update_call,
-            "delete_call": delete_call,
-            "vo_class": vo_class,
-            "add_cmd_class": add_cmd_class,
-            "update_cmd_class": update_cmd_class,
-            "query_class": query_class,
-            "validation_namespace": args.validation_namespace,
-            "field_declarations": "" # placeholder
-        }
-
-        def write_file(path, content):
-            os.makedirs(os.path.dirname(path), exist_ok=True)
-            if not os.path.exists(path) or args.force:
-                with open(path, 'w', encoding='utf-8') as f:
-                    f.write(content)
-                print(f"Generated: {path}")
-            else:
-                print(f"Skipped (exists): {path}")
-
-        # 1. Controller (Web Layer)
-        write_file(os.path.join(web_root, f"{domain_class}Controller.java"), Template(controller_tpl).substitute(ctx))
-        write_file(
-            os.path.join(web_root, "convertor", f"{web_convertor_class}.java"),
-            Template(web_convertor_tpl).substitute(ctx)
-        )
-
-        # 2. DTOs & VO (Domain Layer)
-        ctx["field_declarations"] = field_declarations_vo
-        write_file(os.path.join(domain_root, "vo", f"{domain_class}VO.java"), Template(vo_tpl).substitute(ctx))
-
-        ctx["field_declarations"] = field_declarations_add
-        write_file(os.path.join(domain_root, "dto/cmd", f"{domain_class}AddCmd.java"), Template(add_cmd_tpl).substitute(ctx))
-
-        ctx["field_declarations"] = field_declarations_update
-        write_file(os.path.join(domain_root, "dto/cmd", f"{domain_class}UpdateCmd.java"), Template(update_cmd_tpl).substitute(ctx))
-
-        ctx["field_declarations"] = field_declarations_query
-        write_file(
-            os.path.join(domain_root, "dto/query", f"{domain_class}PageQuery.java"),
-            Template(page_query_tpl).substitute(ctx),
-        )
-
-if __name__ == "__main__":
-    main()

package/template/.trae/skills/yss-web-controller/scripts/test_generate_controller.py

@@ -1,68 +0,0 @@
-#!/usr/bin/env python3
-import json
-import subprocess
-import sys
-import tempfile
-import unittest
-from pathlib import Path
-
-
-SCRIPT = Path(__file__).with_name("generate_controller.py")
-
-
-class GenerateControllerTest(unittest.TestCase):
-    def test_uses_application_service_and_validation_profile(self):
-        metadata = {
-            "tables": [
-                {
-                    "table_name": "quality_rule",
-                    "table_comment": "质量规则",
-                    "columns": [
-                        {"name": "id", "sql_type": "bigint", "primary": True, "nullable": False},
-                        {"name": "rule_name", "sql_type": "varchar(64)", "nullable": False},
-                    ],
-                }
-            ]
-        }
-        with tempfile.TemporaryDirectory() as temp_dir:
-            root = Path(temp_dir)
-            metadata_path = root / "metadata.json"
-            metadata_path.write_text(json.dumps(metadata), encoding="utf-8")
-            subprocess.run(
-                [
-                    sys.executable,
-                    str(SCRIPT),
-                    "--metadata-file",
-                    str(metadata_path),
-                    "--base-package",
-                    "com.yss.demo",
-                    "--module-name",
-                    "demo",
-                    "--domain-segment",
-                    "quality",
-                    "--output-dir",
-                    str(root / "out"),
-                    "--application-service-package",
-                    "com.yss.demo.application.service",
-                    "--validation-namespace",
-                    "jakarta",
-                ],
-                check=True,
-                capture_output=True,
-                text=True,
-            )
-            controller = next((root / "out").rglob("QualityRuleController.java")).read_text(encoding="utf-8")
-            query = next((root / "out").rglob("QualityRulePageQuery.java")).read_text(encoding="utf-8")
-
-        self.assertIn("import com.yss.demo.application.service.QualityRuleService;", controller)
-        self.assertIn("private final QualityRuleService qualityRuleService;", controller)
-        self.assertNotIn("Gateway", controller)
-        self.assertIn("@Valid @RequestBody QualityRuleAddCmd", controller)
-        self.assertIn("import com.yss.demo.client.dto.query.QualityRulePageQuery;", controller)
-        self.assertNotIn("import com.yss.demo.client.dto.query.QualityRulePage;", controller)
-        self.assertIn("import jakarta.validation.Valid;", controller)
-        self.assertIn("class QualityRulePageQuery extends PageQuery", query)
-
-
-if __name__ == "__main__":
-    unittest.main()

package/template/docs/adr/0004-split-lifecycle-and-router-registry-domains.md

@@ -1,5 +0,0 @@
-# ADR-0004: 分离生命周期注册域与 Router 合同域并迁移到 schema v2
-
-> 状态：proposed。当前仅有 `schema_version: 1` 的生命周期结构注册表 shadow 校验；v2 迁移尚未实施。
-
-生命周期控制和实现合同编译具有不同的变化频率与责任边界，因此拟采用一套逻辑治理体系下的两个结构化职责域：生命周期注册域定义主阶段、门禁、产物、工作单元、证据、状态迁移和人工交互，Router 合同域定义实现子合同、技能闭包、写路径与验证约束，两者只通过稳定 ID 引用。后续 schema v2 迁移应提供 v1/v2 读取、dry-run 迁移和冲突时 fail closed；验证通过后才允许只写 v2，并保留来源版本、迁移证据和回滚引用。在上述运行时资产与迁移验证落地前，本 ADR 不构成已完成的发布能力。

package/template/docs/adr/0005-cross-repository-ecosystem-release-manifest.md

@@ -1,5 +0,0 @@
-# ADR-0005: 使用生态发布清单协调模板、CLI 与公开技能
-
-> 状态：proposed。生态发布清单、schema 与跨仓闭合校验尚未实现；当前发布只可声明模板仓库和 CLI 固定模板快照的双仓验证，不得宣称模板、CLI 与公开技能已形成生态级可发布闭环。
-
-YSS 研发操作系统跨模板仓库、`create-yss-spec` 和公开技能仓库发布，单仓测试通过不能证明整体版本一致。提案是在后续 Phase 使用生态发布清单关联生命周期 schema、Matt snapshot、模板 commit/tree hash、CLI version/固定模板快照和公开技能来源 commit/导出 hash，并要求发布校验闭合这些引用；各仓只记录发布时已经存在的上游身份，避免循环引用未来 commit。该设计增加了发布记录和集成验证成本，但在 manifest、schema、校验器和跨仓测试同时落地前不构成当前发布门禁。

package/template/docs/adr/0007-separate-skill-routing-registry-from-integrity-lock.md

@@ -1,5 +0,0 @@
-# ADR-0007: 分离技能路由注册表与完整性锁
-
-> 状态：proposed。`docs/agents/yss-skill-registry.yaml`、schema、Router 消费与校验尚未实现；当前 Router 仍以 `router-contract.yaml` 和 `skills-lock.json` 的既有职责边界运行，不得把本 ADR 作为已生效的运行时入口规则。
-
-`skills-lock.json` 负责技能来源、hash 和投影完整性，而生命周期阶段、影响面、Core/Specialist 分层、成熟度、新鲜度和 Router 默认可用性属于产品路由语义。提案是在后续 Phase 于 `docs/agents/yss-skill-registry.yaml` 中维护后者，并让每个 Agent 运行时只发现一个平台投影根；canonical `.agents/skills` 继续作为内容权威，但不与平台投影同时形成同权运行时入口。该分离增加了一份受 schema 校验的注册资产，却避免完整性锁不断吸收路由策略，也减少同名双入口和“能够安装即等于受支持”的歧义；在注册资产和 Router 消费尚未交付时，不能把该分离视为既有事实。

package/template/docs/implementation/create-yss-spec-repository-mode-contract.md

@@ -1,90 +0,0 @@
-# `create-yss-spec` 接管与模板同步跨仓库契约
-
-本文定义模板源仓库与外部 `create-yss-spec` CLI 仓库之间的身份、资产边界、迁移、同步、验证和发布契约。
-
-## 契约目标
-
-- 模板源仓库保留 `repository_mode: template-source`。
-- CLI 创建或接管的产品仓库写入 `repository_mode: project-instance`。
-- CLI 只管理 manifest 声明的研发管理资产，不接管前后端运行时代码、业务目录、用户文件或 `.git`。
-- 通过模板快照和 40 位 `templateCommit` 使每次初始化、升级和回滚可追踪。
-
-## 生命周期接口
-
-### 空目录初始化
-
-初始化必须把模板身份转换为 `schema_version: 1`、`repository_mode: project-instance`，并执行目标仓库的：
-
-```bash
-scripts/sync-skills --check
-scripts/update-skill-lock --check
-scripts/verify-template
-```
-
-### 已有项目 `attach`
-
-```bash
-npx create-yss-spec@latest attach \
-  --target-dir . \
-  --project-name "项目名称" \
-  --business-domain "业务领域" \
-  --dry-run
-npx create-yss-spec@latest attach \
-  --target-dir . \
-  --project-name "项目名称" \
-  --business-domain "业务领域" \
-  --apply [--force]
-```
-
-`attach` 必须显式选择 dry-run 或 apply，已有 `.yss-template.json` 时拒绝并提示 `sync`。计划按 `missing`、`matched`、`conflict`、`unsafe` 分类；force 只能覆盖受管 conflict，不能绕过 unsafe 或迁移冲突。合法 `template-source` 可转换为 `project-instance`，合法 `project-instance` 保留并校验，非法身份在写入前阻断。
-
-### 持续同步 `sync`
-
-`sync` 只使用 CLI 包内置的模板快照。“最新”指用户执行 `npx create-yss-spec@latest` 所携带的最新已发布快照，不在运行时直接拉取模板仓库。普通同步新增缺失文件、更新 baseline 未被本地修改的文件、报告冲突和模板删除；`sync --force` 先备份再覆盖受管冲突，模板删除默认只报告。
-
-完成后必须重新执行三个模板门禁；任一门禁失败时回滚文件变更并保持旧 metadata 版本。
-
-## metadata v2
-
-`.yss-template.json` 至少包含：
-
-```json
-{
-  "metadataSchemaVersion": 2,
-  "templateName": "create-yss-spec",
-  "cliVersion": "2.1.4",
-  "templateSource": "github:iloveZzz/yss-spec-project-template",
-  "templateCommit": "<40-char-commit>",
-  "managedFilesManifestVersion": "<manifest-hash>",
-  "managedFiles": {}
-}
-```
-
-`managedFiles` 是每个受管文件的 baseline。CLI apply 前把将被覆盖的文件保存到目标目录外的临时备份目录；验证成功后默认保留，失败按操作日志回滚，metadata 不更新。
-
-## 固定迁移规则
-
-CLI 必须遵循 [Spec / Ticket 迁移指南](../user-guide/规格与任务迁移指南.md) 的固定映射：旧 Spec / Ticket skill 和模板入口迁移为当前名称，旧规格文件、根 `.scratch/<feature>/` 迁移到当前路径；无法推断功能归属的扁平 Ticket 标记为 `unsafe` 并阻断。新旧目标内容不一致时标记 `conflict`，不得静默覆盖。
-
-## 跨仓库验收
-
-| 场景 | 必须验证 |
-|---|---|
-| 空目录初始化 | `project-instance`、metadata v2、固定 commit、六类 projection 和模板门禁 |
-| 任意已有项目 attach dry-run | 不写文件、不删除 `.git`，运行时代码和无关文件不变 |
-| attach apply | 缺失资产新增；matched 纳入 baseline；conflict 需 force；unsafe 不可 force 绕过 |
-| 旧资产迁移 | 规格 / Ticket 路径和根 scratch 安全迁移；目标冲突与扁平 Ticket fail closed |
-| sync | 新增、更新、冲突、迁移和删除报告完整；force 只作用于受管文件 |
-| post-sync | 三个门禁全部 fresh 通过；失败时文件和 metadata 回滚 |
-| 发布包 | 固定 commit 下 `npm test` 和 `npm pack --dry-run` 通过，包内含 `template.snapshot.json` |
-
-本变更只涉及模板治理和外部 CLI，不涉及 frontend、backend、OpenAPI 或运行时工程；这些范围为 `not-applicable`。
-
-## 发布顺序与阻断条件
-
-1. 模板恢复 `docs/process/*`、正式处理 `.qoder` 投影并通过 fresh verification，形成确定 commit。
-2. CLI 绑定该 commit，完成 attach / sync 跨仓库测试和独立 review。
-3. 运行固定 commit 的 `npm test`、`npm pack --dry-run`，确认包内快照和实例门禁通过。
-4. 发布 CLI `2.1.4`，并回写版本、验证证据、备份恢复路径和回滚点。
-
-模板引用仍为浮动 ref、任一共同验证失败、独立 review 未完成或打包失败时，只能声明“本仓库实现完成，跨仓库发布受阻”，不得声明整体可发布。本轮不执行 npm publish。

package/template/docs/process/harness-optimization-backlog.md

@@ -1,9 +0,0 @@
-# Harness 优化积压
-
-本文件只记录可验证的 Harness 改进方向，不替代生命周期事实源或 Ticket。
-
-| 项目 | 触发信号 | 验收证据 |
-|---|---|---|
-| 跨仓库快照一致性 | 模板与 CLI manifest 漂移 | 固定 commit 联调、tree hash、解包测试 |
-| 迁移回滚演练 | 旧路径存在目标冲突 | dry-run 计划、外部备份、失败回滚记录 |
-| 门禁可观测性 | 验证失败原因难以定位 | 命令输出包含阶段、路径、恢复动作 |

package/template/docs/process/harness-work-unit-map.md

@@ -1,16 +0,0 @@
-# Harness 工作单元地图
-
-<!-- lifecycle-registry:work-units:start -->
-> 此表由 `docs/process/lifecycle-registry.yaml` 生成；它只描述 `template-source` 的 Harness 工作单元。
-
-| 稳定 ID | 工作单元 | 输入 | 输出 | 完成条件 |
-|---|---|---|---|---|
-| `work-unit.entry-triage` | 入口分诊 | 用户请求、仓库身份。 | 影响面与最近可信阶段。 | 身份和影响面可解释。 |
-| `work-unit.ssot-update` | 单一事实源更新 | 变更合同。 | 权威文档或脚本。 | 其他投影可由脚本生成。 |
-| `work-unit.skill-projection-sync` | 技能投影同步 | .agents/skills。 | Agent root 投影、skills lock。 | --check 通过。 |
-| `work-unit.template-snapshot-build` | 模板快照构建 | 固定模板 commit。 | CLI bundled snapshot。 | commit 与 tree hash 可追踪。 |
-| `work-unit.attach-sync-integration` | attach / sync 集成 | 目标仓库、dry-run 计划。 | 受管资产和 metadata。 | 验证通过或完整回滚。 |
-| `work-unit.fresh-verification` | Fresh verification | 变更仓库。 | 命令输出与证据。 | 所有命中门禁通过。 |
-| `work-unit.independent-review` | 独立审查 | 变更 diff、验证证据。 | review 结论。 | 无未处理阻断项。 |
-| `work-unit.release-and-rollback` | 发布与回滚 | 已审查 commit。 | release note、观察信号、回滚点。 | 两仓库顺序和恢复动作明确。 |
-<!-- lifecycle-registry:work-units:end -->

package/template/docs/releases/next-major-template-governance.md

@@ -1,32 +0,0 @@
-# 下一主版本：模板治理与 Spec / Ticket 规范化
-
-> 状态：草案，尚不可发布。
-
-## 破坏性变更
-
-- 新流程只使用 Spec、Ticket、`to-spec`、`to-tickets`。
-- 根目录新增 `yss-project.yaml`，Agent 必须按 `repository_mode` 路由。
-- `.agents/skills` 成为共享技能权威内容，其他 Agent root 使用生成投影。
-- Spec 初稿使用 `ready-for-human`；`ready-for-agent` 只用于已解除阻塞、可直接实现的垂直切片 Ticket。
-- Spec Delta 只用于修改既有冻结基线的中高风险行为，不用于全新产品或全新模块。
-- 所有面向人的落地文档正文以简体中文为标准语言。
-
-旧版项目必须按 `docs/user-guide/规格与任务迁移指南.md` 一次性迁移，不提供旧 skill 别名。
-
-## 模板仓库验证
-
-```bash
-scripts/sync-skills --check
-scripts/update-skill-lock --check
-scripts/verify-template
-```
-
-当前模板侧 fresh verification 已通过，包括五类生命周期压力场景、完整目录树哈希、旧入口扫描、Markdown 链接、YAML 解析和 Git 空白检查。
-
-## 发布阻塞项
-
-- 需要其他 Agent 或人工 Reviewer 完成独立审查。
-- 外部 `create-yss-spec` 需要按 `docs/implementation/create-yss-spec-repository-mode-contract.md` 实现 `project-instance` 转换、旧版升级和冲突 fail closed。
-- 模板与 CLI 需要共同执行初始化 / 升级集成验证，并绑定确定的 commit / tag。
-
-上述阻塞全部解除前，本草案不能改为已发布状态。

package/template/docs/reviews/lifecycle-registry-phase0-1-red-green-2026-08-17.md

@@ -1,61 +0,0 @@
-# 生命周期注册表 Phase 0 / Phase 1 RED / GREEN 证据
-
-## 范围与边界
-
-- 仓库身份：`template-source`，仅维护可复用流程资产。
-- 已授权范围：Phase 0 一致性修复与 Phase 1 生命周期注册表 shadow/check；不实施运行时 state schema v2、技能注册表或跨仓发布清单。
-- 受管来源：`docs/process/lifecycle-registry.yaml`；`docs/process/lifecycle-artifact-map.md` 与 `docs/process/harness-work-unit-map.md` 的标记区为派生阅读视图。
-
-## RED：旧门禁能放过结构漂移
-
-执行 `scripts/verify-template && ruby scripts/test-export-yss-skills.rb` 时，旧模板发布校验和公开技能导出测试均通过；这不足以证明结构一致。随后新增 `ruby scripts/test-lifecycle-registry.rb` 并在注册表、生成器和校验器尚不存在时执行，得到 1 个失败、2 个错误：
-
-1. `AGENTS.md` 仍声称“21 个门禁”，但原生命周期地图的条件表有 23 行，且混合了门禁、产物、工作单元和证据。
-2. `scripts/verify-lifecycle-registry` 与 `docs/process/lifecycle-registry.yaml` 不存在，旧发布校验没有检测它们。
-3. 负向引用校验无法执行，说明不存在跨对象引用的机器约束。
-
-压力判断：即使旧 `verify-template` 为绿、交付期限临近，也不能把“绿色”合理化为数量、对象类型或派生产物一致；不能把表格行和门禁数量视为同一事实。
-
-独立 RED 压力测试 Agent 因会话模型切换中断，未返回可引用的只读结果；本记录不把该中断误写为通过。RED 基线改由可重放的失败测试和旧门禁绿色输出保留。
-
-## GREEN：本轮新增的可执行约束
-
-1. `docs/process/lifecycle-registry.yaml` 用稳定 ID 区分 `stage.*`、`gate.*`、`artifact.*`、`work-unit.*` 与 `evidence.*`。
-2. `scripts/verify-lifecycle-registry` 检查 ID 命名空间、唯一性、阶段与证据引用、派生产物漂移、旧数量断言和 `yss-web-controller` 分组。
-3. `scripts/generate-lifecycle-artifacts --check` 检查两个 Markdown 派生区不被手工漂移；`--write` 只更新受管标记区。
-4. `scripts/test-lifecycle-registry.rb` 包含未知引用负向测试，并验证陈旧数量不得回流到入口文档。
-5. `scripts/verify-template` 已接入注册表验证、派生一致性和两组回归测试。
-
-## 本轮已执行的 GREEN 验证
-
-```text
-scripts/generate-lifecycle-artifacts --write
-scripts/verify-lifecycle-registry
-ruby scripts/test-lifecycle-registry.rb
-scripts/sync-skills
-scripts/update-skill-lock
-scripts/verify-lifecycle-scenarios
-ruby scripts/test-export-yss-skills.rb
-git diff --check
-```
-
-结果：均通过；公开技能导出测试为 5 runs、72 assertions、0 failures。
-
-## REFACTOR 判断
-
-本轮不把 runtime state、Router contract 或人工批准语义迁移到 registry；`status: shadow` 明确限制该注册表只负责结构事实及派生产物校验。后续 Phase 2 才可在双读 / 单写迁移计划、兼容 fixture 和独立批准下考虑 state schema 切换。
-
-## 独立审查回流与修订
-
-第一次独立审查虽确认五类对象、shadow 边界和公开技能分类正确，但拒绝发布：发布 ID 没有不可变基线，JSON Schema 未实际执行，数量防回归仅匹配两个旧文本，且派生地图仍自称事实源。
-
-修订如下：
-
-1. 新增 `docs/process/lifecycle-registry-baseline.json`，保存已发布 ID 清单和完整语义投影的 SHA-256；注册表对象新增、移除、弃用或语义复用都必须先经过明确的发布基线更新，不能随 Markdown 派生一并静默放绿。
-2. `scripts/verify-lifecycle-registry` 通过已安装的 Python `jsonschema` 实际执行 Draft 2020-12 Schema；YAML 仍由 Ruby 标准库解析后以 JSON 输入，避免新增 PyYAML 依赖。
-3. 所有核心入口与两个派生视图拒绝手工声明“若干个主阶段 / 门禁 / 工作单元 / 职责点”，只引用注册表；地图改为“派生阅读视图”。
-4. 测试新增两个负向场景：删除 `stage.goal` 必须因 JSON Schema 失败；篡改已发布门禁的 `trigger` 必须因语义快照失败。
-
-修订后 fresh 执行 `scripts/verify-template`：通过；生命周期测试为 4 runs、19 assertions、0 failures，公开技能导出测试为 5 runs、72 assertions、0 failures。第二次独立审查结论记录在本文件更新后的 review 结论中。
-
-第二次审查还发现 Ruby 的 `\b` 不能可靠识别“8 个主阶段”中的中文词边界。已将规则收紧为不依赖词边界，并把该文本加入显式正向匹配测试；用户指南改为引用生命周期注册表。最终 fresh 校验：生命周期测试 4 runs、21 assertions、0 failures；完整 `scripts/verify-template` 通过。独立审查最终针对性复核为 PASS：六处核心入口与派生视图无手工数量断言。