create-yss-spec 2.1.1 → 2.1.3

package/README.md

@@ -33,7 +33,7 @@ npx create-yss-spec@latest
 - 旧、新资产内容冲突或清单 schema / mode 非法时 fail closed
 - 保留模板的共享 skill 投影；生成实例可在尚未 `git init` 时运行模板校验
 
-本次新增能力按 `2.1.1` 发布。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。
+本次新增能力按 `2.1.3` 发布。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。
 
 ## 接管已有项目
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yss-spec",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Initialize a YSS spec project template repository",
   "repository": {
     "type": "git",

package/src/cli.js

@@ -4,6 +4,7 @@ const os = require("node:os");
 const path = require("node:path");
 const readline = require("node:readline/promises");
 const { spawnSync } = require("node:child_process");
+const { treeHash } = require("./template-hash");
 
 const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const PACKAGE_MANIFEST = JSON.parse(
@@ -489,35 +490,6 @@ function fileHash(filePath) {
   return sha256(fs.readFileSync(filePath));
 }
 
-function treeHash(rootPath) {
-  const digest = crypto.createHash("sha256");
-
-  function visit(currentPath, relativeDir = "") {
-    for (const entry of fs
-      .readdirSync(currentPath, { withFileTypes: true })
-      .sort((left, right) => left.name.localeCompare(right.name))) {
-      if (entry.name === ".DS_Store") {
-        continue;
-      }
-      const relativePath = relativeDir
-        ? `${relativeDir}/${entry.name}`
-        : entry.name;
-      const absolutePath = path.join(currentPath, entry.name);
-      if (entry.isDirectory()) {
-        digest.update(`dir:${relativePath}\0`);
-        visit(absolutePath, relativePath);
-      } else if (entry.isFile()) {
-        digest.update(`file:${relativePath}\0`);
-        digest.update(fs.readFileSync(absolutePath));
-        digest.update("\0");
-      }
-    }
-  }
-
-  visit(rootPath);
-  return digest.digest("hex");
-}
-
 function pathKind(absolutePath) {
   let stat;
   try {

package/src/template-hash.js

@@ -0,0 +1,44 @@
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const path = require("node:path");
+
+function compareNames(left, right) {
+  if (left < right) {
+    return -1;
+  }
+  if (left > right) {
+    return 1;
+  }
+  return 0;
+}
+
+function treeHash(rootPath) {
+  const digest = crypto.createHash("sha256");
+
+  function visit(currentPath, relativeDir = "") {
+    for (const entry of fs
+      .readdirSync(currentPath, { withFileTypes: true })
+      .sort((left, right) => compareNames(left.name, right.name))) {
+      if (entry.name === ".DS_Store") {
+        continue;
+      }
+      const relativePath = relativeDir
+        ? `${relativeDir}/${entry.name}`
+        : entry.name;
+      const absolutePath = path.join(currentPath, entry.name);
+      if (entry.isDirectory()) {
+        digest.update(`dir:${relativePath}\0`);
+        visit(absolutePath, relativePath);
+      } else if (entry.isFile()) {
+        digest.update(`file:${relativePath}\0`);
+        digest.update(fs.readFileSync(absolutePath));
+        digest.update("\0");
+      }
+    }
+  }
+
+  visit(rootPath);
+  return digest.digest("hex");
+}
+
+module.exports = { treeHash };

package/template/scripts/verify-template

@@ -4,7 +4,13 @@ set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$ROOT_DIR"
 
+# Ruby inherits US-ASCII under a C locale on some macOS installations. Keep
+# all verification scripts UTF-8 capable because the template contains Chinese
+# documentation and skill metadata.
+export RUBYOPT="${RUBYOPT:+$RUBYOPT }-EUTF-8:UTF-8"
+
 ruby <<'RUBY'
+# encoding: UTF-8
 require "pathname"
 require "yaml"
 
@@ -84,6 +90,7 @@ for skill_name in "${required_skills[@]}"; do
 done
 
 ruby <<'RUBY'
+# encoding: UTF-8
 require "json"
 require "pathname"
 require "yaml"
@@ -113,7 +120,7 @@ lock.fetch("skills", {}).fetch("shared", {}).each do |skill_name, metadata|
 end
 
 openapi_path = root.join("docs/templates/openapi-spec-template.yaml")
-openapi_text = openapi_path.read.sub(/\A---\n.*?\n---\n/m, "")
+openapi_text = openapi_path.binread.force_encoding("UTF-8").sub(/\A---\n.*?\n---\n/m, "")
 YAML.safe_load(openapi_text, permitted_classes: [], aliases: true)
 RUBY
 
@@ -128,6 +135,7 @@ scripts/verify-yss-router-scenarios
 scripts/verify-yss-ui-scenarios
 
 ruby <<'RUBY'
+# encoding: UTF-8
 require "pathname"
 require "json"
 
@@ -225,8 +233,8 @@ unless legacy_hits.empty?
   exit 1
 end
 
-unless root.join("AGENTS.md").read.include?("正文统一使用简体中文") &&
-       root.join("CONTEXT.md").read.include?("统一使用简体中文")
+unless root.join("AGENTS.md").binread.force_encoding("UTF-8").include?("正文统一使用简体中文") &&
+       root.join("CONTEXT.md").binread.force_encoding("UTF-8").include?("统一使用简体中文")
   abort("AGENTS.md 与 CONTEXT.md 必须共同声明落地文档使用简体中文")
 end
 

package/template.snapshot.json

@@ -3,8 +3,8 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "b61c5668d717822c2a69a8e8327fc45b1891b29b",
-  "templateCommit": "b61c5668d717822c2a69a8e8327fc45b1891b29b",
+  "requestedRef": "41c68b545caaa439a999ec9d6786bf80a06c70ba",
+  "templateCommit": "41c68b545caaa439a999ec9d6786bf80a06c70ba",
   "encodedPaths": {
     ".agents/skills/beautiful-article/assets/scaffold-template/.npmrc": ".agents/skills/beautiful-article/assets/scaffold-template/__yss_dotfile__.npmrc",
     ".agents/skills/drawio-academic-skills/.gitignore": ".agents/skills/drawio-academic-skills/__yss_dotfile__.gitignore",
@@ -32,6 +32,6 @@
     ".trae/skills/drawio-academic-skills/.gitignore": ".trae/skills/drawio-academic-skills/__yss_dotfile__.gitignore",
     ".trae/skills/excalidraw-diagram-generator/scripts/.gitignore": ".trae/skills/excalidraw-diagram-generator/scripts/__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "9f1c896eb5a1856954b3358b7208bd1e2627d4c888cf061dc9f207e2eb2bbeae",
-  "generatedAt": "2026-08-13T05:09:40.431Z"
+  "snapshotHash": "8817d7689fe6ac5fff6c94ada86f7db25394133a7094108afefcde24fffcfaa5",
+  "generatedAt": "2026-08-14T06:23:07.847Z"
 }