create-yss-spec 3.3.1 → 3.3.3

package/template/scripts/verify-template-verification-scenarios

@@ -1,89 +0,0 @@
-#!/usr/bin/env node
-import assert from "node:assert/strict";
-import { planTemplateVerification } from "./lib/template-verification.mjs";
-
-const releaseBaseline = [
-  ".template-source/scripts/evidence-index --check",
-  "pnpm --dir .template-source/tooling/node test",
-  "pnpm --dir .template-source/tooling/node check:vendor",
-  "scripts/sync-skills --check",
-  "scripts/update-skill-lock --check",
-  "scripts/verify-skill-registry",
-  "scripts/verify-skill-governance",
-  "node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs",
-  "node --check .agents/skills/yss-tactical-design/tests/run-scenarios.mjs",
-  "node .agents/skills/yss-tactical-design/tests/run-scenarios.mjs",
-  "scripts/verify-yss-dto-openapi-profile",
-  "scripts/verify-yss-dto-openapi-scenarios",
-  "scripts/verify-digital-human-roles",
-  "scripts/verify-digital-human-roles-scenarios",
-  "scripts/verify-approval-record --history docs/templates/approval-record-template.yaml",
-  "scripts/verify-lifecycle-registry",
-  "scripts/verify-context-contract --root . --json",
-  "scripts/verify-context-contract-scenarios",
-  "scripts/verify-context-reconciliation-scenarios",
-  "scripts/verify-grill-with-docs-context-scenarios",
-  "scripts/verify-strategic-context-import-scenarios",
-  "scripts/verify-lifecycle-checkpoint docs/process/templates/lifecycle-checkpoint-template.yaml",
-  "scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-plan-template.yaml",
-  "scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-verification-template.yaml",
-  "scripts/verify-subagent-task-package-scenarios",
-  "scripts/verify-digital-human-task-package-scenarios",
-  "scripts/verify-digital-human-task-package .template-source/evidence/maintenance/digital-human-task-package-review-task.yaml",
-  "scripts/verify-digital-human-task-package .template-source/evidence/maintenance/lifecycle-ticket-transition-review-task-package.yaml",
-  "scripts/verify-maintenance-checkpoint .template-source/evidence/maintenance/yss-tactical-design-l3-checkpoint-2026-08-27.yaml",
-  "scripts/verify-lifecycle-scenarios",
-  "scripts/verify-lifecycle-transition-scenarios",
-  "scripts/verify-maintenance-intensity-scenarios",
-  "scripts/verify-governance-release",
-  "scripts/verify-implementation-path-scenarios",
-  "scripts/verify-repository-scope-scenarios",
-  "scripts/verify-scaffold-generator-scenarios",
-  "scripts/verify-prototype-backend-scaffold-scenarios",
-  "scripts/verify-matt-yss-integration-scenarios",
-  "scripts/verify-yss-implementation-contract-compiler-scenarios",
-  "scripts/generate-yss-skill-boundaries --check",
-  "scripts/audit-yss-backend-skills --check",
-  "scripts/verify-retired-skill-ids",
-  "scripts/verify-yss-ui-scenarios",
-  "scripts/verify-yss-prototype-contract-scenarios",
-  "node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-evidence docs/design/templates/prototype-evidence-template.yaml --allow-template",
-  "scripts/verify-openapi-yaml-first-scenarios",
-  "scripts/verify-openapi-json-handoff-scenarios"
-].sort();
-
-const release = planTemplateVerification({ profile: "release", changedFiles: [] });
-assert.equal(release.effective_profile, "release");
-const releaseCommands = new Set(release.commands.map((entry) => entry.command));
-assert.deepEqual(releaseBaseline.filter((command) => !releaseCommands.has(command)), [], "release profile 必须保留旧发布门禁的全部行为命令");
-assert.ok(releaseCommands.has("node scripts/verify-template-verification-scenarios"), "release profile 必须验证三级核验路由本身");
-
-const docsOnly = planTemplateVerification({ profile: "fast", changedFiles: ["docs/user-guide/example.md"] });
-assert.equal(docsOnly.effective_profile, "fast");
-assert.ok(docsOnly.groups.includes("hygiene"));
-assert.ok(!docsOnly.groups.includes("skills"), "文档内循环不得运行无关 skill 投影检查");
-
-const skillChange = planTemplateVerification({ profile: "fast", changedFiles: [".agents/skills/maintaining-skills/SKILL.md"] });
-assert.ok(skillChange.groups.includes("skills"));
-assert.ok(skillChange.groups.includes("hygiene"));
-
-const prototypeContractChange = planTemplateVerification({ profile: "fast", changedFiles: ["scripts/verify-yss-prototype-contract-scenarios"] });
-assert.ok(prototypeContractChange.groups.includes("implementation"), "原型契约脚本变化必须运行实现压力场景");
-
-const candidate = planTemplateVerification({ profile: "candidate", changedFiles: ["docs/process/harness-process-tailoring.md"] });
-assert.equal(candidate.effective_profile, "candidate");
-assert.ok(candidate.groups.includes("maintenance"));
-assert.ok(candidate.groups.includes("candidate-integrity"));
-
-const unknown = planTemplateVerification({ profile: "candidate", changedFiles: ["new-unmapped-root/file.txt"] });
-assert.equal(unknown.effective_profile, "release");
-assert.match(unknown.escalation_reason, /未映射/);
-
-const core = planTemplateVerification({ profile: "fast", changedFiles: ["scripts/lib/template-verification.mjs"] });
-assert.equal(core.effective_profile, "release");
-assert.match(core.escalation_reason, /核心核验/);
-
-const entryRule = planTemplateVerification({ profile: "candidate", changedFiles: ["AGENTS.md"] });
-assert.equal(entryRule.effective_profile, "release", "Agent 入口规则变化必须 fail-safe 到完整门禁");
-
-process.stdout.write("模板三级核验路由场景验证通过\n");

package/template/scripts/verify-upstream-skill-source

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import { skillNames, treeHash, validateYssUiSkillManifest } from "./lib/skill-supply-chain.mjs";
-
-const root = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
-const args = process.argv.slice(2);
-const source = args.find((arg) => arg.startsWith("--source="))?.slice("--source=".length) ?? "mattpocock/skills";
-const sourceRootArg = args.find((arg) => arg.startsWith("--source-root="))?.slice("--source-root=".length);
-if (!sourceRootArg) {
-  process.stderr.write("用法: scripts/verify-upstream-skill-source [--source=<source-id>] --source-root=<上游 checkout>\n");
-  process.exit(2);
-}
-const sourceRoot = path.resolve(sourceRootArg);
-const lock = JSON.parse(readFileSync(path.join(root, "skills-lock.json"), "utf8"));
-const revision = lock.sources?.[source]?.revision;
-if (!revision) throw new TypeError(`锁文件缺少 ${source} source revision`);
-const git = spawnSync("git", ["-C", sourceRoot, "rev-parse", "HEAD"], { encoding: "utf8" });
-if (git.status !== 0) throw new TypeError(`无法读取上游 checkout revision: ${sourceRoot}`);
-if (git.stdout.trim() !== revision) throw new TypeError(`上游 revision 不匹配: expected=${revision} actual=${git.stdout.trim()}`);
-
-if (source === "iloveZzz/yss-ui") {
-  const manifest = validateYssUiSkillManifest(JSON.parse(readFileSync(path.join(root, ".agents/skills/.yss-skills-manifest.json"), "utf8")));
-  if (manifest.source_revision !== revision) throw new TypeError(`yss-ui manifest revision 与锁文件不一致: ${manifest.source_revision}`);
-  const packageJson = JSON.parse(readFileSync(path.join(sourceRoot, manifest.source_root, "package.json"), "utf8"));
-  if (packageJson.name !== manifest.package.name || packageJson.version !== manifest.package.version) {
-    throw new TypeError(`yss-ui skills 包版本不匹配: expected=${manifest.package.name}@${manifest.package.version} actual=${packageJson.name}@${packageJson.version}`);
-  }
-  const upstreamRoot = path.join(sourceRoot, manifest.source_root);
-  const sourceConfig = JSON.parse(readFileSync(path.join(upstreamRoot, "skills.config.json"), "utf8"));
-  if (!sourceConfig.defaultSync?.includes(manifest.source_category)) throw new TypeError(`yss-ui 默认同步不包含分类: ${manifest.source_category}`);
-  const categorySkills = sourceConfig.categories?.[manifest.source_category];
-  if (!Array.isArray(categorySkills)) throw new TypeError(`yss-ui 上游缺少分类: ${manifest.source_category}`);
-  const actualFrontend = categorySkills.filter((name) => !manifest.excluded_skills.includes(name)).sort();
-  const physicalSkills = new Set(skillNames(upstreamRoot).filter((name) => existsSync(path.join(upstreamRoot, name, "SKILL.md"))));
-  for (const name of actualFrontend) if (!physicalSkills.has(name)) throw new TypeError(`yss-ui 上游分类引用不存在的 skill: ${name}`);
-  for (const category of manifest.excluded_categories) {
-    for (const name of sourceConfig.categories?.[category] ?? []) {
-      if (manifest.skills.some(({ upstream }) => upstream === name)) throw new TypeError(`yss-ui 清单误包含已排除分类 ${category}: ${name}`);
-    }
-  }
-  const declaredFrontend = manifest.skills.map(({ upstream }) => upstream).sort();
-  if (JSON.stringify(actualFrontend) !== JSON.stringify(declaredFrontend)) {
-    throw new TypeError(`yss-ui 前端 skills 清单漂移: expected=${declaredFrontend.join(",")} actual=${actualFrontend.join(",")}`);
-  }
-  for (const skill of manifest.skills) {
-    const item = lock.skills?.shared?.[skill.canonical];
-    if (!item || item.source !== source) throw new TypeError(`${skill.canonical} 未按 yss-ui source 锁定`);
-    if (item.skillPath !== `${manifest.source_root}/${skill.upstream}/SKILL.md`) throw new TypeError(`${skill.canonical} 上游路径不一致`);
-    const actualHash = treeHash(path.join(upstreamRoot, skill.upstream));
-    if (actualHash !== skill.upstream_hash || item.upstreamHash !== actualHash) {
-      throw new TypeError(`${skill.canonical} upstreamHash 不匹配: manifest=${skill.upstream_hash} lock=${item.upstreamHash} actual=${actualHash}`);
-    }
-  }
-}
-
-const shared = lock.skills?.shared ?? {};
-for (const [name, item] of Object.entries(shared)) {
-  if (item.source !== source) continue;
-  if (item.sourceRevision !== revision) throw new TypeError(`${name} 缺少一致的 sourceRevision`);
-  const directory = path.dirname(path.join(sourceRoot, item.skillPath));
-  if (!existsSync(directory)) throw new TypeError(`${name} 的上游路径不存在: ${item.skillPath}`);
-  const actualHash = treeHash(directory);
-  if (actualHash !== item.upstreamHash) throw new TypeError(`${name} upstreamHash 不匹配: expected=${item.upstreamHash} actual=${actualHash}`);
-}
-process.stdout.write(`上游 ${source}@${revision} 及其 skill hashes 验证通过\n`);

package/template/scripts/verify-user-decision-scenarios

@@ -1,103 +0,0 @@
-#!/usr/bin/env node
-import assert from "node:assert/strict";
-import { mkdtempSync, rmSync, writeFileSync, readFileSync } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-import { buildDecisionFixture, buildImplementationFixture } from "./fixtures/user-decision/build-fixture.mjs";
-import { validateUserDecision, assertUserDecisionRequirement, assertImplementationDecision, decisionDigest } from "./lib/user-decision.mjs";
-import { validateApprovalRecord, assertCheckpointApprovals, assertCheckpointUserDecisions } from "./lib/approval-record.mjs";
-import { validateNextRoute } from "./lib/lifecycle-transition.mjs";
-import { loadDigitalHumanRoles, countersignRuleForGate, collectCountersignGateIds } from "./lib/digital-human-roles.mjs";
-
-const root = mkdtempSync(path.join(os.tmpdir(), "yss-user-decision-"));
-process.on("exit", () => rmSync(root, { recursive: true, force: true }));
-let count = 0;
-const check = (name, fn) => { fn(); count++; process.stdout.write(`PASS ${name}\n`); };
-const fixture = (name, opts) => buildDecisionFixture(path.join(root, name), opts);
-const verify = (f) => validateUserDecision(f.record, { expected: [f.requirement] });
-const deny = (f, code) => assert.throws(() => verify(f), (error) => error.code === code, code);
-check("真实单项回复通过，CLI 校验通过", () => {
-  const f = fixture("single"); verify(f);
-  assert.equal(spawnSync("scripts/verify-user-decision", [f.ref], { encoding: "utf8" }).status, 0);
-});
-check("无回复保持等待", () => { const f = fixture("pending"); f.record.responses = []; deny(f, "user-decision-response-required"); });
-for (const decision of ["rejected", "changes-requested", "unclear", "revoked"]) check(`${decision} 不放行`, () => { const f = fixture(decision); f.record.responses = []; f.respond({ decision, text: decision, approvedScope: [] }); deny(f, "user-decision-not-approved"); });
-check("数字人代答无效", () => { const f = fixture("bot"); f.record.responses = []; f.respond({ actor: "digital-human" }); deny(f, "user-decision-responder-mismatch"); });
-check("默认选项和无反对意见不能代替原始消息", () => { const f = fixture("default"); f.record.responses[0].source.kind = "default-option"; assert.throws(() => verify(f)); });
-check("记录原文与来源不一致无效", () => { const f = fixture("text"); f.record.responses[0].text = "我批准全部"; deny(f, "user-decision-responder-mismatch"); });
-check("缺失来源和仅 Agent 摘要无效", () => { const f = fixture("missing"); f.record.responses[0].source.ref += ".missing"; deny(f, "user-decision-source-unreadable"); const g = fixture("summary"); g.record.responses[0].source.kind = "agent-summary"; assert.throws(() => verify(g)); });
-check("来源篡改被拒绝", () => { const f = fixture("source-changed"); writeFileSync(f.record.responses[0].source.ref, "变更"); deny(f, "user-decision-source-changed"); });
-check("未展示当前请求不能批准", () => { const f = fixture("presentation"); f.record.request.items[0].recommendation = "不同方案"; deny(f, "user-decision-presentation-mismatch"); });
-check("展示前回复无效", () => { const f = fixture("time"); f.record.responses = []; f.respond({ time: "2026-09-05T01:01:00Z" }); deny(f, "user-decision-source-invalid"); });
-check("错误版本及批准依据变化重新确认", () => { const f = fixture("version"); f.record.request.items[0].subject.version = "v2"; f.present(); deny(f, "user-decision-stale"); const g = fixture("asset"); writeFileSync(g.requirement.subject_ref, "新范围"); deny(g, "user-decision-stale"); });
-check("额外依据变化重新确认，无关文件不影响", () => {
-  const f = fixture("basis"); const ref = f.write("basis.md", "v1"); f.record.request.items[0].basis = [{ ref, version: "v1", digest: decisionDigest(readFileSync(ref)) }]; f.present(); f.record.responses = []; f.respond(); verify(f); f.write("unrelated.md", "change"); verify(f); f.write("basis.md", "v2"); deny(f, "user-decision-stale");
-});
-check("同版本范围可重复使用且不按时间过期", () => { const f = fixture("reuse"); verify(f); verify(f); });
-check("范围扩大和错误事项无效", () => { const f = fixture("scope"); f.requirement.scope.push("new-feature"); deny(f, "user-decision-subject-mismatch"); const g = fixture("wrong-item"); g.record.responses[0].item_ids = ["other"]; deny(g, "user-decision-subject-mismatch"); });
-check("提问者指定负责人有效，未指定代答无效", () => {
-  const f = fixture("delegate"); const item = f.record.request.items[0]; item.responder_ref = "person.owner"; item.delegation_source = f.capture("delegate", "person.requester", "biological-human", "2026-09-05T01:01:00Z", "指定 person.owner 决定 decision.demo"); f.present(); f.record.responses = []; f.respond({ principal: "person.owner" }); verify(f); delete item.delegation_source; f.present(); deny(f, "user-decision-source-invalid");
-});
-check("多项继续无效，明确全部或部分批准有效", () => {
-  const f = fixture("multi"); const second = structuredClone(f.record.request.items[0]); second.id = "decision.second"; second.boundary = "gate.openapi-frozen"; second.scope = ["api.demo"]; f.record.request.items.push(second); f.present(); f.record.responses = []; f.respond({ text: "继续" }); deny(f, "user-decision-ambiguous");
-  f.record.responses = []; f.respond({ text: "同意以上全部事项" }); verify(f);
-  f.record.responses = []; f.respond({ text: "同意 decision.demo", selection: "explicit-items", itemIds: ["decision.demo"], approvedScope: ["feature.demo"] }); verify(f);
-  assert.throws(() => validateUserDecision(f.record, { expected: [{ ...f.requirement, boundary: second.boundary, scope: second.scope }] }), /user-decision-response-required/);
-});
-check("不能把其他对话的同意嫁接为当前批准", () => {
-  const f = fixture("unrelated-response"); const source = f.record.responses[0].source;
-  const raw = JSON.parse(readFileSync(source.ref)); raw.messages[0].reply_to = "different-request"; writeFileSync(source.ref, JSON.stringify(raw)); source.digest = decisionDigest(readFileSync(source.ref)); deny(f, "user-decision-subject-mismatch");
-});
-check("无 reply-to 的完整相邻会话导出可复用", () => {
-  const f = fixture("adjacent-export"); const source = f.record.responses[0].source;
-  const reply = JSON.parse(readFileSync(source.ref)).messages[0]; delete reply.reply_to;
-  const shown = JSON.parse(readFileSync(f.record.request.presented_source.ref)).messages[0];
-  const ref = f.write("original-session.json", { source_kind: "session-export", messages: [shown, reply] });
-  source.ref = ref; source.digest = decisionDigest(readFileSync(ref)); verify(f);
-});
-check("生物人会签者必须与原始回复者一致", () => {
-  const f = fixture("human-approval", { boundary: "gate.release-ready" });
-  const record = { schema_version: 1, gate_id: "gate.release-ready", decision: "approved", actor_kind: "biological-human", role_id: "role.biological-human", runtime_id: "runtime.generic", principal_ref: "person.requester", subject_ref: f.requirement.subject_ref, approval_scope: f.requirement.scope, user_decision_ref: f.ref };
-  validateApprovalRecord(record, { requireApproved: true });
-  assert.throws(() => validateApprovalRecord({ ...record, principal_ref: "person.someone-else" }, { requireApproved: true }), /user-decision-responder-mismatch/);
-});
-check("相反原文不能被 Agent 归一化成批准", () => { const f = fixture("false-approval"); f.record.responses = []; f.respond({ text: "不同意，需要修改", decision: "approved" }); deny(f, "user-decision-ambiguous"); });
-check("完整历史展示无需重发模板消息", () => {
-  const f = fixture("historical"); const item = f.record.request.items[0];
-  const text = [item.title, item.subject.ref, item.subject.version, item.changes, item.recommendation, ...item.scope, ...item.next_actions].join("\n");
-  f.record.request.presented_source = f.capture("old-presentation", "agent.orchestrator", "digital-human", "2026-09-05T01:02:00Z", text); f.record.responses = []; f.respond(); verify(f);
-});
-check("同一事项分批批准保留已批准范围", () => {
-  const f = fixture("incremental-scope", { scope: ["scope.a", "scope.b"] }); f.record.responses = [];
-  f.respond({ text: "同意 scope.a", approvedScope: ["scope.a"] });
-  f.respond({ text: "同意 scope.b", approvedScope: ["scope.b"], time: "2026-09-05T01:04:00Z" }); verify(f);
-});
-check("撤回后不能复用旧批准", () => { const f = fixture("revoke"); f.respond({ decision: "revoked", text: "撤回同意", time: "2026-09-05T01:04:00Z" }); deny(f, "user-decision-not-approved"); });
-check("默认生物人门禁纳入解析和 checkpoint", () => {
-  const roles = loadDigitalHumanRoles();
-  for (const gate of ["gate.design-reviewed", "gate.architecture-reviewed", "gate.user-confirmation"]) {
-    assert.equal(countersignRuleForGate(roles.gate_policy, gate).bucket, "biological_human");
-    assert.ok(collectCountersignGateIds(roles.gate_policy).includes(gate));
-    assert.throws(() => assertCheckpointApprovals({ gates: { [gate]: { status: "approved" } } }), /approval_ref/);
-  }
-});
-check("历史数字人记录可读但不能关闭关键门禁", () => {
-  const record = { schema_version: 1, gate_id: "gate.spec-baseline-approved", decision: "approved", actor_kind: "digital-human", role_id: "role.product-manager", runtime_id: "runtime.generic", principal_ref: "instance:product" };
-  validateApprovalRecord(record); assert.throws(() => validateApprovalRecord(record, { requireApproved: true }), /user-decision/);
-  const f = fixture("approval"); Object.assign(record, { subject_ref: f.requirement.subject_ref, approval_scope: f.requirement.scope, user_decision_ref: f.ref }); validateApprovalRecord(record, { requireApproved: true });
-});
-check("等待期间可保存状态但不能流转依赖工作", () => {
-  const f = fixture("workflow", { boundary: "plan-conclusion" }); const state = { user_decisions: [f.requirement] };
-  assert.equal(validateNextRoute("work-unit.plan-requirements", "work-unit.spec-synthesis", state).result, "blocked", "仅用户确认不能代替完整 Plan 入口审阅");
-  f.record.responses = []; f.save(); assert.equal(validateNextRoute("work-unit.plan-requirements", "work-unit.spec-synthesis", state).result, "blocked");
-  assert.equal(validateNextRoute("work-unit.plan-opportunity", "work-unit.plan-requirements", state).result, "allowed");
-  assertCheckpointUserDecisions({ repository_mode: "project-instance", status: "paused-human-gate", human_review: { required_decisions: [f.requirement] } });
-  assert.throws(() => assertCheckpointUserDecisions({ repository_mode: "project-instance", status: "running", human_review: { required_decisions: [f.requirement] } }), /user-decision-response-required/);
-});
-check("实施批准绑定切片、合同、仓库、路径和基线", () => {
-  const f = buildImplementationFixture(path.join(root, "implementation"), "docs/.scratch/demo/issues/one.md"); assertImplementationDecision(f.state);
-  assert.throws(() => assertImplementationDecision({ ...f.state, vertical_slice_ticket_ref: "another.md" }), /user-decision-scope-mismatch/);
-  writeFileSync(f.state.slice_contract_ref, "changed"); assert.throws(() => assertImplementationDecision(f.state), /user-decision-stale/);
-});
-process.stdout.write(`用户决定场景验证通过：${count} 组\n`);

package/template/scripts/verify-yss-dto-openapi-scenarios

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-import { runScenario } from "./lib/scenario-checks.mjs";
-
-try { runScenario("yssDtoWire"); } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

package/template/scripts/verify-yss-implementation-contract-compiler-scenarios

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { runScenario } from "./lib/scenario-checks.mjs";
-
-try {
-  runScenario("implementationContractCompiler");
-  const result = spawnSync(process.execPath, ["--test", ".agents/skills/yss-implementation-contract-compiler/tests/compiler-scenarios.test.mjs"], { encoding: "utf8" });
-  process.stdout.write(result.stdout);
-  process.stderr.write(result.stderr);
-  if (result.status !== 0) process.exitCode = result.status ?? 1;
-} catch (error) {
-  process.stderr.write(`${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/verify-yss-prototype-contract-scenarios

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import "../.agents/skills/yss-prototype-stage/tests/run-scenarios.mjs";

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

@@ -1,54 +0,0 @@
-#!/usr/bin/env node
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const skillRoot = path.join(root, ".agents/skills/yss-ui");
-const failures = [];
-const read = (filePath) => readFileSync(filePath, "utf8");
-function filesUnder(directory) {
-  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
-    const target = path.join(directory, entry.name);
-    return entry.isDirectory() ? filesUnder(target) : entry.isFile() ? [target] : [];
-  });
-}
-
-const requiredReferences = [
-  "component-routing.md",
-  "antdv-compatibility.md",
-  "theme-locale-overlay.md",
-  "accessibility.md",
-  "verification.md",
-  "migration-antdv-to-yss.md"
-];
-for (const name of requiredReferences) if (!existsSync(path.join(skillRoot, "references", name))) failures.push(`Missing YSS UI governance reference: ${name}`);
-
-for (const skillName of ["yss-ui", "yss-components"]) if (read(path.join(root, ".agents/skills", skillName, "SKILL.md")).includes("yss-hooks")) failures.push(`Nonexistent yss-hooks route remains in ${skillName}`);
-
-const uiBody = read(path.join(skillRoot, "SKILL.md"));
-for (const marker of ["yss-hook", "YssFormily", "component-routing.md", "antdv-compatibility.md", "ConfigProvider", "accessibility"]) if (!uiBody.includes(marker)) failures.push(`YSS UI router missing marker: ${marker}`);
-
-const routingBody = read(path.join(skillRoot, "references/component-routing.md"));
-for (const marker of ["YButton", "YCard", "YTable", "YTree", "YssFormily", "YSplitPane", "required", "fallback", "specialized"]) if (!routingBody.includes(marker)) failures.push(`Component routing missing marker: ${marker}`);
-
-const compatibilityBody = read(path.join(skillRoot, "references/antdv-compatibility.md"));
-for (const marker of ["pnpm why", "4.2.6", "2026-08-08", "lockfile"]) if (!compatibilityBody.includes(marker)) failures.push(`AntDV compatibility reference missing marker: ${marker}`);
-
-const wrappedAntdvComponents = new Set(["Button", "Card", "Table", "Tree"]);
-for (const filePath of filesUnder(path.join(skillRoot, "assets/demos")).filter((filePath) => filePath.endsWith(".vue"))) {
-  for (const match of read(filePath).matchAll(/import\s*\{([^}]*)\}\s*from\s*['"]ant-design-vue['"]/gm)) {
-    const forbidden = match[1].split(",").map((item) => item.trim().split(/\s+as\s+/)[0]).filter((name) => wrappedAntdvComponents.has(name));
-    if (forbidden.length > 0) failures.push(`Demo bypasses required YSS wrapper: ${path.relative(root, filePath)} -> ${forbidden.join(", ")}`);
-  }
-}
-
-if (/<YFormily\b|\bYFormily：/.test(read(path.join(skillRoot, "references/quick-recipes.md")))) failures.push("Quick recipes still recommend YFormily alias");
-
-if (read(path.join(skillRoot, "assets/scenario-index.md")).includes("pending-verification")) failures.push("Recommended scenario index contains pending-verification demo");
-if (failures.length > 0) {
-  process.stderr.write(`${failures.join("\n")}\n`);
-  process.exitCode = 1;
-} else {
-  process.stdout.write("YSS UI governance scenarios passed\n");
-}