@routerhub/agent-rules 1.5.52 → 1.5.53

package/merge.js

@@ -48,6 +48,26 @@ function ensureParentDir(filePath) {
   fs.mkdirSync(parentDir, { recursive: true });
 }
 
+/**
+ * 更新 .agent-rules-version 版本标记文件
+ * 供 postinstall 判断已安装版本是否与上次同步版本一致，避免重复同步
+ */
+function updateVersionMarker() {
+  try {
+    const currentVersion = JSON.parse(
+      fs.readFileSync(path.join(packageRoot, "package.json"), "utf-8")
+    ).version;
+    fs.writeFileSync(
+      path.join(currentRoot, ".agent-rules-version"),
+      currentVersion,
+      "utf-8"
+    );
+  } catch (e) {
+    // 非关键操作，写入失败不阻塞主流程
+    console.warn("[agent-rules] 版本标记写入失败:", e.message);
+  }
+}
+
 function resolveOutputPaths(config) {
   if (Array.isArray(config.outputs) && config.outputs.length > 0) {
     return config.outputs;
@@ -517,6 +537,7 @@ function initAgents() {
   const privateOutputPath = path.join(currentRoot, "AGENTS.private.md");
 
   mergeAgents(getDefaultConfig());
+  updateVersionMarker();
 
   if (!fs.existsSync(privateOutputPath) && fs.existsSync(privateTemplatePath)) {
     fs.copyFileSync(privateTemplatePath, privateOutputPath);
@@ -656,6 +677,7 @@ function main() {
 
   if (command === "sync") {
     mergeAgents(getDefaultConfig());
+    updateVersionMarker();
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.52",
+  "version": "1.5.53",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {

package/postinstall.js

@@ -59,17 +59,54 @@ if (projectRoot.includes("node_modules")) {
   process.exit(0);
 }
 
-// 确保下游项目 .npmrc 中关闭 frozen-lockfile，让 pnpm install 能直接在版本更新后执行
+// 确保下游项目 .npmrc 中关闭 frozen-lockfile + 启用依赖 pre/post 脚本
+// frozen-lockfile=false：让 pnpm install 能在版本更新后直接执行
+// enable-pre-post-scripts=true：让 pnpm 始终执行依赖包的 postinstall 生命周期脚本，
+//   否则 pnpm 默认不会运行依赖的 postinstall，导致 agent-rules 更新后规则文件不刷新
 const npmrcPath = path.join(projectRoot, ".npmrc");
 let npmrcContent = "";
 if (fs.existsSync(npmrcPath)) {
   npmrcContent = fs.readFileSync(npmrcPath, "utf-8");
 }
+const npmrcEntries = [];
 if (!npmrcContent.includes("frozen-lockfile")) {
-  const newEntry =
-    "\n# 允许 pnpm install 在依赖版本更新后直接执行（由 agent-rules 自动添加）\nfrozen-lockfile=false\n";
+  npmrcEntries.push("# 允许 pnpm install 在依赖版本更新后直接执行（由 agent-rules 自动添加）");
+  npmrcEntries.push("frozen-lockfile=false");
+}
+if (!npmrcContent.includes("enable-pre-post-scripts")) {
+  npmrcEntries.push("# 确保依赖包的 postinstall 生命周期脚本始终执行（由 agent-rules 自动添加）");
+  npmrcEntries.push("enable-pre-post-scripts=true");
+}
+if (npmrcEntries.length > 0) {
+  const newEntry = "\n" + npmrcEntries.join("\n") + "\n";
   fs.appendFileSync(npmrcPath, newEntry);
-  console.log("[agent-rules] 已配置 .npmrc: frozen-lockfile=false");
+  console.log("[agent-rules] 已配置 .npmrc: " + npmrcEntries.filter((e) => !e.startsWith("#")).join(", "));
+}
+
+// 版本标记机制：比较已安装版本与上次同步的版本
+//   相同 → 跳过同步（避免每次 pnpm install 都重复生成）
+//   不同/不存在 → 执行同步并更新版本标记
+const versionMarkerPath = path.join(projectRoot, ".agent-rules-version");
+const currentVersion = JSON.parse(
+  fs.readFileSync(path.join(packageRoot, "package.json"), "utf-8")
+).version;
+let needsSync = true;
+
+if (fs.existsSync(versionMarkerPath)) {
+  const lastVersion = fs.readFileSync(versionMarkerPath, "utf-8").trim();
+  if (lastVersion === currentVersion) {
+    needsSync = false;
+    console.log("[agent-rules] 版本未变更 (" + currentVersion + ")，跳过同步");
+  } else {
+    console.log("[agent-rules] 版本变更: " + lastVersion + " → " + currentVersion + "，执行同步...");
+  }
+} else {
+  console.log("[agent-rules] 首次安装 (v" + currentVersion + ")，执行同步...");
+}
+
+if (!needsSync) {
+  console.log("");
+  process.exit(0);
 }
 
 console.log("");
@@ -83,7 +120,9 @@ const syncProcess = spawn("node", [mergeScriptPath, "init"], {
 
 syncProcess.on("close", (code) => {
   if (code === 0) {
-    console.log("[agent-rules] 规则文件初始化完成");
+    // 同步成功后写入版本标记，下次 postinstall 时比较版本号避免重复同步
+    fs.writeFileSync(versionMarkerPath, currentVersion, "utf-8");
+    console.log("[agent-rules] 规则文件初始化完成 (v" + currentVersion + ")");
     console.log("");
   } else {
     console.error("[agent-rules] 初始化失败，退出码:", code);