create-yss-spec 3.3.0 → 3.3.3

package/template/scripts/lib/template-verification.mjs

@@ -1,92 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { parseDocument } from "../vendor/yaml.mjs";
-
-export const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
-export const PROFILE_FILE = path.join(ROOT, "docs/process/template-verification-profiles.yaml");
-
-function fail(message) { throw new TypeError(message); }
-function ensure(condition, message) { if (!condition) fail(message); }
-
-function globRegex(pattern) {
-  let source = "";
-  for (let index = 0; index < pattern.length; index += 1) {
-    const char = pattern[index];
-    if (char === "*" && pattern[index + 1] === "*") {
-      source += ".*";
-      index += 1;
-    } else if (char === "*") source += "[^/]*";
-    else if (char === "?") source += "[^/]";
-    else source += char.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
-  }
-  return new RegExp(`^${source}$`);
-}
-
-function matches(file, pattern) { return globRegex(pattern).test(file); }
-
-export function loadVerificationProfiles(source = readFileSync(PROFILE_FILE, "utf8")) {
-  const document = parseDocument(source, { uniqueKeys: true });
-  ensure(document.errors.length === 0, document.errors[0]?.message || "核验 profile 无法解析");
-  const config = document.toJS({ maxAliasCount: 0 });
-  ensure(config?.schema_version === 1, "核验 profile schema_version 必须为 1");
-  ensure(config.profiles?.fast && config.profiles?.candidate && config.profiles?.release, "必须声明 fast、candidate、release profile");
-  ensure(config.groups && typeof config.groups === "object", "核验 profile 缺少 groups");
-  for (const [name, group] of Object.entries(config.groups)) ensure(Array.isArray(group.commands), `检查组 ${name} 缺少 commands`);
-  return config;
-}
-
-function matchedGroups(config, changedFiles) {
-  const groups = new Set();
-  const unknown = [];
-  for (const file of changedFiles) {
-    let routed = false;
-    for (const rule of config.routing || []) {
-      if ((rule.patterns || []).some((pattern) => matches(file, pattern))) {
-        routed = true;
-        for (const group of rule.groups || []) groups.add(group);
-      }
-    }
-    if (!routed) unknown.push(file);
-  }
-  return { groups, unknown };
-}
-
-export function planTemplateVerification({ profile = "fast", changedFiles = [], config = loadVerificationProfiles() } = {}) {
-  ensure(Object.hasOwn(config.profiles, profile), `未知核验 profile: ${profile}`);
-  ensure(Array.isArray(changedFiles), "changedFiles 必须是数组");
-  const normalized = [...new Set(changedFiles.map((file) => file.replaceAll("\\", "/")).filter(Boolean))].sort();
-  const routed = matchedGroups(config, normalized);
-  const coreChange = normalized.find((file) => (config.core_escalation_patterns || []).some((pattern) => matches(file, pattern)));
-  let effectiveProfile = profile;
-  let escalationReason = null;
-  if (profile !== "release" && coreChange) {
-    effectiveProfile = "release";
-    escalationReason = `核心核验资产变化: ${coreChange}`;
-  } else if (profile !== "release" && routed.unknown.length > 0) {
-    effectiveProfile = "release";
-    escalationReason = `存在未映射路径: ${routed.unknown.join(", ")}`;
-  }
-  const groups = new Set();
-  if (config.profiles[effectiveProfile].all_groups) Object.keys(config.groups).forEach((group) => groups.add(group));
-  else {
-    (config.profiles[effectiveProfile].always_groups || []).forEach((group) => groups.add(group));
-    routed.groups.forEach((group) => groups.add(group));
-  }
-  const orderedGroups = Object.keys(config.groups).filter((group) => groups.has(group));
-  const commands = [];
-  for (const group of orderedGroups) {
-    for (const entry of config.groups[group].commands) {
-      const command = typeof entry === "string" ? entry : entry.run;
-      const when = typeof entry === "string" ? null : entry.when ?? null;
-      ensure(typeof command === "string" && command, `检查组 ${group} 包含无效命令`);
-      commands.push({ group, command, when });
-    }
-  }
-  return { requested_profile: profile, effective_profile: effectiveProfile, escalation_reason: escalationReason, changed_files: normalized, unknown_files: routed.unknown, groups: orderedGroups, commands, required_files: config.required_files || [], syntax_files: config.syntax_files || [], max_concurrency: config.max_concurrency || 4 };
-}
-
-export function assertRequiredFiles(plan, root = ROOT) {
-  const missing = plan.required_files.filter((file) => !existsSync(path.join(root, file)));
-  ensure(missing.length === 0, `缺少模板必需文件: ${missing.join(", ")}`);
-}

package/template/scripts/node-generate-lifecycle-artifacts.mjs

@@ -1,33 +0,0 @@
-import path from "node:path";
-import { parseArgs } from "node:util";
-import { DEFAULT_REGISTRY, ROOT, loadRegistry, renderLifecycleStructure, renderWorkUnits, replaceRegion, validateRegistry } from "./lib/lifecycle-registry.mjs";
-import { isTemplateSource } from "./lib/repository-mode.mjs";
-
-try {
-  const { values } = parseArgs({
-    options: { check: { type: "boolean" }, write: { type: "boolean" }, registry: { type: "string" } },
-    strict: true
-  });
-  if (values.check && values.write) throw new TypeError("--check 与 --write 不能同时使用");
-  const registryPath = values.registry ? path.resolve(values.registry) : DEFAULT_REGISTRY;
-  const registry = validateRegistry(loadRegistry(registryPath));
-  const targets = [[
-    path.join(ROOT, "docs/process/lifecycle-artifact-map.md"),
-    "<!-- lifecycle-registry:structure:start -->",
-    "<!-- lifecycle-registry:structure:end -->",
-    renderLifecycleStructure(registry)
-  ]];
-  if (isTemplateSource(ROOT)) {
-    targets.push([
-      path.join(ROOT, ".template-source/derived/harness-work-unit-map.md"),
-      "<!-- lifecycle-registry:work-units:start -->",
-      "<!-- lifecycle-registry:work-units:end -->",
-      renderWorkUnits(registry)
-    ]);
-  }
-  for (const [target, start, end, rendered] of targets) replaceRegion(target, start, end, rendered, { check: Boolean(values.check) });
-  process.stdout.write(`${values.check ? "生命周期派生产物与注册表一致" : "生命周期派生产物已更新"}\n`);
-} catch (error) {
-  process.stderr.write(`${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/node-verify-lifecycle-registry.mjs

@@ -1,61 +0,0 @@
-import { readFileSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import { parseArgs } from "node:util";
-import { DEFAULT_REGISTRY, ROOT, loadRegistry, validateRegistry } from "./lib/lifecycle-registry.mjs";
-import { isTemplateSource } from "./lib/repository-mode.mjs";
-
-const schemaValidator = String.raw`
-import json
-import sys
-from jsonschema import Draft202012Validator
-
-with open(sys.argv[1], encoding="utf-8") as schema_file:
-    schema = json.load(schema_file)
-registry = json.load(sys.stdin)
-errors = sorted(Draft202012Validator(schema).iter_errors(registry), key=lambda error: list(error.absolute_path))
-if errors:
-    for error in errors:
-        location = ".".join(str(part) for part in error.absolute_path) or "<root>"
-        print(f"{location}: {error.message}", file=sys.stderr)
-    sys.exit(1)
-`;
-
-function run(command, args, options = {}) {
-  return spawnSync(command, args, { cwd: ROOT, encoding: "utf8", ...options });
-}
-
-try {
-  const { values } = parseArgs({ options: { registry: { type: "string" } }, strict: true });
-  const registryPath = values.registry ? path.resolve(values.registry) : DEFAULT_REGISTRY;
-  const schemaPath = path.join(ROOT, "docs/process/schemas/lifecycle-registry.schema.json");
-  const schema = JSON.parse(readFileSync(schemaPath, "utf8"));
-  if (schema.properties?.schema_version?.const !== 1) throw new TypeError("生命周期注册表 JSON Schema 缺少 schema_version 约束");
-  const registry = loadRegistry(registryPath);
-  const schemaResult = run("python3", ["-c", schemaValidator, schemaPath], { input: JSON.stringify(registry) });
-  if (schemaResult.status !== 0) throw new TypeError(`JSON Schema 校验失败: ${schemaResult.stdout}${schemaResult.stderr}`);
-  validateRegistry(registry);
-  if (registryPath === DEFAULT_REGISTRY) {
-    const generated = run("node", ["scripts/node-generate-lifecycle-artifacts.mjs", "--check"]);
-    if (generated.status !== 0) throw new TypeError(`${generated.stdout}${generated.stderr}`.trim());
-    for (const relativePath of ["docs/process/lifecycle-registry.yaml", "docs/process/lifecycle-registry-baseline.json", "docs/process/schemas/lifecycle-registry.schema.json"]) {
-      const ignored = run("git", ["check-ignore", "-q", relativePath]);
-      if (ignored.status === 0) throw new TypeError(`权威注册表资产不得被 Git 忽略: ${relativePath}`);
-    }
-    const stalePaths = ["AGENTS.md", "README.md", "docs/user-guide/用户手册.md", ".agents/skills/yss-product-lifecycle/SKILL.md", "docs/process/lifecycle-artifact-map.md"];
-    if (isTemplateSource(ROOT)) stalePaths.push(".template-source/derived/harness-work-unit-map.md");
-    for (const relativePath of stalePaths) {
-      if (/\d+\s*个(?:主阶段|门禁|工作单元|职责点)/.test(readFileSync(path.join(ROOT, relativePath), "utf8"))) {
-        throw new TypeError(`${relativePath} 不得手工声明生命周期对象数量；请引用 lifecycle-registry.yaml`);
-      }
-    }
-    const publicSkills = JSON.parse(readFileSync(path.join(ROOT, "yss-public-skills.json"), "utf8"));
-    const groups = new Map(publicSkills.groupings.map((group) => [group.title, group.skills]));
-    if (!groups.get("后端")?.includes("yss-web-controller")) throw new TypeError("yss-web-controller 必须在后端分组");
-    if (groups.get("前端")?.includes("yss-web-controller")) throw new TypeError("yss-web-controller 不得在前端分组");
-  }
-  process.stdout.write(`生命周期注册表验证通过（${registry.status}）\n`);
-} catch (error) {
-  process.stderr.write(`生命周期注册表验证失败: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/prepare-maintenance-review

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-import { mkdirSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { parseArgs } from "node:util";
-import { stringify } from "./vendor/yaml.mjs";
-import { generateReviewerTaskPackages } from "./lib/maintenance-review-workflow.mjs";
-import { ROOT } from "./lib/template-verification.mjs";
-
-try {
-  const { values } = parseArgs({ options: {
-    checkpoint: { type: "string" }, candidate: { type: "string" }, "output-dir": { type: "string" },
-    "candidate-kind": { type: "string" }, "candidate-requirement": { type: "string" },
-    "implementation-actor": { type: "string" }, round: { type: "string" }
-  }, strict: true });
-  for (const field of ["checkpoint", "candidate", "output-dir", "candidate-requirement", "implementation-actor", "round"]) if (!values[field]) throw new TypeError(`缺少 --${field}`);
-  const outputPath = path.resolve(ROOT, values["output-dir"]);
-  if (path.relative(ROOT, outputPath).startsWith("..")) throw new TypeError("output-dir 不得越出仓库");
-  mkdirSync(outputPath, { recursive: true });
-  const packages = generateReviewerTaskPackages({ checkpointRef: values.checkpoint, candidateRef: values.candidate, outputDir: values["output-dir"], candidateKind: values["candidate-kind"], candidateRequirement: values["candidate-requirement"], implementationActorId: values["implementation-actor"], round: Number(values.round) });
-  for (const item of packages) writeFileSync(path.join(ROOT, item.packageRef), stringify(item.package, { lineWidth: 0 }));
-  process.stdout.write(`${JSON.stringify(packages.map(({ axis, packageRef, reportRef }) => ({ axis, package_ref: packageRef, report_ref: reportRef })), null, 2)}\n`);
-} catch (error) {
-  process.stderr.write(`维护审查任务包生成失败: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/run-template-verification

@@ -1,134 +0,0 @@
-#!/usr/bin/env node
-import { spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { parseArgs } from "node:util";
-import { assertRequiredFiles, planTemplateVerification, ROOT } from "./lib/template-verification.mjs";
-
-function git(args) {
-  const result = spawnSync("git", args, { cwd: ROOT, encoding: "utf8" });
-  if (result.status !== 0) throw new TypeError(result.stderr.trim() || `git ${args.join(" ")} 执行失败`);
-  return result.stdout;
-}
-
-function collectChangedFiles(base) {
-  const files = new Set();
-  const collect = (source) => source.split("\n").map((line) => line.trim()).filter(Boolean).forEach((file) => files.add(file));
-  if (base) collect(git(["diff", "--name-only", "--diff-filter=ACDMRTUXB", `${base}...HEAD`]));
-  collect(git(["diff", "--name-only", "--diff-filter=ACDMRTUXB"]));
-  collect(git(["diff", "--cached", "--name-only", "--diff-filter=ACDMRTUXB"]));
-  collect(git(["ls-files", "--others", "--exclude-standard"]));
-  return [...files];
-}
-
-function runCommand(command) {
-  return new Promise((resolve) => {
-    const started = Date.now();
-    const child = spawn(command, { cwd: ROOT, shell: true, env: process.env, stdio: ["ignore", "pipe", "pipe"] });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (chunk) => { stdout += chunk; });
-    child.stderr.on("data", (chunk) => { stderr += chunk; });
-    child.on("close", (code) => resolve({ command, code: code ?? 1, duration_ms: Date.now() - started, stdout, stderr }));
-  });
-}
-
-async function runGroups(plan, repositoryMode, concurrency) {
-  const grouped = new Map(plan.groups.map((group) => [group, []]));
-  for (const item of plan.commands) {
-    if (item.when && item.when !== repositoryMode) continue;
-    grouped.get(item.group).push(item.command);
-  }
-  const jobs = [...grouped.entries()].filter(([, commands]) => commands.length > 0).map(([group, commands]) => async () => {
-    const results = [];
-    for (const command of commands) {
-      const result = await runCommand(command);
-      results.push(result);
-      if (result.code !== 0) break;
-    }
-    return { group, results };
-  });
-  const results = [];
-  let cursor = 0;
-  async function worker() {
-    while (cursor < jobs.length) {
-      const job = jobs[cursor];
-      cursor += 1;
-      results.push(await job());
-    }
-  }
-  await Promise.all(Array.from({ length: Math.min(concurrency, jobs.length || 1) }, () => worker()));
-  return results.sort((left, right) => plan.groups.indexOf(left.group) - plan.groups.indexOf(right.group));
-}
-
-function printResults(groups) {
-  for (const group of groups) {
-    process.stdout.write(`\n[${group.group}]\n`);
-    for (const result of group.results) {
-      process.stdout.write(`$ ${result.command} (${result.duration_ms}ms)\n`);
-      if (result.stdout) process.stdout.write(result.stdout);
-      if (result.stderr) process.stderr.write(result.stderr);
-    }
-  }
-}
-
-function runValidator(command, args) {
-  const result = spawnSync(command, args, { cwd: ROOT, encoding: "utf8" });
-  if (result.status !== 0) throw new TypeError(result.stderr.trim() || `${command} 校验失败`);
-}
-
-try {
-  const { values } = parseArgs({
-    options: {
-      profile: { type: "string", default: "fast" },
-      base: { type: "string" },
-      "changed-file": { type: "string", multiple: true },
-      plan: { type: "boolean", default: false },
-      json: { type: "boolean", default: false },
-      concurrency: { type: "string" },
-      checkpoint: { type: "string", multiple: true },
-      "task-package": { type: "string", multiple: true }
-    },
-    strict: true
-  });
-  const explicit = values["changed-file"] || [];
-  const plan = planTemplateVerification({ profile: values.profile, changedFiles: explicit.length > 0 ? explicit : collectChangedFiles(values.base) });
-  if (values.plan) {
-    process.stdout.write(`${JSON.stringify(plan, null, values.json ? 2 : 0)}\n`);
-    process.exit(0);
-  }
-
-  const major = Number(process.versions.node.split(".")[0]);
-  if (major < 22 || major >= 27) throw new TypeError("模板工具需要 Node >=22 <27");
-  assertRequiredFiles(plan);
-  const before = git(["status", "--porcelain=v1", "-z"]);
-  const modeResult = spawnSync("scripts/repository-mode", [], { cwd: ROOT, encoding: "utf8" });
-  if (modeResult.status !== 0) throw new TypeError(modeResult.stderr.trim() || "仓库身份校验失败");
-  const concurrency = Number(values.concurrency || plan.max_concurrency);
-  if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 4) throw new TypeError("concurrency 必须为 1..4");
-
-  process.stdout.write(`模板核验 profile: ${plan.requested_profile} -> ${plan.effective_profile}\n`);
-  if (plan.escalation_reason) process.stdout.write(`自动升级原因: ${plan.escalation_reason}\n`);
-  const groups = await runGroups(plan, modeResult.stdout.trim(), concurrency);
-  printResults(groups);
-  const failed = groups.flatMap((group) => group.results).find((result) => result.code !== 0);
-  if (failed) throw new TypeError(`检查失败: ${failed.command}`);
-
-  if (plan.effective_profile === "release") {
-    for (const file of plan.syntax_files) runValidator(process.execPath, ["--check", file]);
-    const roots = ["scripts", ".template-source/scripts"].filter((dir) => existsSync(`${ROOT}/${dir}`));
-    const legacyRuntime = ["ru", "by"].join("");
-    const legacyCall = spawnSync("rg", ["-n", `^#!.*${legacyRuntime}|\\b${legacyRuntime}\\b`, ...roots, "--glob", "!*.md"], { cwd: ROOT, encoding: "utf8" });
-    if (legacyCall.status === 0) throw new TypeError("模板脚本不得保留活跃 Ruby 调用或 shebang");
-    const legacyFiles = spawnSync("sh", ["-c", `rg --files ${roots.join(" ")} | rg '\\.rb$'`], { cwd: ROOT, encoding: "utf8" });
-    if (legacyFiles.status === 0) throw new TypeError("模板脚本不得保留 .rb 路径");
-  }
-  for (const checkpoint of values.checkpoint || []) runValidator("scripts/verify-maintenance-checkpoint", [checkpoint]);
-  for (const taskPackage of values["task-package"] || []) runValidator("scripts/verify-digital-human-task-package", [taskPackage]);
-  runValidator("git", ["diff", "--check"]);
-  const after = git(["status", "--porcelain=v1", "-z"]);
-  if (after !== before) throw new TypeError("核验命令修改了工作树；检查必须只读");
-  process.stdout.write(`模板核验通过（${plan.effective_profile}）\n`);
-} catch (error) {
-  process.stderr.write(`模板核验失败: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/sync-strategic-handoff-tools

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-// Main-template-owned shared handoff implementation; never edits runtime skill projections.
-import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync, readdirSync } from 'node:fs';
-import path from 'node:path';
-import { inspectWorkingTreeScope } from './lib/repository-scope-policy.mjs';
-const root=path.resolve(import.meta.dirname,'..');
-const check=process.argv.includes('--check');
-const targets=['submodules/yss-harness-design-agent','submodules/yss-harness-dev-agent','submodules/yss-harness-backend-agent','submodules/yss-harness-frontend-agent'];
-const shared=['scripts/strategic-handoff','scripts/verify-strategic-handoff-consumption','scripts/verify-strategic-handoff-package-scenarios','scripts/verify-strategic-context-import','scripts/verify-strategic-context-import-scenarios','scripts/lib/context-contract.mjs','docs/process/strategic-handoff-package.md','docs/process/schemas/strategic-design-handoff.schema.json',...readdirSync(path.join(root,'scripts/lib')).filter(x=>x.startsWith('strategic-handoff-')||x==='strategic-handoff.mjs').map(x=>`scripts/lib/${x}`),...readdirSync(path.join(root,'docs/process/schemas')).filter(x=>x.startsWith('strategic-handoff-')).map(x=>`docs/process/schemas/${x}`),...readdirSync(path.join(root,'scripts/fixtures/strategic-handoff')).map(x=>`scripts/fixtures/strategic-handoff/${x}`)];
-shared.push('scripts/instantiate-harness','scripts/backend-delivery','scripts/verify-frontend-delivery','scripts/lib/backend-delivery.mjs','scripts/lib/frontend-delivery.mjs','scripts/lib/frontend-delivery-boundary.mjs','docs/process/frontend-backend-delivery.md','docs/process/schemas/backend-delivery.schema.json','docs/process/schemas/backend-delivery-verification.schema.json','docs/process/schemas/frontend-delivery-acceptance.schema.json');
-let differences=[];
-// 专职执行范围由各模板持有；后端只消费 wire 校验器，不恢复原型构建技能。
-function sync(source,dest){let bytes=readFileSync(source);if(dest.includes('/yss-harness-backend-agent/')){let content=bytes.toString();if(dest.endsWith('/scripts/lib/strategic-handoff.mjs'))content=content.replace('../../.agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs','./visual-baseline-contract.mjs');if(dest.endsWith('/scripts/fixtures/strategic-handoff/fixture.mjs'))content=content.replace('../../../.agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs','../../lib/visual-baseline-contract.mjs');bytes=Buffer.from(content);}if(!existsSync(dest)||!bytes.equals(readFileSync(dest))){differences.push(path.relative(root,dest));if(!check){mkdirSync(path.dirname(dest),{recursive:true});writeFileSync(dest,bytes);}}if(!check&&path.basename(path.dirname(dest))==='scripts'&&!path.extname(dest))chmodSync(dest,0o755);}
-for(const kind of ['domain-strategy','stage-decision-package'])sync(path.join(root,`.agents/skills/yss-stage-decision/references/${kind}.schema.json`),path.join(root,`docs/process/schemas/strategic-handoff-${kind}.schema.json`));
-for(const target of targets){
- if(!existsSync(path.join(root,target,'.git')))continue;
- if(!check){const state=inspectWorkingTreeScope(root,{project_root:target,repository_scope:'git-submodule',checkout_state:'attached-branch'});if(!state.writable)throw new Error(`${target}: ${state.violation}`);}
- if(!target.endsWith('design-agent'))for(const ref of ['scripts/verify-frontend-delivery-scenarios','scripts/fixtures/backend-delivery/revision-server.mjs'])sync(path.join(root,ref),path.join(root,target,ref));
- for(const ref of new Set(shared))sync(path.join(root,ref),path.join(root,target,ref));
-}
-if(check&&differences.length){process.stderr.write(`交接工具同步漂移: ${differences.join(', ')}\n`);process.exitCode=1;}else process.stdout.write(`战略交接共享工具 ${check?'同步检查通过':`同步 ${differences.length} 文件`}\n`);

package/template/scripts/verify-business-language-scenarios

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
-import path from "node:path";
-import { loadRegistry, renderLifecycleStructure, renderWorkUnits, semanticDigest, validateRegistry } from "./lib/lifecycle-registry.mjs";
-
-const ROOT = path.resolve(import.meta.dirname, "..");
-const PUBLIC_FILES = [
-  "CONTEXT.md",
-  "docs/templates/spec-template.md",
-  "docs/design/templates/product-overview-design-template.md",
-  "docs/process/harness-executive-blueprint.md",
-  ".agents/skills/yss-stage-decision/SKILL.md",
-];
-const JARGON = ["DDD", "子域", "限界上下文", "Context Map", "统一语言", "不变量", "Strategic Design", "Tactical Design"];
-
-function read(relativePath) {
-  return readFileSync(path.join(ROOT, relativePath), "utf8");
-}
-
-for (const relativePath of PUBLIC_FILES) {
-  const source = read(relativePath);
-  for (const term of JARGON) {
-    assert.equal(source.includes(term), false, `${relativePath} 不应向业务角色展示术语: ${term}`);
-  }
-}
-
-const registry = read("docs/process/lifecycle-registry.yaml");
-for (const stableId of ["work-unit.domain-strategy-design", "artifact.domain-strategy", "gate.domain-strategy-approved"]) {
-  assert.match(registry, new RegExp(`id: ${stableId.replaceAll(".", "\\.")}`));
-}
-for (const displayName of ["业务边界与协作梳理", "业务边界与规则设计", "业务边界与规则确认", "方案决策包"]) {
-  assert.match(registry, new RegExp(displayName));
-}
-
-const registryContract = loadRegistry();
-const withoutPublicPresentation = structuredClone(registryContract);
-for (const collection of ["stages", "gates", "artifacts", "work_units", "evidence"]) {
-  for (const record of withoutPublicPresentation[collection]) {
-    for (const key of Object.keys(record).filter((key) => key.startsWith("public_"))) delete record[key];
-  }
-}
-assert.equal(semanticDigest(registryContract), semanticDigest(withoutPublicPresentation), "public_* 展示字段不得改变稳定 ID 语义摘要");
-const rendered = `${renderLifecycleStructure(registryContract)}${renderWorkUnits(registryContract)}`;
-for (const displayName of ["业务边界与协作梳理", "业务边界与规则设计", "业务边界与规则确认", "方案决策包"]) {
-  assert.match(rendered, new RegExp(displayName));
-}
-const invalidPresentation = structuredClone(registryContract);
-invalidPresentation.artifacts[0].public_name = "";
-assert.throws(() => validateRegistry(invalidPresentation, { baseline: null }), /public_name 必须是非空字符串/);
-
-process.stdout.write("本体业务角色通俗语言场景验证通过\n");

package/template/scripts/verify-context-contract-scenarios

@@ -1,105 +0,0 @@
-#!/usr/bin/env node
-import assert from "node:assert/strict";
-import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-
-const ROOT = path.resolve(import.meta.dirname, "..");
-const validator = path.join(ROOT, "scripts/verify-context-contract");
-
-function contextSource(rows = [], scopeHeader = "适用业务责任区") {
-  return `---
-context_schema_version: 1
----
-# 领域上下文
-
-本文档只记录稳定业务语言。
-
-## 流程术语
-
-| 术语 | 含义 | 英文标识 | 避免 / 备注 |
-|---|---|---|---|
-| Spec | 产品研发规格。 | — |  |
-
-## 业务术语
-
-| 术语 | 含义 | 英文标识 | ${scopeHeader} | 避免 / 备注 |
-|---|---|---|---|---|
-${rows.join("\n")}
-`;
-}
-
-function run(root, ...args) {
-  return spawnSync(process.execPath, [validator, "--root", root, ...args], {
-    cwd: ROOT,
-    encoding: "utf8",
-  });
-}
-
-function expectBlocked(result, pattern, label) {
-  assert.notEqual(result.status, 0, `${label} 应被阻断`);
-  assert.match(`${result.stdout}\n${result.stderr}`, pattern, label);
-}
-
-const sandbox = mkdtempSync(path.join(tmpdir(), "yss-context-contract-"));
-try {
-  const valid = path.join(sandbox, "valid");
-  mkdirSync(valid);
-  writeFileSync(path.join(valid, "CONTEXT.md"), contextSource([
-    "| 供应商 | 提供商品或服务的业务主体。 | Supplier | Global | 避免：`厂商` |",
-    "| 准入决定 | 合规审查形成的准入结论。 | AdmissionDecision | ComplianceReview | 避免：`审批结果` |",
-  ]));
-  const validResult = run(valid, "--allowed-context", "ComplianceReview", "--term-ref", "Global/Supplier", "--term-ref", "ComplianceReview/AdmissionDecision", "--json");
-  assert.equal(validResult.status, 0, validResult.stderr);
-  const validOutput = JSON.parse(validResult.stdout);
-  assert.equal(validOutput.result, "completed");
-  assert.match(validOutput.document_digest, /^sha256:[0-9a-f]{64}$/);
-  assert.match(validOutput.referenced_terms_digest, /^sha256:[0-9a-f]{64}$/);
-
-  const legacyHeader = path.join(sandbox, "legacy-header");
-  mkdirSync(legacyHeader);
-  writeFileSync(path.join(legacyHeader, "CONTEXT.md"), contextSource([
-    "| 供应商 | 提供商品或服务的业务主体。 | Supplier | Global |  |",
-  ], "适用限界上下文"));
-  assert.equal(run(legacyHeader, "--term-ref", "Global/Supplier").status, 0, "旧表头应继续兼容读取");
-
-  const lowercase = path.join(sandbox, "lowercase");
-  mkdirSync(lowercase);
-  writeFileSync(path.join(lowercase, "context.md"), contextSource());
-  expectBlocked(run(lowercase), /根目录.*CONTEXT\.md|大小写/, "小写文件名");
-
-  const nested = path.join(sandbox, "nested");
-  mkdirSync(path.join(nested, "contexts/Foo"), { recursive: true });
-  writeFileSync(path.join(nested, "CONTEXT.md"), contextSource());
-  writeFileSync(path.join(nested, "contexts/Foo/CONTEXT.md"), contextSource());
-  expectBlocked(run(nested), /嵌套.*CONTEXT\.md|只允许项目根目录/, "嵌套 CONTEXT.md");
-
-  const mapped = path.join(sandbox, "mapped");
-  mkdirSync(mapped);
-  writeFileSync(path.join(mapped, "CONTEXT.md"), contextSource());
-  writeFileSync(path.join(mapped, "CONTEXT-MAP.md"), "# Context Map\n");
-  expectBlocked(run(mapped), /CONTEXT-MAP\.md.*禁止/, "CONTEXT-MAP.md");
-
-  const duplicate = path.join(sandbox, "duplicate");
-  mkdirSync(duplicate);
-  writeFileSync(path.join(duplicate, "CONTEXT.md"), contextSource([
-    "| 准入决定 | 第一种定义。 | AdmissionDecision | ComplianceReview |  |",
-    "| 准入结论 | 第二种定义。 | AdmissionDecision | ComplianceReview |  |",
-  ]));
-  expectBlocked(run(duplicate, "--allowed-context", "ComplianceReview"), /术语身份重复/, "重复术语身份");
-
-  const unknownContext = path.join(sandbox, "unknown-context");
-  mkdirSync(unknownContext);
-  writeFileSync(path.join(unknownContext, "CONTEXT.md"), contextSource([
-    "| 准入决定 | 合规审查形成的准入结论。 | AdmissionDecision | UnknownContext |  |",
-  ]));
-  expectBlocked(run(unknownContext, "--allowed-context", "ComplianceReview"), /未在业务边界与规则设计中登记/, "未知作用域");
-
-  expectBlocked(run(valid, "--allowed-context", "ComplianceReview", "--term-ref", "CONTEXT.md#Supplier"), /术语引用格式非法/, "Markdown 伪锚点");
-  expectBlocked(run(valid, "--allowed-context", "ComplianceReview", "--term-ref", "ComplianceReview/Missing"), /无法解析/, "缺失术语引用");
-
-  process.stdout.write("CONTEXT Contract 场景验证通过\n");
-} finally {
-  rmSync(sandbox, { recursive: true, force: true });
-}

package/template/scripts/verify-context-reconciliation-scenarios

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-
-const repoRoot = path.resolve(import.meta.dirname, "..");
-const root = mkdtempSync(path.join(tmpdir(), "yss-context-reconciliation-"));
-mkdirSync(path.join(root, "docs", "evidence"), { recursive: true });
-writeFileSync(path.join(root, "yss-project.yaml"), "schema_version: 1\nrepository_mode: project-instance\n");
-writeFileSync(path.join(root, "CONTEXT.md"), `---
-context_schema_version: 1
----
-
-# CONTEXT
-
-## 流程术语
-
-| 术语 | 含义 | 英文标识 | 避免 / 备注 |
-|---|---|---|---|
-| 阶段 | 生命周期阶段 | — | |
-
-## 业务术语
-
-| 术语 | 含义 | 英文标识 | 适用限界上下文 | 避免 / 备注 |
-|---|---|---|---|---|
-| 供应商 | 提供产品或服务的主体 | Supplier | Global | |
-| 准入结论 | 合规审查的准入结果 | AdmissionDecision | ComplianceReview | |
-`);
-
-function run(command, args) {
-  return spawnSync(command, args, { cwd: repoRoot, encoding: "utf8" });
-}
-
-const snapshotResult = run("scripts/verify-context-contract", ["--root", root, "--allowed-context", "ComplianceReview", "--term-ref", "Global/Supplier", "--term-ref", "ComplianceReview/AdmissionDecision", "--json"]);
-if (snapshotResult.status !== 0) throw new Error(snapshotResult.stderr || snapshotResult.stdout);
-const snapshot = JSON.parse(snapshotResult.stdout).context_snapshot;
-
-function record(overrides = {}) {
-  return {
-    schema_version: 1,
-    repository_mode: "project-instance",
-    stage: "stage.discovery",
-    work_unit: "work-unit.domain-strategy-design",
-    status: "reconciled",
-    context_snapshot: snapshot,
-    changes: { added: ["Global/Supplier", "ComplianceReview/AdmissionDecision"], updated: [], deprecated: [] },
-    unresolved_terms: [],
-    evidence_refs: ["CONTEXT.md"],
-    ...overrides,
-  };
-}
-
-function verify(name, value, expectedStatus) {
-  const file = path.join(root, "docs", "evidence", `${name}.json`);
-  writeFileSync(file, JSON.stringify(value, null, 2));
-  const result = run("scripts/verify-context-reconciliation", ["--root", root, file]);
-  if (result.status !== expectedStatus) throw new Error(`${name}: expected ${expectedStatus}, got ${result.status}\n${result.stdout}${result.stderr}`);
-}
-
-verify("valid", record(), 0);
-verify("stale", record({ context_snapshot: { ...snapshot, document_digest: "sha256:stale" } }), 1);
-verify("blocked", record({ status: "blocked", unresolved_terms: [{ term: "准入状态", reason: "英文标识未确认", owner: "product-owner", next_action: "确认命名" }] }), 1);
-verify("missing-term", record({ changes: { added: ["ComplianceReview/Unknown"], updated: [], deprecated: [] } }), 1);
-verify("not-applicable-project", record({ status: "not-applicable", reason: "无术语变化" }), 1);
-writeFileSync(path.join(root, "yss-project.yaml"), "schema_version: 1\nrepository_mode: template-source\n");
-verify("template-source", record({ repository_mode: "template-source", status: "not-applicable", reason: "模板源仅校验 CONTEXT.md 结构", changes: { added: [], updated: [], deprecated: [] } }), 0);
-
-process.stdout.write("Context reconciliation scenarios passed\n");