ai-developer-skill-os 8.3.0 → 9.0.0

package/bin/install.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import fs from 'fs';
 import path from 'path';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "8.3.0",
-  "description": "EDAOS v8.3 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
+  "version": "9.0.0",
+  "description": "EDAOS v9.0 — Governed Capability Platform & Universal Project Knowledge V1 (Dual-Mode Memory Architecture).",
   "main": "bin/install.js",
   "files": [
     "bin",
@@ -20,12 +20,15 @@
     "node": ">=18.0.0"
   },
   "scripts": {
+    "sync:v9": "node tooling/sync-versions.js",
     "build:registry": "node tooling/build-registry.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:registry": "vitest run && node tooling/build-registry.js",
     "test:graph": "node tooling/validate-graph.js",
-    "lint": "node bin/lint.js",
+    "lint": "node tooling/validate-skills.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",

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');