ai-developer-skill-os 8.2.1 → 8.3.1

package/bin/install.js

@@ -1,180 +1,330 @@
 #!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import readline from 'readline';
-import { fileURLToPath } from 'url';
-import os from 'os';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const sourceDir = path.resolve(__dirname, '..', '.agents');
-const packageJsonPath = path.resolve(__dirname, '..', 'package.json');
-const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-const version = pkg.version;
-const cwd = process.cwd();
-
-function parseArgs() {
-  const args = process.argv.slice(2);
-  let ide = null;
-  let scope = null;
-
-  args.forEach(arg => {
-    if (arg.startsWith('--ide=')) {
-      ide = arg.split('=')[1];
-    } else if (arg.startsWith('--scope=')) {
-      scope = arg.split('=')[1];
-    }
-  });
-
-  return { ide, scope };
-}
-
-function copyRecursiveSync(src, dest) {
-  const exists = fs.existsSync(src);
-  const stats = exists && fs.statSync(src);
-  const isDirectory = exists && stats.isDirectory();
-  if (isDirectory) {
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
-    }
-    fs.readdirSync(src).forEach(function (childItemName) {
-      copyRecursiveSync(path.join(src, childItemName), path.join(dest, childItemName));
-    });
-  } else {
-    fs.copyFileSync(src, dest);
-  }
-}
-
-function runInstall(ideChoice, scopeChoice) {
-  const mapIde = {
-    '1': 'cursor',
-    '2': 'windsurf',
-    '3': 'cline',
-    '4': 'antigravity',
-    '5': 'codex',
-    '6': 'kilo',
-    '7': 'multi-ide'
-  };
-
-  const mapScope = {
-    '1': 'local',
-    '2': 'global'
-  };
-
-  const ide = mapIde[ideChoice] || ideChoice;
-  const scope = mapScope[scopeChoice] || scopeChoice;
-  const isGlobal = scope === 'global';
-
-  let targetDir = path.join(cwd, '.agents');
-  
-  if (isGlobal) {
-    const homeDir = os.homedir();
-    if (ide === 'antigravity') {
-      targetDir = path.join(homeDir, '.gemini', 'config');
-    } else {
-      targetDir = path.join(homeDir, '.ai-developer-skill-os', '.agents');
-    }
-  }
-
-  try {
-    console.log(`\n🚀 Đang cài đặt V${version} Agent Engineering OS...`);
-    
-    if (!fs.existsSync(targetDir)) {
-      fs.mkdirSync(targetDir, { recursive: true });
-    }
-
-    if (fs.existsSync(sourceDir)) {
-      copyRecursiveSync(sourceDir, targetDir);
-      console.log(`✅ Đã copy toàn bộ kiến trúc .agents vào: ${targetDir}`);
-      
-      if (isGlobal && ide === 'antigravity') {
-        const targetDirPosix = targetDir.replace(/\\/g, '/');
-        
-        function walkAndReplace(dir) {
-          const files = fs.readdirSync(dir);
-          for (const file of files) {
-            const fullPath = path.join(dir, file);
-            if (fs.statSync(fullPath).isDirectory()) {
-              walkAndReplace(fullPath);
-            } else if (fullPath.endsWith('.md') || fullPath.endsWith('.yml') || fullPath.endsWith('.yaml') || fullPath.endsWith('.json')) {
-              let content = fs.readFileSync(fullPath, 'utf8');
-              let modified = false;
-              
-              const dirsToRewrite = ['skills', 'registry', 'rules', 'workflows', 'knowledge', 'examples', 'docs'];
-              for (const d of dirsToRewrite) {
-                const regex = new RegExp(`\\.agents/${d}`, 'g');
-                if (regex.test(content)) {
-                  content = content.replace(regex, `${targetDirPosix}/${d}`);
-                  modified = true;
-                }
-              }
-              
-              if (content.includes('.agents/skills.json')) {
-                content = content.replace(/\.agents\/skills\.json/g, `${targetDirPosix}/skills.json`);
-                modified = true;
-              }
-      
-              if (modified) {
-                fs.writeFileSync(fullPath, content, 'utf8');
-              }
-            }
-          }
-        }
-        
-        walkAndReplace(targetDir);
-        console.log(`✅ Đã cập nhật đường dẫn tuyệt đối cho cấu hình Global Antigravity`);
-      }
-    } else {
-      console.error(`❌ Lỗi: Không tìm thấy thư mục nguồn ${sourceDir}`);
-      return;
-    }
-    
-    console.log(`\n🎉 HOÀN TẤT! Kiến trúc V${version} đã sẵn sàng tại: ${targetDir}`);
-    
-    if (isGlobal && ide === 'antigravity') {
-      console.log(`💡 Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO, Antigravity cũng sẽ tự động có đủ hệ thống OS mới nhất!`);
-    }
-
-  } catch (error) {
-    console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
-  }
-}
-
-const args = parseArgs();
-
-if (args.ide && args.scope) {
-  runInstall(args.ide, args.scope);
-} else {
-  console.log('🚀 Đang chuẩn bị cài đặt AI Developer Skill OS V8...\n');
-
-  const questionIde = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng:
-(1) Cursor
-(2) Windsurf
-(3) Cline / Roo Code
-(4) Antigravity / Gemini
-(5) Codex
-(6) Kilo Code
-(7) Tất cả các IDE (Multi-IDE)
-
-Nhập số (1-7): `;
-
-  const questionScope = `
-Bạn muốn cài đặt bộ kỹ năng ở đâu?
-(1) Local  (Gắn vào dự án hiện tại - Phù hợp làm việc nhóm)
-(2) Global (Cài vào máy tính dùng chung cho mọi dự án - Dành cho cá nhân)
-
-Nhập số (1-2): `;
-
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-
-  rl.question(questionIde, (answerIde) => {
-    rl.question(questionScope, (answerScope) => {
-      rl.close();
-      runInstall(answerIde.trim(), answerScope.trim());
-    });
-  });
-}
+
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline';
+import { fileURLToPath } from 'url';
+import os from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const sourceDir = path.resolve(__dirname, '..', '.agents');
+const packageJsonPath = path.resolve(__dirname, '..', 'package.json');
+const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+const version = pkg.version;
+const cwd = process.cwd();
+const homeDir = os.homedir();
+
+// Version marker file written after every successful install
+const VERSION_FILE = '.ai-skill-os-version';
+
+// ─── IDE Configuration Map ────────────────────────────────────────────────────
+// Each IDE has:
+//   localDir  — where to install when scope=local (relative to cwd)
+//   globalDir — where to install when scope=global (absolute, user-level)
+//   postInstall — special steps after copy (null = none)
+// ─────────────────────────────────────────────────────────────────────────────
+const IDE_CONFIG = {
+  antigravity: {
+    label: 'Antigravity (Google Gemini)',
+    localDir: path.join(cwd, '.agents'),
+    globalDir: path.join(homeDir, '.gemini', 'config'),
+    postInstall: 'rewriteAbsolutePaths',
+    note: 'Global: ~/.gemini/config — applies to all projects on this machine',
+  },
+  claude: {
+    label: 'Claude Code (Anthropic)',
+    localDir: path.join(cwd, '.claude'),
+    globalDir: path.join(homeDir, '.claude'),
+    postInstall: 'renameToClaude',
+    note: 'Global: ~/.claude/CLAUDE.md — applies to all Claude Code sessions',
+  },
+  cursor: {
+    label: 'Cursor IDE',
+    localDir: path.join(cwd, '.cursor', 'rules'),
+    globalDir: null, // Cursor has no reliable global rules path — use Settings UI
+    postInstall: 'exportCursorRules',
+    note: 'Local only: .cursor/rules/ — use Cursor Settings > Rules for AI for global rules',
+  },
+  codex: {
+    label: 'OpenAI Codex CLI',
+    localDir: path.join(cwd, '.codex'),
+    globalDir: path.join(homeDir, '.codex'),
+    postInstall: null,
+    note: 'Global: ~/.codex — applies to all Codex CLI sessions',
+  },
+};
+
+// ─── Utilities ───────────────────────────────────────────────────────────────
+
+function copyRecursiveSync(src, dest) {
+  if (!fs.existsSync(src)) return;
+  const stats = fs.statSync(src);
+  if (stats.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const child of fs.readdirSync(src)) {
+      copyRecursiveSync(path.join(src, child), path.join(dest, child));
+    }
+  } else {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+/** Read installed version from marker file. Returns null if not installed. */
+function getInstalledVersion(targetDir) {
+  const markerPath = path.join(targetDir, VERSION_FILE);
+  if (!fs.existsSync(markerPath)) return null;
+  try {
+    return fs.readFileSync(markerPath, 'utf8').trim();
+  } catch {
+    return null;
+  }
+}
+
+/** Write version marker after successful install. */
+function writeVersionMarker(targetDir) {
+  fs.writeFileSync(
+    path.join(targetDir, VERSION_FILE),
+    `${version}\nInstalled: ${new Date().toISOString()}\n`,
+    'utf8'
+  );
+}
+
+/** Remove existing install. For Cursor: only delete the .mdc rule file. */
+function removeExistingInstall(targetDir, ide) {
+  if (ide === 'cursor') {
+    const mdcPath = path.join(targetDir, 'ai-skill-os.mdc');
+    if (fs.existsSync(mdcPath)) fs.unlinkSync(mdcPath);
+    console.log('  🗑️  Removed old Cursor rule: ai-skill-os.mdc');
+  } else {
+    if (fs.existsSync(targetDir)) {
+      fs.rmSync(targetDir, { recursive: true, force: true });
+      console.log(`  🗑️  Removed old install: ${targetDir}`);
+    }
+  }
+}
+
+/** Prompt user yes/no. Resolves true for yes. */
+function confirm(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (ans) => resolve(['y', 'yes', ''].includes(ans.trim().toLowerCase())));
+  });
+}
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const result = { ide: null, scope: null };
+  for (const arg of args) {
+    if (arg.startsWith('--ide=')) result.ide = arg.split('=')[1];
+    else if (arg.startsWith('--scope=')) result.scope = arg.split('=')[1];
+  }
+  return result;
+}
+
+// ─── Post-install handlers ────────────────────────────────────────────────────
+
+/**
+ * Antigravity global install: rewrite relative .agents/X paths → absolute paths.
+ * Required because Antigravity reads SKILL.md files from an absolute global path.
+ */
+function rewriteAbsolutePaths(targetDir) {
+  const targetPosix = targetDir.replace(/\\/g, '/');
+  const DIRS_TO_REWRITE = ['skills', 'registry', 'rules', 'workflows', 'knowledge', 'docs', 'blueprints'];
+
+  const walk = (dir) => {
+    for (const file of fs.readdirSync(dir)) {
+      const fullPath = path.join(dir, file);
+      if (fs.statSync(fullPath).isDirectory()) {
+        walk(fullPath);
+      } else if (/\.(md|yml|yaml|json)$/.test(fullPath)) {
+        let content = fs.readFileSync(fullPath, 'utf8');
+        let changed = false;
+
+        for (const d of DIRS_TO_REWRITE) {
+          const re = new RegExp(`\\.agents/${d}`, 'g');
+          if (re.test(content)) {
+            content = content.replace(re, `${targetPosix}/${d}`);
+            changed = true;
+          }
+        }
+        if (content.includes('.agents/skills.json')) {
+          content = content.replace(/\.agents\/skills\.json/g, `${targetPosix}/skills.json`);
+          changed = true;
+        }
+        if (changed) fs.writeFileSync(fullPath, content, 'utf8');
+      }
+    }
+  };
+
+  walk(targetDir);
+  console.log('  ✅ Rewrote .agents/* references → absolute paths for Antigravity global mode');
+}
+
+/**
+ * Claude Code install: copy AGENTS.md → CLAUDE.md at target root.
+ * Claude Code reads ~/.claude/CLAUDE.md as global instructions.
+ */
+function renameToClaude(targetDir) {
+  const agentsMd = path.join(targetDir, 'AGENTS.md');
+  const claudeMd = path.join(targetDir, 'CLAUDE.md');
+
+  if (fs.existsSync(agentsMd) && !fs.existsSync(claudeMd)) {
+    fs.copyFileSync(agentsMd, claudeMd);
+    console.log('  ✅ Copied AGENTS.md → CLAUDE.md (Claude Code entry point)');
+  } else if (fs.existsSync(claudeMd)) {
+    console.log('  ℹ️  CLAUDE.md already exists — skipped overwrite');
+  }
+}
+
+/**
+ * Cursor install: export AGENTS.md content as a .mdc rule file.
+ * Cursor reads .cursor/rules/*.mdc — each file needs YAML frontmatter.
+ */
+function exportCursorRules(targetDir) {
+  const agentsMd = path.join(sourceDir, 'AGENTS.md');
+  if (!fs.existsSync(agentsMd)) return;
+
+  const rawContent = fs.readFileSync(agentsMd, 'utf8');
+  const mdcContent = `---
+description: "AI Developer Skill OS v${version} — global skill rules"
+alwaysApply: true
+---
+
+${rawContent}`;
+
+  const outPath = path.join(targetDir, 'ai-skill-os.mdc');
+  fs.mkdirSync(targetDir, { recursive: true });
+  fs.writeFileSync(outPath, mdcContent, 'utf8');
+  console.log(`  ✅ Exported rules → ${outPath}`);
+  console.log('  ℹ️  For global rules: Cursor Settings > General > Rules for AI');
+}
+
+// ─── Main install logic ───────────────────────────────────────────────────────
+
+async function runInstall(ideKey, scopeKey, rl) {
+  const ideMap = { '1': 'antigravity', '2': 'claude', '3': 'cursor', '4': 'codex' };
+  const scopeMap = { '1': 'local', '2': 'global' };
+
+  const ide = ideMap[ideKey] || ideKey;
+  const scope = scopeMap[scopeKey] || scopeKey;
+  const config = IDE_CONFIG[ide];
+
+  if (!config) {
+    console.error(`❌ IDE không hợp lệ: "${ide}". Chọn: antigravity, claude, cursor, codex`);
+    process.exit(1);
+  }
+
+  const isGlobal = scope === 'global';
+
+  if (isGlobal && config.globalDir === null) {
+    console.warn(`⚠️  ${config.label} không hỗ trợ cài Global qua file.`);
+    console.warn(`   ${config.note}`);
+    console.warn('   Tiến hành cài Local thay thế...');
+  }
+
+  const targetDir = (isGlobal && config.globalDir) ? config.globalDir : config.localDir;
+
+  console.log(`\n🚀 AI Developer Skill OS v${version}`);
+  console.log(`   IDE:   ${config.label}`);
+  console.log(`   Scope: ${isGlobal ? 'Global' : 'Local'}`);
+  console.log(`   Path:  ${targetDir}`);
+
+  // ── Version check ────────────────────────────────────────────────────────
+  const installedVersion = getInstalledVersion(targetDir);
+
+  if (installedVersion) {
+    if (installedVersion === version) {
+      console.log(`\n✅ Phiên bản v${version} đã được cài đặt — không cần cập nhật.`);
+      console.log('   Dùng --force để cài lại.\n');
+      const isForce = process.argv.includes('--force');
+      if (!isForce) {
+        if (rl) rl.close();
+        return;
+      }
+      console.log('   --force detected: tiến hành cài lại...');
+    } else {
+      console.log(`\n⚠️  Phát hiện phiên bản cũ: v${installedVersion}`);
+      console.log(`   Phiên bản mới:             v${version}`);
+      const shouldUpgrade = rl
+        ? await confirm(rl, '\n   Xóa bản cũ và cài bản mới? [Y/n]: ')
+        : true;
+      if (!shouldUpgrade) {
+        console.log('   Hủy cài đặt.');
+        if (rl) rl.close();
+        return;
+      }
+    }
+    // Remove old install before fresh copy
+    removeExistingInstall(targetDir, ide);
+  } else {
+    console.log('   (Chưa cài đặt — fresh install)\n');
+  }
+
+  // ── Install ──────────────────────────────────────────────────────────────
+  try {
+    if (!fs.existsSync(sourceDir)) {
+      console.error(`❌ Không tìm thấy source: ${sourceDir}`);
+      process.exit(1);
+    }
+
+    if (ide === 'cursor') {
+      exportCursorRules(targetDir);
+    } else {
+      copyRecursiveSync(sourceDir, targetDir);
+      console.log(`  ✅ Copied .agents/ → ${targetDir}`);
+
+      if (isGlobal && config.postInstall === 'rewriteAbsolutePaths') {
+        rewriteAbsolutePaths(targetDir);
+      }
+      if (config.postInstall === 'renameToClaude') {
+        renameToClaude(targetDir);
+      }
+    }
+
+    writeVersionMarker(targetDir);
+    console.log(`\n🎉 Hoàn tất v${version}! ${config.note}\n`);
+
+  } catch (err) {
+    console.error('❌ Lỗi cài đặt:', err.message);
+    process.exit(1);
+  } finally {
+    if (rl) rl.close();
+  }
+}
+
+// ─── CLI entry point ──────────────────────────────────────────────────────────
+
+const args = parseArgs();
+
+if (args.ide && args.scope) {
+  // Non-interactive mode (called via npm scripts)
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  await runInstall(args.ide, args.scope, rl);
+} else {
+  // Interactive mode
+  console.log(`\n🚀 AI Developer Skill OS v${version} — Setup\n`);
+
+  const ideQuestion = `Chọn IDE/AI Assistant:
+  (1) Antigravity (Google Gemini)
+  (2) Claude Code (Anthropic)
+  (3) Cursor IDE
+  (4) OpenAI Codex CLI
+
+Nhập số (1-4): `;
+
+  const scopeQuestion = `
+Phạm vi cài đặt:
+  (1) Local  — Chỉ dự án này (.agents/ hoặc .claude/ trong thư mục hiện tại)
+  (2) Global — Toàn bộ máy tính (áp dụng cho mọi dự án)
+
+Nhập số (1-2): `;
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  rl.question(ideQuestion, async (ideAnswer) => {
+    rl.question(scopeQuestion, async (scopeAnswer) => {
+      await runInstall(ideAnswer.trim(), scopeAnswer.trim(), rl);
+    });
+  });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "8.2.1",
-  "description": "EDAOS v8.2 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
+  "version": "8.3.1",
+  "description": "EDAOS v8.3 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
   "main": "bin/install.js",
   "files": [
     "bin",
@@ -26,6 +26,8 @@
     "test:registry": "vitest run && node tooling/build-registry.js",
     "test:graph": "node tooling/validate-graph.js",
     "lint": "node bin/lint.js",
+    "eval": "node evals/runner.js",
+    "eval:all": "node evals/runner.js --all",
     "test:agent": "node tests/agent-evaluation/runner/evaluate-routing.js",
     "generate:evaluation": "node tooling/generate-evaluation-cases.cjs",
     "install:antigravity": "node bin/install.js --ide=antigravity --scope=2",