create-yss-spec 3.5.4 → 3.5.6

package/vendor/cli-core/spec-migration-adapter.mjs

@@ -0,0 +1,83 @@
+import * as fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {createRequire} from 'node:module';
+import {hash,ensure,same,descriptor,write} from './io.mjs';
+import {inventory,copyCandidate,migration,parseMigration,assertUpgradeVersion} from './migrate.mjs';
+import {verifyCore} from './build.mjs';
+export function specAdapter(packageRoot) {
+  verifyCore(packageRoot);
+  const require=createRequire(path.join(packageRoot,'package.json'));
+  const {buildSyncContext,applySyncContext}=require('./src/api/_sync-service');
+  const {verifyGeneratedProjectInstance,refreshGeneratedProjectInstance,readProjectSkillLock}=require('./src/template/verification-runtime');
+  const {readTemplateSnapshot}=require('./src/template/instance-runtime');
+  const pkg=require('./package.json'),snapshot=readTemplateSnapshot();
+  const family={side:'spec',packageName:'create-yss-spec',profileId:'harness.spec-template',metadataFile:'.yss-template.json'};
+  const fingerprint=hash(JSON.stringify({pkg,snapshot,src:inventory(path.join(packageRoot,'src')),driver:inventory(path.join(packageRoot,'vendor/cli-core'))}));
+  return {family,fingerprint,template:{version:pkg.version,...snapshot},
+    check(root,opts){const c=buildSyncContext({targetDir:root,migrateLayout:opts.migrateLayout});assertUpgradeVersion(c.metadata.cliVersion || c.metadata.templateVersion,pkg.version);},
+    prepare(root,opts,id,time){
+      const context=buildSyncContext({targetDir:root,migrateLayout:opts.migrateLayout});
+      const resolutions={...(opts.resolutions || {})}, conflictMap=new Map(context.syncPlan.forceableConflicts.map(o=>[o.relativePath,o]));
+      for(const op of context.syncPlan.forceableConflicts){
+        const saved=context.metadata.managedFiles[op.relativePath]?.migrationCustomization;
+        if(!resolutions[op.relativePath] && saved?.templateDigest===op.desiredHash && saved.contentDigest===context.syncPlan.currentHashes[op.relativePath])
+          resolutions[op.relativePath]={action:'preserve',beforeDigest:saved.contentDigest,templateDigest:saved.templateDigest};
+      }
+      const unresolved=context.syncPlan.conflicts.filter(o=>!resolutions[o.relativePath]);
+      if(unresolved.length)throw Object.assign(new Error(`治理文件冲突，需逐项决议: ${unresolved.map(o=>o.relativePath).join(', ')}`),{code:'CONFLICT',result:{conflicts:unresolved.map(o=>({path:o.relativePath,beforeDigest:context.syncPlan.currentHashes[o.relativePath],templateDigest:o.desiredHash,resolutionSupported:conflictMap.has(o.relativePath)}))}});
+      for(const [ref,r]of Object.entries(resolutions)) {
+        const op=conflictMap.get(ref);
+        ensure(op && context.metadata.managedFiles[ref] && r.beforeDigest===context.syncPlan.currentHashes[ref] && r.templateDigest===op.desiredHash,`非可信或过期的冲突决议: ${ref}`,'CONFLICT');
+        ensure(['preserve','merge'].includes(r.action) && (r.action!=='merge' || typeof r.contentBase64==='string'),'冲突决议非法','CONFLICT');
+      }
+      const scratch=fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(),'yss-spec-migration-')));
+      try {
+        const before=inventory(root);delete before['.yss-harness-migrate.lock'];copyCandidate(root,scratch,before);
+        const stage=buildSyncContext({targetDir:scratch,migrateLayout:opts.migrateLayout});
+        stage.syncPlan.forceableConflicts=stage.syncPlan.forceableConflicts.filter(o=>resolutions[o.relativePath]?.action==='merge');
+        const applied=applySyncContext(stage,{force:stage.syncPlan.forceableConflicts.length>0,prune:opts.prune});
+        try {
+          const merged=Object.entries(resolutions).filter(([,r])=>r.action==='merge');
+          if(merged.length){
+            const lock=readProjectSkillLock(scratch);
+            for(const [ref,r] of merged)write(scratch,ref,Buffer.from(r.contentBase64,'base64'),descriptor(root,ref).mode);
+            // Regenerate from merged skill bytes; historical upstream baselines remain unchanged.
+            const transaction={writeFile:(p,bytes)=>fs.writeFileSync(p,bytes),prepare(){},mark(){},ensureParent:p=>fs.mkdirSync(path.dirname(p),{recursive:true})};
+            refreshGeneratedProjectInstance(scratch,{previousSkillLock:lock,previousManagedFiles:stage.metadata.managedFiles,transaction});
+            verifyGeneratedProjectInstance(scratch);
+          }
+          const metaFile=path.join(scratch,family.metadataFile),meta=JSON.parse(fs.readFileSync(metaFile));
+          for(const [ref,r] of Object.entries(resolutions)) {
+            // Keep the upstream baseline separate from explicitly accepted local content.
+            meta.managedFiles[ref]={...context.metadata.managedFiles[ref],contentHash:r.templateDigest,migrationCustomization:{templateDigest:r.templateDigest,contentDigest:hash(fs.readFileSync(path.join(scratch,ref)))}};
+          }
+          const prior=JSON.parse(fs.readFileSync(path.join(root,family.metadataFile)));
+          meta.lastSyncedAt=prior.lastSyncedAt;
+          if(JSON.stringify(meta)!==JSON.stringify(prior))meta.lastSyncedAt=time;
+          fs.writeFileSync(metaFile,JSON.stringify(meta,null,2)+'\n');
+          const after=inventory(scratch),operations=[];
+          for(const ref of [...new Set([...Object.keys(before),...Object.keys(after)])].sort()) {
+            const a=before[ref] || null,b=after[ref] || null;
+            if(a?.type==='directory' || b?.type==='directory')continue;
+            if(a?.type==='symlink' || b?.type==='symlink'){ensure(JSON.stringify(a)===JSON.stringify(b),'候选改变符号链接','PATH');continue;}
+            if(!same(a,b))operations.push({path:ref,before:a,after:b,bytes:b?fs.readFileSync(path.join(scratch,ref)):undefined});
+          }
+          operations.sort((a,b)=>(a.path===family.metadataFile?1:0)-(b.path===family.metadataFile?1:0));
+          return {operations,changes:context.plan.changes};
+        }finally{if(applied.backupPath)fs.rmSync(applied.backupPath,{recursive:true,force:true});}
+      }finally{fs.rmSync(scratch,{recursive:true,force:true});}
+    },
+    verify(root){
+      const scratch=fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(),'yss-spec-verify-')));
+      try{const tree=inventory(root);delete tree['.yss-harness-migrate.lock'];copyCandidate(root,scratch,tree);verifyGeneratedProjectInstance(scratch);return [{name:'project-instance',status:'passed',location:'isolated-copy'}];}
+      finally{fs.rmSync(scratch,{recursive:true,force:true});}
+    },
+  };
+}
+export function runSpecMigration(packageRoot,args){
+ const {command,opts}=parseMigration(args),require=createRequire(path.join(packageRoot,'package.json'));
+ const {withVerificationOutput}=require('./src/template/verification-runtime'),logs=[];
+ const result=withVerificationOutput(text=>logs.push(text),()=>migration(specAdapter(packageRoot),command,opts));
+ return {...result,...(logs.length?{verificationLog:logs.join('')}:{})};
+}

package/vendor/cli-core/tests/build.test.mjs

@@ -0,0 +1,40 @@
+import {test} from 'node:test';
+import assert from 'node:assert/strict';
+import * as fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {spawnSync} from 'node:child_process';
+import {syncCore,syncTemplate,verifyCore} from '../build.mjs';
+import {loadBundle} from '../bundle.mjs';
+const put=(root,ref,bytes)=>{fs.mkdirSync(path.dirname(path.join(root,ref)),{recursive:true});fs.writeFileSync(path.join(root,ref),bytes);};
+test('战略 YAML 清单投影、固定来源与 WORKTREE 仅在临时副本构建',t=>{
+ const tmp=fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(),'harness-build-')));t.after(()=>fs.rmSync(tmp,{recursive:true,force:true}));
+ const source=path.join(tmp,'source'),pkg=path.join(tmp,'package');
+ fs.mkdirSync(source);put(pkg,'package.json',JSON.stringify({name:'create-yss-harness-design',version:'0.6.0'}));
+ fs.cpSync(path.resolve(import.meta.dirname,'..'),path.join(source,'.template-source/cli-core'),{recursive:true});
+ for(const name of ['README.md','AGENTS.md','CONTEXT.md','DESIGN.md'])put(source,name,name+'\n');
+ put(source,'yss-project.yaml','schema_version: 1\nrepository_mode: template-source\n');
+ put(source,'.template-spec/process/harness-profile.yaml','schema_version: 2\nprofile_id: harness.business-ddd-strategy-handoff\n');
+ put(source,'.template-spec/user-guide/retired.md','retired handbook\n');
+ put(source,'.template-spec/user-guide/current.md','current handbook v1\n');
+ put(source,'.template-spec/process/instance-distribution-manifest.yaml',`schema_version: 1
+profile_id: harness.business-ddd-strategy-handoff
+cli_package: create-yss-harness-design
+template_source: github:iloveZzz/yss-harness-design-agent
+allow_root_entries: [.template-spec]
+allow_root_files: [README.md, AGENTS.md, CONTEXT.md, DESIGN.md, yss-project.yaml]
+exclude_root_entries: [.git, .template-source]
+render_paths: [README.md, AGENTS.md, yss-project.yaml]
+`);
+ const git=(...args)=>{const r=spawnSync('git',['-C',source,...args],{encoding:'utf8'});assert.equal(r.status,0,r.stderr);return r.stdout.trim();};
+ git('init','--initial-branch=main');git('add','.');git('-c','user.name=Fixture','-c','user.email=fixture@example.invalid','commit','-m','fixture');
+ const ref=git('rev-parse','HEAD');syncCore(source,ref,pkg);syncTemplate(source,ref,pkg);verifyCore(pkg);loadBundle(pkg);
+ const before=fs.readFileSync(path.join(pkg,'template.snapshot.json'));
+ put(source,'DESIGN.md','worktree changes\n');syncTemplate(source,ref,pkg,true);assert.deepEqual(fs.readFileSync(path.join(pkg,'template.snapshot.json')),before);
+ fs.rmSync(path.join(source,'.template-spec/user-guide/retired.md'));
+ put(source,'.template-spec/user-guide/current.md','current handbook v2\n');
+ syncTemplate(source,'WORKTREE',pkg);const worktreeBundle=loadBundle(pkg);assert.equal(worktreeBundle.snapshot.sourceState,'working-tree');
+ assert.equal(worktreeBundle.retiredFiles['.template-spec/user-guide/retired.md'].digest.length,64);
+ assert.equal(worktreeBundle.transitionBaselines['.template-spec/user-guide/current.md'].digest.length,64);
+ assert.throws(()=>syncTemplate(source,ref,pkg,true),/漂移/);
+});