@ykdz/template 0.0.40 → 0.0.42

package/node_modules/@ykdz/template-builtin-presets/dist/src/vike-app/definition.js

@@ -31,13 +31,16 @@ function replayDefinitions(initialPackages) {
         migrations: initialPackages.require("migrations"),
     };
 }
-function foundation(packageDefinitions) {
+function foundation(packageDefinitions, includeFrontendTools = false) {
     const workspacePackageGlobs = [
         ...new Set(Object.values(packageDefinitions).map((definition) => `${definition.path.split("/")[0]}/*`)),
     ];
     return {
         toolchains: {},
-        editorCapabilities: ["oxc-format-lint", "vue", "tailwind", "vitest"],
+        editorCapabilities: [
+            "oxc-format-lint",
+            ...(includeFrontendTools ? ["vue", "tailwind", "vitest"] : []),
+        ],
         typescriptConfigurationPackage: { dependency: "required" },
         dependencyMaintenance: {
             ecosystems: ["npm", "github-actions", "docker"],
@@ -57,7 +60,9 @@ function webScripts() {
         "lint:fix": "oxlint --type-aware --format=unix . --fix",
         preview: "DATABASE_PROFILE=dev vike preview",
         start: "node ./dist/server/index.mjs",
-        test: "vitest run --reporter=agent --silent=passed-only --passWithNoTests",
+        "browser:prepare": "playwright install chromium",
+        test: "vitest run --project=node --reporter=agent --silent=passed-only --passWithNoTests",
+        "test:browser": "vitest run --project=browser --reporter=agent --silent=passed-only",
         "test:e2e": "DATABASE_PROFILE=e2e playwright test",
         typecheck: "node --conditions=source scripts/run-vue-tsc.ts --build --noEmit --pretty false",
     };
@@ -71,7 +76,7 @@ function databaseScripts() {
         "format:write": "oxfmt --write .",
         lint: "oxlint --quiet --format=unix .",
         "lint:fix": "oxlint --format=unix . --fix",
-        test: "DATABASE_PROFILE=test NODE_OPTIONS=--conditions=source vitest run --reporter=agent --silent=passed-only",
+        test: "DATABASE_PROFILE=test node --conditions=source --test --test-reporter=spec --test-reporter=./scripts/node-test-count-reporter.ts --test-reporter-destination=stdout --test-reporter-destination=stderr 'test/**/*.test.ts'",
         typecheck: "tsc -p tsconfig.json --noEmit --pretty false",
     };
 }
@@ -131,7 +136,7 @@ function webContribution(context, packageDefinitions = definitions(context)) {
         "web/server/api.ts",
         "web/test/playwright-teardown.ts",
         "web/test/e2e/app.spec.ts",
-        "web/turbo.json",
+        "web/test/counter.browser.test.ts",
         "web/types/env.d.ts",
         "web/vitest.config.ts",
         "web/tsconfig.json",
@@ -147,6 +152,19 @@ function webContribution(context, packageDefinitions = definitions(context)) {
             multilineArrays: ["files"],
         },
         ...copyOperations(context, web.path, sourceFiles),
+        {
+            kind: "writeTextTemplate",
+            source: templateSources.vikeApp,
+            from: "web/turbo.json",
+            to: `${web.path}/turbo.json`,
+            replacements: { DATABASE_PACKAGE_NAME: db.name },
+        },
+        {
+            kind: "copyFile",
+            source: templateSources.vue,
+            from: "TESTING.md",
+            to: `${web.path}/TESTING.md`,
+        },
         {
             kind: "writeTextTemplate",
             source: templateSources.vikeApp,
@@ -251,6 +269,9 @@ function webContribution(context, packageDefinitions = definitions(context)) {
                 typescript: "catalog:",
                 vite: "catalog:",
                 vitest: "catalog:",
+                "@vitest/browser-playwright": "catalog:",
+                playwright: "catalog:",
+                "vitest-browser-vue": "catalog:",
                 "vue-tsc": "catalog:",
             },
             engines: { node: context.toolchain.nodeLtsMajor },
@@ -260,9 +281,12 @@ function webContribution(context, packageDefinitions = definitions(context)) {
         environmentNeeds: [
             playwrightBrowserAssetsEnvironmentNeed({ browser: "chromium", owner }),
         ],
-        ciDiagnosticArtifacts: [{ kind: "playwright", owner }],
+        ciDiagnosticArtifacts: [
+            { kind: "playwright", owner },
+            { kind: "vitest-browser", owner },
+        ],
         foundation: {
-            ...foundation(packageDefinitions),
+            ...foundation(packageDefinitions, true),
             deploymentCheck: {
                 kind: "application-container-with-database-migrations",
                 applicationPackageName: web.name,
@@ -373,8 +397,6 @@ function databaseContribution(context, packageDefinitions = definitions(context)
                 oxlint: "catalog:",
                 "oxlint-tsgolint": "catalog:",
                 "typescript-7": "catalog:",
-                vite: "catalog:",
-                vitest: "catalog:",
             },
             engines: { node: context.toolchain.nodeLtsMajor },
         },
@@ -386,6 +408,12 @@ function databaseContribution(context, packageDefinitions = definitions(context)
                 multilineArrays: ["files"],
             },
             ...copyOperations(context, db.path, sourceFiles),
+            ...["node-test-count-reporter.ts"].map((name) => ({
+                kind: "copyFile",
+                source: templateSources.foundation,
+                from: `scripts/${name}`,
+                to: `${db.path}/scripts/${name}`,
+            })),
         ],
         environmentNeeds: [],
         foundation: {
@@ -409,7 +437,6 @@ function migrationsContribution(context, packageDefinitions = definitions(contex
         "db-migrations/tsconfig.build.json",
         "db-migrations/drizzle/migrations/20260709120325_old_captain_flint/migration.sql",
         "db-migrations/drizzle/migrations/20260709120325_old_captain_flint/snapshot.json",
-        "db-migrations/turbo.json",
     ];
     return {
         definition: migrations,
@@ -438,6 +465,13 @@ function migrationsContribution(context, packageDefinitions = definitions(contex
                 multilineArrays: ["files"],
             },
             ...copyOperations(context, migrations.path, sourceFiles),
+            {
+                kind: "writeTextTemplate",
+                source: templateSources.vikeApp,
+                from: "db-migrations/turbo.json",
+                to: `${migrations.path}/turbo.json`,
+                replacements: { DATABASE_PACKAGE_NAME: db.name },
+            },
             {
                 kind: "writeTextTemplate",
                 source: templateSources.vikeApp,

package/node_modules/@ykdz/template-builtin-presets/dist/src/vue-app/definition.js

@@ -19,7 +19,6 @@ function appContribution(options) {
         "index.html",
         "playwright.config.ts",
         "vite.config.ts",
-        "vitest.config.ts",
         "turbo.json",
         "src/App.vue",
         "test/e2e/app.spec.ts",
@@ -49,6 +48,10 @@ function appContribution(options) {
                 kind: "playwright",
                 owner: { kind: "package-boundary", path: definition.path },
             },
+            {
+                kind: "vitest-browser",
+                owner: { kind: "package-boundary", path: definition.path },
+            },
         ],
         foundation: {
             toolchains: {},

package/node_modules/@ykdz/template-builtin-presets/dist/src/vue-hono-app/definition.js

@@ -11,7 +11,7 @@ function apiScripts() {
         lint: "oxlint --quiet --format=unix .",
         "lint:fix": "oxlint --format=unix . --fix",
         start: "node dist/server.js",
-        test: "vitest run --reporter=agent --silent=passed-only",
+        test: "node --conditions=source --test --test-reporter=spec --test-reporter=./scripts/node-test-count-reporter.ts --test-reporter-destination=stdout --test-reporter-destination=stderr 'test/**/*.test.ts'",
         typecheck: "tsc -p tsconfig.json --noEmit --pretty false",
     };
 }
@@ -21,10 +21,13 @@ function webScripts() {
         typecheck: "node --conditions=source scripts/run-vue-tsc.ts --build --noEmit --pretty false",
     };
 }
-function packageFoundation(packagePath) {
+function packageFoundation(packagePath, includeFrontendTools = false) {
     return {
         toolchains: {},
-        editorCapabilities: ["oxc-format-lint", "vue", "tailwind", "vitest"],
+        editorCapabilities: [
+            "oxc-format-lint",
+            ...(includeFrontendTools ? ["vue", "tailwind", "vitest"] : []),
+        ],
         typescriptConfigurationPackage: { dependency: "required" },
         dependencyMaintenance: {
             ecosystems: ["npm", "github-actions", "docker"],
@@ -52,7 +55,6 @@ function apiContribution(context, definition = {
     };
     const sourceFiles = [
         "turbo.json",
-        "vitest.config.ts",
         "tsconfig.json",
         "tsconfig.build.json",
         "src/index.ts",
@@ -75,6 +77,12 @@ function apiContribution(context, definition = {
                 from: `api/${from}`,
                 to: `${definition.path}/${from}`,
             }),
+        ...["node-test-count-reporter.ts"].map((name) => ({
+            kind: "copyFile",
+            source: templateSources.foundation,
+            from: `scripts/${name}`,
+            to: `${definition.path}/scripts/${name}`,
+        })),
     ];
     return {
         definition,
@@ -92,8 +100,6 @@ function apiContribution(context, definition = {
                 oxlint: "catalog:",
                 "oxlint-tsgolint": "catalog:",
                 "typescript-7": "catalog:",
-                vite: "catalog:",
-                vitest: "catalog:",
             },
             engines: { node: context.toolchain.nodeLtsMajor },
         },
@@ -112,7 +118,6 @@ function webContribution(context, apiDefinition, definition = {
         "env.d.ts",
         "index.html",
         "vite.config.ts",
-        "vitest.config.ts",
         "turbo.json",
         "src/api.ts",
         "src/App.vue",
@@ -138,8 +143,14 @@ function webContribution(context, apiDefinition, definition = {
         }),
         operations,
         environmentNeeds: [],
+        ciDiagnosticArtifacts: [
+            {
+                kind: "vitest-browser",
+                owner: { kind: "package-boundary", path: definition.path },
+            },
+        ],
         foundation: {
-            ...packageFoundation(definition.path),
+            ...packageFoundation(definition.path, true),
             vueHonoJointE2e: {
                 kind: "vue-hono-joint-e2e",
                 apiPackageName: apiDefinition.name,

package/node_modules/@ykdz/template-builtin-presets/package.json

@@ -15,16 +15,32 @@
       "source": "./src/index.ts",
       "types": "./dist/src/index.d.ts",
       "default": "./dist/src/index.js"
+    },
+    "./task-gates": {
+      "source": "./templates/foundation/scripts/task-gates.ts",
+      "types": "./templates/foundation/scripts/task-gates.ts",
+      "default": "./templates/foundation/scripts/task-gates.ts"
+    },
+    "./node-test-count-reporter": {
+      "source": "./templates/foundation/scripts/node-test-count-reporter.ts",
+      "types": "./templates/foundation/scripts/node-test-count-reporter.ts",
+      "default": "./templates/foundation/scripts/node-test-count-reporter.ts"
+    },
+    "./turbo-boundaries": {
+      "source": "./templates/foundation/scripts/run-turbo-boundaries.ts",
+      "types": "./templates/foundation/scripts/run-turbo-boundaries.ts",
+      "default": "./templates/foundation/scripts/run-turbo-boundaries.ts"
     }
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "format:check": "oxfmt --list-different --config ../../oxfmt.config.ts .",
     "format:write": "oxfmt --write --config ../../oxfmt.config.ts .",
-    "lint": "oxlint --quiet --format=unix --config ../../oxlint.config.ts --ignore-pattern dist --ignore-pattern templates . && oxlint --quiet --format=unix --config ../../oxlint.config.ts templates/ts-cli/publication-setup/bridge.ts",
-    "lint:fix": "oxlint --format=unix --config ../../oxlint.config.ts --ignore-pattern dist --ignore-pattern templates . --fix && oxlint --format=unix --config ../../oxlint.config.ts templates/ts-cli/publication-setup/bridge.ts --fix",
-    "test": "vitest run --config vitest.config.ts --reporter=agent --silent=passed-only --maxWorkers=1",
-    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false"
+    "lint": "oxlint --quiet --format=unix --config ../../oxlint.config.ts --ignore-pattern dist --ignore-pattern templates . && oxlint --quiet --format=unix --config ../../oxlint.config.ts templates/ts-cli/publication-setup/bridge.ts && oxlint --quiet --format=unix --config ../../oxlint.template-source.config.ts templates/foundation/scripts/task-gates.ts templates/foundation/scripts/node-test-count-reporter.ts templates/foundation/scripts/run-turbo-boundaries.ts",
+    "lint:fix": "oxlint --format=unix --config ../../oxlint.config.ts --ignore-pattern dist --ignore-pattern templates . --fix && oxlint --format=unix --config ../../oxlint.config.ts templates/ts-cli/publication-setup/bridge.ts --fix && oxlint --format=unix --config ../../oxlint.template-source.config.ts templates/foundation/scripts/task-gates.ts templates/foundation/scripts/node-test-count-reporter.ts templates/foundation/scripts/run-turbo-boundaries.ts --fix",
+    "test": "node --conditions=source --experimental-strip-types --import=./test-support/setup.ts --test --test-concurrency=2 --test-timeout=60000 --test-reporter=spec --test-reporter=@ykdz/template-builtin-presets/node-test-count-reporter --test-reporter-destination=stdout --test-reporter-destination=stderr 'src/**/*.light.test.ts'",
+    "test:integration": "node --conditions=source --experimental-strip-types scripts/run-installed-integration.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false && tsc -p tsconfig.template-scripts.json --noEmit --pretty false"
   },
   "dependencies": {
     "@ykdz/template-core": "workspace:*",
@@ -50,6 +66,7 @@
     "@valibot/to-json-schema": "catalog:",
     "@vikejs/hono": "catalog:",
     "@vitejs/plugin-vue": "catalog:",
+    "@vitest/browser-playwright": "catalog:",
     "@vue/devtools-api": "catalog:",
     "@vue/tsconfig": "catalog:",
     "@ykdz/cli-contract": "catalog:",
@@ -71,6 +88,7 @@
     "vike-vue": "catalog:",
     "vite": "catalog:",
     "vitest": "catalog:",
+    "vitest-browser-vue": "catalog:",
     "vue": "catalog:",
     "vue-tsc": "catalog:"
   },
@@ -85,10 +103,5 @@
     "smol-toml",
     "unbash",
     "yaml"
-  ],
-  "turbo": {
-    "tags": [
-      "template-builtin-presets"
-    ]
-  }
+  ]
 }

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/.github/workflows/check-deployment-diagnostics.yml

@@ -15,23 +15,9 @@ concurrency:
 
 jobs:
   check:
-    name: ${{ matrix.job_name }}
+    name: Full Check
     runs-on: ubuntu-latest
-    timeout-minutes: ${{ matrix.timeout_minutes }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - capability: root
-            job_name: Root Check
-            task_entrypoint: pnpm run check
-            timeout_minutes: 30
-            requires_docker: false
-          - capability: deployment
-            job_name: Deployment Check
-            task_entrypoint: pnpm run check:deployment
-            timeout_minutes: 45
-            requires_docker: true
+    timeout-minutes: 45
     steps:
       - name: Checkout source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
@@ -46,22 +32,26 @@ jobs:
         uses: pnpm/action-setup@d9184bf108216479bc5a137cc391f4d7b14c870b # v6.1.0
         with:
           cache: true
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
-        if: matrix.requires_docker
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
-      - name: Run selected Check
-        run: ${{ matrix.task_entrypoint }}
-      - name: Stage Root Check diagnostics
-        if: failure() && matrix.capability == 'root'
+      - name: Run Light Check
+        run: node --conditions=source scripts/task-gates.ts check
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
+      - name: Run Heavy Check
+        run: node --conditions=source scripts/task-gates.ts check:heavy
+      - name: Stage Check diagnostics
+        if: failure()
         env:
-          DIAGNOSTIC_OWNER_PATHS: |-
-            {{DIAGNOSTIC_OWNER_PATHS}}
+          PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS: |-
+            {{PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS}}
+          VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS: |-
+            {{VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS}}
         run: |
           rm -rf .template-ci-diagnostics
           mkdir -p .template-ci-diagnostics
-          printf '%s\n' "$DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+          printf '%s\n' "$PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+            [ -n "$owner_path" ] || continue
             for diagnostic_directory in test-results playwright-report; do
               source_path="$owner_path/$diagnostic_directory"
               destination_path=".template-ci-diagnostics/$owner_path/$diagnostic_directory"
@@ -71,11 +61,22 @@ jobs:
               fi
             done
           done
-      - name: Upload Root Check diagnostics
-        if: failure() && matrix.capability == 'root'
+          printf '%s\n' "$VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+            [ -n "$owner_path" ] || continue
+            diagnostic_directory=".vitest/attachments/failure-screenshots"
+            source_path="$owner_path/$diagnostic_directory"
+            destination_path=".template-ci-diagnostics/$owner_path/$diagnostic_directory"
+            if [ -d "$source_path" ]; then
+              mkdir -p "$(dirname "$destination_path")"
+              cp -R "$source_path" "$destination_path"
+            fi
+          done
+      - name: Upload Check diagnostics
+        if: failure()
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
-          name: root-check-diagnostics
+          name: check-diagnostics
           path: .template-ci-diagnostics
+          include-hidden-files: true
           if-no-files-found: ignore
           retention-days: 7

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/.github/workflows/check-deployment.yml

@@ -15,23 +15,9 @@ concurrency:
 
 jobs:
   check:
-    name: ${{ matrix.job_name }}
+    name: Full Check
     runs-on: ubuntu-latest
-    timeout-minutes: ${{ matrix.timeout_minutes }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - capability: root
-            job_name: Root Check
-            task_entrypoint: pnpm run check
-            timeout_minutes: 30
-            requires_docker: false
-          - capability: deployment
-            job_name: Deployment Check
-            task_entrypoint: pnpm run check:deployment
-            timeout_minutes: 45
-            requires_docker: true
+    timeout-minutes: 45
     steps:
       - name: Checkout source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
@@ -46,10 +32,11 @@ jobs:
         uses: pnpm/action-setup@d9184bf108216479bc5a137cc391f4d7b14c870b # v6.1.0
         with:
           cache: true
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
-        if: matrix.requires_docker
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
-      - name: Run selected Check
-        run: ${{ matrix.task_entrypoint }}
+      - name: Run Light Check
+        run: node --conditions=source scripts/task-gates.ts check
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@f87e5991a6d7451dcb8d9637bfbc97413f497069 # v4.4.1
+      - name: Run Heavy Check
+        run: node --conditions=source scripts/task-gates.ts check:heavy

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/.github/workflows/check-diagnostics.yml

@@ -34,17 +34,22 @@ jobs:
           cache: true
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
-      - name: Run Root Check
-        run: pnpm run check
+      - name: Run Light Check
+        run: node --conditions=source scripts/task-gates.ts check
+      - name: Run Heavy Check
+        run: node --conditions=source scripts/task-gates.ts check:heavy
       - name: Stage Root Check diagnostics
         if: failure()
         env:
-          DIAGNOSTIC_OWNER_PATHS: |-
-            {{DIAGNOSTIC_OWNER_PATHS}}
+          PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS: |-
+            {{PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS}}
+          VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS: |-
+            {{VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS}}
         run: |
           rm -rf .template-ci-diagnostics
           mkdir -p .template-ci-diagnostics
-          printf '%s\n' "$DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+          printf '%s\n' "$PLAYWRIGHT_DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+            [ -n "$owner_path" ] || continue
             for diagnostic_directory in test-results playwright-report; do
               source_path="$owner_path/$diagnostic_directory"
               destination_path=".template-ci-diagnostics/$owner_path/$diagnostic_directory"
@@ -54,11 +59,22 @@ jobs:
               fi
             done
           done
+          printf '%s\n' "$VITEST_BROWSER_DIAGNOSTIC_OWNER_PATHS" | while IFS= read -r owner_path; do
+            [ -n "$owner_path" ] || continue
+            diagnostic_directory=".vitest/attachments/failure-screenshots"
+            source_path="$owner_path/$diagnostic_directory"
+            destination_path=".template-ci-diagnostics/$owner_path/$diagnostic_directory"
+            if [ -d "$source_path" ]; then
+              mkdir -p "$(dirname "$destination_path")"
+              cp -R "$source_path" "$destination_path"
+            fi
+          done
       - name: Upload Root Check diagnostics
         if: failure()
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
           name: root-check-diagnostics
           path: .template-ci-diagnostics
+          include-hidden-files: true
           if-no-files-found: ignore
           retention-days: 7

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/.github/workflows/check.yml

@@ -34,5 +34,7 @@ jobs:
           cache: true
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
-      - name: Run Root Check
-        run: pnpm run check
+      - name: Run Light Check
+        run: node --conditions=source scripts/task-gates.ts check
+      - name: Run Heavy Check
+        run: node --conditions=source scripts/task-gates.ts check:heavy

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/AGENTS.md.template

@@ -6,12 +6,20 @@
 
 若这些限制与 Spec、Ticket、ADR 等权威本地文档冲突，应该以权威本地文档为准。
 
-- 开发自动化：非临时维护脚本必须使用 `scripts/**/*.ts` 中可擦除的 TypeScript，而不是 `.mjs` 等 JavaScript 脚本；归所属非构建 TypeScript 项目并受 format、lint、typecheck 覆盖，防止腐化；产品 build 不产出这些脚本。普通 Node 自动化使用原生 TypeScript 执行链。
+- 开发自动化：非临时维护脚本必须使用 `scripts/**/*.ts` 中可擦除的 TypeScript，而不是 `.mjs` 等 JavaScript 脚本；归所属非构建 TypeScript 项目并受 format、lint、typecheck 覆盖，防止腐化；产品 build 不产出这些脚本。普通 Node 自动化使用原生 TypeScript 执行链
 - 临时脚本：编写临时脚本时，应该将其放到有临时目录语义的位置
 - 任务归属：优先使用工具原生配置；直接命令与简单 `&&` 编排写在所属 package manifest；只有复杂逻辑才新增 TypeScript script
+- 脚本职责：新增 `package.json scripts` 时，同步在所属 `turbo.json` 声明任务及唯一准确职责；附加标签可自定义，包标签不能替代任务职责。子包自管任务与包标签，根包维护自身任务和全局政策；缺失、未知或冲突职责应使检查失败
+- 按需工作：现有专门职责之外、需单独选择的工作显式声明 `work:on-demand`，仍接受全仓校验。用于证明正确性、兼容性或可发布性的工作必须进入正式验收或其内部步骤，不能通过改名或按需归类避开验收
+- 任务配置：依赖交由 Turbo 原生图表达；有职责的无命令聚合节点必须能到达实际工作，必要的无职责中转节点可以保留。改名或删除脚本时同步清理失效定义与引用
+- 公共入口：保留 `check`、`check:heavy`、`check:full`、`fix` 的统一校验与执行接线，按职责发现任务；CI 直接调用同一实现并校验公共命令接线。开发调试可直接调用所属叶命令
+- 验收唯一入口：同一验收职责只保留一个正式入口和一份实现，开发、CI 与发布复用该实现；仅供内部调用的参数化步骤留在所属实现中
+- 测试表达：默认优先在用例位置使用所属运行器的原生断言、普通循环和局部异步协调表达行为；简单重复不构成提取 helper 的理由。确有复用需求且维护收益足够时才提取职责具体的资产；生成资产必须保持模板源所有权，并由所属包的格式、lint、类型检查、相关行为任务和缓存输入覆盖
 - 包边界：本地文件系统访问留在所属包内；跨包代码与资源通过声明依赖和公开 exports 获取，跨包任务交根 Turbo/pnpm 编排。不要以根目录定位器、跨包物理路径或 `@boundaries-ignore` 绕过边界
 - 最小充分测试：不要过度编写单元测试，包括为硬删除设计的防回归测试（可以临时存在，但是硬删除完成后必须删除，最好放在可丢弃分支中方便清理）、为文档内容或任何文件编写的存在性测试等，确保测试覆盖且仅覆盖业务逻辑本身的正负项
 - YAGNI：除非有明确目的，否则不要规划收益不足的安全边界等内容。简单的代码在未来真的遇到新需求时，重构起来远比一个充满防御性冗余设计的复杂系统要容易得多
 - 正式处理链路：开发、回放和端到端验收应复用生产的正式处理链路与制品，入口和配置可不同；同类流程只保留一份实现，迁移后删除旧链路，局部测试不得冒充全链路验收
 - 用户界面：不要将任何技术细节泄漏到用户可见的 UI 中
 - 逐步验收：先通过改动相关的局部门禁，交付前再执行较重的验收任务
+- 减少持久文档：以代码和少量权威文档作为事实依据；只有明确被允许时，才新增或修改持久文档。过程记录、临时方案等放入临时目录
+- 彻底迁移：迁移或迭代替换旧实现时，同步删除已失效的文档、逻辑和代码。只有任务明确要求兼容或临时绕行时，才保留相应旧内容

package/node_modules/@ykdz/template-builtin-presets/templates/{shared/devcontainer/node-pnpm.Dockerfile → foundation/devcontainer/base.Dockerfile}

@@ -6,7 +6,20 @@ ENV PNPM_HOME="/pnpm"
 ENV PATH="$PNPM_HOME/bin:$PNPM_HOME:$PATH"
 ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
 RUN apt-get update \
-    && apt-get install -y --no-install-recommends ca-certificates git procps bubblewrap \
+    && apt-get install -y --no-install-recommends \
+        bubblewrap \
+        ca-certificates \
+        curl \
+        file \
+        git \
+        iproute2 \
+        jq \
+        openssh-client \
+        procps \
+        python-is-python3 \
+        python3 \
+        ripgrep \
+        unzip \
     && rm -rf /var/lib/apt/lists/* \
     && git config --system init.defaultBranch main \
     && install -d -m 0755 "$PNPM_HOME" "$PNPM_HOME/bin" \

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/gitignore

@@ -6,6 +6,7 @@ target/
 coverage/
 .env
 .template/
+.vitest/
 data/
 playwright-report/
 test-results/

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/pnpm-workspace.yaml

@@ -23,10 +23,13 @@ allowBuilds:
   esbuild: true
 
 catalog:
+  "@vitest/browser-playwright": ^5.0.0
   "@types/node": ^24.13.3
   oxfmt: ^0.71.0
   oxlint: ^1.77.0
   oxlint-tsgolint: ^7.0.2001
+  playwright: 1.64.0
   turbo: 2.11.7
   typescript-7: npm:typescript@^7.0.2
   valibot: ^1.4.2
+  vitest-browser-vue: ^3.1.0

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/scripts/node-test-count-reporter.ts

@@ -0,0 +1,31 @@
+const emptySuiteDiagnostic =
+  "没有执行任何 Node 业务测试用例；请检查测试 glob 与测试内容";
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export default async function* requireExecutedTestCase(
+  events: AsyncIterable<unknown>,
+): AsyncGenerator<string> {
+  let count = 0;
+
+  for await (const event of events) {
+    if (
+      !isRecord(event) ||
+      (event.type !== "test:pass" && event.type !== "test:fail")
+    ) {
+      continue;
+    }
+    const data = event.data;
+    if (!isRecord(data) || typeof data.entryFile !== "string") continue;
+    if (data.skip || data.todo) continue;
+    if (!isRecord(data.details) || data.details.type !== "test") continue;
+    count += 1;
+  }
+
+  if (count === 0) {
+    process.exitCode = 1;
+    yield `${emptySuiteDiagnostic}\n`;
+  }
+}