create-yss-spec 3.3.7 → 3.4.1

package/template/.pi/skills/yss-mvc-scaffold-generator/scripts/lib/envelope.mjs

@@ -1,74 +0,0 @@
-import { cp, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-import { HARNESS_ROOT, MODULES, PROJECT_SCRIPT_FILES, exists, fail } from "./runtime.mjs";
-import { put } from "./storage.mjs";
-
-const TEMPLATE_SOURCE_COMMAND = /scripts\/(?:verify-template(?:-fast|-candidate)?|sync-skills|update-skill-lock|export-yss-skills|verify-upstream-skill-source|verify-maintenance-checkpoint|verify-implementation-path-scenarios|gitworks)/g;
-const TEMPLATE_SOURCE_SECTION = /(^## 4\. `template-source` 模板维护路由[^\S\r\n]*$)[\s\S]*?(?=^## 5\. `project-instance` 产品研发路由[^\S\r\n]*$)/m;
-
-function removeTemplateSourceCommands(content) {
-  return content.replace(TEMPLATE_SOURCE_COMMAND, "上游 Harness 专用命令");
-}
-
-export function renderProjectInstanceAgents(content) {
-  if (!TEMPLATE_SOURCE_SECTION.test(content)) fail("无法定位 AGENTS.md 的模板维护章节边界");
-  return content.replace(
-    TEMPLATE_SOURCE_SECTION,
-    "$1\n\n当前仓库是 `project-instance`，模板维护只在上游 Harness 执行。\n\n"
-  );
-}
-
-export async function writeProjectEnvelope(o) {
-  await put(o.targetDir, "yss-project.yaml", "schema_version: 1\nrepository_mode: project-instance");
-  await put(o.targetDir, ".artifact-workspace.yaml", `schema_version: 1\nkind: service\nservice_id: ${o.projectName}\nowner: ${JSON.stringify(o.gitAuthor)}`);
-  await cp(path.join(HARNESS_ROOT, "AGENTS.md"), path.join(o.targetDir, "AGENTS.md"));
-  const generatedAgents = await readFile(path.join(o.targetDir, "AGENTS.md"), "utf8");
-  await writeFile(path.join(o.targetDir, "AGENTS.md"), renderProjectInstanceAgents(generatedAgents)
-    .replaceAll(".agents/skills", "../skillUtils/.agents/skills")
-    .replaceAll(".codex/skills", "../skillUtils/.codex/skills"), "utf8");
-  await put(o.targetDir, "CONTEXT.md", "# 领域上下文\n\n## 业务术语\n\n| 术语 | 定义 | 英文标识 | 避免 / 备注 |\n|---|---|---|---|\n| 分析数据集 | 支撑一个数据分析功能的表结构、字段语义和查询边界。 | AnalysisDataset | 具体业务术语在需求分析后补充 |\n| 分析结果 | 数据分析接口返回的分页明细或聚合结果。 | AnalysisResult | 不表示未经约束的原始结果集 |");
-  for (const relative of ["docs/agents", "docs/process", "docs/templates", "docs/architecture/templates"]) {
-    const source = path.join(HARNESS_ROOT, relative);
-    if (!await exists(source)) fail(`项目实例治理资产不存在: ${source}`);
-    await cp(source, path.join(o.targetDir, relative), { recursive: true });
-  }
-  const integrationPath = path.join(o.targetDir, "docs/process/implementation-repo-integration.md");
-  const integration = (await readFile(integrationPath, "utf8"))
-    .replace("模板仓库至少执行：", "以下命令仅由上游 Harness 模板源执行，项目实例不分发这些模板维护工具：")
-    .replace(/scripts\/sync-skills --check\r?\nscripts\/update-skill-lock --check\r?\nscripts\/verify-template/, "在 Harness 模板源执行 Skill 投影同步、锁文件检查和模板发布校验。");
-  await writeFile(integrationPath, integration, "utf8");
-  const checklistPath = path.join(o.targetDir, "docs/templates/build-architecture-checklist-template.md");
-  await writeFile(checklistPath, (await readFile(checklistPath, "utf8")).replace("scripts/verify-implementation-path-scenarios", "node scripts/implementation-path-policy"), "utf8");
-  for (const relative of ["AGENTS.md", "docs/process/implementation-repo-integration.md", "docs/process/harness-process-tailoring.md", "docs/templates/build-architecture-checklist-template.md"]) {
-    const target = path.join(o.targetDir, relative);
-    await writeFile(target, removeTemplateSourceCommands(await readFile(target, "utf8")), "utf8");
-  }
-  const agentReadmePath = path.join(o.targetDir, "docs/agents/README.md");
-  const agentReadme = (await readFile(agentReadmePath, "utf8"))
-    .replace("Engineering Skills 的安装、升级和验证说明", "项目实例使用共享 `skillUtils` 的版本检查说明")
-    .replace("GitLab、MR、CI 和自动 gitworks 的技能配置与使用规则", "GitLab、MR 和 CI 的 `glab` 使用规则");
-  await writeFile(agentReadmePath, agentReadme, "utf8");
-  const issueTrackerPath = path.join(o.targetDir, "docs/agents/issue-tracker.md");
-  await writeFile(issueTrackerPath, (await readFile(issueTrackerPath, "utf8")).replace("当平台为 GitLab 时，优先使用 `glab` 或项目快捷入口 `scripts/gitworks`。", "当平台为 GitLab 时，使用已认证的 `glab`。"), "utf8");
-  const tailoringPath = path.join(o.targetDir, "docs/process/harness-process-tailoring.md");
-  await writeFile(tailoringPath, (await readFile(tailoringPath, "utf8")).replace("使用 `scripts/verify-maintenance-checkpoint <file>` 或通过 stdin 传入 YAML / JSON 做只读校验。触发项 ID 与最低等级只由 `docs/process/maintenance-intensity.yaml` 维护；校验器消费该策略。未知触发项必须先更新该权威策略和场景，不能静默接受。", "维护 checkpoint 校验只在上游 Harness 模板源执行。触发项 ID 与最低等级只由 `docs/process/maintenance-intensity.yaml` 维护；未知触发项必须先更新该权威策略和场景，不能静默接受。"), "utf8");
-  await put(o.targetDir, "docs/agents/skills-maintenance.md", "# 项目实例 Skill 环境\n\n本项目不维护或发布共享 Skill。共享 Skill 位于相邻的 `../skillUtils`，版本由项目根 `skills-lock.json` 锁定。\n\n开发前执行：\n\n```bash\nnpm run check-agent-environment\n```\n\n输出 `READY` 表示工具版本、兼容协议、Agent 投影和 canonical Skill hash 一致。输出 `NOT_READY` 时停止功能实现，使用上游 Harness 的项目初始化或刷新流程更新 `skillUtils`；不要在项目内手工同步、导出或覆盖共享 Skill。\n\n项目实例只消费已提交的 `scripts/lib/*.mjs` 和 `scripts/vendor/*.mjs`。模板发布、Skill 投影生成、上游来源验证和公开导出均属于 Harness 模板源维护，不在本项目执行。");
-  await put(o.targetDir, "docs/agents/gitlab-workflow-skills.md", "# GitLab 工作流\n\n本项目不分发 GitLab 包装脚本。需要查看 MR、Pipeline 或 CI 时，使用已认证的 `glab`，并先确认当前仓库的 `origin` 指向目标 GitLab 项目。\n\n常用只读命令：\n\n```bash\ngit status --short --branch\nglab mr list\nglab ci list\nglab ci status\n```\n\n创建分支、commit、push、MR 或触发 Pipeline 都必须遵守 `AGENTS.md` 的显式授权和 checkpoint 规则。Token 只通过 `glab auth login` 或环境变量管理，不写入仓库文件。");
-  for (const relative of PROJECT_SCRIPT_FILES) await cp(path.join(HARNESS_ROOT, "scripts", relative), path.join(o.targetDir, "scripts", relative));
-  for (const relative of ["lib", "vendor"]) await cp(path.join(HARNESS_ROOT, "scripts", relative), path.join(o.targetDir, "scripts", relative), { recursive: true });
-  for (const relative of ["package.json", "skills-lock.json", ".nvmrc"]) {
-    const source = path.join(HARNESS_ROOT, relative);
-    if (await exists(source)) await cp(source, path.join(o.targetDir, relative));
-  }
-  await put(o.targetDir, "skills-lock.json", JSON.stringify({ version: 1, distribution: { mode: "sibling-directory", skillUtilsDir: "../skillUtils", required: true, compatibility: "skill-utils-v1", requiredToolVersion: "1.0.0" }, skills: { source: "../skillUtils/skills-lock.json", validation: "scripts/check-agent-environment.mjs" } }, null, 2));
-  await put(o.targetDir, "package.json", JSON.stringify({ name: o.projectName, private: true, scripts: { "check-agent-environment": "node scripts/check-agent-environment.mjs", "verify-project": "node scripts/verify-lifecycle-registry", "verify-dto": "node scripts/verify-yss-dto-openapi-profile" } }, null, 2));
-  await put(o.targetDir, "docs/process/analysis-project.yaml", `project_name: ${o.projectName}\nproject_type: data-analysis\nrepository_scope: external-repository\nimplementation_root: .\nruntime_java: 8\npersistence_profile: yss-mybatis-plus\nid_strategy: ASSIGN_ID\ndatabase:\n  type: ${o.database}\n  runtime_connection: true\n  metadata_contract: docs/data-model\nquery:\n  sql_mode: readonly\n  allowed_statement_types: [select, with]\n  parameter_binding_required: true\nmodules:\n${MODULES.map((module) => `  - ${module}`).join("\n")}\nworkflow:\n  - requirement-and-data-contract\n  - specification-freeze\n  - vertical-slice-implementation\n  - automated-gates\n  - single-release-confirmation\n  - runtime-monitoring`);
-  await put(o.targetDir, "docs/process/implementation-repo-registry.yaml", `schema_version: 1\nprojects:\n  - project_type: backend\n    project_name: ${o.projectName}\n    project_root: .\n    git_root: .\n    repository_scope: external-repository\n    scaffold_status: initialized\n    default_branch: main\n    allowed_write_paths:\n      - .\n    verification_commands:\n      - mvnw com.coveo:fmt-maven-plugin:2.9.1:check\n      - mvnw validate\n      - mvnw test\n      - mvnw package\n    expected_evidence_files:\n      - docs/.scratch/<feature>/verification/yss-skill-execution-result.yaml\n      - docs/.scratch/<feature>/verification/fresh-verification.md\n    ci: not-configured\n    rollback_point: initial-empty-repository`);
-  await put(o.targetDir, "docs/.scratch/.gitkeep", "# Local lifecycle artifacts are created in feature subdirectories.");
-  await put(o.targetDir, "docs/service/service-overview.md", `# ${o.projectName} 服务说明\n\nOwner: ${o.gitAuthor}\n\n## 职责\n\n提供数据分析服务能力；具体业务职责在产品服务登记和功能 Spec 中维护。\n\n## 非职责\n\n## 依赖服务\n`);
-  await put(o.targetDir, "docs/service/module-map.md", `# ${o.projectName} Module 地图\n\n| Module | 职责 | 主要 Interface |\n|---|---|---|\n| server | Web 入口与运行配置 | HTTP Controller |\n| core | 领域与应用行为 | Domain/Application Interface |\n| client | 对外 DTO 与客户端契约 | Request/Response |\n| repository | 数据持久化 | Gateway/Repository |\n| adapter | 外部系统适配 | Adapter |\n| feign-client | 服务间调用客户端 | Feign Interface |\n`);
-  await put(o.targetDir, "docs/service/current-capabilities.md", "# 当前能力\n\n本文件是发布时生成的派生阅读视图，普通功能开发不手工修改。功能详情位于 `docs/features/`，开发中功能位于 `docs/.scratch/`。\n");
-  await put(o.targetDir, "docs/engineering/data-analysis-java-conventions.md", `# 数据分析 Java 工程规范\n\n变量、参数和字段必须使用业务含义名称。public 类、接口和方法必须有简体中文 Javadoc；Controller 类和公开接口方法使用初始化时读取的 Git user.name（本项目为 @author ${o.gitAuthor}）和生成时的 @date，方法参数、返回值分别使用 @param、@return 完整说明。Javadoc 正文、@author、@date、@param、@return 必须分行；Mapping 注解、方法签名、方法体不得压缩在同一行。\n`);
-  await put(o.targetDir, ".gitignore", "target/\n**/target/\n.idea/\n*.iml\n.env\n.env.*\n!.env.example\n.local/\n");
-}

package/template/.pi/skills/yss-mvc-scaffold-generator/scripts/lib/envelope.test.mjs

@@ -1,36 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import { renderProjectInstanceAgents } from "./envelope.mjs";
-
-test("按章节边界把模板维护路由转换为项目实例说明", () => {
-  const source = `# AGENTS.md
-
-## 3. 上文
-
-保留。
-
-## 4. \`template-source\` 模板维护路由
-
-这里的自然语言允许持续精简，不应参与匹配。
-
-- 模板源命令也不应进入项目实例。
-
-## 5. \`project-instance\` 产品研发路由
-
-继续保留。
-`;
-
-  const result = renderProjectInstanceAgents(source);
-
-  assert.match(result, /## 4\. `template-source` 模板维护路由\n\n当前仓库是 `project-instance`，模板维护只在上游 Harness 执行。/);
-  assert.doesNotMatch(result, /这里的自然语言允许持续精简/);
-  assert.match(result, /## 5\. `project-instance` 产品研发路由\n\n继续保留/);
-});
-
-test("模板维护章节边界缺失时明确失败", () => {
-  assert.throws(
-    () => renderProjectInstanceAgents("# AGENTS.md\n\n## 5. `project-instance` 产品研发路由\n"),
-    /无法定位 AGENTS\.md 的模板维护章节边界/
-  );
-});

package/template/.pi/skills/yss-mvc-scaffold-generator/scripts/lib/runtime.mjs

@@ -1,114 +0,0 @@
-import { existsSync } from "node:fs";
-import { stat } from "node:fs/promises";
-import { spawnSync } from "node:child_process";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-export const MODULES = ["server", "core", "client", "repository", "adapter", "feign-client"];
-export const SKILL_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
-export const HARNESS_ROOT = findHarnessRoot();
-export const SHARED_SKILLS_ROOT = path.join(HARNESS_ROOT, ".agents", "skills");
-export const SKILL_UTILS_NAME = "skillUtils";
-export const SKILL_UTILS_DIRECTORIES = [
-  ".agents/skills", ".codex/skills", ".cursor/skills", ".pi/skills"
-];
-export const PROJECT_SCRIPT_FILES = [
-  "check-agent-environment.mjs", "implementation-path-policy", "repository-mode", "repository-scope-policy",
-  "generate-lifecycle-artifacts", "node-generate-lifecycle-artifacts.mjs", "node-verify-lifecycle-registry.mjs",
-  "verify-lifecycle-registry", "verify-lifecycle-checkpoint", "verify-frontend-implementation-evidence",
-  "verify-yss-dto-openapi-profile"
-];
-
-export function findHarnessRoot() {
-  let candidate = SKILL_ROOT;
-  while (true) {
-    if (existsSync(path.join(candidate, ".agents", "skills")) && existsSync(path.join(candidate, "AGENTS.md"))) return candidate;
-    const parent = path.dirname(candidate);
-    if (parent === candidate) break;
-    candidate = parent;
-  }
-  throw new Error(`未找到插件 Harness 根目录: ${SKILL_ROOT}`);
-}
-
-export function fail(message) { throw new Error(message); }
-
-export function parseArgs(argv) {
-  const options = { database: "oracle", withMock: false, dryRun: false };
-  const fields = {
-    "--project-name": "projectName", "--base-package": "basePackage", "--target-dir": "targetDir",
-    "--database": "database", "--maven-settings": "mavenSettings"
-  };
-  for (let index = 0; index < argv.length; index += 1) {
-    let token = argv[index];
-    if (token === "--with-mock") { options.withMock = true; continue; }
-    if (token === "--dry-run") { options.dryRun = true; continue; }
-    if (token === "--help" || token === "-h") { options.help = true; continue; }
-    const equals = token.indexOf("=");
-    let value = equals >= 0 ? token.slice(equals + 1) : undefined;
-    if (equals >= 0) token = token.slice(0, equals);
-    if (!fields[token]) fail(`不支持的参数: ${token}`);
-    if (value === undefined) value = argv[++index];
-    if (!value || value.startsWith("--")) fail(`参数 ${token} 缺少值`);
-    options[fields[token]] = value;
-  }
-  if (options.help) return options;
-  if (!options.projectName || !/^[a-z][a-z0-9-]*$/.test(options.projectName)) fail("--project-name 必须是小写连字符名称");
-  if (!options.basePackage || !/^[a-zA-Z_$][\w$]*(\.[a-zA-Z_$][\w$]*)+$/.test(options.basePackage)) fail("--base-package 不是合法 Java 包名");
-  if (!options.targetDir) fail("必须提供 --target-dir");
-  if (!["oracle", "oceanbase-oracle"].includes(options.database)) fail("--database 只支持 oracle 或 oceanbase-oracle");
-  options.targetDir = path.resolve(options.targetDir);
-  if (options.mavenSettings) options.mavenSettings = path.resolve(options.mavenSettings);
-  return options;
-}
-
-export async function exists(target) {
-  try { await stat(target); return true; } catch (error) {
-    if (error.code === "ENOENT") return false;
-    throw error;
-  }
-}
-
-export function xml(value) { return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;"); }
-export function packagePath(name) { return name.replaceAll(".", "/"); }
-export function generatedAtLocal() {
-  const now = new Date();
-  const pad = (value) => String(value).padStart(2, "0");
-  return `${now.getFullYear()}/${pad(now.getMonth() + 1)}/${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}`;
-}
-
-export function runGit(args, cwd) { return spawnSync("git", args, { cwd, encoding: "utf8" }); }
-export function assertGitAvailable() {
-  const result = runGit(["--version"], process.cwd());
-  if (result.status !== 0) fail("未检测到可用的 Git，无法初始化独立项目仓库");
-}
-export function resolveGitAuthor() {
-  const result = runGit(["config", "--get", "user.name"], process.cwd());
-  const author = result.status === 0 ? result.stdout.trim() : "";
-  if (!author) fail("未配置 Git user.name；请先执行 git config --global user.name \"你的姓名\"");
-  if (/[\r\n]|\*\//.test(author)) fail("Git user.name 包含不能安全写入 Javadoc 的字符");
-  return author;
-}
-export function initializeGit(root) {
-  let result = runGit(["init", "--initial-branch=main"], root);
-  if (result.status !== 0) {
-    result = runGit(["init"], root);
-    if (result.status === 0) result = runGit(["branch", "-M", "main"], root);
-  }
-  if (result.status !== 0) fail(`Git 仓库初始化失败: ${(result.stderr || result.stdout).trim()}`);
-}
-
-export async function resolveMavenSettings(options) {
-  if (options.mavenSettings) {
-    if (!await exists(options.mavenSettings)) fail(`Maven settings 不存在: ${options.mavenSettings}`);
-    return { path: options.mavenSettings, source: "explicit", available: true };
-  }
-  if (process.env.YSS_MAVEN_SETTINGS) {
-    const environmentPath = path.resolve(process.env.YSS_MAVEN_SETTINGS);
-    if (!await exists(environmentPath)) fail(`Maven settings 不存在: ${environmentPath}`);
-    return { path: environmentPath, source: "environment", available: true };
-  }
-  const userSettings = path.join(os.homedir(), ".m2", "settings.xml");
-  if (await exists(userSettings)) return { path: userSettings, source: "user-home", available: true };
-  return { path: null, source: "maven-default", available: false };
-}

package/template/.pi/skills/yss-mvc-scaffold-generator/scripts/lib/storage.mjs

@@ -1,90 +0,0 @@
-import { cp, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-import {
-  HARNESS_ROOT,
-  SKILL_ROOT,
-  SKILL_UTILS_DIRECTORIES,
-  SKILL_UTILS_NAME,
-  fail,
-  exists
-} from "./runtime.mjs";
-
-const BOOTSTRAP_ONLY_SKILLS = ["yss-mvc-scaffold-generator"];
-
-async function distributedSkillLock() {
-  const source = path.join(HARNESS_ROOT, "skills-lock.json");
-  if (!await exists(source)) fail(`技能工具包源锁文件不存在: ${source}`);
-  const lock = JSON.parse(await readFile(source, "utf8"));
-  for (const name of BOOTSTRAP_ONLY_SKILLS) {
-    delete lock.skills?.shared?.[name];
-    for (const platform of Object.values(lock.skills?.platform ?? {})) delete platform?.[name];
-  }
-  return `${JSON.stringify(lock, null, 2)}\n`;
-}
-
-export async function assertEmpty(target) {
-  if (!await exists(target)) return;
-  if ((await readdir(target)).length) fail(`目标目录非空，拒绝生成: ${target}`);
-}
-
-export async function put(root, relative, content, author) {
-  const target = path.join(root, relative);
-  const rendered = author ? content.replaceAll("@author system", `@author ${author}`) : content;
-  await mkdir(path.dirname(target), { recursive: true });
-  await writeFile(target, `${rendered.trim()}\n`, "utf8");
-}
-
-export async function renderAsset(name, replacements) {
-  let content = await readFile(path.join(SKILL_ROOT, "assets", name), "utf8");
-  for (const [token, value] of Object.entries(replacements)) content = content.replaceAll(`{{${token}}}`, value);
-  return content;
-}
-
-async function populateSkillUtils(destination) {
-  await mkdir(destination, { recursive: true });
-  for (const relative of SKILL_UTILS_DIRECTORIES) {
-    const source = path.join(HARNESS_ROOT, relative);
-    if (!await exists(source)) fail(`技能工具包源目录不存在: ${source}`);
-    await cp(source, path.join(destination, relative), { recursive: true });
-  }
-  for (const root of SKILL_UTILS_DIRECTORIES) {
-    for (const name of BOOTSTRAP_ONLY_SKILLS) {
-      await rm(path.join(destination, root, name), { recursive: true, force: true });
-    }
-  }
-  await writeFile(path.join(destination, "skills-lock.json"), await distributedSkillLock(), "utf8");
-  const publicSkills = path.join(HARNESS_ROOT, "yss-public-skills.json");
-  if (!await exists(publicSkills)) fail(`技能工具包源文件不存在: ${publicSkills}`);
-  await cp(publicSkills, path.join(destination, "yss-public-skills.json"));
-  await writeFile(path.join(destination, "skill-utils.yaml"), `schema_version: 1\nkind: yss-skill-utils\ntool_version: 1.0.0\ncompatibility: skill-utils-v1\nsource: ${path.basename(HARNESS_ROOT)}\ncanonical_root: .agents/skills\nprojection_roots:\n  - .codex/skills\n  - .cursor/skills\n  - .pi/skills\nexcluded_skills:\n  - yss-mvc-scaffold-generator\n`, "utf8");
-}
-
-export async function ensureSkillUtils(targetDir, { apply = true } = {}) {
-  const parent = path.dirname(targetDir);
-  const skillUtils = path.join(parent, SKILL_UTILS_NAME);
-  const marker = path.join(skillUtils, "skill-utils.yaml");
-  const expectedLock = await distributedSkillLock();
-  if (await exists(skillUtils)) {
-    if (!await exists(marker)) fail(`技能工具包目录已存在但不是受支持的 skillUtils: ${skillUtils}`);
-    const installedLock = path.join(skillUtils, "skills-lock.json");
-    const current = await exists(installedLock) ? await readFile(installedLock, "utf8") : "";
-    if (current === expectedLock) return { path: skillUtils, created: false, refreshed: false, backup: null };
-    if (!apply) return { path: skillUtils, created: false, refreshed: true, backup: null };
-    const staging = await mkdtemp(path.join(parent, ".skillUtils.refresh-"));
-    const backup = path.join(parent, `.skillUtils.backup-${Date.now()}`);
-    try {
-      await populateSkillUtils(staging);
-      await rename(skillUtils, backup);
-      try { await rename(staging, skillUtils); }
-      catch (error) { await rename(backup, skillUtils); throw error; }
-    } catch (error) {
-      if (await exists(staging)) await rm(staging, { recursive: true, force: true });
-      throw error;
-    }
-    return { path: skillUtils, created: false, refreshed: true, backup };
-  }
-  if (!apply) return { path: skillUtils, created: true, refreshed: false, backup: null };
-  await populateSkillUtils(skillUtils);
-  return { path: skillUtils, created: true, refreshed: false, backup: null };
-}

package/template/.pi/skills/yss-mvc-scaffold-generator/scripts/lib/templates.mjs

@@ -1,54 +0,0 @@
-import { generatedAtLocal, packagePath, xml } from "./runtime.mjs";
-
-export function parentPom(o) {
-  const modules = o.modules.map((module) => `    <module>${module}</module>`).join("\n");
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-  <modelVersion>4.0.0</modelVersion><parent><groupId>com.yss.cloud</groupId><artifactId>yss-cloud-microservice</artifactId><version>2.0.0-SNAPSHOT</version><relativePath/></parent>
-  <groupId>${xml(o.basePackage)}</groupId><artifactId>${o.projectName}</artifactId><version>2.0.0-SNAPSHOT</version><packaging>pom</packaging>
-  <properties><java.version>1.8</java.version><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><yss-components.version>2.0.0-SNAPSHOT</yss-components.version></properties>
-  <modules>\n${modules}\n  </modules>
-  <dependencyManagement><dependencies><dependency><groupId>com.yss.cloud</groupId><artifactId>yss-components-bom</artifactId><version>\${yss-components.version}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>
-  <build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-source-plugin</artifactId></plugin><plugin><groupId>com.coveo</groupId><artifactId>fmt-maven-plugin</artifactId><version>2.9.1</version></plugin></plugins></build>
-</project>`;
-}
-
-export function modulePom(o, module) {
-  const artifact = (name) => `<dependency><groupId>${xml(o.basePackage)}</groupId><artifactId>${o.projectName}-${name}</artifactId><version>\${project.version}</version></dependency>`;
-  const yss = (name) => `<dependency><groupId>com.yss.cloud</groupId><artifactId>${name}</artifactId></dependency>`;
-  const databaseDriver = o.database === "oceanbase-oracle" ? `<dependency><groupId>com.oceanbase</groupId><artifactId>oceanbase-client</artifactId><version>2.4.3</version></dependency>` : `<dependency><groupId>com.oracle.database.jdbc</groupId><artifactId>ojdbc8</artifactId><version>19.8.0.0</version></dependency>`;
-  const dependencies = {
-    client: `${yss("yss-component-dto")}\n${yss("yss-component-validation-jsr303")}\n<dependency><groupId>com.yss.cloud</groupId><artifactId>yss-component-excel-mvc</artifactId><version>\${yss-components.version}</version></dependency>\n<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><scope>provided</scope></dependency>`,
-    core: `${artifact("client")}\n${yss("yss-component-exception")}\n<dependency><groupId>com.yss.datamiddle</groupId><artifactId>yss-component-userinfo-starter</artifactId></dependency>\n<dependency><groupId>org.mapstruct</groupId><artifactId>mapstruct</artifactId></dependency>`,
-    repository: `${artifact("core")}\n${artifact("client")}\n${yss("yss-component-mybatis-starter")}\n${yss("yss-component-distributed-id")}\n${databaseDriver}`,
-    adapter: `${artifact("core")}\n${artifact("client")}\n<dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId></dependency>\n<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-openfeign-core</artifactId></dependency>`,
-    "feign-client": `${artifact("client")}\n<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-openfeign-core</artifactId></dependency>`,
-    server: `<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>\n<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-bootstrap</artifactId></dependency>\n${artifact("repository")}\n${artifact("adapter")}\n${artifact("client")}\n${yss("yss-component-audit-log")}\n${yss("yss-component-cache-starter")}\n<dependency><groupId>com.yss.cloud</groupId><artifactId>yss-component-excel-mvc</artifactId><version>\${yss-components.version}</version></dependency>\n${yss("yss-component-distributed-id")}\n<dependency><groupId>com.yss.datamiddle</groupId><artifactId>yss-component-userinfo-starter</artifactId></dependency>\n<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId></dependency>\n<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency>\n<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>`
-  }[module];
-  const profiles = module === "server" ? `<profiles><profile><id>nacos</id><activation><activeByDefault>true</activeByDefault></activation><properties><app.env>dev</app.env><app.profiles>nacos</app.profiles></properties><dependencies><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId></dependency></dependencies></profile></profiles>` : "";
-  const plugin = module === "server" ? `<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin><plugin><groupId>com.ly.smart-doc</groupId><artifactId>smart-doc-maven-plugin</artifactId><version>3.0.5</version><configuration><configFile>src/main/resources/smart-doc.json</configFile><includes><include>com.yss.cloud:yss-component-dto</include><include>com.yss.cloud:yss-component-exception</include><include>com.yss.cloud:yss-component-cache-starter</include><include>${xml(o.basePackage)}:${o.projectName}-client</include><include>${xml(o.basePackage)}:${o.projectName}-core</include><include>${xml(o.basePackage)}:${o.projectName}-repository</include></includes><projectName>\${project.artifactId}</projectName></configuration></plugin></plugins></build>` : "";
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"><modelVersion>4.0.0</modelVersion><parent><groupId>${xml(o.basePackage)}</groupId><artifactId>${o.projectName}</artifactId><version>2.0.0-SNAPSHOT</version></parent><artifactId>${o.projectName}-${module}</artifactId><dependencies>${dependencies}</dependencies>${profiles}${plugin}</project>`;
-}
-
-export async function writeJavaSources(o, put) {
-  const root = o.targetDir;
-  const pkg = o.basePackage;
-  const pp = packagePath(pkg);
-  const generatedAt = generatedAtLocal();
-  await put(root, `client/src/main/java/${pp}/client/query/AnalysisQuery.java`, `package ${pkg}.client.query;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport lombok.NoArgsConstructor;\n\n/** 数据分析分页查询。 */\n@Data\n@NoArgsConstructor\n@AllArgsConstructor\npublic class AnalysisQuery {\n    private int pageNo;\n    private int pageSize;\n    private String sql;\n}`, o.gitAuthor);
-  await put(root, `client/src/main/java/${pp}/client/response/AnalysisResult.java`, `package ${pkg}.client.response;\n\nimport java.util.List;\nimport java.util.Map;\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport lombok.NoArgsConstructor;\n\n/** 数据分析分页结果。 */\n@Data\n@NoArgsConstructor\n@AllArgsConstructor\npublic class AnalysisResult {\n    private int pageNo;\n    private int pageSize;\n    private long total;\n    private List<Map<String, Object>> rows;\n    private String source;\n}`, o.gitAuthor);
-  await put(root, `core/src/main/java/${pp}/core/gateway/AnalysisQueryExecutor.java`, `package ${pkg}.core.gateway;\n\nimport ${pkg}.client.query.AnalysisQuery;\nimport ${pkg}.client.response.AnalysisResult;\n\n/** 数据分析执行接口。 */\npublic interface AnalysisQueryExecutor {\n    AnalysisResult execute(AnalysisQuery query);\n}`, o.gitAuthor);
-  await put(root, `core/src/main/java/${pp}/core/service/AnalysisQueryService.java`, `package ${pkg}.core.service;\n\nimport ${pkg}.client.query.AnalysisQuery;\nimport ${pkg}.client.response.AnalysisResult;\nimport ${pkg}.core.gateway.AnalysisQueryExecutor;\n\n/** 数据分析查询服务。 */\npublic final class AnalysisQueryService {\n    private final AnalysisQueryExecutor analysisQueryExecutor;\n\n    public AnalysisQueryService(AnalysisQueryExecutor analysisQueryExecutor) {\n        this.analysisQueryExecutor = analysisQueryExecutor;\n    }\n\n    public AnalysisResult execute(AnalysisQuery query) {\n        return analysisQueryExecutor.execute(query);\n    }\n}`, o.gitAuthor);
-  await put(root, `adapter/src/main/java/${pp}/adapter/oracle/OracleAnalysisQueryExecutor.java`, `package ${pkg}.adapter.oracle;\n\nimport ${pkg}.client.query.AnalysisQuery;\nimport ${pkg}.client.response.AnalysisResult;\nimport ${pkg}.core.gateway.AnalysisQueryExecutor;\n\n/** Oracle 数据分析执行器占位实现。 */\npublic final class OracleAnalysisQueryExecutor implements AnalysisQueryExecutor {\n    @Override\n    public AnalysisResult execute(AnalysisQuery query) {\n        throw new UnsupportedOperationException("Oracle execution requires an approved vertical slice");\n    }\n}`, o.gitAuthor);
-  if (o.withMock) await put(root, `adapter/src/main/java/${pp}/adapter/mock/MockAnalysisQueryExecutor.java`, `package ${pkg}.adapter.mock;\n\nimport ${pkg}.client.query.AnalysisQuery;\nimport ${pkg}.client.response.AnalysisResult;\nimport ${pkg}.core.gateway.AnalysisQueryExecutor;\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\n\n/** 本地联调数据分析执行器。 */\npublic final class MockAnalysisQueryExecutor implements AnalysisQueryExecutor {\n    @Override\n    public AnalysisResult execute(AnalysisQuery query) {\n        Map<String, Object> row = new HashMap<String, Object>();\n        row.put("metric", "mock-value");\n        row.put("value", 100);\n        List<Map<String, Object>> rows = new ArrayList<Map<String, Object>>();\n        rows.add(row);\n        return new AnalysisResult(query.getPageNo(), query.getPageSize(), 1, rows, "mock");\n    }\n}`, o.gitAuthor);
-  await put(root, `server/src/main/java/${pp}/Application.java`, `package ${pkg};\n\nimport com.yss.cloud.audit.EnableAuditLog;\nimport com.yss.cloud.cache.EnableYssCloudRedisCache;\nimport com.yss.cloud.excel.annotation.EnableExcelControl;\nimport org.springframework.boot.SpringApplication;\nimport org.springframework.boot.autoconfigure.SpringBootApplication;\nimport org.springframework.cloud.openfeign.EnableFeignClients;\nimport org.springframework.context.annotation.ComponentScan;\nimport org.springframework.context.annotation.FilterType;\n\n/** 数据分析服务启动入口。 */\n@EnableYssCloudRedisCache\n@EnableExcelControl\n@EnableAuditLog\n@EnableFeignClients\n@ComponentScan(\n    value = {"${pkg}", "com.yss.cloud"},\n    excludeFilters = @ComponentScan.Filter(\n        type = FilterType.REGEX,\n        pattern = {"com\\\\.yss\\\\.cloud\\\\.mybatis\\\\..*", "com\\\\.yss\\\\.cloud\\\\.sankuai\\\\..*"}))\n@SpringBootApplication\npublic class Application {\n    public static void main(String[] args) {\n        SpringApplication.run(Application.class, args);\n    }\n}`, o.gitAuthor);
-  await put(root, `server/src/main/java/${pp}/server/configuration/DatabaseInfrastructureConfiguration.java`, `package ${pkg}.server.configuration;\n\nimport com.yss.cloud.EnableDistributedId;\nimport com.yss.cloud.mybatis.config.MapperConfiguration;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.context.annotation.Import;\nimport org.springframework.context.annotation.Profile;\n\n/** 数据库及分布式 ID 基础设施配置。 */\n@Configuration\n@Profile("!mock")\n@EnableDistributedId\n@Import(MapperConfiguration.class)\npublic class DatabaseInfrastructureConfiguration {\n}`, o.gitAuthor);
-  const mockImport = o.withMock ? `import ${pkg}.adapter.mock.MockAnalysisQueryExecutor;\n` : "";
-  const mockBean = o.withMock ? `\n    @Bean\n    @Profile("mock")\n    AnalysisQueryExecutor mockAnalysisQueryExecutor() {\n        return new MockAnalysisQueryExecutor();\n    }\n` : "";
-  const databaseRuntimeProfile = o.database === "oceanbase-oracle" ? "oceanbase-oracle" : "oracle";
-  const oracleProfile = o.withMock ? `${databaseRuntimeProfile} & !mock` : databaseRuntimeProfile;
-  await put(root, `server/src/main/java/${pp}/server/configuration/AnalysisConfiguration.java`, `package ${pkg}.server.configuration;\n\n${mockImport}import ${pkg}.adapter.oracle.OracleAnalysisQueryExecutor;\nimport ${pkg}.core.gateway.AnalysisQueryExecutor;\nimport ${pkg}.core.service.AnalysisQueryService;\nimport org.springframework.context.annotation.Bean;\nimport org.springframework.context.annotation.Configuration;\nimport org.springframework.context.annotation.Profile;\n\n/** 数据分析服务 Bean 配置。 */\n@Configuration\npublic class AnalysisConfiguration {${mockBean}\n    @Bean\n    @Profile("${oracleProfile}")\n    AnalysisQueryExecutor oracleAnalysisQueryExecutor() {\n        return new OracleAnalysisQueryExecutor();\n    }\n\n    @Bean\n    AnalysisQueryService analysisQueryService(AnalysisQueryExecutor analysisQueryExecutor) {\n        return new AnalysisQueryService(analysisQueryExecutor);\n    }\n}`, o.gitAuthor);
-  await put(root, `server/src/main/java/${pp}/server/controller/AnalysisController.java`, `package ${pkg}.server.controller;\n\nimport ${pkg}.client.query.AnalysisQuery;\nimport ${pkg}.client.response.AnalysisResult;\nimport ${pkg}.core.service.AnalysisQueryService;\nimport org.springframework.web.bind.annotation.PostMapping;\nimport org.springframework.web.bind.annotation.RequestBody;\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RestController;\n\n/**\n * 数据分析查询接口。\n *\n * @author system\n * @date ${generatedAt}\n */\n@RestController\n@RequestMapping("/api/analysis")\npublic class AnalysisController {\n    private final AnalysisQueryService analysisQueryService;\n\n    public AnalysisController(AnalysisQueryService analysisQueryService) {\n        this.analysisQueryService = analysisQueryService;\n    }\n\n    /**\n     * 分页查询数据分析结果。\n     *\n     * @author system\n     * @date ${generatedAt}\n     * @param query 数据分析分页查询条件\n     * @return 数据分析分页结果\n     */\n    @PostMapping("/query")\n    public AnalysisResult query(@RequestBody AnalysisQuery query) {\n        return analysisQueryService.execute(query);\n    }\n}`, o.gitAuthor);
-  if (o.withMock) await put(root, `server/src/test/java/${pp}/server/controller/AnalysisControllerTest.java`, `package ${pkg}.server.controller;\n\nimport org.junit.jupiter.api.Test;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.context.ActiveProfiles;\nimport org.springframework.test.web.servlet.MockMvc;\n\nimport static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;\nimport static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;\nimport static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;\n\n@SpringBootTest\n@AutoConfigureMockMvc\n@ActiveProfiles("mock")\nclass AnalysisControllerTest {\n    @Autowired private MockMvc mockMvc;\n\n    @Test\n    void returnsMockAnalysis() throws Exception {\n        mockMvc.perform(post("/api/analysis/query").contentType("application/json").content("{\\\"pageNo\\\":1,\\\"pageSize\\\":10}"))\n            .andExpect(status().isOk())\n            .andExpect(jsonPath("$.source").value("mock"));\n    }\n}`, o.gitAuthor);
-}

package/template/.pi/skills/yss-mvc-scaffold-generator/scripts/verify_project.mjs

@@ -1,103 +0,0 @@
-#!/usr/bin/env node
-import { readFile, stat } from "node:fs/promises";
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-
-const modules = ["server", "core", "client", "repository", "adapter", "feign-client"];
-const args = process.argv.slice(2); const index = args.indexOf("--project-root");
-if (index < 0 || !args[index + 1]) { console.error("必须提供 --project-root"); process.exit(1); }
-const root = path.resolve(args[index + 1]);
-async function required(relative) { try { await stat(path.join(root, relative)); } catch { throw new Error(`缺少必需路径: ${relative}`); } }
-try {
-  await Promise.all([".git", ".gitignore", ".artifact-workspace.yaml", "yss-project.yaml", "AGENTS.md", "CONTEXT.md", "skills-lock.json", "scripts/check-agent-environment.mjs", "docs/service/service-overview.md", "docs/service/module-map.md", "docs/service/current-capabilities.md", "docs/agents/issue-tracker.md", "docs/process/lifecycle-registry.yaml", "docs/process/harness-process-tailoring.md", "docs/process/implementation-repo-registry.yaml", "docs/templates/approval-record-template.yaml", "docs/templates/implementation-routing-template.md", "docs/templates/verification-record-template.md", "docs/templates/vertical-slice-ticket-template.md", ".yss/scaffold-generation.json"].map(required));
-  const manifest = JSON.parse(await readFile(path.join(root, ".yss/scaffold-generation.json"), "utf8"));
-  if (manifest.skill !== "yss-mvc-scaffold-generator" || !["oracle", "oceanbase-oracle"].includes(manifest.database)) throw new Error("生成清单与 YSS MVC 脚手架合同不一致");
-  if (manifest.runtime_java !== "8" || manifest.project_version !== "2.0.0-SNAPSHOT" || manifest.persistence_profile !== "yss-mybatis-plus") throw new Error("Java 8/YSS MyBatis-Plus 技术基线不正确");
-  const skillUtils = path.resolve(root, manifest.skill_utils_dir);
-  await Promise.all(["skill-utils.yaml", "skills-lock.json", ".agents/skills/yss-product-lifecycle/SKILL.md", ".agents/skills/yss-implementation-contract-compiler/SKILL.md"].map((relative) => required(path.join(manifest.skill_utils_dir, relative))));
-  for (const projection of [".agents", ".codex", ".cursor", ".pi"]) {
-    const nestedGenerator = path.join(skillUtils, projection, "skills", "yss-mvc-scaffold-generator");
-    if (await stat(nestedGenerator).then(() => true).catch(() => false)) throw new Error(`skillUtils 不应分发创建期生成器: ${projection}/skills/yss-mvc-scaffold-generator`);
-  }
-  for (const forbidden of [".agents", ".codex", ".cursor", ".pi"]) if (await stat(path.join(root, forbidden)).then(() => true).catch(() => false)) throw new Error(`项目不应携带技能投影目录: ${forbidden}`);
-  if (JSON.stringify(manifest.modules) !== JSON.stringify(modules)) throw new Error("模块集合或顺序不正确");
-  const backendRoot = path.join(root, manifest.backend_root || "");
-  await Promise.all(["pom.xml", "mvnw", "mvnw.cmd", ...modules.map((item) => `${item}/pom.xml`)].map((relative) => required(path.join(manifest.backend_root || "", relative))));
-  const packagePath = manifest.base_package.replaceAll(".", "/");
-  await Promise.all([
-    `server/src/main/java/${packagePath}/Application.java`,
-    `server/src/main/java/${packagePath}/server/controller/AnalysisController.java`,
-    `server/src/main/java/${packagePath}/server/configuration/AnalysisConfiguration.java`,
-    `server/src/main/java/${packagePath}/server/configuration/DatabaseInfrastructureConfiguration.java`,
-    `core/src/main/java/${packagePath}/core/gateway/AnalysisQueryExecutor.java`,
-    `core/src/main/java/${packagePath}/core/service/AnalysisQueryService.java`,
-    `client/src/main/java/${packagePath}/client/query/AnalysisQuery.java`,
-    `client/src/main/java/${packagePath}/client/response/AnalysisResult.java`,
-    `adapter/src/main/java/${packagePath}/adapter/oracle/OracleAnalysisQueryExecutor.java`,
-  ].map(required));
-  const all = await readFile(path.join(backendRoot, "pom.xml"), "utf8");
-  for (const module of modules) if (!all.includes(`<module>${module}</module>`)) throw new Error(`父 POM 未声明模块: ${module}`);
-  for (const expected of ["yss-cloud-microservice", "yss-components-bom", "<java.version>1.8</java.version>", "<version>2.0.0-SNAPSHOT</version>"]) if (!all.includes(expected)) throw new Error(`父 POM 缺少技术基线: ${expected}`);
-  await Promise.all(["server/src/main/resources/bootstrap.yml", "server/src/main/resources/bootstrap-nacos.yml", "server/src/main/resources/application-mock.yml", `server/src/main/resources/application-${manifest.database}.yml`, "server/src/main/resources/logback-spring.xml", "server/src/main/resources/smart-doc.json"].map(required));
-  if (manifest.mock_enabled) await required("server/src/main/resources/bootstrap-mock.yml");
-  const bootstrap = await readFile(path.join(backendRoot, "server/src/main/resources/bootstrap.yml"), "utf8");
-  const databaseProfile = manifest.database === "oceanbase-oracle" ? "oceanbase-oracle" : "oracle";
-  const expectedProfiles = `active: \${app.env:dev},datasource,nacos,${databaseProfile}${manifest.mock_enabled ? ",mock" : ""}`;
-  if (!bootstrap.includes(expectedProfiles) || /mock,\s*$/m.test(bootstrap)) throw new Error("Bootstrap profile 顺序或格式不正确");
-  const bootstrapNacos = await readFile(path.join(backendRoot, "server/src/main/resources/bootstrap-nacos.yml"), "utf8");
-  for (const expected of ["${nacosserver:192.168.165.58:8848}", "${nacos_group:yss-dm}", "enabled: true"]) if (!bootstrapNacos.includes(expected)) throw new Error(`Nacos Bootstrap 配置不完整: ${expected}`);
-  if (manifest.mock_enabled) {
-    const bootstrapMock = await readFile(path.join(backendRoot, "server/src/main/resources/bootstrap-mock.yml"), "utf8");
-    if (!/discovery:\s*\n\s*enabled: false/.test(bootstrapMock) || !/config:\s*\n\s*enabled: false/.test(bootstrapMock)) throw new Error("Mock Bootstrap 未禁用 Nacos Discovery/Config");
-    const applicationMock = await readFile(path.join(backendRoot, "server/src/main/resources/application-mock.yml"), "utf8");
-    if (!/leaf:\s*\n\s*leafSegmentEnable: false\s*\n\s*leafSnowflakeEnable: false/.test(applicationMock)) throw new Error("Mock Profile 未禁用 Leaf Segment/Snowflake");
-  }
-  const serverPom = await readFile(path.join(backendRoot, "server/pom.xml"), "utf8");
-  for (const expected of ["spring-boot-maven-plugin", "smart-doc-maven-plugin", "<id>nacos</id>", "<activeByDefault>true</activeByDefault>", "<app.env>dev</app.env>", "<app.profiles>nacos</app.profiles>", `${manifest.project_name}-client`, `${manifest.project_name}-core`, `${manifest.project_name}-repository`]) {
-    if (!serverPom.includes(expected)) throw new Error(`server POM 缺少标准配置: ${expected}`);
-  }
-  const smartDocPlugin = serverPom.match(/<plugin>(?:(?!<\/plugin>)[\s\S])*?<artifactId>smart-doc-maven-plugin<\/artifactId>(?:(?!<\/plugin>)[\s\S])*?<\/plugin>/)?.[0];
-  if (!smartDocPlugin) throw new Error("server POM 缺少 Smart-doc 人工文档能力");
-  if (smartDocPlugin.includes("<executions>")) throw new Error("Smart-doc 不得绑定 Maven execution");
-  const smartDoc = await readFile(path.join(backendRoot, "server/src/main/resources/smart-doc.json"), "utf8");
-  for (const expected of [`"projectName": "${manifest.project_name}"`, `"packageFilters": "${manifest.base_package}.server.controller.*"`, '"showAuthor": true', '"appToken": ""']) {
-    if (!smartDoc.includes(expected)) throw new Error(`Smart-doc 配置不完整: ${expected}`);
-  }
-  if (/43fd1d4bc1c743c1b83bf4843e8167bf|192\.168\./.test(smartDoc)) throw new Error("Smart-doc 不得携带示例项目的内网地址或 Token");
-  const logback = await readFile(path.join(backendRoot, "server/src/main/resources/logback-spring.xml"), "utf8");
-  for (const expected of ['springProfile name="dev,mock"', 'springProfile name="uat,pro,oracle,oceanbase-oracle"', manifest.base_package, "RollingFileAppender", "<maxFileSize>100MB</maxFileSize>", "<maxHistory>7</maxHistory>"]) {
-    if (!logback.includes(expected)) throw new Error(`Logback 配置不完整: ${expected}`);
-  }
-  const controller = await readFile(path.join(backendRoot, `server/src/main/java/${packagePath}/server/controller/AnalysisController.java`), "utf8");
-  for (const expected of [`@author ${manifest.javadoc_author}`, "@date ", "@param query", "@return "]) if (!controller.includes(expected)) throw new Error(`Controller Javadoc 不完整: ${expected}`);
-  const application = await readFile(path.join(backendRoot, `server/src/main/java/${packagePath}/Application.java`), "utf8");
-  if (application.includes("@EnableDistributedId")) throw new Error("启动类不得在 Mock profile 无条件启用分布式 ID");
-  const databaseInfrastructure = await readFile(path.join(backendRoot, `server/src/main/java/${packagePath}/server/configuration/DatabaseInfrastructureConfiguration.java`), "utf8");
-  for (const expected of ['@Profile("!mock")', "@EnableDistributedId", "@Import(MapperConfiguration.class)"]) if (!databaseInfrastructure.includes(expected)) throw new Error(`数据库基础设施 Profile 隔离不完整: ${expected}`);
-  const configuration = await readFile(path.join(backendRoot, `server/src/main/java/${packagePath}/server/configuration/AnalysisConfiguration.java`), "utf8");
-  const expectedOracleProfile = manifest.mock_enabled ? `@Profile("${databaseProfile} & !mock")` : `@Profile("${databaseProfile}")`;
-  if (!configuration.includes(expectedOracleProfile)) throw new Error("Oracle/Mock 执行器 Profile 隔离不正确");
-  const identity = await readFile(path.join(root, "yss-project.yaml"), "utf8");
-  if (!identity.includes("repository_mode: project-instance")) throw new Error("项目身份不是 project-instance");
-  const registry = await readFile(path.join(root, "docs/process/implementation-repo-registry.yaml"), "utf8");
-  if (/smart-doc(?:-maven-plugin[^\n]*:openapi|-verification\.md|:html|:torna-rest)/i.test(registry)) throw new Error("AI Coding 默认验证不得执行 Smart-doc 或要求其证据");
-  const expectedRegistryLines = [
-    `    project_name: ${manifest.project_name}`,
-    `    project_root: ${manifest.backend_root}`,
-    "    git_root: .",
-    "    repository_scope: external-repository",
-    "      - .",
-  ];
-  for (const line of expectedRegistryLines) {
-    if (!registry.split(/\r?\n/).includes(line)) throw new Error(`实现仓登记与生成清单不一致: ${line.trim()}`);
-  }
-  const gitRoot = spawnSync("git", ["-C", root, "rev-parse", "--show-toplevel"], { encoding: "utf8" });
-  if (gitRoot.status !== 0 || path.resolve(gitRoot.stdout.trim()).toLowerCase() !== root.toLowerCase()) throw new Error("目标目录不是独立 Git 仓库根");
-  const branch = spawnSync("git", ["-C", root, "branch", "--show-current"], { encoding: "utf8" });
-  if (branch.status !== 0 || branch.stdout.trim() !== "main") throw new Error("独立 Git 仓库默认分支不是 main");
-  const commits = spawnSync("git", ["-C", root, "rev-list", "--all", "--count"], { encoding: "utf8" });
-  if (commits.status !== 0 || commits.stdout.trim() !== "0") throw new Error("生成器不得创建 Git commit");
-  const remotes = spawnSync("git", ["-C", root, "remote"], { encoding: "utf8" });
-  if (remotes.status !== 0 || remotes.stdout.trim()) throw new Error("生成器不得配置 Git remote");
-  console.log(`项目结构验证通过：${manifest.project_name}，${modules.length} 个模块，mock=${manifest.mock_enabled}`);
-} catch (error) { console.error(error.message); process.exitCode = 1; }

package/template/docs/user-guide//346/210/230/346/234/257/350/256/276/350/256/241/345/255/220/351/241/271/347/233/256/347/224/250/346/210/267/346/211/213/345/206/214.md

@@ -1,35 +0,0 @@
-# 战术设计子项目用户手册
-
-本入口保留给既有读者。“战术设计子项目”通过 `yss-technical-design` 统一承接技术设计，整体主控仍为 `yss-product-lifecycle`。先确认后端项目采用 `domain-driven` 或 `layered-mvc`，再分别调用 `yss-tactical-design` 或 `yss-mvc-design`；DDD 是选项，不是默认要求。技术设计不代替 API Freeze 或 Slice Contract 批准。
-
-## 输入与开始
-
-先核对本仓身份、profile、根 CONTEXT.md、适用的战略交接、需求及批准证据。已有战略包时，导入快照后完成目标词汇对账，再逐项登记源规则/关键场景的承接；缺失、冲突或过期先回交，不能猜测业务规则。
-
-```text
-请按本仓生命周期检查“设备领用”当前战略输入及目标词汇对账。
-使用 yss-technical-design 核对已确认的项目架构并起草技术设计，
-DDD 调用 yss-tactical-design，传统 MVC 调用 yss-mvc-design；
-解释设备占用的竞争、状态转换和一致性边界，并映射公开测试 seam。
-逐项列出已承接、冲突、延期及依赖切片，等待适用审查后再编译实现合同。
-```
-
-## 评审要回答的问题
-
-| 设计问题 | 设备借用中的例子 |
-|---|---|
-| 谁保护不变量 | 哪个对象/边界保证设备不能同时被领用 |
-| 状态是否合法 | 未批准申请是否允许领用；重复归还如何处理 |
-| 一致性在哪里保证 | 申请与设备占用是否同事务；失败如何恢复 |
-| 外部依赖如何隔离 | API/Repository/适配边界怎样映射而不篡改业务含义 |
-| 如何证伪设计 | 并发领用、无权限、重复请求的公开 seam 与预期结果 |
-
-案例只是提问方向，答案由项目实际业务与工程条件决定。MVC 不要求先完成战略 DDD，也不要求聚合、值对象或 DDD Gateway；用例、规则、事务、幂等、并发和测试承接仍须清晰。没有相关技术设计影响时记录带原因的 not-applicable。
-
-## 从设计到实现
-
-综合项目由本仓生命周期继续路由，通用研发/后端由 Harness 流程承接。前端专职只消费上游规则、冻结接口并准备前端工程设计，不在本仓派发后端战术实现。
-
-技术设计经现有门禁批准后，编译器消费当前设计并起草实现合同，批准与可实现状态由本仓编排和门禁控制。实现前确认工程登记、冻结接口、测试 seam、允许路径与回滚点。战术评审通过不等于 ready-for-agent。
-
-过程示例见 [设备借用贯穿案例](设备借用贯穿案例.md)；项目选型见 [用户手册](用户手册.md)。