ai-developer-skill-os 8.2.0 → 8.3.0

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());
-    });
-  });
-}
+#!/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();
+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.0",
-  "description": "EDAOS v8.2 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
+  "version": "8.3.0",
+  "description": "EDAOS v8.3 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
   "main": "bin/install.js",
   "files": [
     "bin",

package/.agents/CHANGELOG.md

@@ -1,131 +0,0 @@
-# Changelog
-
-All notable changes to AI Developer Skill OS are documented here.
-Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
-
----
-
-## [8.2.0] — 2026-07 — EDAOS v8.2: Governed Capability Metadata & Eval Platform
-
-### Added
-- **Manifest-First Architecture & Registry Engine**: Created `tooling/build-registry.js` (`npm run build:registry`) generating lightweight lookup index `.agents/registry/index.yaml` and O(1) runtime adjacency graph `.agents/registry/graph.json` with cycle/orphan detection.
-- **V8.2 Blueprint Plugins**: Introduced customizable project scaffolding templates under `.agents/blueprints/` (`rag`, `coding`, `workflow`) featuring multi-profile environments (`development`, `production`, `testing`) and feature flags.
-- **Governed Capability Manifests**: Created minimalist `.agents/skills/_template/capability.yaml` (`schema_version: 1`) to decouple execution metadata from natural language instructions.
-- **Eval Pipeline Platform**: Added quantitative verification frameworks via inheritance-ready `.agents/skills/_template/evals/scorecard.yaml` (`extends: default`), linking ground-truth execution traces with automated score rubrics.
-- **Domain Patterns Reference Architecture**: Added reference blueprint for Enterprise Domain AI at `.agents/knowledge/domain-patterns/construction/ddc-construction-ai-blueprint.md` (Construction AI, DDC 192 domain skills, QTO IFC bóc tách, n8n automation workflows) showcasing zero interference with core developer capabilities.
-
-### Changed
-- **`qk-project-bootstrap` Evolution (v8.2.0)**: Upgraded to support One-Click Blueprint selection, automated `project.yaml` generation, and the Universal 4-Folder RAG Architecture (`prompts/`, `data/`, `agents/`, `evals/`).
-- **`qk-validation-gate` Evolution (v8.2.0)**: Integrated automated Eval Pipeline validation, reading `scorecard.yaml` rubrics, verifying trace logs in `evals/traces/`, and enforcing quantitative pass thresholds.
-- **`qk-ai-builder` Evolution (v8.2.0)**: Upgraded to Manifest-first capability packaging and strict 4-folder data discipline (immutable `data/raw/` vs cleaned `data/processed/`).
-- Updated system core description in `package.json` to reflect the EDAOS v8.2 paradigm shift.
-- Synced `.agents/CHANGELOG.md` and `.agents/README.md` with root documentation.
-
----
-
-## [8.1.7] — 2026-07 — README Sync
-
-### Changed
-- **README Sync**: Synced `.agents/README.md` with root `README.md` so the installed documentation is fully up-to-date with V8.1 architecture.
-- Bumped version to `8.1.7`.
-
----
-
-## [8.1.6] — 2026-07 — Design Intelligence Content & Sync
-
-### Added
-- **Design Intelligence Populated**: Sourced core market-standard knowledge (Tailwind, Radix, Apple, Vercel-like principles) into `.agents/knowledge/design-intelligence/` covering components, patterns, industries, themes, and references.
-- **Animation Knowledge**: Added `visual-language/animation.md` for micro-interactions and transition durations.
-- **Dependency Wiring**: Linked `qk-ui-system-builder` to `design-intelligence` so it utilizes the newly generated design constraints.
-- **Changelog Sync**: Synced `.agents/CHANGELOG.md` with root `CHANGELOG.md` so the installed copy reflects the true V8 evolution.
-
-### Changed
-- All skill descriptions properly translated to Vietnamese for ecosystem consistency.
-- Bumped version to `8.1.6` for final, truly complete Design Intelligence NPM Release.
-
----
-
-## [8.1.4] — 2026-07 — Design Intelligence Pack
-
-### Added
-- **Design Intelligence Layer**: `.agents/knowledge/design-intelligence/` (industries, themes, patterns, visual-language, components, templates)
-- **Knowledge Dependencies**: `qk-design-system-engineering` and `qk-ui-builder` now have strict dependency bounds tied to Design Intelligence without bloating the Capability Graph.
-- **Design Routing Test Cases**: `design-intel-01`, `02`, `03` for validating routing logic in design scenarios.
-- **Re-introduced CLI Installer**: Restored and refactored `bin/install.js` to correctly copy `.agents` across global/local directories for easy NPM setup.
-
-### Changed
-- Refined **Decision Boundaries**: `qk-ui-builder` explicitly forbidden from defining visual direction or brand identity (strict capability bounds).
-- **README.md** reflects 30 Master Skills and the "Agent Engineering OS" mindset.
-- **package.json**: Version bump `8.1.4` and whitelisted files for npm publish.
-
----
-
-## [8.1.3] — 2026-07 — Architecture Freeze & Governance
-
-### Added
-- **Capability Graph & Routing**: `.agents/registry/capability-graph.yml` to define skill relations (`depends_on`, `delegates_to`).
-- **Priority Governance**: `.agents/rules/priorities.yml` enforcing safety layers (`P1: System Integrity`, `P2: Guardrails`).
-- **Audit Tools**: `tooling/run-aar.js` for architectural acceptance testing.
-- Test cases for routing and boundary attacks.
-
-### Changed
-- Name transition from "Self-Improving" to **Adaptive Agent OS** (Self Optimizing ≠ Self Modifying).
-- Enforced hard cap of **30 Skills** to prevent Skill Inflation.
-- Frozen Baseline achieved: `v8.1.3-agent-os-production`.
-
----
-
-## [8.0.0] — 2026-07 — Agent Knowledge System
-
-### Philosophy shift
-- **V7:** Skill Repository — human selects skill, AI executes
-- **V8:** Agent Knowledge System — AI retrieves context, selects capability, executes workflow, verifies
-
-### Added
-- `rules/` — Agent behavior policies (global, coding, safety)
-- `workflows/` — Reusable execution pipelines (YAML, with inputs/outputs per step)
-- `examples/` — Few-shot knowledge (good/, bad/)
-- `learnings/` — Evidence-based learning lifecycle (draft/, validated/, deprecated/)
-- `registry/` — Generated AI retrieval index (skills-index.yml)
-- `docs/ARCHITECTURE.md` — Agent request flow diagram
-- `docs/VERSIONING.md` — Semantic versioning policy
-- `docs/schemas/` — Schema definitions for all knowledge objects
-- `docs/decisions/` — Architecture Decision Records (ADRs)
-- `.agentsignore` — AI boundary file (what agents should NOT load)
-- `tooling/` — Dev automation (generate-registry.js, validate-skills.js)
-- `tests/agent-evaluation/` — Agent behavior test harness
-
-### Changed
-- SKILL.md schema upgraded to V8: added `type`, `intent`, `triggers`, `complexity`, `workflow`, `verification`, `related_skills`
-- `skills.json` demoted to **generated compatibility manifest** (source of truth = SKILL.md)
-- Workflows extracted from individual skills → shared reusable templates
-
-### Removed
-- Embedded workflows inside SKILL.md body (moved to workflows/)
-- Old migration scripts (migrate-v*.js, patch*.py, add_lang.*, etc.)
-- Duplicate documentation (CLAUDE.md, old docs/)
-- Experimental packages (packages/edaos-sdk)
-- framework/, knowledge/, specs/, templates/ directories
-
-### Migration
-- V7.5.1 tagged at git: `v7.5.1`
-- V7 skills preserved in git history; migration is additive schema upgrade
-
----
-
-## [7.5.1] — 2026-07 — Final V7 Release
-
-- Bumped all skill versions to 7.5.1
-- Added qk-fe-api-integration skill
-- Added qk-performance-tuner (global config)
-- Stabilized frontmatter schema across all 22 skills
-
-## [7.5.0] — 2026-07
-
-- Major skills refactor with EDAOS runtime adapter
-- Added MCP server integration
-- Added qk-bug-resolution workflow contracts
-
-## [7.0.0] — 2026
-
-- V7 release: 22 skills, YAML frontmatter, token budget system