create-yss-spec 3.3.0 → 3.3.3

package/template/.qoder/skills/yss-formily-schema-generator/references/workflow.md

@@ -1,240 +0,0 @@
-# YssFormily Schema Conversion Workflow
-
-This reference is for converting text, images, and Figma designs into YssFormily artifacts.
-
-## 1. Normalize the request
-
-Classify the target form first:
-
-| Form type | Signals |
-| --- | --- |
-| 查询表单 | 筛选、搜索、重置、查询、导出 |
-| 新增表单 | 新建、创建、录入、保存 |
-| 编辑表单 | 编辑、更新、修改 |
-| 详情表单 | 查看、详情、只读、描述列表 |
-| 复合表单 | 同页同时支持新增/编辑/查看 |
-
-Then decide the expected output:
-
-- schema only
-- schema + render snippet
-- schema + data model + scope/effects plan
-
-## 2. Extract a field table
-
-Before writing schema, create a mental table with:
-
-| Item | Meaning |
-| --- | --- |
-| key | stable field name |
-| title | display label |
-| type | business data type |
-| component | YssFormily component |
-| required | whether mandatory |
-| group | section placement |
-| span | layout width |
-| enum source | static or remote |
-| linkage | depends on or affects other fields |
-| custom render | slot/detail slot needed or not |
-
-If a field key is not explicit, generate a stable domain name.
-Avoid UI-only names such as `input1`, `selectA`, `fieldLeft`.
-
-## 3. Component mapping heuristics
-
-Use these defaults:
-
-| Input clue | Preferred YssFormily component |
-| --- | --- |
-| 单行文本 | `Input` |
-| 多行说明 | `Input.TextArea` |
-| 单选下拉 | `Select` |
-| 单选按钮 | `Radio.Group` |
-| 开关 | `Switch` |
-| 日期 | `DatePicker` |
-| 日期区间 | `DatePicker.RangePicker` |
-| 数值 | `InputNumber` |
-| 多选标签 | `Select` with multiple mode |
-| 文件上传 | `Upload` |
-| 可重复行 | `ArrayItems` |
-
-If the UI is clearly custom:
-
-- use `Slot` for edit mode
-- use `detail-*` slot for detail mode
-
-Typical custom cases:
-
-- SQL editor
-- code editor
-- rich text
-- complex helper panel
-- embedded table or tree selector
-
-## 4. Layout mapping heuristics
-
-Convert visual grouping to YssFormily structure:
-
-- page-level layout -> `FormLayout`
-- grid rows and columns -> `FormGrid`
-- section title -> `GroupHeader`
-- footer actions -> `AutoButtonGroup`
-
-Use `gridSpan` when:
-
-- field is visually full width
-- long text area spans across columns
-- custom editor needs horizontal space
-
-Conservative defaults:
-
-- ordinary field: `gridSpan: 1`
-- medium-wide field: `gridSpan: 2`
-- editor-like block: `gridSpan: 3` if page is wide enough
-
-## 5. Validation extraction
-
-Confidence levels:
-
-- high confidence:
-  required star, obvious numeric/date constraints, explicit helper text
-- medium confidence:
-  common business conventions such as name required, code length hint
-- low confidence:
-  hidden uniqueness checks, server-side validation, cross-form constraints
-
-Only encode low-confidence validation if the user explicitly described it.
-
-## 6. Linkage extraction
-
-Map visible interactions into one of these:
-
-| Situation | Mechanism |
-| --- | --- |
-| 简单显隐 | `x-visible` |
-| 简单禁用 | `x-disabled` |
-| 单字段依赖更新 | `x-reactions` |
-| 调接口更新选项 | `scope` handler |
-| 多字段协同或提交兜底 | `effects` |
-
-Examples:
-
-- “选择数据源类型后才显示 JDBC 配置” -> `x-visible`
-- “切换开关后禁用描述字段” -> `x-disabled`
-- “选择省份后重置城市并更新选项” -> `x-reactions`
-- “输入编码后查重” -> `scope` or async validator
-- “提交失败统一 toast” -> `effects`
-
-## 7. Output template
-
-Preferred answer skeleton:
-
-```md
-理解
-
-假设
-
-字段模型
-
-```ts
-// schema
-...
-```
-
-```ts
-// initial model shape
-...
-```
-
-```vue
-<!-- optional render snippet -->
-...
-```
-```
-
-## 8. Schema skeleton
-
-Use this as the default starting point:
-
-```ts
-const schema: ISchema = {
-  type: 'object',
-  properties: {
-    layout: {
-      type: 'void',
-      'x-component': 'FormLayout',
-      'x-component-props': {
-        layout: 'horizontal',
-        labelWidth: 120,
-      },
-      properties: {
-        grid: {
-          type: 'void',
-          'x-component': 'FormGrid',
-          properties: {},
-        },
-      },
-    },
-  },
-};
-```
-
-## 9. Query form special handling
-
-When the form is clearly a search form:
-
-- keep fields compact
-- avoid excessive required rules
-- place actions in `AutoButtonGroup`
-- include `Submit` and `Reset`
-- prefer light linkage over complex `effects`
-
-Typical query output includes:
-
-- schema
-- initial filter model
-- submit/reset handlers through `scope`
-
-## 10. Detail form special handling
-
-If the target is read-only or mixed add/edit/detail:
-
-- plan `mode`
-- check whether detail mode needs custom slots
-- do not generate editable controls only
-- leverage default descriptions rendering when enough
-
-Use custom detail slots only when:
-
-- value needs rich formatting
-- arrays should render tags
-- code or rich text should render in a viewer
-
-## 11. Figma-specific notes
-
-When converting from Figma:
-
-- extract semantic labels, not layer IDs
-- ignore purely decorative layers
-- map helper text and required marks into schema rules
-- convert footer buttons into action area, not ordinary fields
-- infer full-width editors from large framed regions
-
-Do not preserve design-only names such as:
-
-- `Frame 123`
-- `Input / Default`
-- `Group 14`
-
-Translate them into domain names and stable field keys.
-
-## 12. Image-specific notes
-
-When converting from screenshots:
-
-- distinguish placeholder text from actual label text
-- watch for tabs or segmented controls that imply conditional sections
-- identify whether a box is a custom editor or just a textarea
-- keep uncertain parts in assumptions
-
-If confidence is low, generate a clean schema baseline instead of fake precision.

package/template/.qoder/skills/yss-frontend-scaffold-generator/SKILL.md

@@ -1,81 +0,0 @@
----
-name: yss-frontend-scaffold-generator
-description: Use when creating a new YSS frontend micro-application from the standard frontend template.
----
-
-# YSS Frontend Scaffold Generator
-
-用于从标准 YSS 前端模板创建 0-1 前端微应用工程。它只在阶段 5 的 `work-unit.implementation-repository-preparation` 中消费生命周期批准、持久化且当前的 Project Scaffold Contract schema v4，执行 `controlled-generation`；不生成业务页面。
-
-## Template Source
-
-```text
-repo: http://192.168.167.142:8081/Data-Middleground-Develop-Area/product-code/ai-frontend/yss-design/yss-frontend-template.git
-branch: template
-```
-
-模板基线：Vue 3、TypeScript、Vite、Qiankun、pnpm、Ant Design Vue、`@yss-ui/components`、`@yss-ui/hooks`、Orval。
-
-## Inputs
-
-- `app_name`：应用名。
-- `microapp_name`：微应用注册名。
-- `base_route`：基础路由。
-- Project Scaffold Contract schema v4：包含用户确认的仓库 scope、目标路径、`init_git`、模板 commit、应用参数、允许写路径和验证命令。
-- OpenAPI Freeze 记录：有 API 影响时提供已批准的冻结 YAML 版本和引用；无 API 影响时提供带原因的 `not-applicable`。
-- OpenAPI JSON 派生记录：`docs/.scratch/<feature>/api/<feature>-json-export.md`，包含 YAML / JSON SHA-256、Redocly CLI 版本和 lockfile 引用。
-- 冻结 JSON 产物：`docs/.scratch/<feature>/api/<feature>.json`；这是唯一允许交给既有前端代码生成流程的上游产物。
-- `target_git_url` 或 `output_dir`：目标实现仓库或本地输出目录。
-- `package_manager`：默认 pnpm。
-- `init_git`：是否初始化 Git；默认必须用户明确确认。
-
-## Workflow
-
-采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `docs/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
-
-1. 确认当前任务已经通过 Harness 入口分诊、逐项目脚手架决定已由真实用户确认，且 schema v4 合同已由生命周期批准、持久化并保持当前。
-2. 确认目标是外部实现仓库；只有用户明确选择时才输出到 Harness 仓库的 `apps/frontend/<project>/`。`apps/frontend/` 只能作为项目容器，`app/frontend/`、`app/backend/` 及其子路径禁止作为输出位置。`git-submodule` 只能在已初始化且附加分支的子仓工作树生成；空 gitlink、detached HEAD、`--force` 覆盖挂载点不得当成普通目录。
-3. 只读检查模板分支和合同锁定的 40 位 commit 是否可访问；生成时使用精确 commit，不跟随浮动分支。
-4. 使用 `scripts/generate_and_verify_scaffold.mjs` 从已核验 checkout 复制工作树，排除模板 `.git`；目标必须不存在或为空。不得默认写入 Harness、不得 `--force`。仅合同 `init_git=true` 时初始化目标 Git。
-5. 替换应用名、微应用名、路由、`micro-config.json`、环境变量和 README 中的模板占位。
-6. 有 API 影响时核验 OpenAPI Freeze 记录和 JSON 派生记录，将摘要一致的 JSON 原样物化到 `<frontend>/openapi/openapi.json`；`openapi_impact=not-applicable` 时必须有原因并禁止生成 API client。
-7. 保持模板既有的前端代码生成配置不变；本 Harness 只将 SHA-256 一致的 JSON 原样交给既有前端代码生成流程，不修改该配置、不在此仓库执行生成，也不设置生成 CI 门禁。目标前端项目在需要时手动运行其既有命令。
-8. 实际执行并记录 `pnpm install --frozen-lockfile`、`pnpm lint`、`pnpm type-check`、`pnpm build` 的退出码和日志；缺失脚本只能由批准的工程基线提供替代命令。任何必需命令失败都阻断。
-9. 按 `docs/templates/implementation-repo-registry-template.md` 回写前端实现仓库登记。
-
-## Expected Template Shape
-
-```text
-openapi/
-packages/src/api/
-packages/src/router/
-packages/src/views/
-packages/src/styles/
-micro-config.json
-orval.config.ts
-package.json
-packages/package.json
-```
-
-## Boundaries
-
-- 不直接创建远端 Git 项目，除非用户明确要求。
-- 不保留模板 `.git` 或模板 remote；不在未获确认时执行 `git init`。
-- 不推送、不创建 MR / PR，除非用户明确要求。
-- 不绕过 OpenAPI Draft / Freeze；API client 只消费与 OpenAPI JSON 派生记录 SHA-256 一致的冻结 JSON。
-- 不接受任意 URL、未冻结 YAML、后端运行时输出或手工 JSON 作为既有前端代码生成流程的输入。
-- 不修改模板既有的代码生成配置，也不把客户端生成加入 CI。
-- 不得把 `apps/frontend/` 容器根登记为项目根；Harness 内每个前端项目必须有独立的 `apps/frontend/<project>/` 路径。
-- 不把模板示例页面当作业务功能交付。
-- 生成后仍需使用 `yss-ui-business-page-generation`、`yss-components`、`yss-api-integration` 等专项 skill 实现业务页面。
-
-## Output
-
-- 前端工程生成位置或目标仓库信息。
-- 模板来源和 commit / branch 证据。
-- 替换参数清单。
-- install / lint / type-check / build 命令，以及目标前端项目既有的手动客户端生成命令（如有）。
-- OpenAPI Freeze 记录、OpenAPI JSON 派生记录、JSON SHA-256 和 `openapi/openapi.json` 物化证据。
-- Harness 实现仓库登记草案。
-- `.yss/scaffold-generation.json` Manifest v4 与 `scaffold-verification.json`。
-- 未覆盖项和 `TODO-HUMAN-REVIEW`。

package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/generate_and_verify_scaffold.mjs

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-import { generate } from "./generate_scaffold.mjs";
-import { verify } from "./run_scaffold_verification.mjs";
-function argsOf(argv) { const args = {}; for (let i = 0; i < argv.length; i += 2) args[argv[i].replace(/^--/, "")] = argv[i + 1]; return args; }
-try {
-  const args = argsOf(process.argv.slice(2));
-  generate({ contractFile: args["contract-file"], templateCheckout: args["template-checkout"], outputDir: args["output-dir"] });
-  const report = verify(args["output-dir"], args["evidence-dir"]);
-  if (report.status !== "passed") process.exitCode = 1;
-} catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-import { createHash } from "node:crypto";
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { validateJsonSchema } from "../../../../scripts/lib/json-schema.mjs";
-
-const fail = (message) => { throw new TypeError(message); };
-const REPOSITORY_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../..");
-const sha256 = (value) => `sha256:${createHash("sha256").update(value).digest("hex")}`;
-function argsOf(argv) {
-  const args = {};
-  for (let i = 0; i < argv.length; i += 2) args[argv[i].replace(/^--/, "")] = argv[i + 1];
-  return args;
-}
-function git(cwd, ...args) {
-  const result = spawnSync("git", args, { cwd, encoding: "utf8" });
-  if (result.status !== 0) fail(result.stderr || `git ${args.join(" ")} failed`);
-  return result.stdout.trim();
-}
-function walk(root) {
-  return readdirSync(root, { withFileTypes: true }).flatMap((entry) => {
-    const item = path.join(root, entry.name);
-    return entry.isDirectory() ? walk(item) : entry.isFile() ? [item] : [];
-  });
-}
-function validate(contract, outputDir) {
-  validateJsonSchema(contract, path.join(REPOSITORY_ROOT, "docs/process/schemas/project-scaffold-contract.schema.json"), { label: "Project Scaffold Contract v4" });
-  if (contract.schema_version !== 4 || contract.kind !== "project-scaffold-contract") fail("frontend scaffold requires Project Scaffold Contract schema v4");
-  if (contract.status !== "approved" || contract.current_version !== true || !contract.persisted_ref) fail("scaffold contract must be approved, persisted and current");
-  if (contract.delivery_role !== "frontend" || contract.scaffold_kind !== "frontend-yss-vue3" || contract.generator_skill !== "yss-frontend-scaffold-generator") fail("contract is not for the YSS frontend generator");
-  if (path.resolve(contract.target_output_dir) !== outputDir) fail("output directory differs from approved contract");
-  if (contract.generation_policy?.mode !== "initialize-only" || contract.generation_policy?.existing_target !== "unsupported") fail("unsupported generation policy");
-  if (!contract.frontend?.template?.repository || !/^[a-f0-9]{40}$/.test(contract.frontend.template.commit || "")) fail("template repository and exact 40-character commit are required");
-  if (contract.frontend.openapi_impact === "frozen" && (!contract.frontend.openapi_json_ref || !contract.frontend.openapi_json_digest)) fail("frozen OpenAPI JSON and digest are required");
-  if (contract.frontend.openapi_impact === "not-applicable" && !contract.frontend.openapi_not_applicable_reason) fail("no-API scaffold requires a reason");
-}
-
-export function generate({ contractFile, templateCheckout, outputDir }) {
-  const contract = JSON.parse(readFileSync(contractFile, "utf8"));
-  outputDir = path.resolve(outputDir);
-  templateCheckout = path.resolve(templateCheckout);
-  validate(contract, outputDir);
-  if (!existsSync(path.join(templateCheckout, ".git"))) fail("template checkout must be a Git worktree");
-  if (git(templateCheckout, "rev-parse", "HEAD") !== contract.frontend.template.commit) fail("template checkout does not match approved commit");
-  if (git(templateCheckout, "config", "--get", "remote.origin.url") !== contract.frontend.template.repository) fail("template repository differs from approved source");
-  if (existsSync(outputDir) && readdirSync(outputDir).length > 0) fail("target directory must not exist or must be empty");
-  mkdirSync(outputDir, { recursive: true });
-  cpSync(templateCheckout, outputDir, { recursive: true, filter: (source) => path.basename(source) !== ".git" });
-
-  const replacements = {
-    "__APP_NAME__": contract.frontend.app_name,
-    "__MICROAPP_NAME__": contract.frontend.microapp_name,
-    "__BASE_ROUTE__": contract.frontend.base_route,
-    ...(contract.frontend.replacements || {}),
-  };
-  for (const file of walk(outputDir)) {
-    if (statSync(file).size > 2_000_000) continue;
-    let text;
-    try { text = readFileSync(file, "utf8"); } catch { continue; }
-    const replaced = Object.entries(replacements).reduce((value, [from, to]) => value.split(from).join(to), text);
-    if (replaced !== text) writeFileSync(file, replaced);
-  }
-  if (contract.frontend.openapi_impact === "frozen") {
-    const bytes = readFileSync(contract.frontend.openapi_json_ref);
-    if (sha256(bytes) !== contract.frontend.openapi_json_digest) fail("OpenAPI JSON digest mismatch");
-    mkdirSync(path.join(outputDir, "openapi"), { recursive: true });
-    writeFileSync(path.join(outputDir, "openapi", "openapi.json"), bytes);
-  }
-  if (contract.init_git === true) git(outputDir, "init");
-  const generatedFiles = walk(outputDir).map((file) => path.relative(outputDir, file)).filter((file) => file !== ".yss/scaffold-generation.json").sort();
-  const manifest = {
-    schema_version: 4,
-    kind: "frontend-scaffold",
-    delivery_role: "frontend",
-    generator_skill: "yss-frontend-scaffold-generator",
-    contract_id: contract.contract_id,
-    contract_version: contract.contract_version,
-    contract_digest: sha256(readFileSync(contractFile)),
-    contract_file_ref: path.resolve(contractFile),
-    persisted_ref: contract.persisted_ref,
-    approval_ref: contract.approval.approval_ref,
-    template: { ...contract.frontend.template, checkout: templateCheckout },
-    repository_scope: contract.repository_scope,
-    target_output_dir: outputDir,
-    init_git: contract.init_git,
-    openapi_impact: contract.frontend.openapi_impact,
-    generation_mode: "controlled-generation",
-    generation_policy: contract.generation_policy,
-    verification_commands: contract.verification_commands,
-    generated_files: generatedFiles,
-    completion_level: "generated",
-    generated_at: new Date().toISOString(),
-  };
-  mkdirSync(path.join(outputDir, ".yss"), { recursive: true });
-  writeFileSync(path.join(outputDir, ".yss", "scaffold-generation.json"), `${JSON.stringify(manifest, null, 2)}\n`);
-  return manifest;
-}
-
-if (import.meta.url === `file://${process.argv[1]}`) {
-  try {
-    const args = argsOf(process.argv.slice(2));
-    generate({ contractFile: args["contract-file"], templateCheckout: args["template-checkout"], outputDir: args["output-dir"] });
-    process.stdout.write("frontend scaffold generated\n");
-  } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }
-}

package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs

@@ -1,41 +0,0 @@
-#!/usr/bin/env node
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-
-const ALLOWED = new Map([
-  ["pnpm install --frozen-lockfile", ["install", "--frozen-lockfile"]],
-  ["pnpm lint", ["lint"]],
-  ["pnpm type-check", ["type-check"]],
-  ["pnpm build", ["build"]],
-]);
-function argsOf(argv) { const args = {}; for (let i = 0; i < argv.length; i += 2) args[argv[i].replace(/^--/, "")] = argv[i + 1]; return args; }
-export function verify(projectRoot, evidenceDir) {
-  projectRoot = path.resolve(projectRoot); evidenceDir = path.resolve(evidenceDir);
-  const manifestPath = path.join(projectRoot, ".yss", "scaffold-generation.json");
-  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
-  if (manifest.schema_version !== 4 || manifest.kind !== "frontend-scaffold" || manifest.generation_mode !== "controlled-generation") throw new TypeError("invalid frontend scaffold manifest");
-  if (!manifest.generated_files.includes("pnpm-lock.yaml")) throw new TypeError("frontend template must contain pnpm-lock.yaml");
-  const commands = manifest.verification_commands;
-  for (const required of ALLOWED.keys()) if (!commands.includes(required)) throw new TypeError(`missing required verification command: ${required}`);
-  mkdirSync(evidenceDir, { recursive: true });
-  const results = commands.map((command, index) => {
-    const argv = ALLOWED.get(command);
-    if (!argv) throw new TypeError(`unsupported verification command: ${command}`);
-    const started = Date.now();
-    const result = spawnSync("pnpm", argv, { cwd: projectRoot, encoding: "utf8" });
-    const stdoutRef = path.join(evidenceDir, `${index + 1}-stdout.log`), stderrRef = path.join(evidenceDir, `${index + 1}-stderr.log`);
-    writeFileSync(stdoutRef, result.stdout || ""); writeFileSync(stderrRef, result.stderr || "");
-    return { command, exit_code: result.status ?? 1, duration_ms: Date.now() - started, stdout_ref: stdoutRef, stderr_ref: stderrRef, executed_at: new Date().toISOString() };
-  });
-  const passed = results.every((item) => item.exit_code === 0);
-  const report = { schema_version: 1, kind: "frontend-scaffold-verification", status: passed ? "passed" : "failed", project_root: projectRoot, scaffold_manifest_ref: manifestPath, commands: results };
-  const reportPath = path.join(evidenceDir, "scaffold-verification.json");
-  writeFileSync(reportPath, `${JSON.stringify(report, null, 2)}\n`);
-  if (passed) { manifest.completion_level = "empty-scaffold-verified"; manifest.scaffold_verification_ref = reportPath; writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`); }
-  return report;
-}
-if (import.meta.url === `file://${process.argv[1]}`) {
-  try { const args = argsOf(process.argv.slice(2)); const report = verify(args["project-root"], args["evidence-dir"]); process.stdout.write(`${report.status}\n`); if (report.status !== "passed") process.exitCode = 1; }
-  catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }
-}

package/template/.qoder/skills/yss-frontend-scaffold-generator/scripts/scaffold-generator.test.mjs

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-import assert from "node:assert/strict";
-import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-
-const root = mkdtempSync(path.join(os.tmpdir(), "yss-frontend-scaffold-"));
-process.on("exit", () => rmSync(root, { recursive: true, force: true }));
-const template = path.join(root, "template"), output = path.join(root, "output"), evidence = path.join(root, "evidence"), bin = path.join(root, "bin");
-mkdirSync(template); mkdirSync(bin);
-writeFileSync(path.join(template, "package.json"), JSON.stringify({ name: "__APP_NAME__", scripts: { lint: "noop", "type-check": "noop", build: "noop" } }));
-writeFileSync(path.join(template, "pnpm-lock.yaml"), "lockfileVersion: '9.0'\n");
-writeFileSync(path.join(template, "micro-config.json"), JSON.stringify({ name: "__MICROAPP_NAME__", route: "__BASE_ROUTE__" }));
-for (const args of [["init"], ["config", "user.email", "test@example.com"], ["config", "user.name", "test"], ["remote", "add", "origin", template], ["add", "."], ["commit", "-m", "fixture"]]) {
-  const result = spawnSync("git", args, { cwd: template, encoding: "utf8" }); assert.equal(result.status, 0, result.stderr);
-}
-const commit = spawnSync("git", ["rev-parse", "HEAD"], { cwd: template, encoding: "utf8" }).stdout.trim();
-const contract = {
-  schema_version: 4, kind: "project-scaffold-contract", contract_id: "frontend.demo.v1", contract_version: "1", status: "approved", persisted_ref: "docs/.scratch/demo/scaffold-contract.json", current_version: true,
-  delivery_role: "frontend", scaffold_kind: "frontend-yss-vue3", generator_skill: "yss-frontend-scaffold-generator", implementation_repository: output, target_output_dir: output, repository_scope: "external-repository", init_git: false,
-  frontend: { app_name: "demo-app", microapp_name: "demo", base_route: "/demo", package_manager: "pnpm", template: { repository: template, commit }, openapi_impact: "not-applicable", openapi_not_applicable_reason: "static-only" },
-  allowed_write_paths: [output], expected_evidence_files: [".yss/scaffold-generation.json"], verification_commands: ["pnpm install --frozen-lockfile", "pnpm lint", "pnpm type-check", "pnpm build"], approval: { approval_ref: "decision://frontend", approver: "user" }, generation_policy: { mode: "initialize-only", existing_target: "unsupported", old_project_migration: "unsupported", template_upgrade: "unsupported" }
-};
-const contractFile = path.join(root, "contract.json"); writeFileSync(contractFile, JSON.stringify(contract));
-const mockPnpm = path.join(bin, "pnpm"); writeFileSync(mockPnpm, "#!/bin/sh\nexit 0\n"); chmodSync(mockPnpm, 0o755);
-const runner = path.resolve(".agents/skills/yss-frontend-scaffold-generator/scripts/generate_and_verify_scaffold.mjs");
-const result = spawnSync(process.execPath, [runner, "--contract-file", contractFile, "--template-checkout", template, "--output-dir", output, "--evidence-dir", evidence], { encoding: "utf8", env: { ...process.env, PATH: `${bin}:${process.env.PATH}` } });
-assert.equal(result.status, 0, result.stderr);
-assert.equal(existsSync(path.join(output, ".git")), false);
-assert.equal(JSON.parse(readFileSync(path.join(output, "package.json"))).name, "demo-app");
-assert.equal(JSON.parse(readFileSync(path.join(output, ".yss", "scaffold-generation.json"))).completion_level, "empty-scaffold-verified");
-assert.equal(JSON.parse(readFileSync(path.join(evidence, "scaffold-verification.json"))).commands.length, 4);
-const second = spawnSync(process.execPath, [runner, "--contract-file", contractFile, "--template-checkout", template, "--output-dir", output, "--evidence-dir", evidence], { encoding: "utf8", env: { ...process.env, PATH: `${bin}:${process.env.PATH}` } });
-assert.notEqual(second.status, 0);
-assert.match(second.stderr, /must not exist or must be empty/);
-process.stdout.write("前端脚手架受控生成场景验证通过\n");