create-yss-spec 3.0.1 → 3.1.3

package/template/scripts/verify-frontend-delivery-scenarios

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { fork } from 'node:child_process';
+import { once } from 'node:events';
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync, cpSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { tmpdir } from 'node:os';
+import { fixture, context } from './fixtures/strategic-handoff/fixture.mjs';
+import { exportBundle } from './lib/strategic-handoff.mjs';
+const backendTools=process.env.YSS_DELIVERY_TEST_BACKEND_ROOT;
+const frontendTools=process.env.YSS_DELIVERY_TEST_FRONTEND_ROOT;
+const { backendDeliveryBasis, exportBackendDelivery, openBackendDelivery, inspectBackendDelivery } = await import(backendTools?pathToFileURL(path.join(backendTools,'scripts/lib/backend-delivery.mjs')):'./lib/backend-delivery.mjs');
+const {importBackendDelivery}=await import(frontendTools?pathToFileURL(path.join(frontendTools,'scripts/lib/backend-delivery.mjs')):'./lib/backend-delivery.mjs');
+const { verifyFrontendDelivery } = await import(frontendTools?pathToFileURL(path.join(frontendTools,'scripts/lib/frontend-delivery.mjs')):'./lib/frontend-delivery.mjs');
+const { enforceFrontendDelivery } = await import(frontendTools?pathToFileURL(path.join(frontendTools,'scripts/lib/frontend-delivery-boundary.mjs')):'./lib/frontend-delivery-boundary.mjs');
+const { compileDefaultImplementationContract } = await import(frontendTools?pathToFileURL(path.join(frontendTools,'scripts/lib/implementation-contract-compiler.mjs')):'./lib/implementation-contract-compiler.mjs');
+const { validateNextRoute, validateImplementationEntry } = await import(frontendTools?pathToFileURL(path.join(frontendTools,'scripts/lib/lifecycle-transition.mjs')):'./lib/lifecycle-transition.mjs');
+import { read, hash, json, ROOT } from './lib/strategic-handoff-io.mjs';
+const runtimeRegistry=read(path.join(frontendTools||ROOT,'docs/process/lifecycle-registry.yaml'));
+const frontendStage=runtimeRegistry.stages.find(x=>x.id==='stage.frontend-engineering-design')?.id||runtimeRegistry.stages.find(x=>x.id==='stage.tactical-design')?.id||'stage.system-data-engineering';
+const frontendWorkUnit=frontendStage==='stage.frontend-engineering-design'?'work-unit.frontend-engineering-design':frontendStage==='stage.tactical-design'?'work-unit.tactical-design':'work-unit.technical-analysis';
+
+test('战略与后端交付联合接收：便携、真实服务、拒绝不完整/过期输入及执行入口绕过',async t=>{
+  const base=mkdtempSync(path.join(tmpdir(),'frontend-delivery-test-'));
+  const put=(root,ref,value)=>{mkdirSync(path.dirname(path.join(root,ref)),{recursive:true});writeFileSync(path.join(root,ref),typeof value==='string'?value:json(value));};
+  const source=path.join(base,'strategy'), backend=path.join(base,'backend'), frontend=path.join(base,'frontend');
+  [source,backend,frontend].forEach(root=>mkdirSync(root));
+  if(backendTools)cpSync(backendTools,backend,{recursive:true});
+  if(frontendTools)cpSync(frontendTools,frontend,{recursive:true});
+  const f=await fixture(source);
+  for(const root of [backend,frontend]) {put(root,'yss-project.yaml','schema_version: 1\nrepository_mode: project-instance\n');put(root,'CONTEXT.md',context);}
+  const strategic=await exportBundle({sourceRoot:source,handoffRef:'handoff.yaml',output:path.join(backend,'strategy-package')});
+  const roles=read(path.join(source,'docs/agents/digital-human-roles.yaml'));
+  for(const gate of ['gate.openapi-frozen','gate.slice-contract-approved']) {
+    roles.gate_policy.biological_human=(roles.gate_policy.biological_human||[]).filter(x=>x!==gate);
+    roles.gate_policy.digital_human_review=(roles.gate_policy.digital_human_review||[]).filter(x=>x.gate!==gate);
+    roles.gate_policy.digital_human_review.push({gate,countersigners:['role.product-manager']});
+  }
+  put(backend,'docs/agents/digital-human-roles.yaml',roles);
+  put(backend,'api.yaml',{openapi:'3.1.0',info:{title:'Synthetic supplier API',version:'1'},paths:{'/suppliers':{post:{operationId:'submitSupplier',responses:{'200':{description:'OK'}}}}}});
+  put(backend,'slice.json',{schema_version:2,contract_id:'contract.backend',contract_version:'v1',slice_id:'slice.submit',status:'approved'});
+  put(backend,'data.md','Synthetic data setup for maintenance tests, not product verification.');
+  put(backend,'verification.log','Synthetic test fixture: successful/failed submissions exercised.');
+  const file=ref=>({ref,digest:hash(readFileSync(path.join(backend,ref)))});
+  const approved=(ref,id,gate)=>{
+    const binding={...file(ref),id,version:'v1',approval_ref:`approvals/${id}.json`};
+    put(backend,binding.approval_ref,{schema_version:1,gate_id:gate,decision:'approved',actor_kind:'digital-human',role_id:'role.product-manager',runtime_id:'runtime.generic',principal_ref:'synthetic-maintenance-fixture',artifact_bindings:[{id,version:'v1',digest:binding.digest}]});return binding;
+  };
+  const serverState=path.join(base,'server.json');put(base,'server.json',{body:{}});
+  const server=fork(path.join(ROOT,'scripts/fixtures/backend-delivery/revision-server.mjs'),[serverState],{stdio:['ignore','ignore','inherit','ipc']});
+  t.after(()=>{server.kill();rmSync(base,{recursive:true,force:true});});
+  const [{port}]=await once(server,'message');
+  const delivery={schema_version:1,delivery_id:'backend-delivery.supplier',version:'v1',status:'verified',strategic_bundle_ref:'strategy-package',strategic_bundle_digest:strategic.bundle_digest,scope:{slice_id:'slice.submit',source_ids:['rule.complete','scenario.submit'],operation_ids:['submitSupplier']},openapi:approved('api.yaml','api.supplier','gate.openapi-frozen'),slice_contract:approved('slice.json','contract.backend','gate.slice-contract-approved'),build:{source_commit:'a'.repeat(40),artifact_digest:`sha256:${'b'.repeat(64)}`},environment:{id:'fixture-local',base_url:`http://127.0.0.1:${port}`,deployment_id:'fixture-v1',revision_path:'/version',revision_pointers:{deployment_id:'/deployment_id',source_commit:'/source_commit',openapi_digest:'/openapi_digest',artifact_digest:'/artifact_digest',test_data_digest:'/test_data_digest'},test_data:file('data.md')},verification:{},supporting_files:[]};
+  const record=kind=>({schema_version:1,kind,subject_digest:backendDeliveryBasis(delivery),results:[{command:'synthetic-maintenance-test',executed_at:new Date().toISOString(),exit_code:0,evidence:[file('verification.log')]}],operation_ids:['submitSupplier'],coverage:[{source_id:'scenario.submit',outcome:'success'},{source_id:'scenario.submit',outcome:'failure'}]});
+  put(backend,'contract-test.json',record('backend-contract'));put(backend,'deployment-test.json',record('backend-deployment'));
+  delivery.verification={contract:file('contract-test.json'),deployment:file('deployment-test.json')};put(backend,'delivery.json',delivery);
+  const body={deployment_id:'fixture-v1',source_commit:delivery.build.source_commit,openapi_digest:delivery.openapi.digest,artifact_digest:delivery.build.artifact_digest,test_data_digest:delivery.environment.test_data.digest};
+  put(base,'server.json',{body});
+  await t.test('导出拒绝缺失场景、篡改接口及错误批准',async()=>{
+    const bytes=readFileSync(path.join(backend,'api.yaml'));put(backend,'api.yaml','changed');
+    await assert.rejects(()=>inspectBackendDelivery(backend,'delivery.json'),/摘要不一致/);writeFileSync(path.join(backend,'api.yaml'),bytes);
+    const approval=read(path.join(backend,delivery.openapi.approval_ref));put(backend,delivery.openapi.approval_ref,{...approval,artifact_bindings:[]});
+    await assert.rejects(()=>inspectBackendDelivery(backend,'delivery.json'),/批准未绑定/);put(backend,delivery.openapi.approval_ref,approval);
+    const tests=record('backend-contract');tests.coverage.pop();put(backend,'contract-test.json',tests);
+    const broken=structuredClone(delivery);broken.verification.contract=file('contract-test.json');put(backend,'delivery.json',broken);
+    await assert.rejects(()=>inspectBackendDelivery(backend,'delivery.json'),/成功\/失败/);
+    put(backend,'contract-test.json',record('backend-contract'));delivery.verification.contract=file('contract-test.json');put(backend,'delivery.json',delivery);
+  });
+  const output=path.join(base,'package');await exportBackendDelivery({sourceRoot:backend,deliveryRef:'delivery.json',output,zip:true});
+  const imported=await importBackendDelivery({bundle:`${output}.zip`,targetRoot:frontend});
+  assert.equal((await importBackendDelivery({bundle:output,targetRoot:frontend})).result,'already-imported');
+  const acceptance=read(path.join(frontend,imported.acceptance_ref));
+  await t.test('草案/缺少两类产物不能进入前端任务',async()=>{
+    await assert.rejects(()=>verifyFrontendDelivery({root:frontend,acceptanceRef:imported.acceptance_ref,sliceRef:'slice.submit'}),/schema/);
+    const profileRef=path.join(frontend,'docs/process/harness-profile.yaml');
+    const profile=existsSync(profileRef)?read(profileRef):{schema_version:1,profile_id:'harness.frontend-delivery'};
+    put(frontend,'docs/process/harness-profile.yaml',{...profile,frontend_delivery:{required:true}});
+    assert.throws(()=>enforceFrontendDelivery({}, {root:frontend}),/frontend-delivery-required/);
+    assert.throws(()=>compileDefaultImplementationContract({root:frontend}),/frontend-delivery-required/);
+    assert.throws(()=>enforceFrontendDelivery({contract:{kind:'template-maintenance'}},{root:frontend}),/不得用模板维护/);
+    assert.equal(validateNextRoute(frontendWorkUnit==='work-unit.technical-analysis'?'work-unit.spec-synthesis':'work-unit.harness-entry',frontendWorkUnit,undefined,{root:frontend}).result,'blocked');
+    assert.equal(validateImplementationEntry({}, {root:frontend}).blocking_signals[0],'frontend-delivery-blocked');
+  });
+  put(frontend,'reconciliation.json',{schema_version:1,repository_mode:'project-instance',stage:frontendStage,work_unit:frontendWorkUnit,status:'reconciled',context_snapshot:f.snapshot,changes:{added:['Global/Supplier'],updated:[],deprecated:[]},unresolved_terms:[],evidence_refs:['CONTEXT.md']});
+  put(frontend,'cases.md','Synthetic planned UI cases: complete submission succeeds; incomplete submission fails.');
+  acceptance.status='accepted';acceptance.strategic_handoff.context_reconciliation_ref='reconciliation.json';
+  acceptance.frontend_cases=['success','failure'].map(outcome=>({case_id:`submit-${outcome}`,source_ids:['rule.complete','scenario.submit'],outcome,operation_ids:['submitSupplier'],visual_case_ids:['primary-desktop','primary-narrow'],evidence_ref:'cases.md',evidence_digest:hash(readFileSync(path.join(frontend,'cases.md')))}));
+  for(const row of acceptance.strategic_handoff.rows)Object.assign(row,{disposition:'mapped',frontend_case_refs:acceptance.frontend_cases.map(x=>x.case_id),dependency_status:'known',dependent_slice_refs:['slice.submit'],evidence_refs:['cases.md']});
+  put(frontend,imported.acceptance_ref,acceptance);
+  const check=()=>verifyFrontendDelivery({root:frontend,acceptanceRef:imported.acceptance_ref,sliceRef:'slice.submit'});
+  await t.test('源仓消失后可验 ZIP 并独立恢复；输入就绪不授予代码实施',async()=>{
+    rmSync(source,{recursive:true});rmSync(backend,{recursive:true});
+    assert.equal(await openBackendDelivery(`${output}.zip`,b=>b.delivery.scope.slice_id),'slice.submit');
+    const verified=await check();assert.equal(verified.result,'inputs-verified');assert.equal(verified.ready_for_agent,false);
+    assert.equal(verified.actual_verification.observed.deployment_id,'fixture-v1');
+    const draft=compileDefaultImplementationContract({root:frontend,slice_id:'slice.submit',frontend_delivery:{acceptance_ref:imported.acceptance_ref},requiredCapabilities:['governance.implementation-contract']});
+    assert.equal(draft.status,'draft');assert.equal(draft.slice_id,'slice.submit');assert.equal(draft.frontend_delivery.digest,verified.acceptance_digest);
+    assert.equal(enforceFrontendDelivery({slice_id:'slice.submit',frontend_delivery:{acceptance_ref:imported.acceptance_ref}}, {root:frontend}).result,'inputs-verified');
+    assert.throws(()=>enforceFrontendDelivery({slice_id:'slice.submit',frontend_delivery:{acceptance_ref:imported.acceptance_ref}}, {root:frontend,phase:'implementation'}),/approved Slice Contract/);
+  });
+  await t.test('实现边界读取持久化合同并冻结接收记录及用例字节',async()=>{
+    const binding={acceptance_ref:imported.acceptance_ref,digest:hash(readFileSync(path.join(frontend,imported.acceptance_ref)))};
+    put(frontend,'frontend-contract.json',{status:'approved',slice_id:'slice.submit',frontend:{delivery:binding}});
+    assert.equal(enforceFrontendDelivery({slice_contract_ref:'frontend-contract.json'},{root:frontend,phase:'implementation'}).result,'inputs-verified');
+    put(frontend,'cases.md','changed case');await assert.rejects(check,/摘要漂移/);
+    put(frontend,'cases.md','Synthetic planned UI cases: complete submission succeeds; incomplete submission fails.');
+    put(frontend,'frontend-contract.json',{status:'draft',slice_id:'slice.submit',frontend:{delivery:binding}});
+    assert.throws(()=>enforceFrontendDelivery({slice_contract_ref:'frontend-contract.json'},{root:frontend,phase:'implementation'}),/approved Slice Contract/);
+  });
+  await t.test('部署版本/数据失配与服务失败使旧接收记录失效',async()=>{
+    for(const field of ['deployment_id','source_commit','openapi_digest','artifact_digest','test_data_digest']) {
+      put(base,'server.json',{body:{...body,[field]:'wrong'}});await assert.rejects(check,/真实服务版本不匹配/);
+    }
+    put(base,'server.json',{status:503,body});await assert.rejects(check,/真实接口不可用/);put(base,'server.json',{body});
+  });
+  await t.test('范围、摘要和逐条承接缺口均拒绝',async()=>{
+    await assert.rejects(()=>verifyFrontendDelivery({root:frontend,acceptanceRef:imported.acceptance_ref,sliceRef:'slice.other'}),/切片不匹配/);
+    await assert.rejects(()=>verifyFrontendDelivery({root:frontend,acceptanceRef:imported.acceptance_ref,sliceRef:'slice.submit',expectedDigest:`sha256:${'0'.repeat(64)}`}),/摘要已变化/);
+    for(const mutate of [a=>a.frontend_cases.pop(),a=>a.strategic_handoff.rows[0].disposition='pending',a=>a.frontend_cases[0].operation_ids=['unknown'],a=>a.strategic_handoff.bundle_digest=`sha256:${'0'.repeat(64)}`]) {
+      const changed=structuredClone(acceptance);mutate(changed);put(frontend,imported.acceptance_ref,changed);await assert.rejects(check);
+    }
+    put(frontend,imported.acceptance_ref,acceptance);
+  });
+  await t.test('已导入更新版本阻断旧切片；包篡改拒绝',async()=>{
+    const receipt=read(path.join(frontend,imported.receipt_ref));const newer=path.posix.dirname(path.posix.dirname(imported.receipt_ref))+'/v2';
+    put(frontend,`${newer}/import-receipt.json`,{...receipt,version:'v2'});await assert.rejects(check,/旧前端接收记录 stale/);rmSync(path.join(frontend,newer),{recursive:true});
+    const changed=path.join(base,'tampered');cpSync(output,changed,{recursive:true});put(changed,'extra.txt','extra');await assert.rejects(()=>openBackendDelivery(changed,()=>null),/未登记文件/);
+  });
+});

package/template/scripts/verify-frontend-implementation-evidence

@@ -5,9 +5,11 @@ import path from "node:path";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
 import { parseDocument } from "./vendor/yaml.mjs";
+import { validateVisualBaseline } from "../.agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs";
+import { enforceFrontendDelivery } from "./lib/frontend-delivery-boundary.mjs";
 
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const schemaPath = path.join(root, "docs/process/schemas/frontend-implementation-evidence.schema.json");
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const schemaPath = path.join(repoRoot, "docs/process/schemas/frontend-implementation-evidence.schema.json");
 const validator = String.raw`
 import json
 import sys
@@ -22,27 +24,50 @@ sys.exit(1 if errors else 0)
 `;
 
 try {
-  const { values, positionals } = parseArgs({ options: { "allow-template": { type: "boolean" } }, allowPositionals: true, strict: true });
-  if (positionals.length !== 1) throw new TypeError("用法: scripts/verify-frontend-implementation-evidence [--allow-template] <file.yaml>");
+  const { values, positionals } = parseArgs({ options: { "allow-template": { type: "boolean" }, root: { type: "string", default: repoRoot } }, allowPositionals: true, strict: true });
+  if (positionals.length !== 1) throw new TypeError("用法: scripts/verify-frontend-implementation-evidence [--allow-template] [--root <repo>] <file.yaml>");
+  const root = path.resolve(values.root);
   const document = parseDocument(readFileSync(path.resolve(positionals[0]), "utf8"), { maxAliasCount: 0, uniqueKeys: true });
   if (document.errors.length) throw new TypeError(document.errors[0].message);
   const value = document.toJS({ maxAliasCount: 0 });
-  const result = spawnSync("python3", ["-c", validator, schemaPath], { cwd: root, encoding: "utf8", input: JSON.stringify(value) });
+  if (!values["allow-template"]) enforceFrontendDelivery(value, { root, phase: value.kind === "verification" ? "implementation" : "inputs" });
+  if (value.schema_version === 1 && !values["allow-template"]) throw new TypeError("migration-required: frontend implementation evidence v1 是只读历史资产；在途 UI 工作必须升级 v2 并绑定 Visual Baseline case_id");
+  const result = spawnSync("python3", ["-c", validator, schemaPath], { cwd: repoRoot, encoding: "utf8", input: JSON.stringify(value) });
   if (result.status !== 0) throw new TypeError(`${result.stdout}${result.stderr}`.trim());
   if (!values["allow-template"] && value.template !== false) throw new TypeError("正式证据必须设置 template: false");
   if (!values["allow-template"] && value.status !== "approved") throw new TypeError("正式证据必须达到 status: approved");
   const serialized = JSON.stringify(value);
   if (!values["allow-template"] && /REPLACE_ME|<[^>]+>|docs\/\.scratch\/example/.test(serialized)) throw new TypeError("正式证据不得保留模板占位值");
   if (!values["allow-template"]) {
-    for (const field of ["prototype_ref", "spec_ref"]) {
-      const reference = value[field];
+    for (const field of ["prototype_ref", "spec_ref", "visual_baseline.manifest_ref"]) {
+      const reference = field === "visual_baseline.manifest_ref" ? value.visual_baseline.manifest_ref : value[field];
       if (!/^https?:\/\//.test(reference) && !existsSync(path.resolve(root, reference))) throw new TypeError(`${field} 不可读取: ${reference}`);
     }
+    const baselineDocument = parseDocument(readFileSync(path.resolve(root, value.visual_baseline.manifest_ref), "utf8"), { maxAliasCount: 0, uniqueKeys: true });
+    if (baselineDocument.errors.length) throw new TypeError(baselineDocument.errors[0].message);
+    const baseline = baselineDocument.toJS({ maxAliasCount: 0 });
+    const baselineValidation = await validateVisualBaseline(baseline, { bundleRoot: path.dirname(path.resolve(root, value.visual_baseline.manifest_ref)) });
+    if (baselineValidation.errors.length) throw new TypeError(`Visual Baseline Bundle 无效:\n${baselineValidation.errors.join("\n")}`);
+    if (baseline.baseline_id !== value.visual_baseline.baseline_id || baseline.version !== value.visual_baseline.version || baseline.bundle?.digest !== value.visual_baseline.digest || baseline.status !== "approved") throw new TypeError("Visual Baseline 身份、版本、digest 或状态不一致");
+    const manifestCaseIds = new Set((baseline.cases ?? []).map((item) => item.case_id));
+    const selectedCaseIds = value.visual_baseline.case_ids;
+    if (selectedCaseIds.some((id) => !manifestCaseIds.has(id))) throw new TypeError("前端证据引用了 Visual Baseline 中不存在的 case_id");
+    for (const item of value.route_and_page_inventory) if (item.case_ids.some((id) => !selectedCaseIds.includes(id))) throw new TypeError("route_and_page_inventory.case_ids 必须属于选定 Visual Baseline cases");
+    if (value.kind === "plan" && value.baseline_case_ids.some((id) => !selectedCaseIds.includes(id))) throw new TypeError("baseline_case_ids 必须属于选定 Visual Baseline cases");
   }
   if (!values["allow-template"] && value.kind === "verification") {
     if (value.console_warning_check !== "pass") throw new TypeError("前端验证必须通过 console warning 检查");
-    if (value.uncovered_differences.length > 0 && !value.difference_owner) throw new TypeError("存在未覆盖差异时必须填写 difference_owner");
+    if (value.uncovered_differences.length > 0) throw new TypeError("存在未解释视觉差异，不能通过前端实现还原验证");
     if (value.independent_review?.status !== "approved") throw new TypeError("前端验证必须通过独立 UI fidelity review");
+    const expected = [...value.visual_baseline.case_ids].sort();
+    const actual = value.case_results.map((item) => item.case_id).sort();
+    if (new Set(actual).size !== actual.length || JSON.stringify(actual) !== JSON.stringify(expected)) throw new TypeError("case_results 必须与选定 Visual Baseline case_ids 一一对应");
+    for (const item of value.case_results) {
+      if (item.result !== "pass" || item.uncovered_difference !== false) throw new TypeError(`${item.case_id} 存在未通过或未解释差异`);
+      for (const field of ["baseline_image_ref", "implementation_image_ref", "diff_ref"]) if (!existsSync(path.resolve(root, item[field]))) throw new TypeError(`${item.case_id}.${field} 不可读取`);
+      if (item.mask_ref !== "not-applicable" && !existsSync(path.resolve(root, item.mask_ref))) throw new TypeError(`${item.case_id}.mask_ref 不可读取`);
+    }
+    if (value.actual_verification.some((item) => item.exit_code !== 0)) throw new TypeError("pnpm fresh verification 存在非零退出码");
   }
   process.stdout.write(`前端实现还原 ${value.kind} 验证通过\n`);
 } catch (error) {

package/template/scripts/verify-frontend-implementation-evidence-scenarios

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { sealVisualBaseline } from "../.agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs";
+
+const repoRoot = path.resolve(import.meta.dirname, "..");
+const root = mkdtempSync(path.join(os.tmpdir(), "yss-frontend-evidence-"));
+const write = (relative, value = relative) => {
+  const file = path.join(root, relative); mkdirSync(path.dirname(file), { recursive: true }); writeFileSync(file, Buffer.isBuffer(value) || typeof value === "string" ? value : JSON.stringify(value, null, 2)); return relative;
+};
+write("docs/spec.md"); write("docs/prototype.html");
+for (const file of ["verification/desktop.png", "verification/narrow.png", "verification/desktop-diff.png", "verification/narrow-diff.png", "verification/pnpm.txt", "verification/review.md"]) write(file);
+const digest = `sha256:${"a".repeat(64)}`;
+function pngHeader(width, height) { const value = Buffer.alloc(24); Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]).copy(value, 0); value.writeUInt32BE(13, 8); value.write("IHDR", 12, "ascii"); value.writeUInt32BE(width, 16); value.writeUInt32BE(height, 20); return value; }
+write("baseline/images/primary-desktop.png", pngHeader(1440, 900)); write("baseline/images/primary-narrow.png", pngHeader(390, 844));
+write("baseline/sources/prototype.html", "<main>demo</main>\n"); write("baseline/sources/interaction.md", "# Interaction\n"); write("baseline/sources/states.md", "# States\n");
+write("baseline/capture/capture.mjs", "// capture\n"); write("baseline/capture/result.json", "{\"result\":\"passed\"}\n");
+const baselineFile = write("baseline/visual-baseline.yaml", {
+  schema_version: 1, baseline_id: "visual-baseline.demo", feature: "demo", version: "v1", status: "approved",
+  bundle: { format: "portable-directory", root_ref: "baseline", digest, size_bytes: 0, max_image_bytes: 5242880, max_bundle_bytes: 104857600 },
+  source: { prototype_ref: "sources/prototype.html", prototype_digest: digest, interaction_spec_ref: "sources/interaction.md", interaction_spec_digest: digest, state_matrix_ref: "sources/states.md", state_matrix_digest: digest },
+  capture_environment: { browser: "chromium", browser_version: "140.0.0", operating_system: "linux", fonts_digest: digest, device_scale_factor: 1, color_space: "srgb", locale: "zh-CN", timezone: "Asia/Shanghai", animations_disabled: true, cursor_hidden: true, capture_script_ref: "capture/capture.mjs", capture_script_digest: digest, capture_result_ref: "capture/result.json", capture_result_digest: digest },
+  cases: [
+    { case_id: "primary-desktop", route: "/demo", page: "DemoPage", state: "normal", viewport: { name: "desktop", width: 1440, height: 900, scroll_mode: "viewport", scroll_position: 0 }, theme: "compact-light", locale: "zh-CN", data_scenario: "primary", image_ref: "images/primary-desktop.png", image_digest: digest, image_size_bytes: 1, mask_ref: "not-applicable", mask_digest: "not-applicable", mask_size_bytes: 0, semantic_refs: ["sources/prototype.html", "sources/interaction.md"], allowed_differences: [], result: "passed" },
+    { case_id: "primary-narrow", route: "/demo", page: "DemoPage", state: "normal", viewport: { name: "narrow", width: 390, height: 844, scroll_mode: "viewport", scroll_position: 0 }, theme: "compact-light", locale: "zh-CN", data_scenario: "primary", image_ref: "images/primary-narrow.png", image_digest: digest, image_size_bytes: 1, mask_ref: "not-applicable", mask_digest: "not-applicable", mask_size_bytes: 0, semantic_refs: ["sources/states.md"], allowed_differences: [], result: "passed" }
+  ]
+});
+const sealedBaseline = await sealVisualBaseline(path.join(root, baselineFile), path.join(root, "baseline"));
+const visual_baseline = { baseline_id: "visual-baseline.demo", version: "v1", digest: sealedBaseline.bundle.digest, manifest_ref: "baseline/visual-baseline.yaml", status: "approved", case_ids: ["primary-desktop", "primary-narrow"] };
+const base = {
+  schema_version: 2, template: false, status: "approved", prototype_ref: "docs/prototype.html", spec_ref: "docs/spec.md", visual_baseline,
+  route_and_page_inventory: [{ route: "/demo", page: "DemoPage", case_ids: ["primary-desktop", "primary-narrow"] }], pnpm_commands: ["pnpm test"]
+};
+const plan = { ...base, kind: "plan", baseline_case_ids: ["primary-desktop", "primary-narrow"], desktop_viewport: "1440x900", narrow_viewport: "390x844", state_cases: ["normal"] };
+const verification = {
+  ...base, kind: "verification",
+  case_results: [
+    { case_id: "primary-desktop", baseline_image_ref: "baseline/images/primary-desktop.png", implementation_image_ref: "verification/desktop.png", diff_ref: "verification/desktop-diff.png", mask_ref: "not-applicable", result: "pass", uncovered_difference: false, explanation: "无未解释差异" },
+    { case_id: "primary-narrow", baseline_image_ref: "baseline/images/primary-narrow.png", implementation_image_ref: "verification/narrow.png", diff_ref: "verification/narrow-diff.png", mask_ref: "not-applicable", result: "pass", uncovered_difference: false, explanation: "无未解释差异" }
+  ],
+  interaction_results: ["normal passed"], console_warning_check: "pass", actual_verification: [{ command: "pnpm test", exit_code: 0, executed_at: "2026-09-05T00:00:00Z", evidence_ref: "verification/pnpm.txt" }],
+  uncovered_differences: [], difference_owner: null, independent_review: { reviewer: "reviewer-1", candidate_digest: digest, status: "approved", findings_ref: "verification/review.md" }
+};
+const run = (name, value, expected, pattern) => {
+  const file = write(`${name}.json`, value);
+  const result = spawnSync("scripts/verify-frontend-implementation-evidence", ["--root", root, path.join(root, file)], { cwd: repoRoot, encoding: "utf8" });
+  if (result.status !== expected || (pattern && !pattern.test(`${result.stdout}${result.stderr}`))) throw new Error(`${name} unexpected\n${result.stdout}${result.stderr}`);
+};
+run("valid-plan", plan, 0);
+run("valid-verification", verification, 0);
+run("missing-case", { ...verification, case_results: verification.case_results.slice(0, 1) }, 1, /一一对应/);
+run("unexplained", { ...verification, uncovered_differences: ["间距偏差"], difference_owner: "frontend" }, 1, /未解释视觉差异/);
+run("nonzero", { ...verification, actual_verification: [{ ...verification.actual_verification[0], exit_code: 1 }] }, 1, /非零退出码/);
+process.stdout.write("Frontend implementation evidence v2 scenarios passed\n");

package/template/scripts/verify-grill-with-docs-context-scenarios

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+
+const root = path.resolve(import.meta.dirname, "..");
+const skill = readFileSync(path.join(root, ".agents/skills/grill-with-docs/SKILL.md"), "utf8");
+for (const marker of ["scripts/verify-context-contract --root . --json", "domain-modeling/CONTEXT-FORMAT.md", "<ContextId>/<EnglishIdentifier>", "context_reconciliation", "referenced_terms_digest", "template-source", "not-applicable", "yss-product-lifecycle"]) {
+  if (!skill.includes(marker)) throw new Error(`grill-with-docs 缺少统一 Context Contract 标记: ${marker}`);
+}
+for (const script of ["scripts/verify-context-contract-scenarios", "scripts/verify-context-reconciliation-scenarios"]) {
+  const result = spawnSync(path.join(root, script), { cwd: root, encoding: "utf8" });
+  if (result.status !== 0) throw new Error(`${script} failed\n${result.stdout}${result.stderr}`);
+}
+process.stdout.write("grill-with-docs Context Contract scenarios passed\n");

package/template/scripts/verify-lifecycle-checkpoint

@@ -5,7 +5,7 @@ import path from "node:path";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
 import { parseDocument } from "./vendor/yaml.mjs";
-import { assertCheckpointApprovals } from "./lib/approval-record.mjs";
+import { assertCheckpointApprovals, assertCheckpointUserDecisions } from "./lib/approval-record.mjs";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const schemaPath = path.join(root, "docs/process/schemas/lifecycle-checkpoint.schema.json");
@@ -32,6 +32,14 @@ try {
   const result = spawnSync("python3", ["-c", validator, schemaPath], { cwd: root, encoding: "utf8", input: JSON.stringify(value) });
   if (result.status !== 0) throw new TypeError(`${result.stdout}${result.stderr}`.trim());
   assertCheckpointApprovals(value, sourcePath);
+  assertCheckpointUserDecisions(value);
+  if (value.repository_mode === "project-instance" && ["paused-human-gate", "completed"].includes(value.status)) {
+    if (value.context_reconciliation?.status !== "reconciled" || !value.context_reconciliation?.ref) throw new TypeError("project-instance 在会签或完成前必须具有 reconciled context_reconciliation");
+    const reconciliation = path.resolve(root, value.context_reconciliation.ref);
+    const checked = spawnSync(path.join(root, "scripts/verify-context-reconciliation"), ["--root", root, reconciliation], { cwd: root, encoding: "utf8" });
+    if (checked.status !== 0) throw new TypeError(checked.stderr.trim() || "context_reconciliation 无效");
+  }
+  if (value.repository_mode === "template-source" && value.context_reconciliation?.status !== "not-applicable") throw new TypeError("template-source context_reconciliation 必须为 not-applicable");
   process.stdout.write("生命周期 checkpoint 验证通过\n");
 } catch (error) {
   process.stderr.write(`生命周期 checkpoint 验证失败: ${error.message}\n`);

package/template/scripts/verify-lifecycle-transition-scenarios

@@ -1,17 +1,25 @@
 #!/usr/bin/env node
 import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, readFileSync, existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { buildImplementationFixture } from "./fixtures/user-decision/build-fixture.mjs";
+const temp = mkdtempSync(path.join(os.tmpdir(), "lifecycle-decision-test-"));
+process.on("exit", () => rmSync(temp, { recursive: true, force: true }));
+const approval = buildImplementationFixture(temp, "docs/.scratch/demo/issues/01-valid-slice.md");
 import { validateImplementationEntry, validateNextRoute, validateTicketFormalization } from "./lib/lifecycle-transition.mjs";
 
 const exists = (ref) => [
   "docs/process/lifecycle-registry.yaml",
   "docs/.scratch/demo/issues/01-valid-slice.md",
   "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
-].includes(ref);
+].includes(ref) || existsSync(ref);
 const decompositionResult = `result_schema: workflow-execution-result-v1\nwork_unit: work-unit.ticket-decomposition\nresult: completed\nevidence_refs:\n  - docs/.scratch/demo/evidence/ticket-decomposition-result.yaml\n`;
-const read = (ref) => ref === "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml" ? decompositionResult : "";
+const read = (ref) => ref === "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml" ? decompositionResult : readFileSync(ref, "utf8");
 const options = { exists, read };
 
 const validTicketState = {
+  ...approval.state,
   predecessor_work_unit: "work-unit.ticket-decomposition",
   tracker_kind: "local-markdown",
   ticket_decomposition_result_ref: "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
@@ -92,14 +100,16 @@ const arbitraryReadable = validateTicketFormalization({
 }, options);
 assert.equal(arbitraryReadable.result, "blocked");
 assert.ok(arbitraryReadable.blocking_signals.includes("ticket-decomposition-incomplete"));
+const remoteApproval = buildImplementationFixture(path.join(temp, "remote"), "https://github.com/example/project/issues/1");
 assert.equal(validateTicketFormalization({
   ...validTicketState,
+  ...remoteApproval.state,
   tracker_kind: "github",
   ticket_decomposition_result_ref: "https://github.com/example/project/issues/1",
   ticket_decomposition_result: { result: "completed", evidence_refs: ["https://github.com/example/project/issues/1"] },
   vertical_slice_ticket_ref: "https://github.com/example/project/issues/1",
   vertical_slice_ticket: { ref: "https://github.com/example/project/issues/1", kind: "vertical-slice-ticket", role: "ready-for-agent" },
   slice_contract: { ...validTicketState.slice_contract, ticket_ref: "https://github.com/example/project/issues/1" },
-}, { ...options, exists: (ref) => ref === "https://github.com/example/project/issues/1", read: (ref) => ref === "https://github.com/example/project/issues/1" ? decompositionResult.replace("docs/.scratch/demo/evidence/ticket-decomposition-result.yaml", "https://github.com/example/project/issues/1") : "" }).result, "allowed");
+}, { ...options, exists: (ref) => ref === "https://github.com/example/project/issues/1", read: (ref) => ref === "https://github.com/example/project/issues/1" ? decompositionResult.replace("docs/.scratch/demo/evidence/ticket-decomposition-result.yaml", "https://github.com/example/project/issues/1") : readFileSync(ref, "utf8") }).result, "allowed");
 
 process.stdout.write("生命周期转换压力场景验证通过\n");

package/template/scripts/verify-retired-skill-ids

@@ -4,18 +4,44 @@ import { existsSync } from "node:fs";
 import path from "node:path";
 import { PROJECTION_ROOTS, ROOT } from "./lib/skill-supply-chain.mjs";
 
-const retired = ["yss-router", "yss-source-index"];
-const allowed = (relative) => relative === "docs/agents/skill-migrations.md"
+const retired = [
+  "ask-matt",
+  "dispatching-parallel-agents",
+  "loop-me",
+  "migrate-to-shoehorn",
+  "prototype-page-acceptance",
+  "scaffold-exercises",
+  "setup-pre-commit",
+  "setup-ts-deep-modules",
+  "teach",
+  "writing-beats",
+  "writing-fragments",
+  "writing-shape",
+  "yss-microapp-commit",
+  "yss-page-module-development",
+  "yss-router",
+  "yss-source-index",
+];
+const allowed = (relative, line) => relative === "docs/agents/skill-migrations.md"
   || relative.includes("/docs/agents/skill-migrations.md")
   || relative.endsWith(".template-source/wiki/raw/skill-migrations.md")
   || relative.startsWith(".template-source/evidence/")
   || relative.includes("/.template-source/evidence/")
   || relative.includes("/tests/")
+  || relative.startsWith(".template-source/tooling/node/test/")
+  || relative.endsWith("/skills/.yss-skills-manifest.json")
+  || relative === "docs/agents/yss-ui-skills-integration.md"
+  || relative === "scripts/lib/skill-governance.mjs"
+  || (relative.endsWith("/skills/yss-product-lifecycle/references/orchestration-contract.yaml") && line.includes("retired_shared_skills:"))
   || relative.endsWith("scripts/verify-retired-skill-ids")
   || relative.endsWith("scripts/lib/skill-supply-chain.mjs")
   || relative.endsWith("scripts/lib/implementation-contract-compiler.mjs");
 
-const search = spawnSync("rg", ["-n", "--hidden", "--glob", "!.git/**", "--glob", "!.codegraph/**", "--glob", "!submodules/**", retired.join("|"), "."], {
+const escaped = retired.filter((id) => id !== "teach").map((id) => id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+const exactSkillIdPattern = `(?<![a-z0-9-])(?:${escaped.join("|")})(?![a-z0-9-])`;
+const teachSkillPattern = "(?:`teach`|/teach(?:/|\\b)|(?:^|[\\[,])\\s*[\"']?teach[\"']?\\s*(?=[,\\]])|\\b(?:id|name)\\s*:\\s*[\"']?teach[\"']?\\b)";
+const retiredSkillPattern = `(?:${exactSkillIdPattern}|${teachSkillPattern})`;
+const search = spawnSync("rg", ["-n", "--pcre2", "--hidden", "--glob", "!.git/**", "--glob", "!.codegraph/**", "--glob", "!submodules/**", retiredSkillPattern, "."], {
   cwd: ROOT,
   encoding: "utf8"
 });
@@ -25,7 +51,7 @@ if (![0, 1].includes(search.status)) {
 }
 const violations = search.stdout.split(/\r?\n/).filter(Boolean).filter((line) => {
   const match = line.match(/^\.\/(.*?):\d+:/);
-  return !match || !allowed(match[1]);
+  return !match || !allowed(match[1], line);
 });
 for (const name of retired) {
   const roots = [".agents/skills", ...PROJECTION_ROOTS];

package/template/scripts/verify-scaffold-architecture-decision-scenarios

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import { attachScaffoldDecisionFixture } from "./fixtures/user-decision/build-fixture.mjs";
+import path from "node:path";
+import { parseDocument } from "./vendor/yaml.mjs";
+
+const root = mkdtempSync(path.join(os.tmpdir(), "scaffold-decision-scenarios-"));
+process.on("exit", () => rmSync(root, { recursive: true, force: true }));
+const verifier = path.resolve("scripts/verify-scaffold-architecture-decisions");
+const digest = `sha256:${"1".repeat(64)}`;
+const confirmation = `\n    user_confirmation:\n      confirmed_by: user\n      channel: codex\n      confirmation_ref: turn://1\n      confirmed_at: 2026-09-05T01:00:00+08:00\n      normalized_text: 确认 MVC`;
+function run(name, body) {
+  const file = path.join(root, `${name}.yaml`);
+  const value = parseDocument(body).toJS();
+  value.decisions = value.decisions.map((decision) => attachScaffoldDecisionFixture(path.join(root, name, decision.project_id), decision));
+  writeFileSync(file, JSON.stringify(value));
+  return spawnSync(verifier, [file], { encoding: "utf8" });
+}
+const base = `schema_version: 1\nkind: scaffold-architecture-decisions\ntemplate: false\nstatus: current\ndecisions:\n`;
+const mvc = `${base}  - decision_id: scaffold-decision.main\n    project_id: main\n    parent_project_id: null\n    status: lifecycle-approved\n    recommended_architecture: layered-mvc\n    recommendation_reasons: [CRUD 与报表为主]\n    confirmed_architecture: layered-mvc\n    override_reason: null\n    inheritance_mode: root-default\n    inherited_from: null\n    platform_profile: spring-boot-2.7-jdk8\n    architecture_profile: layered-mvc-service\n    verification_database: h2\n    production_database: not-bound\n    requested_capabilities: [feign-client]\n    resolved_modules: [server, service, repository, client, feign-client]\n    resolution_version: 1${confirmation}\n    decision_inputs_digest: ${digest}\n`;
+assert.equal(run("mvc", mvc).status, 0);
+assert.notEqual(run("missing-confirmation", mvc.replace("confirmation_ref: turn://1", "confirmation_ref: null")).status, 0);
+assert.notEqual(run("invalid-closure", mvc.replace("[server, service, repository, client, feign-client]", "[server, service, repository]")).status, 0);
+const child = `${mvc}  - decision_id: scaffold-decision.child\n    project_id: child\n    parent_project_id: main\n    status: lifecycle-approved\n    recommended_architecture: domain-driven\n    recommendation_reasons: [存在复杂状态机]\n    confirmed_architecture: layered-mvc\n    override_reason: 继承本体的统一架构\n    inheritance_mode: inherit\n    inherited_from: main\n    platform_profile: spring-boot-2.7-jdk8\n    architecture_profile: layered-mvc-service\n    verification_database: h2\n    production_database: not-bound\n    requested_capabilities: []\n    resolved_modules: [server, service, repository]\n    resolution_version: 1${confirmation}\n    decision_inputs_digest: ${digest}\n`;
+assert.equal(run("child", child).status, 0);
+assert.notEqual(run("inherit-mismatch", child.replace("confirmed_architecture: layered-mvc\n    override_reason: 继承本体的统一架构\n    inheritance_mode: inherit", "confirmed_architecture: domain-driven\n    override_reason: null\n    inheritance_mode: inherit")).status, 0);
+process.stdout.write("脚手架架构选择场景验证通过\n");

package/template/scripts/verify-scaffold-architecture-decisions

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
+import { parseDocument } from "./vendor/yaml.mjs";
+import { validateJsonSchema } from "./lib/json-schema.mjs";
+import { loadSkillRegistry } from "./lib/skill-registry.mjs";
+import { assertScaffoldUserDecision } from "./lib/user-decision.mjs";
+import { validateArchitectureIdentity } from "./lib/backend-architecture.mjs";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const schemaPath = path.join(repoRoot, "docs/process/schemas/scaffold-architecture-decisions.schema.json");
+const MVC_ORDER = ["server", "service", "repository", "adapter", "client", "feign-client"];
+const DDD_MODULES = ["domain", "application", "infrastructure", "adapter", "bootstrap"];
+const CAPABILITIES = { "external-integration": ["adapter"], "published-client": ["client"], "feign-client": ["client", "feign-client"] };
+
+function mvcModules(capabilities) {
+  const result = new Set(["server", "service", "repository"]);
+  for (const capability of capabilities) for (const module of CAPABILITIES[capability] ?? []) result.add(module);
+  return MVC_ORDER.filter((module) => result.has(module));
+}
+
+try {
+  const { values, positionals } = parseArgs({ options: { "allow-template": { type: "boolean" } }, allowPositionals: true, strict: true });
+  if (positionals.length !== 1) throw new TypeError("用法: scripts/verify-scaffold-architecture-decisions [--allow-template] <file.yaml>");
+  const document = parseDocument(readFileSync(path.resolve(positionals[0]), "utf8"), { maxAliasCount: 0, uniqueKeys: true });
+  if (document.errors.length) throw new TypeError(document.errors[0].message);
+  const value = document.toJS({ maxAliasCount: 0 });
+  validateJsonSchema(value, schemaPath, { cwd: repoRoot, label: "scaffold architecture decision schema" });
+  if (!values["allow-template"] && value.template !== false) throw new TypeError("正式决策记录必须设置 template: false");
+  const ids = new Set();
+  const projects = new Map();
+  for (const decision of value.decisions) {
+    if (ids.has(decision.decision_id) || projects.has(decision.project_id)) throw new TypeError("decision_id 与 project_id 必须唯一");
+    ids.add(decision.decision_id);
+    projects.set(decision.project_id, decision);
+    const confirmed = ["user-confirmed", "lifecycle-approved", "consumed"].includes(decision.status);
+    const confirmation = decision.user_confirmation;
+    if (confirmed && (!decision.confirmed_architecture || Object.values(confirmation).some((item) => item === null || item === ""))) throw new TypeError(`${decision.project_id} 已确认状态必须提供完整用户确认引用`);
+    if (!confirmed && decision.status !== "stale" && decision.confirmed_architecture !== null) throw new TypeError(`${decision.project_id} 未确认状态不得预填 confirmed_architecture`);
+    if (decision.confirmed_architecture && decision.confirmed_architecture !== decision.recommended_architecture && !decision.override_reason) throw new TypeError(`${decision.project_id} 覆盖 Agent 推荐时必须说明 override_reason`);
+    if (decision.inheritance_mode === "root-default" && (decision.parent_project_id !== null || decision.inherited_from !== null)) throw new TypeError(`${decision.project_id} 根默认不得声明父项目`);
+    if (["inherit", "override"].includes(decision.inheritance_mode) && (!decision.parent_project_id || decision.inherited_from !== decision.parent_project_id)) throw new TypeError(`${decision.project_id} 子项目继承引用不完整`);
+    if (confirmed && value.template === false) {
+      assertScaffoldUserDecision(decision);
+    }
+    const registry = loadSkillRegistry();
+    validateArchitectureIdentity({ ...decision, architecture_family: decision.confirmed_architecture ?? decision.recommended_architecture, generator_skill: registry.architecture_profiles?.[decision.architecture_profile]?.generator_skill, contract_digest: decision.decision_inputs_digest }, registry);
+  }
+  for (const decision of value.decisions) {
+    if (!decision.parent_project_id) continue;
+    const parent = projects.get(decision.parent_project_id);
+    if (!parent) throw new TypeError(`${decision.project_id} 引用了不存在的父项目`);
+    if (decision.inheritance_mode === "inherit" && decision.confirmed_architecture && parent.confirmed_architecture && decision.confirmed_architecture !== parent.confirmed_architecture) throw new TypeError(`${decision.project_id} 继承值与父项目不一致；需要改为 override`);
+  }
+  process.stdout.write("脚手架架构选择记录验证通过\n");
+} catch (error) {
+  process.stderr.write(`脚手架架构选择记录验证失败: ${error.message}\n`);
+  process.exitCode = 1;
+}