create-yss-spec 3.5.5 → 3.5.6

package/README.md

@@ -191,6 +191,8 @@ npm pack --dry-run
 
 ## 固定计划实例迁移
 
+创建实例时默认安装 `yss-harness-upgrade`；已有实例执行 `sync` 时自动补齐该技能、已选择运行时的投影和升级协议，并更新技能锁与分发登记。`sync --dry-run` 只预览，不安装。补装保留原有技能、运行时和阶段选择。
+
 `migrate plan --target-dir <项目绝对路径> --output <项目外新计划.json>` 生成项目只读计划；`migrate apply --plan <计划>` 执行固定候选并保存持久归档。计划后输入变化必须重新规划。需要旧布局迁移或安全退出分发清理时，规划阶段显式加入 `--migrate-layout` / `--prune`。
 
 `migrate status` 查看状态；`migrate recover` 预览中断恢复，`migrate rollback` 预览最近一次成功迁移的整体回退，均需显式 `--apply` 才写入。后续修改、跨家族、未知基线及损坏归档阻断，禁止用 force 绕过。所有新接口支持 `--json`。

package/cli-core.lock.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "sourceRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "sourceRevision": "b98bafda74fc60c2b41c6020e3d41d84a4f1b1b7",
+  "sourceRevision": "dd58fc3929b3958579ac8a426f06f087682f2f6c",
   "sourceState": "committed",
   "sourcePath": ".template-source/cli-core",
   "coreVersion": "0.2.0",
@@ -84,7 +84,7 @@
       "mode": 420
     },
     "tests/package-contract.mjs": {
-      "digest": "812129d3c327515269ed2aff08fec97049aa306b65f752d47a3cd004a168be72",
+      "digest": "ce8fcaa4e4f4498e2f4f49e86c9ab455b54c9ce386fe0911396ffe8f5eb6ff49",
       "mode": 420
     },
     "transaction.mjs": {
@@ -112,7 +112,7 @@
       "mode": 420
     }
   },
-  "digest": "f5199dba3f9dc94a9b2e92a8b4d65d0633a5a3dfc489d88d30cb461204b8d63d",
+  "digest": "9a4cfce884a706efa91ae8dd8dc2fc82cd7d17e8a84f633bdb049ea531436ae1",
   "upgradeResources": {
     "SKILL.md": {
       "digest": "40495ca033ebd0345363714e45571ee77258a435ea1523ae716dc2402ced0487",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yss-spec",
-  "version": "3.5.5",
+  "version": "3.5.6",
   "description": "Initialize a YSS spec project template repository",
   "main": "src/api/index.js",
   "repository": {

package/src/template/asset-runtime.js

@@ -244,7 +244,9 @@ function assetPaths(root, distribution) {
     for (const ref of bundle.files || []) addFile(root, result, ref);
     for (const ref of bundle.scripts || []) moduleClosure(root, result, ref, selectedSkills);
   }
-  for (const skill of distribution.resourceSkills || []) skillReferences(root, result, skill, selectedSkills);
+  const resourceSkills = new Set(distribution.resourceSkills || []);
+  if (selectedSkills.has("yss-harness-upgrade")) resourceSkills.add("yss-harness-upgrade");
+  for (const skill of resourceSkills) skillReferences(root, result, skill, selectedSkills);
   return result;
 }
 

package/src/template/instance-runtime.js

@@ -275,7 +275,9 @@ function buildSyncVariables(metadata) {
       variables.includeExampleDocs === undefined
         ? !(metadata.metadataSchemaVersion >= 3)
         : Boolean(variables.includeExampleDocs),
-    distribution: metadata.metadataSchemaVersion >= 3 ? metadata.distribution : { mode: "legacy-all" },
+    distribution: metadata.metadataSchemaVersion >= 3 && metadata.distribution?.mode === "selected"
+      ? { ...metadata.distribution, installedSkills: [...new Set([...metadata.distribution.installedSkills, "yss-harness-upgrade"])] }
+      : metadata.metadataSchemaVersion >= 3 ? metadata.distribution : { mode: "legacy-all" },
   };
 }
 
@@ -495,7 +497,7 @@ function buildNextSyncMetadata(metadata, syncPlan, {
   return {
     ...metadata,
     metadataSchemaVersion: METADATA_SCHEMA_VERSION,
-    distribution: metadata.metadataSchemaVersion >= 3 ? metadata.distribution : { mode: "legacy-all" },
+    distribution: buildSyncVariables(metadata).distribution,
     templateName: PACKAGE_MANIFEST.name,
     cliVersion: PACKAGE_MANIFEST.version,
     templateVersion: PACKAGE_MANIFEST.version,

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": "b98bafda74fc60c2b41c6020e3d41d84a4f1b1b7",
-  "templateCommit": "b98bafda74fc60c2b41c6020e3d41d84a4f1b1b7",
+  "requestedRef": "dd58fc3929b3958579ac8a426f06f087682f2f6c",
+  "templateCommit": "dd58fc3929b3958579ac8a426f06f087682f2f6c",
   "sourceState": "committed",
   "manifestHash": "544e8ae01c49ef451a784237b06772137876f8e8d6b5334094827e2ca2fe0f13",
   "encodedPaths": {
@@ -17,5 +17,5 @@
     ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore"
   },
   "snapshotHash": "e97773b2461a3bb7a35551a1f97371af689b94f281bbdb7a635e687d5239b405",
-  "generatedAt": "2026-10-01T14:00:46.523Z"
+  "generatedAt": "2026-10-01T15:17:35.092Z"
 }

package/vendor/cli-core/tests/package-contract.mjs

@@ -27,6 +27,19 @@ export function packageContract(root) {
   verifyCore(root);loadBundle(root);
   success(run('init',[...init,'--dry-run']));assert.equal(fs.existsSync(target),false);
   success(run('init',init));
+  const upgrade='yss-harness-upgrade',protocol='.template-spec/process/harness-upgrade.md';
+  const checkUpgrade=()=>{
+   const lock=JSON.parse(fs.readFileSync(path.join(target,'skills-lock.json')));
+   assert.ok(lock.skills.shared[upgrade]);
+   for(const base of ['.agents/skills',...lock.projectionRoots])for(const ref of ['SKILL.md','references/cli-families.md'])assert.ok(fs.existsSync(path.join(target,base,upgrade,ref)));
+   assert.ok(fs.existsSync(path.join(target,protocol)));
+  };
+  checkUpgrade();
+  // Reproduce an older instance whose managed baseline did not include this skill.
+  const oldMeta=JSON.parse(fs.readFileSync(path.join(target,family.metadataFile)));
+  for(const ref of Object.keys(oldMeta.managedFiles))if(ref.includes('/'+upgrade+'/')||ref===protocol){fs.rmSync(path.join(target,ref),{force:true});delete oldMeta.managedFiles[ref];}
+  oldMeta.baselineDigest=hash(JSON.stringify(oldMeta.managedFiles));fs.writeFileSync(path.join(target,family.metadataFile),JSON.stringify(oldMeta,null,2)+'\n');
+  const oldLock=JSON.parse(fs.readFileSync(path.join(target,'skills-lock.json')));delete oldLock.skills.shared[upgrade];fs.writeFileSync(path.join(target,'skills-lock.json'),JSON.stringify(oldLock,null,2)+'\n');
   const readme=path.join(target,'README.md'),context=path.join(target,'CONTEXT.md'),metadata=path.join(target,family.metadataFile);
   fs.writeFileSync(readme,'# 用户文档\n');
   const contextBefore=fs.readFileSync(context);
@@ -36,6 +49,7 @@ export function packageContract(root) {
   success(run('sync',['--plan','--prune']));
   assert.deepEqual(fs.readFileSync(metadata),before);assert.equal(journalCount(),count);
   success(run('sync',['--apply','--prune']));
+  checkUpgrade();
   assert.equal(fs.readFileSync(readme,'utf8'),'# 用户文档\n');assert.deepEqual(fs.readFileSync(context),contextBefore);
   before=fs.readFileSync(metadata);success(run('sync',['--apply']));assert.deepEqual(fs.readFileSync(metadata),before);
   if(family.side==='design') {