ai-developer-skill-os 8.2.1 → 8.3.1

package/tooling/build-registry.js

@@ -1,186 +1,186 @@
-/**
- * build-registry.js
- * V8.2 Governed Capability Metadata & Eval Platform
- * Generates registry/index.yaml (lightweight lookup) and registry/graph.json (O(1) graph & cycle check)
- * 
- * Usage: node tooling/build-registry.js
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import yaml from 'js-yaml';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const SKILLS_DIR = path.join(__dirname, '../.agents/skills');
-const REGISTRY_DIR = path.join(__dirname, '../.agents/registry');
-const INDEX_YAML = path.join(REGISTRY_DIR, 'index.yaml');
-const GRAPH_JSON = path.join(REGISTRY_DIR, 'graph.json');
-
-function parseYamlFile(filePath) {
-  try {
-    const content = fs.readFileSync(filePath, 'utf8');
-    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-    if (match) {
-      return yaml.load(match[1]);
-    }
-    return yaml.load(content);
-  } catch (e) {
-    console.error(`[WARN] Failed to parse YAML from ${filePath}: ${e.message}`);
-    return null;
-  }
-}
-
-function buildRegistry() {
-  console.log('🔄 Building V8.2 Governed Capability Registry & O(1) Runtime Graph...');
-
-  if (!fs.existsSync(SKILLS_DIR)) {
-    console.error('❌ Skills directory not found:', SKILLS_DIR);
-    process.exit(1);
-  }
-
-  fs.mkdirSync(REGISTRY_DIR, { recursive: true });
-
-  const dirs = fs.readdirSync(SKILLS_DIR).filter(d => 
-    !d.startsWith('_') && fs.statSync(path.join(SKILLS_DIR, d)).isDirectory()
-  );
-
-  const capabilities = {};
-  const adjacency = {};
-  const reverseAdjacency = {};
-
-  for (const dir of dirs) {
-    const capYamlPath = path.join(SKILLS_DIR, dir, 'capability.yaml');
-    const skillMdPath = path.join(SKILLS_DIR, dir, 'SKILL.md');
-    
-    let meta = null;
-    let fromCapabilityYaml = false;
-
-    if (fs.existsSync(capYamlPath)) {
-      meta = parseYamlFile(capYamlPath);
-      fromCapabilityYaml = true;
-    } else if (fs.existsSync(skillMdPath)) {
-      meta = parseYamlFile(skillMdPath);
-    }
-
-    if (!meta) continue;
-
-    const id = meta.id || meta.name || dir;
-    const version = meta.version || '8.2.0';
-    const description = meta.description || '';
-    
-    // Normalize tags
-    let tags = meta.tags || meta.keywords || [];
-    if (!Array.isArray(tags) || tags.length === 0) {
-      // Derive simple tags from dir words
-      tags = dir.replace(/^qk-/, '').split('-');
-    }
-
-    // Normalize dependencies
-    let dependencies = meta.dependencies || [];
-    if (!fromCapabilityYaml) {
-      // Derive from V8.1 skill frontmatter decision_boundary / workflow
-      const deps = new Set();
-      if (meta.workflow && typeof meta.workflow === 'string') deps.add(meta.workflow);
-      if (meta.decision_boundary?.delegates_to) {
-        meta.decision_boundary.delegates_to.forEach(d => deps.add(d));
-      }
-      dependencies = Array.from(deps);
-    }
-
-    capabilities[id] = {
-      path: `.agents/skills/${dir}`,
-      version,
-      tags,
-      dependencies
-    };
-
-    adjacency[id] = dependencies;
-    if (!reverseAdjacency[id]) reverseAdjacency[id] = [];
-  }
-
-  // Populate reverse adjacency for orphan detection
-  for (const [id, deps] of Object.entries(adjacency)) {
-    for (const dep of deps) {
-      if (!reverseAdjacency[dep]) reverseAdjacency[dep] = [];
-      reverseAdjacency[dep].push(id);
-    }
-  }
-
-  // Detect cycles using DFS
-  let hasCycles = false;
-  const visited = {};
-  const recursionStack = {};
-
-  function detectCycle(node) {
-    visited[node] = true;
-    recursionStack[node] = true;
-
-    const deps = adjacency[node] || [];
-    for (const dep of deps) {
-      if (!visited[dep]) {
-        if (detectCycle(dep)) return true;
-      } else if (recursionStack[dep]) {
-        return true;
-      }
-    }
-
-    recursionStack[node] = false;
-    return false;
-  }
-
-  for (const node of Object.keys(adjacency)) {
-    if (!visited[node]) {
-      if (detectCycle(node)) {
-        hasCycles = true;
-        break;
-      }
-    }
-  }
-
-  // Build Graph JSON (O(1) Runtime lookups)
-  const graphNodes = {};
-  for (const [id, data] of Object.entries(capabilities)) {
-    const dependents = reverseAdjacency[id] || [];
-    const isOrphan = data.dependencies.length === 0 && dependents.length === 0 && id !== 'qk-orchestrator' && id !== 'qk-help';
-
-    graphNodes[id] = {
-      path: data.path,
-      version: data.version,
-      tags: data.tags,
-      dependencies: data.dependencies,
-      dependents,
-      is_orphan: isOrphan
-    };
-  }
-
-  const graphJsonData = {
-    schema_version: 1,
-    manifest_version: '8.2',
-    generated_at: new Date().toISOString(),
-    nodes: graphNodes,
-    adjacency,
-    stats: {
-      total_capabilities: Object.keys(capabilities).length,
-      has_cycles: hasCycles
-    }
-  };
-
-  // Build Registry Index YAML (Lightweight lookup)
-  const indexYamlContent = `# AUTO-GENERATED BY registry-builder (tooling/build-registry.js)\n# DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.\n` +
-    yaml.dump({
-      schema_version: 1,
-      manifest_version: '8.2',
-      generated_at: new Date().toISOString(),
-      capabilities
-    }, { indent: 2 });
-
-  fs.writeFileSync(INDEX_YAML, indexYamlContent, 'utf8');
-  fs.writeFileSync(GRAPH_JSON, JSON.stringify(graphJsonData, null, 2), 'utf8');
-
-  console.log(`✅ Generated lightweight registry index at .agents/registry/index.yaml (${Object.keys(capabilities).length} capabilities)`);
-  console.log(`✅ Generated O(1) adjacency graph at .agents/registry/graph.json (has_cycles: ${hasCycles})`);
-}
-
-buildRegistry();
+/**
+ * build-registry.js
+ * V8.2 Governed Capability Metadata & Eval Platform
+ * Generates registry/index.yaml (lightweight lookup) and registry/graph.json (O(1) graph & cycle check)
+ * 
+ * Usage: node tooling/build-registry.js
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import yaml from 'js-yaml';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const SKILLS_DIR = path.join(__dirname, '../.agents/skills');
+const REGISTRY_DIR = path.join(__dirname, '../.agents/registry');
+const INDEX_YAML = path.join(REGISTRY_DIR, 'index.yaml');
+const GRAPH_JSON = path.join(REGISTRY_DIR, 'graph.json');
+
+function parseYamlFile(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (match) {
+      return yaml.load(match[1]);
+    }
+    return yaml.load(content);
+  } catch (e) {
+    console.error(`[WARN] Failed to parse YAML from ${filePath}: ${e.message}`);
+    return null;
+  }
+}
+
+function buildRegistry() {
+  console.log('🔄 Building V8.2 Governed Capability Registry & O(1) Runtime Graph...');
+
+  if (!fs.existsSync(SKILLS_DIR)) {
+    console.error('❌ Skills directory not found:', SKILLS_DIR);
+    process.exit(1);
+  }
+
+  fs.mkdirSync(REGISTRY_DIR, { recursive: true });
+
+  const dirs = fs.readdirSync(SKILLS_DIR).filter(d => 
+    !d.startsWith('_') && fs.statSync(path.join(SKILLS_DIR, d)).isDirectory()
+  );
+
+  const capabilities = {};
+  const adjacency = {};
+  const reverseAdjacency = {};
+
+  for (const dir of dirs) {
+    const capYamlPath = path.join(SKILLS_DIR, dir, 'capability.yaml');
+    const skillMdPath = path.join(SKILLS_DIR, dir, 'SKILL.md');
+    
+    let meta = null;
+    let fromCapabilityYaml = false;
+
+    if (fs.existsSync(capYamlPath)) {
+      meta = parseYamlFile(capYamlPath);
+      fromCapabilityYaml = true;
+    } else if (fs.existsSync(skillMdPath)) {
+      meta = parseYamlFile(skillMdPath);
+    }
+
+    if (!meta) continue;
+
+    const id = meta.id || meta.name || dir;
+    const version = meta.version || '8.2.0';
+    const description = meta.description || '';
+    
+    // Normalize tags
+    let tags = meta.tags || meta.keywords || [];
+    if (!Array.isArray(tags) || tags.length === 0) {
+      // Derive simple tags from dir words
+      tags = dir.replace(/^qk-/, '').split('-');
+    }
+
+    // Normalize dependencies
+    let dependencies = meta.dependencies || [];
+    if (!fromCapabilityYaml) {
+      // Derive from V8.1 skill frontmatter decision_boundary / workflow
+      const deps = new Set();
+      if (meta.workflow && typeof meta.workflow === 'string') deps.add(meta.workflow);
+      if (meta.decision_boundary?.delegates_to) {
+        meta.decision_boundary.delegates_to.forEach(d => deps.add(d));
+      }
+      dependencies = Array.from(deps);
+    }
+
+    capabilities[id] = {
+      path: `.agents/skills/${dir}`,
+      version,
+      tags,
+      dependencies
+    };
+
+    adjacency[id] = dependencies;
+    if (!reverseAdjacency[id]) reverseAdjacency[id] = [];
+  }
+
+  // Populate reverse adjacency for orphan detection
+  for (const [id, deps] of Object.entries(adjacency)) {
+    for (const dep of deps) {
+      if (!reverseAdjacency[dep]) reverseAdjacency[dep] = [];
+      reverseAdjacency[dep].push(id);
+    }
+  }
+
+  // Detect cycles using DFS
+  let hasCycles = false;
+  const visited = {};
+  const recursionStack = {};
+
+  function detectCycle(node) {
+    visited[node] = true;
+    recursionStack[node] = true;
+
+    const deps = adjacency[node] || [];
+    for (const dep of deps) {
+      if (!visited[dep]) {
+        if (detectCycle(dep)) return true;
+      } else if (recursionStack[dep]) {
+        return true;
+      }
+    }
+
+    recursionStack[node] = false;
+    return false;
+  }
+
+  for (const node of Object.keys(adjacency)) {
+    if (!visited[node]) {
+      if (detectCycle(node)) {
+        hasCycles = true;
+        break;
+      }
+    }
+  }
+
+  // Build Graph JSON (O(1) Runtime lookups)
+  const graphNodes = {};
+  for (const [id, data] of Object.entries(capabilities)) {
+    const dependents = reverseAdjacency[id] || [];
+    const isOrphan = data.dependencies.length === 0 && dependents.length === 0 && id !== 'qk-orchestrator' && id !== 'qk-help';
+
+    graphNodes[id] = {
+      path: data.path,
+      version: data.version,
+      tags: data.tags,
+      dependencies: data.dependencies,
+      dependents,
+      is_orphan: isOrphan
+    };
+  }
+
+  const graphJsonData = {
+    schema_version: 1,
+    manifest_version: '8.2',
+    generated_at: new Date().toISOString(),
+    nodes: graphNodes,
+    adjacency,
+    stats: {
+      total_capabilities: Object.keys(capabilities).length,
+      has_cycles: hasCycles
+    }
+  };
+
+  // Build Registry Index YAML (Lightweight lookup)
+  const indexYamlContent = `# AUTO-GENERATED BY registry-builder (tooling/build-registry.js)\n# DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.\n` +
+    yaml.dump({
+      schema_version: 1,
+      manifest_version: '8.2',
+      generated_at: new Date().toISOString(),
+      capabilities
+    }, { indent: 2 });
+
+  fs.writeFileSync(INDEX_YAML, indexYamlContent, 'utf8');
+  fs.writeFileSync(GRAPH_JSON, JSON.stringify(graphJsonData, null, 2), 'utf8');
+
+  console.log(`✅ Generated lightweight registry index at .agents/registry/index.yaml (${Object.keys(capabilities).length} capabilities)`);
+  console.log(`✅ Generated O(1) adjacency graph at .agents/registry/graph.json (has_cycles: ${hasCycles})`);
+}
+
+buildRegistry();

package/tooling/fix-refactor.js

@@ -0,0 +1,8 @@
+const fs = require('fs');
+
+const skillMd = `---\nname: qk-refactor\nversion: 8.0.0\nstatus: stable\ndescription: "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."\nplatforms: [antigravity, claude-code, cursor, windsurf, kilo-code]\n\ntype: capability\n\nintent:\n  - refactoring\n  - code-cleanup\n  - complexity-reduction\n\ncomplexity:\n  level: medium\n  criteria:\n    files_affected: "2-5"\n    has_behavior_change: false\n    has_external_dependency: false\n    has_breaking_change: false\n\ntriggers:\n  - refactor\n  - tái cấu trúc\n  - clean up this code\n  - simplify\n  - reduce complexity\n  - dẫn cấu trúc code\n\nselection:\n  priority: medium\n  confidence_threshold: 0.80\n\nworkflow: refactor\n\nrules:\n  - global\n  - coding\n  - safety\n\ntools:\n  - filesystem\n  - terminal\n\nrelated_skills:\n  - qk-engineering-standard\n  - qk-project-health\n\nknowledge_scope:\n  owns:\n    - refactoring-patterns\n    - code-smells\n  references:\n    - architecture\n    - coding-standards\n\nverification:\n  required: true\n  strategy: refactor\n\nexamples: []\nlearnings: []\n\nexecution_mode: deterministic\ncost: medium\nlatency: medium\nrisk: medium\nside_effects: edit_files\nproduces: [code, report]\nconsumes: [source-code]\n\ntoken_budget:\n  max_files_read: 3\n  max_lines_per_read: 150\n  max_shell_commands: 2\n  stop_early: true\n\nexit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]\n---\n\n# qk-refactor - Safe Refactor\n\n> Language rule: Code, identifiers, file names → English. Explanations, summaries → Vietnamese.\n\n## Preconditions\n- [ ] Target file(s) or module(s) are specified\n- [ ] Tests exist for the target code (or can be created)\n\nOn missing precondition:\n  EXIT: BLOCKED\n  Message: "Missing: target files or test coverage"\n\n## Scope\n- Improve internal code quality without changing external behavior\n- Reduce complexity, improve naming, extract functions\n- Remove dead code and duplication\n\n## Non-Goals\n- Add new functionality\n- Change public API signatures\n- Modify behavior or business logic\n\n## Workflow\n1. Establish baseline (current behavior + tests)\n2. Plan refactor steps\n3. Execute step by step\n4. Verify behavior unchanged\n5. Run validation gate\n\n## Exit Codes\n| Code | Meaning |\n|------|---------|\n| SUCCESS | Refactor complete, behavior preserved, tests pass |\n| PARTIAL | Refactor done, some tests need attention |\n| BLOCKED | Missing preconditions |\n| FAILED | Behavior changed or tests broken |\n`;
+
+const capYaml = `schema_version: 1\nid: "qk-refactor"\nversion: "8.0.0"\ndescription: "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."\ndependencies:\n  - "refactor"\ntools:\n  - "filesystem"\n  - "terminal"\nknowledge:\n  owns:\n    - "refactoring-patterns"\n    - "code-smells"\n  references:\n    - "architecture"\n    - "coding-standards"\neval:\n  scorecard: "evals/scorecard.yaml"\ndecision_boundary:\n  owns:\n    - "refactoring-patterns"\n  does_not_own:\n    - "new-functionality"\n    - "api-changes"\n  conflicts_with: []\n  delegates_to: []\n`;\n
+fs.writeFileSync('.agents/skills/qk-refactor/SKILL.md', skillMd, 'utf8');
+fs.writeFileSync('.agents/skills/qk-refactor/capability.yaml', capYaml, 'utf8');
+console.log('Written qk-refactor files with correct UTF-8 encoding');

package/tooling/sync-versions.js

@@ -0,0 +1,49 @@
+import fs from 'fs';
+import path from 'path';
+
+const targetVersion = "8.3.1";
+const rootDir = process.cwd();
+const skillsDir = path.join(rootDir, '.agents', 'skills');
+
+const skills = fs.readdirSync(skillsDir).filter(f => fs.statSync(path.join(skillsDir, f)).isDirectory());
+
+let updatedCount = 0;
+
+skills.forEach(skill => {
+  const skillPath = path.join(skillsDir, skill);
+  
+  // 1. SKILL.md
+  const skillMdPath = path.join(skillPath, 'SKILL.md');
+  if (fs.existsSync(skillMdPath)) {
+    let content = fs.readFileSync(skillMdPath, 'utf8');
+    const newContent = content.replace(/^version:\s*["']?[\d.]+["']?/m, `version: ${targetVersion}`);
+    if (content !== newContent) {
+      fs.writeFileSync(skillMdPath, newContent);
+      updatedCount++;
+    }
+  }
+
+  // 2. capability.yaml
+  const capPath = path.join(skillPath, 'capability.yaml');
+  if (fs.existsSync(capPath)) {
+    let content = fs.readFileSync(capPath, 'utf8');
+    const newContent = content.replace(/^version:\s*["']?[\d.]+["']?/m, `version: "${targetVersion}"`);
+    if (content !== newContent) {
+      fs.writeFileSync(capPath, newContent);
+      updatedCount++;
+    }
+  }
+
+  // 3. evals/scorecard.yaml
+  const evalPath = path.join(skillPath, 'evals', 'scorecard.yaml');
+  if (fs.existsSync(evalPath)) {
+    let content = fs.readFileSync(evalPath, 'utf8');
+    const newContent = content.replace(/^version:\s*["']?[\d.]+["']?/m, `version: ${targetVersion}`);
+    if (content !== newContent) {
+      fs.writeFileSync(evalPath, newContent);
+      updatedCount++;
+    }
+  }
+});
+
+console.log(`✅ Synchronized version to ${targetVersion} across ${updatedCount} files.`);

package/tooling/validate-graph.js

@@ -1,87 +1,87 @@
-import fs from 'fs';
-import path from 'path';
-import yaml from 'js-yaml';
-
-const GRAPH_FILE = path.resolve('.agents/registry/capability-graph.yml');
-
-function validateGraph() {
-  if (!fs.existsSync(GRAPH_FILE)) {
-    console.error('Không tìm thấy capability-graph.yml');
-    process.exit(1);
-  }
-
-  const content = fs.readFileSync(GRAPH_FILE, 'utf8');
-  const graph = yaml.load(content);
-
-  const nodes = Object.keys(graph.nodes || {});
-  const edges = graph.edges || [];
-
-  let errors = [];
-  
-  // 1. Kiểm tra edge references (tồn tại node đích)
-  let conflictsCount = 0;
-  edges.forEach(e => {
-    if (!nodes.includes(e.to)) {
-       // Cảnh báo nhưng không luôn lỗi vì to có thể là tên workflow
-       if (e.relation !== 'depends_on') {
-         errors.push(`Edge error: '${e.from}' trỏ đến '${e.to}' không tồn tại trong nodes (${e.relation})`);
-       }
-    }
-    if (e.relation === 'conflicts_with') conflictsCount++;
-  });
-
-  // 2. Kiểm tra reverse delegation (implementation -> architecture)
-  // Logic giả định dựa trên keyword
-  edges.forEach(e => {
-    if (e.relation === 'delegates_to') {
-       if (e.from.includes('ui-builder') && e.to.includes('architecture')) {
-           errors.push(`Policy violation: Implementation skill '${e.from}' không được delegate cho Architecture skill '${e.to}'`);
-       }
-    }
-  });
-
-  // 3. Isolated nodes (Ngoại trừ qk-orchestrator, qk-product-specification)
-  let orphanCount = 0;
-  const allowedIsolated = ['qk-orchestrator', 'qk-product-specification'];
-  
-  const connectedNodes = new Set();
-  edges.forEach(e => {
-    connectedNodes.add(e.from);
-    if (nodes.includes(e.to)) connectedNodes.add(e.to);
-  });
-
-  nodes.forEach(n => {
-    if (!connectedNodes.has(n)) {
-       if (!allowedIsolated.includes(n)) {
-          errors.push(`Orphan node: '${n}' bị cô lập (không nối đi đâu, không ai nối tới).`);
-          orphanCount++;
-       }
-    }
-  });
-
-  // Mock Cycles check
-  let cyclesCount = 0; // Để đơn giản, giả lập 0 cycles. Trong thực tế dùng thuật toán DFS.
-
-  const score = Math.max(0, 100 - (errors.length * 5));
-
-  console.log('─────────────────────────────────────────────────');
-  console.log('📊 Capability Graph Health');
-  console.log('─────────────────────────────────────────────────');
-  console.log(`Nodes:       ${nodes.length}`);
-  console.log(`Edges:       ${edges.length}`);
-  console.log(`Coverage:    100%`);
-  console.log(`Conflicts:   ${conflictsCount}`);
-  console.log(`Orphan:      ${orphanCount}`);
-  console.log(`Cycles:      ${cyclesCount}`);
-  console.log(`\nScore:       ${score}/100`);
-  
-  if (errors.length > 0) {
-    console.log('\n⚠️ Cảnh báo & Lỗi:');
-    errors.forEach(err => console.log(`- ${err}`));
-    process.exit(1);
-  } else {
-    console.log('\n✅ Capability Graph hợp lệ.');
-  }
-}
-
-validateGraph();
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+
+const GRAPH_FILE = path.resolve('.agents/registry/capability-graph.yml');
+
+function validateGraph() {
+  if (!fs.existsSync(GRAPH_FILE)) {
+    console.error('Không tìm thấy capability-graph.yml');
+    process.exit(1);
+  }
+
+  const content = fs.readFileSync(GRAPH_FILE, 'utf8');
+  const graph = yaml.load(content);
+
+  const nodes = Object.keys(graph.nodes || {});
+  const edges = graph.edges || [];
+
+  let errors = [];
+  
+  // 1. Kiểm tra edge references (tồn tại node đích)
+  let conflictsCount = 0;
+  edges.forEach(e => {
+    if (!nodes.includes(e.to)) {
+       // Cảnh báo nhưng không luôn lỗi vì to có thể là tên workflow
+       if (e.relation !== 'depends_on') {
+         errors.push(`Edge error: '${e.from}' trỏ đến '${e.to}' không tồn tại trong nodes (${e.relation})`);
+       }
+    }
+    if (e.relation === 'conflicts_with') conflictsCount++;
+  });
+
+  // 2. Kiểm tra reverse delegation (implementation -> architecture)
+  // Logic giả định dựa trên keyword
+  edges.forEach(e => {
+    if (e.relation === 'delegates_to') {
+       if (e.from.includes('ui-builder') && e.to.includes('architecture')) {
+           errors.push(`Policy violation: Implementation skill '${e.from}' không được delegate cho Architecture skill '${e.to}'`);
+       }
+    }
+  });
+
+  // 3. Isolated nodes (Ngoại trừ qk-orchestrator, qk-product-specification)
+  let orphanCount = 0;
+  const allowedIsolated = ['qk-orchestrator', 'qk-product-specification'];
+  
+  const connectedNodes = new Set();
+  edges.forEach(e => {
+    connectedNodes.add(e.from);
+    if (nodes.includes(e.to)) connectedNodes.add(e.to);
+  });
+
+  nodes.forEach(n => {
+    if (!connectedNodes.has(n)) {
+       if (!allowedIsolated.includes(n)) {
+          errors.push(`Orphan node: '${n}' bị cô lập (không nối đi đâu, không ai nối tới).`);
+          orphanCount++;
+       }
+    }
+  });
+
+  // Mock Cycles check
+  let cyclesCount = 0; // Để đơn giản, giả lập 0 cycles. Trong thực tế dùng thuật toán DFS.
+
+  const score = Math.max(0, 100 - (errors.length * 5));
+
+  console.log('─────────────────────────────────────────────────');
+  console.log('📊 Capability Graph Health');
+  console.log('─────────────────────────────────────────────────');
+  console.log(`Nodes:       ${nodes.length}`);
+  console.log(`Edges:       ${edges.length}`);
+  console.log(`Coverage:    100%`);
+  console.log(`Conflicts:   ${conflictsCount}`);
+  console.log(`Orphan:      ${orphanCount}`);
+  console.log(`Cycles:      ${cyclesCount}`);
+  console.log(`\nScore:       ${score}/100`);
+  
+  if (errors.length > 0) {
+    console.log('\n⚠️ Cảnh báo & Lỗi:');
+    errors.forEach(err => console.log(`- ${err}`));
+    process.exit(1);
+  } else {
+    console.log('\n✅ Capability Graph hợp lệ.');
+  }
+}
+
+validateGraph();