prd-workflow-cli 1.1.25 → 1.1.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prd-workflow-cli",
-  "version": "1.1.25",
+  "version": "1.1.27",
   "description": "产品需求管理规范 CLI 工具 - 基于 A→R→B→C 流程，集成 PM 确认机制和对话归档的需求管理命令行工具",
   "main": "index.js",
   "bin": {

package/scripts/postinstall.js

@@ -2,14 +2,15 @@
 
 /**
  * postinstall 脚本
- * 在 npm install 完成后自动执行，更新项目中的 workflows 和规则文件
+ * 在 npm install 完成后自动执行，复制 workflows 和规则文件到项目中
  */
 
 const fs = require('fs');
 const path = require('path');
 
-// 静默模式运行（减少安装时的输出噪音）
+// 静默模式运行
 const SILENT = process.env.PRD_POSTINSTALL_SILENT === 'true';
+const DEBUG = process.env.PRD_DEBUG === 'true';
 
 function log(msg) {
     if (!SILENT) {
@@ -17,27 +18,14 @@ function log(msg) {
     }
 }
 
-function logError(msg) {
-    // 错误始终输出
-    console.error(msg);
-}
-
-/**
- * 获取项目根目录（向上查找包含 .prd-config.json 的目录）
- */
-function findProjectRoot(startDir) {
-    let currentDir = startDir;
-    const root = path.parse(currentDir).root;
-
-    while (currentDir !== root) {
-        const configPath = path.join(currentDir, '.prd-config.json');
-        if (fs.existsSync(configPath)) {
-            return currentDir;
-        }
-        currentDir = path.dirname(currentDir);
+function debug(msg) {
+    if (DEBUG) {
+        console.log('[DEBUG]', msg);
     }
+}
 
-    return null;
+function logError(msg) {
+    console.error(msg);
 }
 
 /**
@@ -57,28 +45,6 @@ function filesAreDifferent(sourcePath, targetPath) {
     }
 }
 
-/**
- * 递归复制目录
- */
-function copyDirSync(src, dest) {
-    if (!fs.existsSync(dest)) {
-        fs.mkdirSync(dest, { recursive: true });
-    }
-
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-
-    for (const entry of entries) {
-        const srcPath = path.join(src, entry.name);
-        const destPath = path.join(dest, entry.name);
-
-        if (entry.isDirectory()) {
-            copyDirSync(srcPath, destPath);
-        } else {
-            fs.copyFileSync(srcPath, destPath);
-        }
-    }
-}
-
 /**
  * 获取目录下所有文件（递归）
  */
@@ -107,31 +73,81 @@ function getAllFiles(dirPath, basePath = dirPath) {
     return files;
 }
 
+/**
+ * 检查是否是全局安装
+ */
+function isGlobalInstall(packagePath) {
+    // 全局安装的路径通常包含 lib/node_modules 或类似结构
+    // 本地安装的路径是 项目/node_modules/包名
+    const normalizedPath = packagePath.toLowerCase();
+
+    // 检查是否在项目的 node_modules 中
+    const pathParts = packagePath.split(path.sep);
+    const nodeModulesIndex = pathParts.lastIndexOf('node_modules');
+
+    if (nodeModulesIndex === -1) {
+        return true; // 不在 node_modules 中，可能是开发环境
+    }
+
+    // 检查 node_modules 前面是否有 lib 目录（全局安装的特征）
+    if (nodeModulesIndex > 0 && pathParts[nodeModulesIndex - 1] === 'lib') {
+        return true;
+    }
+
+    // 检查是否在 /usr/local 或 /opt 等系统目录下
+    if (normalizedPath.includes('/usr/') || normalizedPath.includes('/opt/')) {
+        return true;
+    }
+
+    return false;
+}
+
 /**
  * 主函数
  */
 function main() {
     try {
-        // 获取 npm 包的路径（当前脚本所在目录的上级）
+        // 获取 npm 包的路径
+        // 脚本路径: node_modules/prd-workflow-cli/scripts/postinstall.js
+        // __dirname = node_modules/prd-workflow-cli/scripts
+        // packagePath = node_modules/prd-workflow-cli
         const packagePath = path.join(__dirname, '..');
 
-        // 尝试找到项目根目录
-        // 通常 node_modules 在项目根目录下，所以向上查找
-        const nodeModulesPath = path.dirname(path.dirname(packagePath));
-        const potentialProjectRoot = path.dirname(nodeModulesPath);
+        debug(`packagePath = ${packagePath}`);
 
-        // 检查是否是 PRD 项目
-        const projectRoot = findProjectRoot(potentialProjectRoot);
+        // 检查是否是全局安装
+        if (isGlobalInstall(packagePath)) {
+            debug('检测到全局安装，跳过文件复制');
+            return;
+        }
+
+        // 计算项目根目录
+        // packagePath = /project/node_modules/prd-workflow-cli
+        // node_modules = /project/node_modules
+        // projectRoot = /project
+        const nodeModulesPath = path.dirname(packagePath);
+        const projectRoot = path.dirname(nodeModulesPath);
+
+        debug(`nodeModulesPath = ${nodeModulesPath}`);
+        debug(`projectRoot = ${projectRoot}`);
+
+        // 验证项目根目录存在
+        if (!fs.existsSync(projectRoot)) {
+            debug('项目根目录不存在，跳过');
+            return;
+        }
 
-        if (!projectRoot) {
-            // 不是 PRD 项目，静默退出（这是正常情况，比如全局安装）
+        // 检查是否有 package.json（确认是一个 npm 项目）
+        const packageJsonPath = path.join(projectRoot, 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+            debug('项目根目录没有 package.json，跳过');
             return;
         }
 
-        log('\n📦 prd-workflow-cli: 检测到 PRD 项目，正在更新配置文件...');
+        log('\n📦 prd-workflow-cli: 正在配置 AI 工作流文件...');
 
-        // 定义需要更新的文件/目录
-        const updateItems = [
+        // 定义需要复制的文件/目录
+        const copyItems = [
             {
                 name: 'Workflows',
                 source: '.agent/workflows',
@@ -161,11 +177,12 @@ function main() {
         let updatedCount = 0;
         let newCount = 0;
 
-        for (const item of updateItems) {
+        for (const item of copyItems) {
             const sourcePath = path.join(packagePath, item.source);
             const targetPath = path.join(projectRoot, item.target);
 
             if (!fs.existsSync(sourcePath)) {
+                debug(`源文件不存在: ${sourcePath}`);
                 continue;
             }
 
@@ -225,16 +242,20 @@ function main() {
             if (updatedCount > 0) {
                 log(`   🔄 更新 ${updatedCount} 个文件`);
             }
-            log('   ✅ 配置文件已同步到最新版本\n');
+            log('   ✅ AI 工作流配置完成！\n');
+            log('   📁 已添加文件:');
+            log('      .agent/workflows/   - PRD 工作流指引');
+            log('      .cursorrules        - Cursor AI 规则');
+            log('      .antigravity/       - Antigravity AI 规则');
+            log('      AI-GUIDE.md         - AI 使用指南\n');
         } else {
             log('   ✅ 所有配置文件已是最新版本\n');
         }
 
     } catch (error) {
         // postinstall 失败不应该阻止安装
-        // 只输出警告，不抛出错误
-        logError(`\n⚠️ prd-workflow-cli: 自动更新配置文件失败: ${error.message}`);
-        logError('   您可以稍后手动运行 "prd upgrade" 来更新配置文件\n');
+        logError(`\n⚠️ prd-workflow-cli: 配置文件复制失败: ${error.message}`);
+        logError('   您可以手动运行 "npx prd upgrade" 来完成配置\n');
     }
 }