@givolt/i3-composer-agent 3.2.1 → 4.0.0

package/bin/native-migration.cjs

@@ -7,15 +7,12 @@ const inventory = require('./legacy-native-files.json').files;
 const name = 'i3-composer-agent';
 const publishedFiles = new Set(inventory);
 const retiredSopFingerprints = require('./retired-sop-fingerprints.json').files;
+const retiredCustomFingerprints = require('./retired-custom-fingerprints.json').files;
+const retiredPrototypeRule = 'rules/i3-prototype-entry.md';
+const retiredPrototypeAgent = 'agents/prototype-specialist.md';
 const sopResource = relative => /^skills\/(?:i3-)?enterprise-sop\/references\//.test(relative);
-// Reviewed native bytes from the 99b5eae / 521c958 pilot package. Earlier or
-// edited variants have no reliable content record in layout-3 manifests, so
-// they require manual handling rather than trusting a path-only ownership claim.
-const retiredPrototypeAssets = {
-  'rules/i3-prototype-entry.md': '1c89ad58619968e1826cab31b9f6de29ac04d5fc5b8b1c2a2e1a1b64ec9449af',
-  'agents/prototype-specialist.md': '4d1aa1c6c913694e8a1c7d3373245377899f9cf3f08ec410b40814fa7cda541f',
-};
-
+const retiredCustom = relative => /^skills\/(?:i3-)?ui-prototype\//.test(relative)
+  || Object.hasOwn(retiredCustomFingerprints, relative.replace(/^(evals|hooks|scripts)\/i3-composer-agent\//, `${name}/$1/`));
 function ownsAsset(previous, relative) {
   return previous.assets.some(file => file === relative
     || (!(previous.layoutVersion >= 2) && publishedFiles.has(relative) && relative.startsWith(file + '/')));
@@ -24,8 +21,7 @@ function ownsAsset(previous, relative) {
 function allowed(relative) {
   return typeof relative === 'string' && !relative.includes('\0') && !relative.includes(':') && !relative.includes('\\')
     && !relative.split('/').some(part => ['', '.', '..'].includes(part))
-    && (relative === 'rules/i3-prototype-entry.md'
-      || /^(skills|commands|agents|references|evals|hooks|scripts|docs)\//.test(relative)
+    && (relative === retiredPrototypeRule || /^(skills|commands|agents|references|evals|hooks|scripts|docs)\//.test(relative)
       || relative.startsWith(`${name}/`) || [`${name}-LICENSE`, `${name}-NOTICE.md`].includes(relative));
 }
 
@@ -40,33 +36,76 @@ function fileAt(base, relative) {
   return file;
 }
 
+function lstat(file) {
+  try { return fs.lstatSync(file); }
+  catch (error) { if (error.code !== 'ENOENT') throw error; }
+}
+
+function checkRetiredEntries(target, previous) {
+  for (const relative of [retiredPrototypeRule, retiredPrototypeAgent]) {
+    const owned = previous?.assets.includes(relative);
+    if (!owned && (relative !== retiredPrototypeRule || !target.agents?.some(id => ['codebuddy', 'workbuddy'].includes(id)))) continue;
+    const file = path.join(target.base, relative), stat = lstat(file);
+    if (!stat) continue;
+    if (!owned || !fileAt(target.base, relative) || !stat.isFile()) {
+      throw new Error(`保留了未归属、未知或非普通文件的旧原型入口，请先人工检查：${file}`);
+    }
+  }
+}
+
+// Read-only retirement preconditions, not Hook registration or recovery. The
+// old adapter used this cache instead of the upstream script's default path.
+function assertRetirementSafe(assets, targets = []) {
+  for (const target of targets) checkRetiredEntries(target, {
+    assets: assets.filter(asset => asset.base === target.base && asset.kind === 'legacy').map(asset => asset.relative),
+  });
+  const bases = new Set(assets.filter(asset => asset.kind === 'legacy' && retiredCustom(asset.relative)).map(asset => asset.base));
+  function directory(base, relative) {
+    let file = base;
+    for (const part of relative.split('/')) {
+      file = path.join(file, part);
+      const stat = lstat(file);
+      if (!stat) return;
+      if (stat.isSymbolicLink() || !stat.isDirectory()) throw new Error(`无法安全核对旧 simplify 缓存，保留现场并先人工检查：${file}`);
+    }
+    return file;
+  }
+  for (const base of bases) {
+    const root = directory(base, 'cache/i3-composer-agent/hooks');
+    if (!root) continue;
+    for (const project of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!project.isDirectory() && !project.isSymbolicLink()) continue;
+      const projectCache = directory(root, project.name);
+      if (!projectCache) continue;
+      const eventLock = path.join(projectCache, '.simplify-ignore.event.i3-prototype.lock');
+      if (lstat(eventLock)) throw new Error(`旧 simplify 回调仍在运行，请先结束旧会话并确认代码恢复后再升级；保留现有安装、配置及缓存：${eventLock}`);
+      const cache = directory(projectCache, 'simplify-ignore');
+      if (!cache) continue;
+      const pending = fs.readdirSync(cache).find(name => name.endsWith('.bak') || name.endsWith('.lock'));
+      if (pending) throw new Error(`旧 simplify 保护尚未恢复或仍在运行，请先结束旧会话并确认代码恢复后再升级；保留现有安装、配置及缓存：${path.join(cache, pending)}`);
+    }
+  }
+}
+
 function migrationAssets(target, previous, current) {
   const assets = [];
   const oldFiles = new Set();
   const retired = new Set();
   const base = target.base;
-  for (const [relative, expectedFingerprint] of Object.entries(retiredPrototypeAssets)) {
-    if (current.has(relative)) continue;
-    const file = fileAt(base, relative);
-    let present;
-    try { present = fs.lstatSync(path.join(base, relative)); }
-    catch (error) { if (error.code === 'ENOENT') continue; throw error; }
-    const owned = previous?.assets.includes(relative);
-    // Keep the existing protection for unowned CodeBuddy rules. A user-created
-    // Agent with this name is outside our catalog and must not be claimed.
-    if (!owned && relative.startsWith('agents/')) continue;
-    if (!owned && !target.agents?.includes('codebuddy')) continue;
-    if (!owned || !file || !present.isFile() || fingerprint(file) !== expectedFingerprint) {
-      throw new Error(`保留了已修改、未知或未归属本包的旧原型入口，不能自动退出；请先检查并手动处理后重试：${path.join(base, relative)}`);
-    }
-  }
+  checkRetiredEntries(target, previous);
   if (!previous) return [];
   function retire(relative) {
     if (retired.has(relative) || current.has(relative)) return;
     const file = fileAt(base, relative);
     if (!file || !fs.statSync(file).isFile()) return;
-    let retiredFingerprint = retiredPrototypeAssets[relative];
-    if (/^(?:i3-composer-agent\/)?references\/(?:enterprise-sop-resources|engineering-skeleton-resources)\//.test(relative)) {
+    let retiredFingerprint;
+    if (retiredCustom(relative)) {
+      const observed = fingerprint(file);
+      if (!retiredCustomFingerprints[relative]?.includes(observed)) {
+        throw new Error(`保留了已修改或来源未知的旧定制资产，请先比较并明确处理：${file}`);
+      }
+      retiredFingerprint = observed;
+    } else if (/^(?:i3-composer-agent\/)?references\/(?:enterprise-sop-resources|engineering-skeleton-resources)\//.test(relative)) {
       const expected = retiredSopFingerprints[relative];
       const observed = fingerprint(file);
       if (!expected?.includes(observed)) {
@@ -123,6 +162,7 @@ function migrationAssets(target, previous, current) {
     }
     if (fileAt(base, `evals/${name}`)) visit(oldEvals);
   }
+  assertRetirementSafe(assets);
   return assets;
 }
 
@@ -137,4 +177,4 @@ function pruneRetiredDirectories(assets) {
   }
 }
 
-module.exports = { migrationAssets, pruneRetiredDirectories, ownsAsset, sopResource };
+module.exports = { migrationAssets, pruneRetiredDirectories, ownsAsset, sopResource, assertRetirementSafe };