jsharness 1.4.0 → 1.5.0

package/bin/jsharness.js

@@ -13,15 +13,17 @@
  *   npx jsharness openspec list               # 列出 OpenSpec 变更
  */
 
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 import path from 'path';
 
 // 关键：用相对路径引用主库，不用 import('jsharness') 包名
 // 这样在 npx 临时安装环境中也能可靠定位模块
+// Windows 上必须用 file:// URL 格式，不能用 C:\path 格式
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const libPath = path.join(__dirname, '..', 'lib', 'index.mjs');
+const libURL = pathToFileURL(libPath).href;
 
-const { runInit, listTools, showStatus, listOpenSpecChanges, archiveOpenSpecChange } = await import(libPath);
+const { runInit, listTools, showStatus, listOpenSpecChanges, archiveOpenSpecChange } = await import(libURL);
 
 // 读取版本号
 import { createRequire } from 'module';

package/lib/index.mjs

@@ -584,6 +584,100 @@ function downloadFile(url, destPath) {
   });
 }
 
+// ============================================================
+// 复制 .harness/ 完整目录到目标项目
+// ============================================================
+
+/**
+ * 将源 .harness/ 目录递归复制到目标项目的 .harness/ 目录
+ *
+ * 包含所有子目录：rules/, skills/, agents/, gate/, workflow/, mcp/,
+ * config/, dev-map/, docs/, specs/ 以及根级文件 README.md 等
+ *
+ * @param {string} sourceHarnessDir - 源 .harness/ 目录
+ * @param {string} projectDir - 目标项目根目录
+ * @param {object} options
+ * @param {boolean} [options.force] - 是否覆盖已有文件
+ * @param {boolean} [options.verbose]
+ * @param {string} [options.stack] - 技术栈过滤（影响 rules/project/ 下的文件）
+ * @returns {{ copied: string[], skipped: string[] }}
+ */
+function copyHarnessToProject(sourceHarnessDir, projectDir, options = {}) {
+  const { force = false, verbose = false, stack = 'all' } = options;
+  const targetHarnessDir = path.join(projectDir, '.harness');
+  const copied = [];
+  const skipped = [];
+
+  // 需要跳过的文件/目录（二进制、临时文件等）
+  const SKIP_ENTRIES = new Set(['.git', 'node_modules', '.DS_Store', 'Thumbs.db']);
+
+  // 技术栈过滤：rules/project/ 下只复制匹配的文件
+  function shouldCopyFile(relPath) {
+    if (stack === 'all') return true;
+
+    const lowerRel = relPath.toLowerCase().replace(/\\/g, '/');
+
+    // rules/project/ 下的文件需要按技术栈过滤
+    if (lowerRel.includes('rules/project/')) {
+      if (stack === 'vue3') {
+        return lowerRel.includes('vue') || lowerRel.includes('frontend') || lowerRel.includes('web');
+      }
+      if (stack === 'java') {
+        return lowerRel.includes('java') || lowerRel.includes('backend');
+      }
+    }
+
+    return true;
+  }
+
+  function copyRecursive(srcDir, destDir, relBase) {
+    if (!fs.existsSync(srcDir)) return;
+
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (SKIP_ENTRIES.has(entry.name)) continue;
+
+      const srcPath = path.join(srcDir, entry.name);
+      const relPath = relBase ? `${relBase}/${entry.name}` : entry.name;
+      const destPath = path.join(destDir, entry.name);
+
+      if (entry.isDirectory()) {
+        // 递归复制子目录
+        if (!fs.existsSync(destPath)) {
+          fs.mkdirSync(destPath, { recursive: true });
+        }
+        copyRecursive(srcPath, destPath, relPath);
+      } else {
+        // 文件：检查是否需要复制
+        if (!shouldCopyFile(relPath)) {
+          if (verbose) console.log(`    ⏭  技术栈过滤跳过: ${relPath}`);
+          continue;
+        }
+
+        if (fs.existsSync(destPath) && !force) {
+          skipped.push(`.harness/${relPath}`);
+          if (verbose) console.log(`    ⏭  跳过 (已存在): .harness/${relPath}`);
+          continue;
+        }
+
+        // 确保目标目录存在
+        const destFileDir = path.dirname(destPath);
+        if (!fs.existsSync(destFileDir)) {
+          fs.mkdirSync(destFileDir, { recursive: true });
+        }
+
+        fs.copyFileSync(srcPath, destPath);
+        copied.push(`.harness/${relPath}`);
+        if (verbose) console.log(`    ✅ 复制: .harness/${relPath}`);
+      }
+    }
+  }
+
+  copyRecursive(sourceHarnessDir, targetHarnessDir, '');
+
+  return { copied, skipped };
+}
+
 // ============================================================
 // 扫描 Harness 源文件
 // ============================================================
@@ -782,7 +876,17 @@ export async function runInit(projectDir, options = {}) {
   if (!stack) stack = await promptSelectStack();
   console.log(`\n🏗️  技术栈: ${stackLabel(stack)}\n`);
 
-  // 4. 扫描源文件
+  // 4. 复制 .harness/ 完整目录到目标项目（rules/skills/agents/gate/workflow/... 全部写入）
+  console.log(`📂 复制 .harness/ 完整目录到项目...`);
+  const harnessCopyResult = copyHarnessToProject(harnessDir, projectDir, { force, verbose, stack });
+  if (harnessCopyResult.copied.length > 0) {
+    console.log(`  ✅ 复制 ${harnessCopyResult.copied.length} 个文件/目录到 .harness/`);
+  }
+  if (harnessCopyResult.skipped.length > 0) {
+    console.log(`  ⏭  跳过 ${harnessCopyResult.skipped.length} 个 (已存在)`);
+  }
+
+  // 5. 扫描源文件（用于注入到 AI 工具特有目录）
   const allRuleFiles = scanHarnessRules(harnessDir, stack);
   const allSkillFiles = scanHarnessSkills(harnessDir, stack);
 
@@ -790,7 +894,7 @@ export async function runInit(projectDir, options = {}) {
     console.log(`📋 扫描结果: ${allRuleFiles.length} 个规则, ${allSkillFiles.length} 个技能\n`);
   }
 
-  // 5. 对每个目标工具执行注入
+  // 6. 对每个目标工具执行注入（写入 AI 工具特有目录如 .codebuddy/ .claude/ 等）
   const summary = [];
 
   for (const tool of targetTools) {
@@ -812,7 +916,7 @@ export async function runInit(projectDir, options = {}) {
     summary.push({ tool: tool.name, written, skipped });
   }
 
-  // 6. 初始化 OpenSpec
+  // 7. 初始化 OpenSpec
   console.log('\n━━━ 初始化 OpenSpec ━━━');
   const openspecResult = initOpenSpec(projectDir, { force, verbose });
   if (openspecResult.created.length > 0) {
@@ -823,10 +927,24 @@ export async function runInit(projectDir, options = {}) {
     console.log(`  ⏭  跳过 ${openspecResult.skipped.length} 项 (已存在)`);
   }
 
-  // 7. 输出总结
+  // 8. 输出总结
   console.log('\n═════════════════════════════');
   console.log('✅ 初始化完成！');
 
+  // .harness/ 完整目录
+  if (harnessCopyResult.copied.length > 0) {
+    console.log(`\n  [.harness/ 完整目录]`);
+    console.log(`  ✅ 复制 ${harnessCopyResult.copied.length} 个文件到 .harness/`);
+    if (verbose) {
+      harnessCopyResult.copied.forEach(f => console.log(`     - ${f}`));
+    }
+  }
+  if (harnessCopyResult.skipped.length > 0 && verbose) {
+    console.log(`  ⏭  跳过 ${harnessCopyResult.skipped.length} 个 (.harness/ 中已存在):`);
+    harnessCopyResult.skipped.forEach(f => console.log(`     - ${f}`));
+  }
+
+  // AI 工具特有目录注入
   for (const s of summary) {
     if (s.written.length > 0) {
       console.log(`\n  [${s.tool}]`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsharness",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Harness Engineering - AI 编程行为工程化管控系统。将 rules/skills/gate/agents 一键注入到 CodeBuddy、Cursor、Copilot 等 AI 工具中。",
   "main": "lib/index.mjs",
   "bin": {