0xray 2.2.2 → 2.2.4

package/.opencode/codex.codex

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "terms": [
      1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68
   ],

package/.opencode/commands/dependency-audit.md

@@ -69,7 +69,7 @@ Comprehensive dependency analysis and security audit for all project dependencie
   "vulnerabilities": [
     {
       "package": "lodash",
-      "version": "2.2.1",
+      "version": "2.2.2",
       "severity": "high",
       "cve": "CVE-2021-23337",
       "description": "Command injection vulnerability"
@@ -85,14 +85,14 @@ Security-focused format for CI/CD integration:
 
 ```json
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
   "runs": [
     {
       "tool": {
         "driver": {
           "name": "Dependency Audit",
-          "version": "2.2.1"
+          "version": "2.2.2"
         }
       },
       "results": [...]

package/.opencode/enforcer-config.json

@@ -1,6 +1,6 @@
 {
   "framework": "xray 2.0",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Codex-compliant framework configuration for Credible UI project",
   "thresholds": {
     "bundleSize": {
@@ -220,7 +220,7 @@
       }
     },
     "codex": {
-      "version": "2.2.1",
+      "version": "2.2.2",
       "terms": [
         1,
         2,

package/README.md

@@ -1,6 +1,6 @@
 # 0xRay — Self-Healing AI Governance OS
 
-**v2.1.3** — 42 agents · 46 skills · 15 MCPs servers · 9 codex terms · ~2,2196 tests
+**v2.2.3** — 41 agents · 44 skills · 15 MCPs servers · 9 codex terms · 160 test files
 
 [![Docs](https://img.shields.io/badge/docs-0xRayAI.github.io/xray-10b981?style=flat-square)](https://0xrayai.github.io/xray/)
 
@@ -179,7 +179,7 @@ Every subsystem is configurable via `features.json` (located at `.opencode/xray/
 
 ```json
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "token_optimization": {
     "enabled": true,
     "max_context_tokens": 20000,
@@ -277,7 +277,7 @@ Install more skills anytime: `npx 0xray skill:install`
 
 ## Testing & Reliability
 
-0xRay is battle-tested with **~2,2196 tests** across every subsystem:
+0xRay is battle-tested with **160 test files** (2,778+ individual tests) across every subsystem:
 
 | Suite | Tests | Status |
 |-------|-------|--------|

package/dist/CHANGELOG.md

@@ -4,6 +4,72 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Conventional Commits](https://www.conventionalcommits.org/).
 
+## [2.2.4] - 2026-06-10
+
+### 🐛 Bug Fixes
+- fix: Dynamo SSOT local-mode for inference cycles (requireExternalDynamo: !XRAY_LOCAL_MODE to prevent silent needs_revision fallback in dev/CI) (5e0746665)
+- ci: add verify:consumer as hard gate in release.yml before GitHub release (5e0746665)
+- fix: routing cleanup — dedup availableServers list, correct research/explore mapping to "researcher" skill directly (prior + 5e0746665)
+- fix: release.mjs publish timeout handling (npm view check for "already published") and step order (push before publish) (b444b6ac8, b1f9c6cdd)
+
+### 🔄 Changes
+- Scope 2.2.4 to the 5 blocking items only (Dynamo, CI gate, routing hygiene). All Phase 1-4 deferred to v3 per v3-architecture-plan.md.
+
+---
+
+## [2.2.3] - 2026-06-10
+
+### 🔄 Changes
+
+### 🐛 Bug Fixes
+- fix: make hermes E2E tolerant to model response variance; soft-fail Phase 3/6, keep hard gates on bridge + activity.log (a290fb9ec)
+- fix: sync README counts (41 agents, 44 skills, 15 MCPs, 68 codex terms, 160 tfiles); version-manager now auto-counts codex + tests (a783dc2e6)
+
+---
+
+## [2.2.2] - 2026-06-10
+
+### 🔄 Changes
+
+### 🐛 Bug Fixes
+- fix: make hermes E2E tolerant to model response variance; soft-fail Phase 3/6, keep hard gates on bridge + activity.log (a290fb9ec)
+- fix: sync README counts (41 agents, 44 skills, 15 MCPs, 68 codex terms, 160 tfiles); version-manager now auto-counts codex + tests (a783dc2e6)
+
+---
+
+## [2.2.2] - 2026-06-10
+
+### 🔄 Changes
+
+### 🐛 Bug Fixes
+- fix: sync README counts (41 agents, 44 skills, 15 MCPs, 68 codex terms, 160 tfiles); version-manager now auto-counts codex + tests (a783dc2e6)
+
+---
+
+## [2.2.2] - 2026-06-10
+
+### 🔄 Changes
+
+- Version bump
+
+---
+
+## [2.2.2] - 2026-06-10
+
+### 🔄 Changes
+
+- Version bump
+
+---
+
+## [2.2.2] - 2026-06-10
+
+### 🔄 Changes
+
+- Version bump
+
+---
+
 ## [2.2.2] - 2026-06-10
 
 ### 🔄 Changes

package/dist/README.md

@@ -1,6 +1,6 @@
 # 0xRay — Self-Healing AI Governance OS
 
-**v2.1.3** — 42 agents · 46 skills · 15 MCPs servers · 9 codex terms · ~2,2196 tests
+**v2.2.3** — 41 agents · 44 skills · 15 MCPs servers · 9 codex terms · 160 test files
 
 [![Docs](https://img.shields.io/badge/docs-0xRayAI.github.io/xray-10b981?style=flat-square)](https://0xrayai.github.io/xray/)
 
@@ -179,7 +179,7 @@ Every subsystem is configurable via `features.json` (located at `.opencode/xray/
 
 ```json
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "token_optimization": {
     "enabled": true,
     "max_context_tokens": 20000,
@@ -277,7 +277,7 @@ Install more skills anytime: `npx 0xray skill:install`
 
 ## Testing & Reliability
 
-0xRay is battle-tested with **~2,2196 tests** across every subsystem:
+0xRay is battle-tested with **160 test files** (2,778+ individual tests) across every subsystem:
 
 | Suite | Tests | Status |
 |-------|-------|--------|

package/dist/analytics/routing-refiner.js

@@ -36,7 +36,7 @@ class RoutingRefiner {
         const optimizations = this.suggestMappingOptimizations(promptAnalysis, performanceReport);
         const warnings = this.generateWarnings(newMappings, optimizations);
         return {
-            version: "2.2.1",
+            version: "2.2.2",
             generatedAt: new Date(),
             summary: {
                 newMappings: newMappings.length,

package/dist/config/routing-mappings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Routing Mappings — Shared keyword→agent+skill lookup table.
+ *
+ * Extracted from enforcer-tools.ts to be queryable at runtime
+ * by the main AI delegation decision tools.
+ */
+export interface RoutingMappingEntry {
+    keywords: string[];
+    skill: string;
+    agent: string;
+    confidence: number;
+}
+export declare const ROUTING_MAPPINGS: RoutingMappingEntry[];
+export interface RoutingMatch {
+    agent: string;
+    skill: string;
+    confidence: number;
+    matchedKeywords: string[];
+}
+export declare function queryRoutingMappings(keywords: string[]): RoutingMatch[];
+export declare function getAllRoutingMappings(): RoutingMappingEntry[];

package/dist/config/routing-mappings.js

@@ -0,0 +1,132 @@
+/**
+ * Routing Mappings — Shared keyword→agent+skill lookup table.
+ *
+ * Extracted from enforcer-tools.ts to be queryable at runtime
+ * by the main AI delegation decision tools.
+ */
+export const ROUTING_MAPPINGS = [
+    // Core built-in skills (high confidence)
+    { keywords: ["write", "file", "create"], skill: "code-review", agent: "code-reviewer", confidence: 0.9 },
+    { keywords: ["review", "audit", "assess", "evaluate", "check", "inspect", "quality", "validate", "code-review"], skill: "code-review", agent: "code-reviewer", confidence: 0.9 },
+    { keywords: ["test", "testing", "jest", "coverage", "unit", "e2e", "cypress", "spec", "verify"], skill: "testing-strategy", agent: "testing-lead", confidence: 0.95 },
+    { keywords: ["fix", "debug", "triage", "broken", "error", "crash", "bug", "issue", "resolve"], skill: "bug-triage", agent: "bug-triage-specialist", confidence: 0.92 },
+    { keywords: ["security", "vulnerability", "threat", "scan", "risk", "exploit", "secure", "pentest"], skill: "security-audit", agent: "security-auditor", confidence: 0.95 },
+    { keywords: ["refactor", "cleanup", "improve", "restructure", "modernize", "debt"], skill: "refactoring-strategies", agent: "refactorer", confidence: 0.92 },
+    { keywords: ["performance", "optimize", "bottleneck", "benchmark", "profile", "speed"], skill: "performance-optimization", agent: "performance-engineer", confidence: 0.93 },
+    { keywords: ["frontend", "react", "vue", "angular", "ui", "ux", "interface", "component"], skill: "frontend-development", agent: "frontend-engineer", confidence: 0.95 },
+    { keywords: ["backend", "api", "server", "microservice", "endpoint"], skill: "backend-development", agent: "backend-engineer", confidence: 0.95 },
+    { keywords: ["docs", "documentation", "readme", "wiki", "guide", "manual"], skill: "documentation-generation", agent: "tech-writer", confidence: 0.9 },
+    { keywords: ["database", "db", "sql", "schema", "migration", "query"], skill: "database-design", agent: "database-engineer", confidence: 0.95 },
+    { keywords: ["deploy", "ci/cd", "pipeline", "docker", "kubernetes", "infrastructure"], skill: "devops-deployment", agent: "devops-engineer", confidence: 0.94 },
+    { keywords: ["mobile", "ios", "android", "react-native", "flutter"], skill: "mobile-development", agent: "mobile-developer", confidence: 0.95 },
+    { keywords: ["enforce", "compliance", "rule", "standard", "codex", "block", "prevent"], skill: "code-review", agent: "code-reviewer", confidence: 0.95 },
+    { keywords: ["design", "architect", "plan", "system", "model", "pattern", "architecture"], skill: "architecture-patterns", agent: "architect", confidence: 0.95 },
+    { keywords: ["codebase", "explore", "research", "discover", "implementation"], skill: "researcher", agent: "researcher", confidence: 0.92 },
+    // Additional built-in skill mappings
+    { keywords: ["api", "rest", "graphql", "openapi", "endpoint", "swagger"], skill: "api-design", agent: "backend-engineer", confidence: 0.9 },
+    { keywords: ["strategy", "roadmap", "planning", "technical", "decision", "architecture"], skill: "architecture-patterns", agent: "strategist", confidence: 0.88 },
+    { keywords: ["reflection", "story", "narrative", "saga", "journey", "document"], skill: "storyteller", agent: "tech-writer", confidence: 0.85 },
+    { keywords: ["analyze", "metrics", "complexity", "maintainability", "quality"], skill: "code-analyzer", agent: "code-analyzer", confidence: 0.9 },
+    { keywords: ["growth", "marketing", "conversion", "acquisition", "user-acquisition"], skill: "growth-strategist", agent: "growth-strategist", confidence: 0.9 },
+    { keywords: ["seo", "search", "organic", "traffic", "keywords", "ranking"], skill: "seo-consultant", agent: "seo-consultant", confidence: 0.92 },
+    { keywords: ["content", "copy", "blog", "marketing", "social"], skill: "content-creator", agent: "content-creator", confidence: 0.88 },
+    { keywords: ["format", "lint", "prettier", "eslint", "style", "formatting"], skill: "auto-format", agent: "code-reviewer", confidence: 0.85 },
+    { keywords: ["project", "structure", "health", "dependencies", "architecture"], skill: "project-analysis", agent: "architect", confidence: 0.88 },
+    { keywords: ["compliance", "audit", "standards", "framework", "validation"], skill: "framework-compliance-audit", agent: "code-reviewer", confidence: 0.9 },
+    { keywords: ["session", "state", "persistence", "storage", "cache"], skill: "session-management", agent: "backend-engineer", confidence: 0.85 },
+    { keywords: ["image", "visual", "pdf", "diagram", "multimedia", "media"], skill: "multimodal-looker", agent: "multimodal-looker", confidence: 0.92 },
+    { keywords: ["testing", "strategy", "coverage", "test-plan"], skill: "testing-strategy", agent: "testing-lead", confidence: 0.92 },
+    { keywords: ["inference", "model", "llm", "tuning", "optimization"], skill: "inference-improve", agent: "performance-engineer", confidence: 0.88 },
+    { keywords: ["orchestrate", "boot", "initialize", "startup", "bootstrap"], skill: "boot-orchestrator", agent: "architect", confidence: 0.9 },
+    // Additional unmapped skills
+    { keywords: ["tool", "utility", "helper", "instrument"], skill: "architect-tools", agent: "architect", confidence: 0.85 },
+    { keywords: ["design", "visual", "style", "theme", "css", "accessibility"], skill: "ui-ux-design", agent: "frontend-ui-ux-engineer", confidence: 0.9 },
+    { keywords: ["agent", "multi-agent", "coordination", "hermes", "communication"], skill: "hermes-agent", agent: "architect", confidence: 0.88 },
+    { keywords: ["log", "diagnostic", "trace", "monitor", "watch"], skill: "log-monitor", agent: "log-monitor", confidence: 0.9 },
+    { keywords: ["health", "diagnostic", "model-health", "validate-llm"], skill: "model-health-check", agent: "performance-engineer", confidence: 0.88 },
+    { keywords: ["profiling", "memory", "cpu", "latency"], skill: "performance-analysis", agent: "performance-engineer", confidence: 0.9 },
+    { keywords: ["pipeline", "stream", "etl", "batch", "process"], skill: "processor-pipeline", agent: "backend-engineer", confidence: 0.88 },
+    { keywords: ["vulnerability", "cve", "sast", "dast", "dependency-check"], skill: "security-scan", agent: "security-auditor", confidence: 0.92 },
+    { keywords: ["state", "store", "redux", "context", "persistence"], skill: "state-manager", agent: "backend-engineer", confidence: 0.88 },
+    // Community Skills (optional, lower confidence)
+    { keywords: ["theme", "design-system", "color", "font", "typography", "palette"], skill: "antigravity--theme-factory", agent: "frontend-ui-ux-engineer", confidence: 0.6 },
+    { keywords: ["hig", "salesforce design", "lightning design", "slds"], skill: "antigravity--hig-components-system", agent: "frontend-ui-ux-engineer", confidence: 0.65 },
+    { keywords: ["slide", "deck", "presentation", "powerpoint"], skill: "antigravity--theme-factory", agent: "content-creator", confidence: 0.55 },
+    { keywords: ["seo technical", "crawl", "indexability", "core web vitals", "sitemap"], skill: "antigravity--seo-technical", agent: "seo-consultant", confidence: 0.7 },
+    { keywords: ["seo structure", "content hierarchy", "schema", "internal linking"], skill: "antigravity--seo-structure-architect", agent: "seo-consultant", confidence: 0.7 },
+    { keywords: ["seo snippet", "meta description", "title tag"], skill: "antigravity--seo-snippet-hunter", agent: "seo-consultant", confidence: 0.7 },
+    { keywords: ["seo hreflang", "international seo", "multilingual"], skill: "antigravity--seo-hreflang", agent: "seo-consultant", confidence: 0.65 },
+    { keywords: ["backend security", "secure coding", "input validation", "authentication"], skill: "antigravity--backend-security-coder", agent: "security-auditor", confidence: 0.7 },
+    { keywords: ["mobile security", "ios security", "android security"], skill: "antigravity--mobile-security-coder", agent: "security-auditor", confidence: 0.65 },
+    { keywords: ["security audit", "vulnerability assessment", "penetration test"], skill: "security-audit", agent: "security-auditor", confidence: 0.75 },
+    { keywords: ["vector", "embeddings", "similarity search", "pinecone", "qdrant", "chroma"], skill: "antigravity--vector-database-engineer", agent: "database-engineer", confidence: 0.65 },
+    { keywords: ["similarity search", "approximate nearest neighbor"], skill: "antigravity--similarity-search-patterns", agent: "database-engineer", confidence: 0.65 },
+    { keywords: ["svelte", "sveltekit", "svelte.js"], skill: "antigravity--sveltekit", agent: "frontend-engineer", confidence: 0.65 },
+    { keywords: ["trpc", "typescript rpc", "tRPC"], skill: "antigravity--trpc-fullstack", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["vercel ai", "ai sdk", "vapi"], skill: "antigravity--vercel-ai-sdk-expert", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["threejs", "3d web", "webgl", "3d graphics"], skill: "antigravity--threejs-loaders", agent: "frontend-engineer", confidence: 0.6 },
+    { keywords: ["comfyui", "ai image generation", "stable diffusion"], skill: "antigravity--comfyui-gateway", agent: "multimodal-looker", confidence: 0.6 },
+    { keywords: ["swiftui", "ios development"], skill: "antigravity--swiftui-liquid-glass", agent: "mobile-developer", confidence: 0.7 },
+    { keywords: ["ios performance", "swift optimization"], skill: "antigravity--swiftui-performance-audit", agent: "mobile-developer", confidence: 0.65 },
+    { keywords: ["react native", "rn"], skill: "mobile-development", agent: "mobile-developer", confidence: 0.7 },
+    { keywords: ["golang", "go", "gopher"], skill: "antigravity--golang-pro", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["temporal", "workflow", " durable execution"], skill: "antigravity--temporal-golang-pro", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["python async", "asyncio", "uvloop"], skill: "antigravity--async-python-patterns", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["pydantic", "data validation", "python models"], skill: "antigravity--pydantic-models-py", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["scala", "spark", "big data"], skill: "antigravity--scala-pro", agent: "backend-engineer", confidence: 0.6 },
+    { keywords: ["dotnet", "c#", ".net"], skill: "antigravity--dotnet-backend-patterns", agent: "backend-engineer", confidence: 0.6 },
+    { keywords: ["azure", "azd", "azure deploy"], skill: "antigravity--azd-deployment", agent: "devops-engineer", confidence: 0.65 },
+    { keywords: ["azure storage", "file share"], skill: "antigravity--azure-storage-file-share-ts", agent: "devops-engineer", confidence: 0.6 },
+    { keywords: ["azure service bus", "messaging"], skill: "antigravity--azure-servicebus-py", agent: "devops-engineer", confidence: 0.6 },
+    { keywords: ["discord bot", "discord automation"], skill: "antigravity--discord-bot-architect", agent: "backend-engineer", confidence: 0.6 },
+    { keywords: ["n8n", "workflow automation"], skill: "antigravity--n8n-expression-syntax", agent: "devops-engineer", confidence: 0.6 },
+    { keywords: ["linkedin automation", "social posting"], skill: "antigravity--linkedin-automation", agent: "growth-strategist", confidence: 0.55 },
+    { keywords: ["reddit automation"], skill: "antigravity--reddit-automation", agent: "growth-strategist", confidence: 0.55 },
+    { keywords: ["freshdesk", "customer support automation"], skill: "antigravity--freshdesk-automation", agent: "devops-engineer", confidence: 0.55 },
+    { keywords: ["pagerduty", "incident management"], skill: "antigravity--pagerduty-automation", agent: "devops-engineer", confidence: 0.55 },
+    { keywords: ["local llm", "ollama", "llama", "local model"], skill: "antigravity--local-llm-expert", agent: "performance-engineer", confidence: 0.65 },
+    { keywords: ["mcp", "model context protocol"], skill: "antigravity--agent-memory-mcp", agent: "architect", confidence: 0.65 },
+    { keywords: ["agent evaluation", "agent testing"], skill: "antigravity--agent-evaluation", agent: "testing-lead", confidence: 0.65 },
+    { keywords: ["ai agent", "autonomous agent"], skill: "antigravity--ai-agent-development", agent: "backend-engineer", confidence: 0.65 },
+    { keywords: ["marketing content", "ad creative", "campaign"], skill: "antigravity--marketing-ideas", agent: "content-creator", confidence: 0.6 },
+    { keywords: ["conversion", "cro", "optimization"], skill: "antigravity--onboarding-cro", agent: "growth-strategist", confidence: 0.6 },
+    { keywords: ["code documentation", "code explain", "explain code"], skill: "antigravity--code-documentation-code-explain", agent: "tech-writer", confidence: 0.65 },
+    { keywords: ["code refactoring", "clean code"], skill: "antigravity--code-refactoring-refactor-clean", agent: "refactorer", confidence: 0.65 },
+    { keywords: ["code review checklist"], skill: "antigravity--code-review-checklist", agent: "code-reviewer", confidence: 0.7 },
+    { keywords: ["microservices", "service mesh", "distributed systems"], skill: "antigravity--microservices-patterns", agent: "architect", confidence: 0.65 },
+    { keywords: ["architecture decision", "adr", "decision records"], skill: "antigravity--architecture-decision-records", agent: "architect", confidence: 0.65 },
+    { keywords: ["context management", "context compression", "token optimization"], skill: "antigravity--context-compression", agent: "performance-engineer", confidence: 0.65 },
+    { keywords: ["context guardian", "memory safety"], skill: "antigravity--context-guardian", agent: "performance-engineer", confidence: 0.6 },
+    { keywords: ["context fundamentals"], skill: "antigravity--context-fundamentals", agent: "performance-engineer", confidence: 0.6 },
+    { keywords: ["interview", "technical interview", "coding interview"], skill: "antigravity--interview-coach", agent: "growth-strategist", confidence: 0.6 },
+    { keywords: ["i18n", "localization", "translation"], skill: "antigravity--i18n-localization", agent: "frontend-engineer", confidence: 0.6 },
+    { keywords: ["accessibility", "a11y", "wcag"], skill: "antigravity--accessibility-compliance-accessibility-audit", agent: "frontend-ui-ux-engineer", confidence: 0.7 },
+    { keywords: ["pwa", "progressive web app"], skill: "antigravity--progressive-web-app", agent: "frontend-engineer", confidence: 0.6 },
+    { keywords: ["data migration", "sql migration"], skill: "antigravity--database-migrations-sql-migrations", agent: "database-engineer", confidence: 0.65 },
+    { keywords: ["request code review", "pr review", "pull request"], skill: "superpowers--requesting-code-review", agent: "code-reviewer", confidence: 0.7 },
+];
+export function queryRoutingMappings(keywords) {
+    const descLower = keywords.join(" ").toLowerCase();
+    const matches = [];
+    for (const mapping of ROUTING_MAPPINGS) {
+        const matched = [];
+        for (const kw of mapping.keywords) {
+            if (descLower.includes(kw.toLowerCase())) {
+                matched.push(kw);
+            }
+        }
+        if (matched.length > 0) {
+            matches.push({
+                agent: mapping.agent,
+                skill: mapping.skill,
+                confidence: mapping.confidence,
+                matchedKeywords: matched,
+            });
+        }
+    }
+    matches.sort((a, b) => b.confidence - a.confidence);
+    return matches;
+}
+export function getAllRoutingMappings() {
+    return ROUTING_MAPPINGS;
+}

package/dist/core/boot-orchestrator.js

@@ -717,9 +717,9 @@ export class BootOrchestrator {
         try {
             // Consumer runtime compat (XRAY_ env + .xray fallbacks)
             const xrayConfig = {
-                version: "2.2.1",
+                version: "2.2.2",
                 codex_enabled: true,
-                codex_version: "v2.2.0",
+                codex_version: "v2.2.1",
                 codex_terms: [
                     1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
                     21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37,

package/dist/core/features-config.js

@@ -286,7 +286,7 @@ export class FeaturesConfigLoader {
      */
     getDefaultConfig() {
         return {
-            version: "2.2.1",
+            version: "2.2.2",
             description: "0xRay Framework - Unified Feature Configuration",
             token_optimization: {
                 enabled: true,

package/dist/enforcement/enforcer-tools.js

@@ -7,135 +7,13 @@ import { frameworkLogger } from "../core/framework-logger.js";
 import { AgentDelegator } from "../delegation/agent-delegator.js";
 import { XrayStateManager } from "../state/state-manager.js";
 import { strRayConfigLoader } from "../core/config-loader.js";
+import { ROUTING_MAPPINGS } from "../config/routing-mappings.js";
 import * as fs from "fs";
 import * as path from "path";
 // Minimum confidence to auto-delegate to another agent
 const DELEGATION_CONFIDENCE_THRESHOLD = 0.50;
 // Agents that enforcer should NOT delegate to (enforcer handles these itself)
 const ENFORCER_HANDLES = new Set(["code-reviewer"]);
-// Community skills are OPTIONAL - they may not be installed
-// These mappings have lower confidence (0.55-0.7) since skills may not be available
-// The system will fall back gracefully if the skill isn't installed
-const ROUTING_MAPPINGS = [
-    // Core built-in skills (high confidence)
-    { keywords: ["write", "file", "create"], skill: "code-review", agent: "code-reviewer", confidence: 0.9 },
-    { keywords: ["review", "audit", "assess", "evaluate", "check", "inspect", "quality", "validate", "code-review"], skill: "code-review", agent: "code-reviewer", confidence: 0.9 },
-    { keywords: ["test", "testing", "jest", "coverage", "unit", "e2e", "cypress", "spec", "verify"], skill: "testing-strategy", agent: "testing-lead", confidence: 0.95 },
-    { keywords: ["fix", "debug", "triage", "broken", "error", "crash", "bug", "issue", "resolve"], skill: "bug-triage", agent: "bug-triage-specialist", confidence: 0.92 },
-    { keywords: ["security", "vulnerability", "threat", "scan", "risk", "exploit", "secure", "pentest"], skill: "security-audit", agent: "security-auditor", confidence: 0.95 },
-    { keywords: ["refactor", "cleanup", "improve", "restructure", "modernize", "debt"], skill: "refactoring-strategies", agent: "refactorer", confidence: 0.92 },
-    { keywords: ["performance", "optimize", "bottleneck", "benchmark", "profile", "speed"], skill: "performance-optimization", agent: "performance-engineer", confidence: 0.93 },
-    { keywords: ["frontend", "react", "vue", "angular", "ui", "ux", "interface", "component"], skill: "frontend-development", agent: "frontend-engineer", confidence: 0.95 },
-    { keywords: ["backend", "api", "server", "microservice", "endpoint"], skill: "backend-development", agent: "backend-engineer", confidence: 0.95 },
-    { keywords: ["docs", "documentation", "readme", "wiki", "guide", "manual"], skill: "documentation-generation", agent: "tech-writer", confidence: 0.9 },
-    { keywords: ["database", "db", "sql", "schema", "migration", "query"], skill: "database-design", agent: "database-engineer", confidence: 0.95 },
-    { keywords: ["deploy", "ci/cd", "pipeline", "docker", "kubernetes", "infrastructure"], skill: "devops-deployment", agent: "devops-engineer", confidence: 0.94 },
-    { keywords: ["mobile", "ios", "android", "react-native", "flutter"], skill: "mobile-development", agent: "mobile-developer", confidence: 0.95 },
-    { keywords: ["enforce", "compliance", "rule", "standard", "codex", "block", "prevent"], skill: "code-review", agent: "code-reviewer", confidence: 0.95 },
-    { keywords: ["design", "architect", "plan", "system", "model", "pattern", "architecture"], skill: "architecture-patterns", agent: "architect", confidence: 0.95 },
-    { keywords: ["codebase", "explore", "research", "discover", "implementation"], skill: "git-workflow", agent: "researcher", confidence: 0.88 },
-    // Additional built-in skill mappings
-    { keywords: ["api", "rest", "graphql", "openapi", "endpoint", "swagger"], skill: "api-design", agent: "backend-engineer", confidence: 0.9 },
-    { keywords: ["strategy", "roadmap", "planning", "technical", "decision", "architecture"], skill: "architecture-patterns", agent: "strategist", confidence: 0.88 },
-    { keywords: ["reflection", "story", "narrative", "saga", "journey", "document"], skill: "storyteller", agent: "tech-writer", confidence: 0.85 },
-    { keywords: ["analyze", "metrics", "complexity", "maintainability", "quality"], skill: "code-analyzer", agent: "code-analyzer", confidence: 0.9 },
-    { keywords: ["growth", "marketing", "conversion", "acquisition", "user-acquisition"], skill: "growth-strategist", agent: "growth-strategist", confidence: 0.9 },
-    { keywords: ["seo", "search", "organic", "traffic", "keywords", "ranking"], skill: "seo-consultant", agent: "seo-consultant", confidence: 0.92 },
-    { keywords: ["content", "copy", "blog", "marketing", "social"], skill: "content-creator", agent: "content-creator", confidence: 0.88 },
-    { keywords: ["format", "lint", "prettier", "eslint", "style", "formatting"], skill: "auto-format", agent: "code-reviewer", confidence: 0.85 },
-    { keywords: ["project", "structure", "health", "dependencies", "architecture"], skill: "project-analysis", agent: "architect", confidence: 0.88 },
-    { keywords: ["compliance", "audit", "standards", "framework", "validation"], skill: "framework-compliance-audit", agent: "code-reviewer", confidence: 0.9 },
-    { keywords: ["session", "state", "persistence", "storage", "cache"], skill: "session-management", agent: "backend-engineer", confidence: 0.85 },
-    { keywords: ["image", "visual", "pdf", "diagram", "multimedia", "media"], skill: "multimodal-looker", agent: "multimodal-looker", confidence: 0.92 },
-    { keywords: ["testing", "strategy", "coverage", "test-plan"], skill: "testing-strategy", agent: "testing-lead", confidence: 0.92 },
-    { keywords: ["inference", "model", "llm", "tuning", "optimization"], skill: "inference-improve", agent: "performance-engineer", confidence: 0.88 },
-    { keywords: ["orchestrate", "boot", "initialize", "startup", "bootstrap"], skill: "boot-orchestrator", agent: "architect", confidence: 0.9 },
-    // Additional unmapped skills
-    { keywords: ["tool", "utility", "helper", "instrument"], skill: "architect-tools", agent: "architect", confidence: 0.85 },
-    { keywords: ["design", "visual", "style", "theme", "css", "accessibility"], skill: "ui-ux-design", agent: "frontend-ui-ux-engineer", confidence: 0.9 },
-    { keywords: ["agent", "multi-agent", "coordination", "hermes", "communication"], skill: "hermes-agent", agent: "architect", confidence: 0.88 },
-    { keywords: ["log", "diagnostic", "trace", "monitor", "watch"], skill: "log-monitor", agent: "log-monitor", confidence: 0.9 },
-    { keywords: ["health", "diagnostic", "model-health", "validate-llm"], skill: "model-health-check", agent: "performance-engineer", confidence: 0.88 },
-    { keywords: ["analyze", "profiling", "memory", "cpu", "latency"], skill: "performance-analysis", agent: "performance-engineer", confidence: 0.9 },
-    { keywords: ["pipeline", "stream", "etl", "batch", "process"], skill: "processor-pipeline", agent: "backend-engineer", confidence: 0.88 },
-    { keywords: ["vulnerability", "cve", "sast", "dast", "dependency-check"], skill: "security-scan", agent: "security-auditor", confidence: 0.92 },
-    { keywords: ["state", "store", "redux", "context", "persistence"], skill: "state-manager", agent: "backend-engineer", confidence: 0.88 },
-    // ============================================================
-    // Community Skills (optional, lower confidence)
-    // These skills are from antigravity and may not be installed
-    // ============================================================
-    // UI/UX Design & Themes (antigravity)
-    { keywords: ["theme", "design-system", "color", "font", "typography", "palette"], skill: "antigravity--theme-factory", agent: "frontend-ui-ux-engineer", confidence: 0.6 },
-    { keywords: ["hig", "salesforce design", "lightning design", "slds"], skill: "antigravity--hig-components-system", agent: "frontend-ui-ux-engineer", confidence: 0.65 },
-    { keywords: ["slide", "deck", "presentation", "powerpoint"], skill: "antigravity--theme-factory", agent: "content-creator", confidence: 0.55 },
-    // SEO (antigravity)
-    { keywords: ["seo technical", "crawl", "indexability", "core web vitals", "sitemap"], skill: "antigravity--seo-technical", agent: "seo-consultant", confidence: 0.7 },
-    { keywords: ["seo structure", "content hierarchy", "schema", "internal linking"], skill: "antigravity--seo-structure-architect", agent: "seo-consultant", confidence: 0.7 },
-    { keywords: ["seo snippet", "meta description", "title tag"], skill: "antigravity--seo-snippet-hunter", agent: "seo-consultant", confidence: 0.7 },
-    { keywords: ["seo hreflang", "international seo", "multilingual"], skill: "antigravity--seo-hreflang", agent: "seo-consultant", confidence: 0.65 },
-    // Security (antigravity)
-    { keywords: ["backend security", "secure coding", "input validation", "authentication"], skill: "antigravity--backend-security-coder", agent: "security-auditor", confidence: 0.7 },
-    { keywords: ["mobile security", "ios security", "android security"], skill: "antigravity--mobile-security-coder", agent: "security-auditor", confidence: 0.65 },
-    { keywords: ["security audit", "vulnerability assessment", "penetration test"], skill: "security-audit", agent: "security-auditor", confidence: 0.75 },
-    // Vector/AI Databases (antigravity)
-    { keywords: ["vector", "embeddings", "similarity search", "pinecone", "qdrant", "chroma"], skill: "antigravity--vector-database-engineer", agent: "database-engineer", confidence: 0.65 },
-    { keywords: ["similarity search", "approximate nearest neighbor"], skill: "antigravity--similarity-search-patterns", agent: "database-engineer", confidence: 0.65 },
-    // Frameworks & Libraries (antigravity)
-    { keywords: ["svelte", "sveltekit", "svelte.js"], skill: "antigravity--sveltekit", agent: "frontend-engineer", confidence: 0.65 },
-    { keywords: ["trpc", "typescript rpc", "tRPC"], skill: "antigravity--trpc-fullstack", agent: "backend-engineer", confidence: 0.65 },
-    { keywords: ["vercel ai", "ai sdk", "vapi"], skill: "antigravity--vercel-ai-sdk-expert", agent: "backend-engineer", confidence: 0.65 },
-    { keywords: ["threejs", "3d web", "webgl", "3d graphics"], skill: "antigravity--threejs-loaders", agent: "frontend-engineer", confidence: 0.6 },
-    { keywords: ["comfyui", "ai image generation", "stable diffusion"], skill: "antigravity--comfyui-gateway", agent: "multimodal-looker", confidence: 0.6 },
-    // Mobile (antigravity)
-    { keywords: ["swiftui", "ios development"], skill: "antigravity--swiftui-liquid-glass", agent: "mobile-developer", confidence: 0.7 },
-    { keywords: ["ios performance", "swift optimization"], skill: "antigravity--swiftui-performance-audit", agent: "mobile-developer", confidence: 0.65 },
-    { keywords: ["react native", "rn"], skill: "mobile-development", agent: "mobile-developer", confidence: 0.7 },
-    // Backend/Golang (antigravity)
-    { keywords: ["golang", "go", "gopher"], skill: "antigravity--golang-pro", agent: "backend-engineer", confidence: 0.65 },
-    { keywords: ["temporal", "workflow", " durable execution"], skill: "antigravity--temporal-golang-pro", agent: "backend-engineer", confidence: 0.65 },
-    { keywords: ["python async", "asyncio", "uvloop"], skill: "antigravity--async-python-patterns", agent: "backend-engineer", confidence: 0.65 },
-    { keywords: ["pydantic", "data validation", "python models"], skill: "antigravity--pydantic-models-py", agent: "backend-engineer", confidence: 0.65 },
-    { keywords: ["scala", "spark", "big data"], skill: "antigravity--scala-pro", agent: "backend-engineer", confidence: 0.6 },
-    { keywords: ["dotnet", "c#", ".net"], skill: "antigravity--dotnet-backend-patterns", agent: "backend-engineer", confidence: 0.6 },
-    // Cloud/Azure (antigravity)
-    { keywords: ["azure", "azd", "azure deploy"], skill: "antigravity--azd-deployment", agent: "devops-engineer", confidence: 0.65 },
-    { keywords: ["azure storage", "file share"], skill: "antigravity--azure-storage-file-share-ts", agent: "devops-engineer", confidence: 0.6 },
-    { keywords: ["azure service bus", "messaging"], skill: "antigravity--azure-servicebus-py", agent: "devops-engineer", confidence: 0.6 },
-    // Automation/Bots (antigravity)
-    { keywords: ["discord bot", "discord automation"], skill: "antigravity--discord-bot-architect", agent: "backend-engineer", confidence: 0.6 },
-    { keywords: ["n8n", "workflow automation"], skill: "antigravity--n8n-expression-syntax", agent: "devops-engineer", confidence: 0.6 },
-    { keywords: ["linkedin automation", "social posting"], skill: "antigravity--linkedin-automation", agent: "growth-strategist", confidence: 0.55 },
-    { keywords: ["reddit automation"], skill: "antigravity--reddit-automation", agent: "growth-strategist", confidence: 0.55 },
-    { keywords: ["freshdesk", "customer support automation"], skill: "antigravity--freshdesk-automation", agent: "devops-engineer", confidence: 0.55 },
-    { keywords: ["pagerduty", "incident management"], skill: "antigravity--pagerduty-automation", agent: "devops-engineer", confidence: 0.55 },
-    // AI/ML (antigravity)
-    { keywords: ["local llm", "ollama", "llama", "local model"], skill: "antigravity--local-llm-expert", agent: "performance-engineer", confidence: 0.65 },
-    { keywords: ["agent", "mcp", "model context protocol"], skill: "antigravity--agent-memory-mcp", agent: "architect", confidence: 0.65 },
-    { keywords: ["agent evaluation", "agent testing"], skill: "antigravity--agent-evaluation", agent: "testing-lead", confidence: 0.65 },
-    { keywords: ["ai agent", "autonomous agent"], skill: "antigravity--ai-agent-development", agent: "backend-engineer", confidence: 0.65 },
-    // Content/Marketing (antigravity)
-    { keywords: ["marketing content", "ad creative", "campaign"], skill: "antigravity--marketing-ideas", agent: "content-creator", confidence: 0.6 },
-    { keywords: ["conversion", "cro", "optimization"], skill: "antigravity--onboarding-cro", agent: "growth-strategist", confidence: 0.6 },
-    // Documentation & Code Quality (antigravity)
-    { keywords: ["code documentation", "code explain", "explain code"], skill: "antigravity--code-documentation-code-explain", agent: "tech-writer", confidence: 0.65 },
-    { keywords: ["code refactoring", "clean code"], skill: "antigravity--code-refactoring-refactor-clean", agent: "refactorer", confidence: 0.65 },
-    { keywords: ["code review checklist"], skill: "antigravity--code-review-checklist", agent: "code-reviewer", confidence: 0.7 },
-    // Microservices & Architecture (antigravity)
-    { keywords: ["microservices", "service mesh", "distributed systems"], skill: "antigravity--microservices-patterns", agent: "architect", confidence: 0.65 },
-    { keywords: ["architecture decision", "adr", "decision records"], skill: "antigravity--architecture-decision-records", agent: "architect", confidence: 0.65 },
-    // Context/Memory Management (antigravity)
-    { keywords: ["context management", "context compression", "token optimization"], skill: "antigravity--context-compression", agent: "performance-engineer", confidence: 0.65 },
-    { keywords: ["context guardian", "memory safety"], skill: "antigravity--context-guardian", agent: "performance-engineer", confidence: 0.6 },
-    { keywords: ["context fundamentals"], skill: "antigravity--context-fundamentals", agent: "performance-engineer", confidence: 0.6 },
-    // Specialized Skills
-    { keywords: ["interview", "technical interview", "coding interview"], skill: "antigravity--interview-coach", agent: "growth-strategist", confidence: 0.6 },
-    { keywords: ["i18n", "localization", "translation"], skill: "antigravity--i18n-localization", agent: "frontend-engineer", confidence: 0.6 },
-    { keywords: ["accessibility", "a11y", "wcag"], skill: "antigravity--accessibility-compliance-accessibility-audit", agent: "frontend-ui-ux-engineer", confidence: 0.7 },
-    { keywords: ["pwa", "progressive web app"], skill: "antigravity--progressive-web-app", agent: "frontend-engineer", confidence: 0.6 },
-    { keywords: ["data migration", "sql migration"], skill: "antigravity--database-migrations-sql-migrations", agent: "database-engineer", confidence: 0.65 },
-    // Requesting Code Review (superpowers)
-    { keywords: ["request code review", "pr review", "pull request"], skill: "superpowers--requesting-code-review", agent: "code-reviewer", confidence: 0.7 },
-];
 export function getTaskRoutingRecommendation(taskDescription) {
     const desc = taskDescription.toLowerCase();
     for (const mapping of ROUTING_MAPPINGS) {

package/dist/inference/inference-cycle.js

@@ -524,7 +524,7 @@ Respond with EXACTLY one of:
                 source: 'inference-cycle',
             },
             options: {
-                requireExternalDynamo: true,
+                requireExternalDynamo: !process.env.XRAY_LOCAL_MODE,
             },
         };
         return handleGovernRequest(governanceRequest);

package/dist/mcps/governance.server.js

@@ -29,7 +29,7 @@ class GovernanceServer {
     server;
     constructor() {
         this.server = new Server({
-            name: "governance", version: "2.2.1",
+            name: "governance", version: "2.2.2",
         }, {
             capabilities: {
                 tools: {},

package/dist/mcps/knowledge-skills/skill-invocation.server.js

@@ -293,9 +293,8 @@ class SkillInvocationServer extends XrayKnowledgeSkillBase {
             "code-review", "security-audit", "performance-optimization",
             "testing-strategy", "researcher", "skill-invocation",
             "framework-help", "session-management", "code-analyzer",
-            "code-reviewer", "architect", "researcher",
-            "architect", "bug-triage-specialist", "log-monitor",
-            "code-reviewer", "security-auditor", "refactorer",
+            "code-reviewer", "architect", "bug-triage-specialist", "log-monitor",
+            "security-auditor", "refactorer",
             "growth-strategist", "strategist", "devops-deployment",
             "database-design", "tech-writer", "documentation-generation",
             "mobile-development", "seo-consultant",

package/dist/mcps/knowledge-skills/tech-writer.server.js

@@ -595,7 +595,7 @@ class XrayDocumentationGenerationServer extends XrayKnowledgeSkillBase {
             openapi: "3.0.0",
             info: {
                 title: "API Documentation",
-                version: "2.2.1",
+                version: "2.2.2",
                 description: "Generated API documentation",
             },
             servers: [

package/dist/mcps/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "0xRay Community MCPs Registry - curated API-focused MCP servers",
   "sources": [
     {

package/dist/skills/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "0xRay Skills Registry - recommended skill sources for consumers",
   "sources": [
     {

package/dist/tools/assess-complexity-tool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Assess Complexity Tool
+ *
+ * Wraps ComplexityAnalyzer so the main AI can query task complexity
+ * and decide whether to delegate to subagents.
+ *
+ * Exposes:
+ *  - assessComplexity() — full analysis returning score, level, strategy, agents
+ *  - simple assess() helper for quick threshold checks
+ */
+export interface AssessmentInput {
+    taskDescription: string;
+    files?: string[];
+    dependencies?: string[];
+    changeVolume?: number;
+    riskLevel?: "low" | "medium" | "high" | "critical";
+    estimatedDuration?: number;
+}
+export interface AssessmentResult {
+    score: number;
+    level: "simple" | "moderate" | "complex" | "enterprise";
+    strategy: "single-agent" | "multi-agent" | "orchestrator-led";
+    estimatedAgents: number;
+    reasoning: string[];
+}
+export declare function assessComplexity(input: AssessmentInput): AssessmentResult;
+export declare function shouldDelegate(input: AssessmentInput): boolean;
+export declare function getDelegationStrategy(input: AssessmentInput): AssessmentResult;

package/dist/tools/assess-complexity-tool.js

@@ -0,0 +1,44 @@
+/**
+ * Assess Complexity Tool
+ *
+ * Wraps ComplexityAnalyzer so the main AI can query task complexity
+ * and decide whether to delegate to subagents.
+ *
+ * Exposes:
+ *  - assessComplexity() — full analysis returning score, level, strategy, agents
+ *  - simple assess() helper for quick threshold checks
+ */
+import { getComplexityAnalyzer, } from "../delegation/complexity-analyzer.js";
+import { frameworkLogger } from "../core/framework-logger.js";
+const analyzer = getComplexityAnalyzer();
+export function assessComplexity(input) {
+    const metrics = analyzer.analyzeComplexity(input.taskDescription, {
+        files: input.files ?? [],
+        dependencies: input.dependencies ?? [],
+        changeVolume: input.changeVolume ?? 0,
+        riskLevel: input.riskLevel ?? "low",
+        estimatedDuration: input.estimatedDuration ?? 30,
+    });
+    const score = analyzer.calculateComplexityScore(metrics);
+    frameworkLogger.log("assess-complexity-tool", "assessment-complete", "info", {
+        taskDescription: input.taskDescription.substring(0, 80),
+        score: score.score,
+        level: score.level,
+        strategy: score.recommendedStrategy,
+        estimatedAgents: score.estimatedAgents,
+    });
+    return {
+        score: score.score,
+        level: score.level,
+        strategy: score.recommendedStrategy,
+        estimatedAgents: score.estimatedAgents,
+        reasoning: score.reasoning,
+    };
+}
+export function shouldDelegate(input) {
+    const result = assessComplexity(input);
+    return result.score > 15;
+}
+export function getDelegationStrategy(input) {
+    return assessComplexity(input);
+}

package/dist/tools/query-routing-tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Query Routing Tool
+ *
+ * Lets the main AI discover which agent/skill best matches a task.
+ * Combines ROUTING_MAPPINGS keyword lookup with AGENT_REGISTRY metadata.
+ */
+export interface AgentRoutingDetail {
+    agent: string;
+    skill: string;
+    confidence: number;
+    matchedKeywords: string[];
+    description: string | undefined;
+    capabilities: string[];
+    expertise: string | undefined;
+}
+export declare function queryRouting(keywords: string[]): AgentRoutingDetail[];
+export declare function listAllRoutes(): AgentRoutingDetail[];

package/dist/tools/query-routing-tool.js

@@ -0,0 +1,59 @@
+/**
+ * Query Routing Tool
+ *
+ * Lets the main AI discover which agent/skill best matches a task.
+ * Combines ROUTING_MAPPINGS keyword lookup with AGENT_REGISTRY metadata.
+ */
+import { queryRoutingMappings, getAllRoutingMappings, } from "../config/routing-mappings.js";
+import { getAgentEntry, getAgentCapabilities, } from "../agents/registry.js";
+import { frameworkLogger } from "../core/framework-logger.js";
+export function queryRouting(keywords) {
+    const matches = queryRoutingMappings(keywords);
+    const enriched = matches.map((m) => {
+        const entry = getAgentEntry(m.agent);
+        return {
+            agent: m.agent,
+            skill: m.skill,
+            confidence: m.confidence,
+            matchedKeywords: m.matchedKeywords,
+            description: entry?.description,
+            capabilities: entry
+                ? entry.capabilities
+                : getAgentCapabilities(m.agent),
+            expertise: entry?.expertise,
+        };
+    });
+    frameworkLogger.log("query-routing-tool", "query-complete", "info", {
+        keywords,
+        matchCount: enriched.length,
+        topMatch: enriched[0]
+            ? { agent: enriched[0].agent, confidence: enriched[0].confidence }
+            : null,
+    });
+    return enriched;
+}
+export function listAllRoutes() {
+    const all = getAllRoutingMappings();
+    const seen = new Set();
+    const unique = [];
+    for (const mapping of all) {
+        const key = `${mapping.agent}:${mapping.skill}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const entry = getAgentEntry(mapping.agent);
+        unique.push({
+            agent: mapping.agent,
+            skill: mapping.skill,
+            confidence: mapping.confidence,
+            matchedKeywords: mapping.keywords,
+            description: entry?.description,
+            capabilities: entry
+                ? entry.capabilities
+                : getAgentCapabilities(mapping.agent),
+            expertise: entry?.expertise,
+        });
+    }
+    unique.sort((a, b) => b.confidence - a.confidence);
+    return unique;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "description": "Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw",
   "license": "MIT",
   "repository": {

package/scripts/node/release.mjs

@@ -8,9 +8,10 @@
  *   2. npm version (bumps package.json, triggers preversion → version scripts)
  *   3. Build
  *   4. Consumer verification (npm pack + fresh install + 4 bridge E2Es)
- *   5. Commit + tag
- *   6. npm publish (triggers prepublishOnly → prepare-consumer + build)
- *   7. Push commit + tag
+ *   5. Commit
+ *   6. Tag
+ *   7. Push commit + tag to remote
+ *   8. npm publish (triggers prepublishOnly → prepare-consumer + build)
  *
  * Usage:
  *   npm run release:patch           # patch bump (default)
@@ -151,26 +152,36 @@ async function main() {
     }
   }
 
-  // Step 7: Publish (prepublishOnly runs prepare-consumer + build)
-  step(7, 'Publish to npm');
+  // Step 7: Push (git state before registry)
+  step(7, 'Push to remote');
   if (!dryRun) {
-    if (!run('npm publish --access public', `Publish 0xray@${newVersion}`)) {
-      log(`  ✗`, 'Publish failed — trying without scripts', RED);
-      if (!run('npm publish --access public --ignore-scripts', `Publish 0xray@${newVersion} (fallback)`)) {
-        process.exit(1);
-      }
-    }
+    if (!run('git push', 'Push commits')) process.exit(1);
+    if (!run(`git push origin v${newVersion}`, 'Push tag')) process.exit(1);
   } else {
-    log(`  ~`, 'Would publish: npm publish --access public', YELLOW);
+    log(`  ~`, 'Would push commits + tag', YELLOW);
   }
 
-  // Step 8: Push
-  step(8, 'Push to remote');
+  // Step 8: Publish (prepublishOnly runs prepare-consumer + build)
+  step(8, 'Publish to npm');
   if (!dryRun) {
-    if (!run('git push', 'Push commits')) process.exit(1);
-    if (!run(`git push origin v${newVersion}`, 'Push tag')) process.exit(1);
+    const publishResult = run('npm publish --access public', `Publish 0xray@${newVersion}`);
+    if (!publishResult) {
+      // Check if the version was already published (non-fatal — previous attempt may have timed out)
+      try {
+        const published = execSync(`npm view 0xray@${newVersion} version`, { encoding: 'utf-8', timeout: 15000 }).trim();
+        if (published === newVersion) {
+          log(`  ✓`, `Already published 0xray@${newVersion}`, GREEN);
+        } else {
+          log(`  ✗`, 'Publish failed', RED);
+          process.exit(1);
+        }
+      } catch {
+        log(`  ✗`, 'Publish failed — cannot verify', RED);
+        process.exit(1);
+      }
+    }
   } else {
-    log(`  ~`, 'Would push commits + tag', YELLOW);
+    log(`  ~`, 'Would publish: npm publish --access public', YELLOW);
   }
 
   console.log(`\n${BOLD}${GREEN}✅ Released 0xray@${newVersion}${RESET}\n`);

package/scripts/node/universal-version-manager.js

@@ -147,7 +147,7 @@ function detectCodexInfo() {
       return { version: cver.startsWith("v") ? cver : `v${cver}`, termsCount: termCount, lastUpdated: new Date().toISOString().split("T")[0] };
     } catch {}
   }
-  return { version: "v2.2.0", termsCount: 68, lastUpdated: new Date().toISOString().split("T")[0] };
+  return { version: "v2.2.1", termsCount: 68, lastUpdated: new Date().toISOString().split("T")[0] };
 }
 
 const detectedCodex = detectCodexInfo();
@@ -155,7 +155,7 @@ const detectedCodex = detectCodexInfo();
 const OFFICIAL_VERSIONS = {
   // Framework version
   framework: {
-    version: "2.2.2",
+    version: "2.2.3",
       displayName: "xray: Self-Healing AI Governance OS",
       lastUpdated: "2026-06-10",
     // Counts (auto-calculated, but can be overridden)
@@ -403,7 +403,7 @@ const UPDATE_PATTERNS = [
       pattern: /xray AI v[0-9]+\.[0-9]+\.[0-9]+/g,
       replacement: `xray AI v${OFFICIAL_VERSIONS.framework.version}`,
     },
-    // Footer bare version (e.g., "**Version**: 2.2.1")
+    // Footer bare version (e.g., "**Version**: 2.2.2")
     {
       pattern: /\*\*Version\*\*:\s*[0-9]+\.[0-9]+\.[0-9]+/g,
       replacement: `**Version**: ${OFFICIAL_VERSIONS.framework.version}`,

package/scripts/node/version-manager.mjs

@@ -158,6 +158,22 @@ function generateChangelogFromCommits(commits) {
   return sections.join('\n\n') || '- Version bump';
 }
 
+function findTestFiles(dir) {
+  let count = 0;
+  try {
+    for (const entry of fs.readdirSync(dir)) {
+      const full = path.join(dir, entry);
+      const stat = fs.statSync(full);
+      if (stat.isDirectory()) {
+        count += findTestFiles(full);
+      } else if (entry.endsWith('.test.ts') || entry.endsWith('.spec.ts')) {
+        count++;
+      }
+    }
+  } catch {}
+  return count;
+}
+
 /**
  * Count actual framework components
  */
@@ -165,7 +181,9 @@ function getFrameworkCounts() {
   const counts = {
     agents: 0,
     mcps: 0,
-    skills: 0
+    skills: 0,
+    codexTerms: 0,
+    tests: 0
   };
   
   // Count agents (.yml files in src/opencode/agents/ — source of truth)
@@ -200,6 +218,27 @@ function getFrameworkCounts() {
       .filter(f => fs.existsSync(path.join(skillsDir, f, 'SKILL.md')))
       .length;
   }
+
+  // Count codex terms (xray/codex.json is SSOT)
+  const codexPath = path.join(rootDir, 'xray/codex.json');
+  if (fs.existsSync(codexPath)) {
+    try {
+      const codex = JSON.parse(fs.readFileSync(codexPath, 'utf-8'));
+      counts.codexTerms = Object.keys(codex.terms || codex.rules || codex).length;
+    } catch {
+      counts.codexTerms = 0;
+    }
+  }
+
+  // Count test files across all of src/
+  try {
+    const srcDir = path.join(rootDir, 'src');
+    if (fs.existsSync(srcDir)) {
+      counts.tests = findTestFiles(srcDir);
+    }
+  } catch {
+    counts.tests = 0;
+  }
   
   return counts;
 }
@@ -290,8 +329,15 @@ function updateReadme(counts, newVersion) {
     `${counts.agents} agents, ${counts.mcps} MCP servers`
   );
   
+  // Update only the version in the summary line.
+  // Counts are marketing copy — not auto-mutated on release (see audit:counts for observability).
+  readme = readme.replace(
+    /\*\*v[\d.]+?\*\*/,
+    `**v${newVersion}**`
+  );
+  
   fs.writeFileSync(readmePath, readme);
-  console.log(`✅ Updated README.md (version: ${newVersion}, agents: ${counts.agents}, mcps: ${counts.mcps}, skills: ${counts.skills})`);
+  console.log(`✅ Updated README.md (version only: ${newVersion})`);
 }
 
 /**

package/src/mcps/governance.server.ts

@@ -68,7 +68,7 @@ class GovernanceServer {
   constructor() {
     this.server = new Server(
       {
-        name: "governance", version: "2.2.1",
+        name: "governance", version: "2.2.2",
       },
       {
         capabilities: {

package/src/mcps/knowledge-skills/skill-invocation.server.ts

@@ -395,9 +395,8 @@ class SkillInvocationServer extends XrayKnowledgeSkillBase {
       "code-review", "security-audit", "performance-optimization",
       "testing-strategy", "researcher", "skill-invocation",
       "framework-help", "session-management", "code-analyzer",
-      "code-reviewer", "architect", "researcher",
-      "architect", "bug-triage-specialist", "log-monitor",
-      "code-reviewer", "security-auditor", "refactorer",
+      "code-reviewer", "architect", "bug-triage-specialist", "log-monitor",
+      "security-auditor", "refactorer",
       "growth-strategist", "strategist", "devops-deployment",
       "database-design", "tech-writer", "documentation-generation",
       "mobile-development", "seo-consultant",

package/src/mcps/knowledge-skills/tech-writer.server.ts

@@ -888,7 +888,7 @@ class XrayDocumentationGenerationServer extends XrayKnowledgeSkillBase {
       openapi: "3.0.0",
       info: {
         title: "API Documentation",
-        version: "2.2.1",
+        version: "2.2.2",
         description: "Generated API documentation",
       },
       servers: [

package/src/mcps/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "0xRay Community MCPs Registry - curated API-focused MCP servers",
   "sources": [
     {

package/src/opencode/codex.codex

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "terms": [
      1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68
   ],

package/src/opencode/commands/dependency-audit.md

@@ -69,7 +69,7 @@ Comprehensive dependency analysis and security audit for all project dependencie
   "vulnerabilities": [
     {
       "package": "lodash",
-      "version": "2.2.1",
+      "version": "2.2.2",
       "severity": "high",
       "cve": "CVE-2021-23337",
       "description": "Command injection vulnerability"
@@ -85,14 +85,14 @@ Security-focused format for CI/CD integration:
 
 ```json
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
   "runs": [
     {
       "tool": {
         "driver": {
           "name": "Dependency Audit",
-          "version": "2.2.1"
+          "version": "2.2.2"
         }
       },
       "results": [...]

package/src/opencode/enforcer-config.json

@@ -1,6 +1,6 @@
 {
   "framework": "xray 2.0",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Codex-compliant framework configuration for Credible UI project",
   "thresholds": {
     "bundleSize": {
@@ -220,7 +220,7 @@
       }
     },
     "codex": {
-      "version": "2.2.1",
+      "version": "2.2.2",
       "terms": [
         1,
         2,

package/src/skills/registry.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "0xRay Skills Registry - recommended skill sources for consumers",
   "sources": [
     {

package/xray/codex.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.1",
+  "version": "2.2.2",
   "lastUpdated": "2026-06-05",
   "errorPreventionTarget": 0.998,
   "terms": {

package/xray/config.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./config.schema.json",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "0xRay Framework - Token Management & Performance Configuration",
   "token_management": {
     "maxPromptTokens": 20000,

package/xray/features.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./features.schema.json",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "0xRay Framework - Unified Feature Configuration",
   "token_optimization": {
     "enabled": true,

package/xray/integrations.json

@@ -4,19 +4,19 @@
     "openclaw": {
       "enabled": false,
       "type": "external-service",
-      "version": "2.2.1",
+      "version": "2.2.2",
       "config": {}
     },
     "python-bridge": {
       "enabled": false,
       "type": "protocol-bridge",
-      "version": "2.2.1",
+      "version": "2.2.2",
       "config": {}
     },
     "react": {
       "enabled": false,
       "type": "framework-adapter",
-      "version": "2.2.1",
+      "version": "2.2.2",
       "config": {}
     }
   }