0xray 3.0.11 → 3.0.14

package/README.md

@@ -1,364 +1,126 @@
-# 0xRay — Self-Healing AI Governance OS
+# xray — MCP-Centric AI Governance OS
 
-**v3.0.11** — 41 agents · 44 skills · 15 MCPs servers · 20 codex terms · 160 test files
+**v2.0.0** — 9 agents · 44 skills · 16 MCPs governance servers · 60 codex terms · 2,2527 tests
 
-[![Docs](https://img.shields.io/badge/docs-0xRayAI.github.io/xray-10b981?style=flat-square)](https://0xrayai.github.io/xray/)
+xray is the pure v2 three-subsystem AI orchestration framework, now **MCP-centric** with dedicated skill servers for governance deliberation:
 
-0xRay prevents AI coding mistakes before they happen. It's an intelligent governance layer that sits between you and your AI coding tools — intercepting bad proposals, enforcing code quality rules, and orchestrating multi-agent workflows automatically.
+- **Inference** — reasoning, execution, and agent intelligence
+- **External Governance** — Dynamo Solar SSOT for proposal evaluation, resonance/isotopic signals, coherence, and Codex enforcement before any action
+- **Autonomous Engine** — thinDispatch 7-flow in the MCP orchestrator for automatic delegation, routing, and end-to-end coordination
 
-Every code change is checked against a **68-term Codex** (coding constitution), deliberated by specialized AI agents, and either approved, revised, or blocked before it ever touches your codebase.
-
-Think of it as an **AI supervisor for your AI coders**: catch hallucinations, prevent slop, enforce standards — automatically.
-
----
+3 dedicated MCP servers (`code-review`, `security-audit`, `researcher`) deliberate governance proposals. Agents are declared in `.opencode/agents/*.yml` — the YML SSOT. Zero manual setup. Automatic discovery and activation.
 
 ## Quick Start
 
-Pick your AI coding tool and run **one command**:
-
 ```bash
-# OpenCode (most common)
-npx -y 0xray opencode install
+npm install 0xray
 
-# Grok CLI
-npx -y 0xray grok install
-
-# Hermes Agent
-npx -y 0xray hermes install
-
-# OpenClaw
-npx -y 0xray openclaw install
+# CLI
+npx 0xray --help
+npx 0xray grok install          # Install Grok CLI plugin
+npx 0xray hermes bridge         # Hermes Agent bridge
 ```
 
-That's it — 0xRay installs as a native plugin with agents, governance, and MCP servers for your platform. Run `npx 0xray --help` to see all commands.
-
-**Requirements:** Node.js 18+, npm 9+, macOS or Linux.
-
----
-
-## What Problem Does 0xRay Solve?
-
-AI coding assistants are powerful but unreliable. They hallucinate APIs, introduce security vulnerabilities, violate project conventions, and make conflicting changes across files. 0xRay solves this by:
-
-| Problem | How 0xRay Fixes It |
-|---------|-------------------|
-| AI hallucinates bad code | **Governance gate** blocks non-compliant proposals before execution |
-| No code quality enforcement | **68-rule Codex** checks every change against your standards |
-| Single-agent blindspots | **3 specialized reviewers** (code, security, research) debate each proposal |
-| Scattered, conflicting edits | **Multi-agent orchestrator** coordinates work across specialists |
-| Repeating the same mistakes | **Inference engine** learns patterns and prevents regressions |
-
----
-
-## How It Works
+The installation seeds YML surfaces and MCP servers. Place agent definitions in `.opencode/agents/` — they are live immediately.
 
-0xRay uses a three-layer architecture that operates **before any code change is made**:
+## Three-Subsystem Architecture
 
 ```
 ┌─────────────────────────────────────────────────┐
 │                  Inference                       │
-│  Reasoning · Pattern learning · Execution       │
+│  Proposals · Reflection · Execution             │
 ├─────────────────────────────────────────────────┤
 │           External Governance (Dynamo)           │
-│  Codex enforcement · Multi-agent review · SSOT  │
-│  15 MCPs servers deliberate proposals via 3-skill governance │
+│  Codex enforcement · Resonance/Isotopic · SSOT  │
+│  16 MCPs skill servers deliberate proposals       │
 ├─────────────────────────────────────────────────┤
 │          Autonomous Engine (thinDispatch)        │
-│  Task routing · Multi-agent coordination        │
-│  Complexity-based delegation (7-flow MCP)       │
+│  7-flow MCP · Delegation · Governance gate      │
 └─────────────────────────────────────────────────┘
 ```
 
-### 1. Inference Layer
-Generates proposals, runs reflection cycles, and plans execution. Everything produced here enters the governance gate before any code is written.
-
-### 2. Governance Layer (The "Gate")
-Every proposal is reviewed by **3 specialized AI servers** — code review, security audit, and research — using a weighted voting system (PHI/TAU matrix) to reach a consensus. Non-compliant proposals are blocked or sent back for revision. This is powered by **Dynamo**, a neural network that evaluates codex compliance, structural coherence, and risk before any action executes.
-
-### 3. Autonomous Engine
-Routes tasks to the right agents based on complexity (simple tasks go to a single agent, enterprise-grade work triggers a full multi-agent team). Handles dependency ordering, conflict resolution, and parallel execution.
-
----
-
-## Platform Installation
+### Inference
+Proposal generation, reflection cycles, and execution planning. Produces structured proposals that enter the governance gate.
 
-0xRay integrates with all major AI coding platforms:
+### External Governance (Dynamo Solar SSOT)
+Mandatory governance filter powered by Dynamo — a neural net based on solar physics and temporal first principles. Evaluates proposals for Codex compliance, resonance alignment, and isotopic coherence before any action is taken.
 
-| Platform | Install Command | What It Does |
-|----------|----------------|--------------|
-| **OpenCode** | `npx 0xray opencode install` | Installs as native plugin, seeds YML agent surfaces, merges configuration |
-| **Grok CLI** | `npx 0xray grok install` | Registers plugin + xray-skills MCP server (13 tools, 44 skills) |
-| **Hermes Agent** | `npx 0xray hermes install` | Copies bridge plugin to `~/.hermes/plugins/` |
-| **OpenClaw** | `npx 0xray openclaw install` | Creates integration config at `.xray/config/openclaw.json` |
+- 3 real MCP skill servers deliberate: `code-review`, `security-audit`, `researcher`
+- Weighted voting via PHI (1.666) / TAU (0.865) matrix
+- External Dynamo integration required (not optional)
+- CodexPolicyService — single source of truth for Codex loading
+- Active codex snapshot available via `get_active_codex` MCP tool
 
-Postinstall automatically registers MCP servers with Grok CLI when `grok` is available on your PATH.
+### Autonomous Engine (thinDispatch 7-flow)
+MCP orchestrator with 7-flow dispatch for automatic delegation, routing, and coordination. Handles complex multi-step tasks with automatic complexity-based routing.
 
----
-
-## CLI Reference
-
-### Core Commands
-
-| Command | Description |
-|---------|-------------|
-| `install` | Install 0xRay framework in current project |
-| `setup` | Full setup: hooks, Hermes, symlinks, MCP paths |
-| `init` | Install + setup (one command) |
-| `status` | Show framework health and configuration |
-| `health` / `check` | Run health checks on all subsystems |
-| `validate` | Verify installation is complete |
-| `report` | Generate activity and health reports |
-| `fix` | Auto-repair common issues |
-| `doctor` | Diagnose issues (read-only) |
-| `debug` | Print all framework paths |
-
-### Skills
-
-| Command | Description |
-|---------|-------------|
-| `skill:install` | Browse and install starter skill packs |
-| `skill:install <source>` | Install skills from registry or any GitHub repo |
-| `skill:registry list` | List all configured skill sources |
-| `skill:registry add --name X --url Y` | Add a custom skill source |
-| `skill:registry remove --name X` | Remove a skill source |
-
-### MCP Servers
-
-| Command | Description |
-|---------|-------------|
-| `mcp skills` | Run the xray-skills MCP server (stdio, 13 tools) |
-| `mcp governance` | Run the xray-governance MCP server (stdio, advanced) |
-| `mcp:list` | Browse available community MCP servers |
-| `mcp:status` | Show installed MCP servers |
-| `mcp:install <name>` | Install an MCP server from the registry |
-| `mcp:remove <name>` | Remove an installed MCP server |
-
-### Platform Integration
-
-| Command | Description |
-|---------|-------------|
-| `opencode install` | Install as OpenCode plugin |
-| `grok install` | Install as Grok CLI plugin |
-| `hermes install` | Install as Hermes Agent plugin |
-| `openclaw install` | Install OpenClaw integration |
-
-### Plugins
-
-| Command | Description |
-|---------|-------------|
-| `plugin list` | List all installed plugins |
-| `plugin install <name>` | Install a new plugin |
-| `plugin enable <name>` | Enable a disabled plugin |
-| `plugin disable <name>` | Disable a plugin without uninstalling |
-| `plugin uninstall <name>` | Remove a plugin completely |
-
-### Inference & Self-Improvement
-
-| Command | Description |
-|---------|-------------|
-| `inference:run` | Run full self-improvement cycle: collect → propose → govern → verify |
-| `inference:improve` | Run inference improvement cycle |
-| `inference:tuner` | Start/stop the autonomous inference tuner |
-
-### Other Commands
-
-| Command | Description |
-|---------|-------------|
-| `analytics` | Pattern analysis, insights, and consent management |
-| `antigravity status` | Show status of all installed skills |
-| `storyteller [type]` | Generate reflections, sagas, or narratives |
-| `publish-agent` | Package agents for the AgentStore |
-| `credible init` | Initialize Credible Pod infrastructure (planned) |
-
----
-
-## Configuration
-
-### Feature Flags (`features.json`)
-
-Every subsystem is configurable via `features.json` (located at `xray/features.json`):
-
-```json
-{
-  "version": "3.0.10",
-  "token_optimization": {
-    "enabled": true,
-    "max_context_tokens": 20000,
-    "context_compression": { "enabled": true, "threshold_tokens": 15000, "compression_ratio": 0.4 }
-  },
-  "multi_agent_orchestration": { "enabled": true, "max_concurrent_agents": 3 },
-  "autonomous_reporting": { "enabled": true, "interval_minutes": 60 },
-  "security": { "enabled": true, "vulnerability_scanning": true },
-  "analytics": { "enabled": true, "default_limit": 100 },
-  "pattern_learning": { "enabled": true, "learning_interval_ms": 3600000 },
-  "complexity_thresholds": { "simple": 15, "moderate": 25, "complex": 50, "enterprise": 100 }
-}
-```
+## CLI
 
-Toggle any feature on/off with `enabled: true/false`. The framework reloads configuration automatically.
-
-### Governance Setup
-
-Governance is your quality gate. Configure it under `inference_governance` in `features.json`. The hosted Railway endpoint is available at `https://governance-production-69c3.up.railway.app/mcp`:
-
-```json
-{
-  "inference_governance": {
-    "enabled": true,
-    "endpoint_url": "https://governance-production-69c3.up.railway.app/mcp",
-    "request_timeout_ms": 10000,
-    "min_confidence_threshold": 0.5,
-    "decision_logic": {
-      "pass_confidence_min": 0.9,
-      "revision_confidence_max": 0.89
-    }
-  }
-}
-```
-
-The governance pipeline works in three stages:
-1. **3 AI reviewers** (`code-review`, `security-audit`, `researcher`) analyze each proposal independently
-2. **Dynamo** cross-checks against the 68-term Codex for compliance, security, and coherence
-3. **Weighted voting** (PHI/TAU matrix) produces a final decision: approve, revise, or reject
-
-**Options:** `requireExternalDynamo`, `minConfidence`, `enableSolarAdjustment`, `timeoutMs`, `maxAbstentionThreshold`.
-
-> ⚠️ **Privacy Notice**: All proposals submitted to the governance endpoint are **public by default**. They are **not persisted on-chain** unless the `onChain: true` flag is set. 0xRay framework self-governance proposals (tagged `0xray`) save on-chain by default; project proposals do not. Set `onChain: false` or omit the field for non-public governance checks.
-
----
-
-## Included Agents (41)
-
-0xRay ships with specialized agents for every engineering domain:
-
-| Agent | Role |
-|-------|------|
-| **Architect** | System design, technical decisions, architecture reviews |
-| **Bug Triage Specialist** | Error investigation, root cause analysis |
-| **Code Reviewer** | Code quality, best practices, style compliance |
-| **Security Auditor** | Vulnerability detection, threat modeling |
-| **Researcher** | Codebase exploration, pattern discovery |
-| **Testing Lead** | Test strategy, coverage planning |
-| **Refactorer** | Technical debt elimination, code simplification |
-| **Frontend Engineer** | React, CSS, responsive design |
-| **Backend Engineer** | APIs, microservices, server architecture |
-| **DevOps Engineer** | CI/CD, infrastructure, deployment automation |
-| **Database Engineer** | SQL/NoSQL, query optimization, data modeling |
-| **Performance Engineer** | Profiling, benchmarking, optimization |
-| **Mobile Developer** | iOS, Android, React Native, Flutter |
-| **Content Creator** | Technical writing, docs, marketing copy |
-| **Growth Strategist** | Analytics, user acquisition, conversion |
-| **SEO Consultant** | Search optimization, keyword strategy |
-| **Strategy Analyst** | System design, technical roadmaps |
-| **Multimodal Looker** | Image, diagram, visual content analysis |
-| **Code Analyzer** | Code metrics, complexity analysis |
-| **Log Monitor** | Diagnostics, error pattern detection |
-
-Plus 22 domain-specialist subagents for full-stack, database, mobile, UI/UX, and more. All agents are declared declaratively in `src/opencode/agents/*.yml` — add or customize without touching code.
-
----
-
-## MCP Servers
-
-0xRay ships two MCP servers. The primary user-facing one runs standalone with zero configuration:
-
-### xray-skills (public)
-13 tools for code review, security audit, API design, database design, testing strategy, and more. Runs via `npx`:
-
-```json
-{
-  "mcpServers": {
-    "xray-skills": {
-      "command": "npx",
-      "args": ["-y", "0xray", "mcp", "skills"]
-    }
-  }
-}
+```bash
+0xray <command>
+
+Commands:
+  install         Install xray framework
+  grok            Grok CLI plugin management
+  hermes          Hermes Agent bridge
+  integration     Integration management
+  validate        Validate installation
+  version         Show version
 ```
 
-- **13 tools**: skill-code-review, skill-security-audit, skill-api-design, skill-database-design, skill-project-analysis, skill-testing-strategy, skill-performance-optimization, skill-ui-ux-design, skill-devops-deployment, skill-documentation-generation, skill-storyteller, list-skills, invoke-skill
-- **44 knowledge skills** (SKILL.md) for chat-based development assistance
-- No external services, no API keys, no configuration needed
-
-### xray-governance (advanced)
-Orchestrates proposals through code-review + security-audit + researcher + external Dynamo SSOT. Requires additional setup.
-
-```json
-{
-  "mcpServers": {
-    "xray-governance": {
-      "command": "npx",
-      "args": ["-y", "0xray", "mcp", "governance"]
-    }
-  }
-}
-```
+## Integrations
 
-Or connect to the hosted Railway endpoint:
-`https://governance-production-69c3.up.railway.app/mcp`
+| Platform | Status | Description |
+|----------|--------|-------------|
+| **OpenClaw** | ✅ | API server, client, config, hooks — full integration |
+| **Hermes Agent** | ✅ | Python bridge, plugin YAML, tools, schemas |
+| **Grok CLI** | ✅ | Plugin install via `0xray grok install --force`, user-level plugin hooks |
+| **OpenCode** | ✅ | Native YML agent surfaces, E2E 42/42 solo, 34/34 orchestrator |
 
-> **Marketplace**: 0xRay is listed on the [xAI Plugin Marketplace](https://github.com/xai-org/plugin-marketplace) (PR #23) — one-click install for Grok users.
->
-> **Deploy your own**: see the [custom MCP server guide](https://0xrayai.github.io/xray/docs/mcp/deploy-custom) for stdio and Railway HTTP deployment patterns.
+## MCP Server Ecosystem
 
----
+xray ships MCP servers for all governance deliberation and framework capabilities:
 
-## Included Skills (44)
+**Governance Deliberation:** code-review, security-audit, researcher, enforcer-tools, governance
 
-api-design, architect-tools, architecture-patterns, auto-format, backend-engineer, boot-orchestrator, bug-triage, code-analyzer, code-review, content-creator, database-engineer, devops-engineer, enforcer, framework-compliance-audit, frontend-engineer, frontend-ui-ux-engineer, git-workflow, growth-strategist, hermes-agent, inference-improve, lint, log-monitor, mobile-developer, model-health-check, multimodal-looker, orchestrator, performance-analysis, performance-engineer, performance-optimization, processor-pipeline, project-analysis, refactoring-strategies, researcher, security-audit, security-scan, seo-consultant, session-management, state-manager, storyteller, strategist, tech-writer, testing-best-practices, testing-strategy, ui-ux-design
+**Core Framework:** architect-tools, boot-orchestrator, estimation, framework-compliance-audit, framework-help, lint, model-health-check, orchestrator, performance-analysis, processor-pipeline, state-manager, auto-format
 
-Install more skills anytime: `npx 0xray skill:install`
+**Knowledge Skills:** api-design, architecture-patterns, bug-triage-specialist, code-analyzer, content-creator, database-design, devops-deployment, git-workflow, growth-strategist, log-monitor, mobile-development, multimodal-looker, performance-optimization, project-analysis, refactoring-strategies, seo-consultant, session-management, skill-invocation, strategist, tech-writer, testing-best-practices, testing-strategy, ui-ux-design
 
----
+## Governance & Codex
 
-## Testing & Reliability
+Codex enforcement is integrated at every level:
 
-0xRay is battle-tested with **160 test files** (2,778+ individual tests) across every subsystem:
+- **60 terms** across categories: core, architecture, testing, performance, security, operations, governance
+- CodexPolicyService — canonical Governance-owned SSOT for Codex loading
+- Pre-governance gate blocks non-compliant proposals before execution
+- 16 MCPs skill servers deliberate each proposal
+- frameworkLogger structured logging throughout (never console.*)
+- Active codex snapshot available via `get_active_codex` MCP tool
 
-| Suite | Tests | Status |
-|-------|-------|--------|
-| Unit & Integration | 164 files | All pass |
-| Performance | 164 files | All pass |
-| Infrastructure | 164 files | All pass |
-| Consumer E2E | 4 platforms | All pass |
-| OpenCode E2E | 42 solo + 34 orchestrator | All pass |
-| OpenClaw E2E | 99 E2E | All pass |
-| Hermes E2E | 46 E2E | All pass |
-| Grok CLI E2E | 56 E2E (54 passed, 2 skipped) | All pass |
+## Testing (2,2527 tests)
 
----
+| Suite | Status |
+|-------|--------|
+| Unit / Integration | 158 files, all pass |
+| Performance | 2527 tests, all pass |
+| Infrastructure | 2527 tests, all pass |
+| Consumer E2E | 4 platforms, all pass |
+| OpenCode E2E | 42/42 solo, 34/34 orchestrator, all pass |
+| OpenClaw E2E | 2527 tests, all pass |
+| Hermes E2E | 2527 tests, all pass |
+| Grok CLI E2E | 60/60 solo, 59/59 orchestrator, all pass |
 
-## Next Steps
+## Release
 
 ```bash
-# 1. Check your installation
-npx 0xray status
-
-# 2. Install skill packs (adds agent expertise)
-npx 0xray skill:install
-
-# 3. Configure governance (optional)
-# Edit xray/features.json
-
-# 4. View full agent documentation
-less AGENTS.md
-
-# 5. Run a health check
-npx 0xray health
+npm run release              # patch bump
+npm run release minor        # minor bump
+npm run release major        # major bump
+npm run release -- --dry-run # preview
 ```
 
----
-
-## Resources
-
-- **[AGENTS.md](AGENTS.md)** — Full agent reference, subsystem deep dive, operating model
-- **[CHANGELOG.md](CHANGELOG.md)** — Version history and release notes
-- **[docs/](docs/)** — Architecture docs, governance model, integration guides
-- **[Docs](https://0xrayai.github.io/xray/)** — Full documentation site
-- **[Dynamo Governance](https://0xrayai.github.io/xray/docs/guides/self-hosting-dynamo)** — External governance service (self-host your own instance — see docs)
-- **[Deploy a Custom MCP Server](https://0xrayai.github.io/xray/docs/mcp/deploy-custom)** — Create, register, and deploy your own MCP server (stdio or Railway HTTP)
-- **[GitHub](https://github.com/0xRayAI/xray)** — Source code, issues, discussions
-- **[npm](https://www.npmjs.com/package/0xray)** — Package registry
+The release pipeline: test → version:sync → build → commit → publish → push.
 
 ## License
 
@@ -366,4 +128,4 @@ MIT — see [LICENSE](LICENSE)
 
 ---
 
-*0xRay — self-healing, governed, autonomous. Catch AI mistakes before they ship.*
+*xray — MCP-centric, governed, autonomous. Pure v2 three-subsystem.*

package/dist/AGENTS.md

@@ -1,14 +1,14 @@
 # xray Agents
 
-Quick reference for xray AI orchestration framework (v15 MCPs-centric three-subsystem).
+Quick reference for xray AI orchestration framework (v16 MCPs-centric three-subsystem).
 
 ## What is xray?
 
-xray provides intelligent multi-agent orchestration with automatic delegation and Codex compliance validation under the pure v3 three-subsystem model (Inference + External Governance via Dynamo + Autonomous Engine via thinDispatch 7-flow in MCP orchestrator). Agents operate via `src/opencode/agents/*.yml` YML surfaces and 3 dedicated MCP skill servers — no manual setup needed.
+xray provides intelligent multi-agent orchestration with automatic delegation and Codex compliance validation under the pure v2 three-subsystem model (Inference + External Governance via Dynamo + Autonomous Engine via thinDispatch 7-flow in MCP orchestrator). Agents operate via `.opencode/agents/*.yml` YML surfaces and 3 dedicated MCP skill servers — no manual setup needed.
 
-## v15 MCPs-Centric Architecture
+## v16 MCPs-Centric Architecture
 
-The v3 release centers on **MCP (Model Context Protocol)** as the primary surface for agent skills. Three agent MCP servers handle governance deliberation:
+The v2 release centers on **MCP (Model Context Protocol)** as the primary surface for agent skills. Three agent MCP servers handle governance deliberation:
 
 - `code-review` — Proposal quality, code analysis, best practices
 - `security-audit` — Vulnerability detection, threat modeling
@@ -18,7 +18,7 @@ These MCP servers integrate with the three-subsystem pipeline for governance-gat
 
 ## xray Three-Subsystem Operation
 
-xray operates under the pure three-subsystem model: Inference + External Governance (Dynamo Solar SSOT) + Autonomous Engine (thinDispatch 7-flow in MCP orchestrator). Agents are declared in `src/opencode/agents/*.yml` YML surfaces with zero manual setup.
+xray operates under the pure three-subsystem model: Inference + External Governance (Dynamo Solar SSOT) + Autonomous Engine (thinDispatch 7-flow in MCP orchestrator). Agents are declared in `.opencode/agents/*.yml` YML surfaces with zero manual setup.
 
 ### Core Tenets
 - YML declarations are the SSOT
@@ -39,7 +39,7 @@ xray operates under the pure three-subsystem model: Inference + External Governa
 | **Scripts** | `scripts/` or `scripts/bash/` | `scripts/bash/my-script.sh` |
 | **Test Files** | `src/__tests__/` | `src/__tests__/unit/my-test.test.ts` |
 | **Source Code** | `src/` | `src/my-module.ts` |
-| **Config** | `config/` or `xray/` | `xray/config.json` |
+| **Config** | `config/` or `.opencode/xray/` | `.opencode/xray/config.json` |
 
 **Never save to root** - Root directory is for essential files only:
 - `README.md`, `CHANGELOG.md`, `package.json`, `tsconfig.json`
@@ -82,30 +82,16 @@ The Autonomous Engine routes via complexity:
 
 ## Codex
 
-xray enforces the Universal Development Codex (68 terms) via Dynamo governance. The codex lives in `xray/codex.json`.
-
-Pure v15 MCPs. Clean. Complete.
-
-## Session: v2.1.2 Release Polish
-
-- Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `2.0.0`.
-- Renamed `strray-ai` → `0xray` across 60+ source files, CLI help text, grok plugin, hermes-agent bridge (Python + JS), docusaurus config.
-- **12 stale docs git-rm'd**: AGENTS-consumer.md, AGENTS-full.md, CHANGELOG-v1.15.x.md, 7 docs/ files.
-- **AGENTS.md + README.md**: Rewritten v15 MCPs-centric.
-- **CLI help text**: `npx 0xray` — removed dead `dashboard` command, stale examples.
-- `.npmignore`: removed `src/` (conflicted with `files` field — was silently dropping published sources).
-- `.gitignore`: cleaned stale `.strray/` entries, `strray-ai-*.tgz` → `0xray-*.tgz`.
-- **Deep review fixes via 4 parallel agents**:
-  - `researcher/SKILL.md`: MCP path fixed → `researcher.server.js`
-  - `security-audit/SKILL.md`: tool list fixed to match actual 4 tools
-  - `governance-service.ts`: `overallDecision` now returns `'reject'` when appropriate; ProposalType mapping fixed
-  - `governance.server.ts`: `process.stderr.write` → `frameworkLogger.log`
-  - `boot-orchestrator.server.ts`: `console.log` → `frameworkLogger.log`
-  - `ui-ux-design.server.ts`: duplicate import removed
-  - `testing-strategy.server.ts`: 7 malformed log keys fixed
-  - `framework-compliance-audit.server.ts`: 2 malformed log IDs fixed
-  - `status.ts` CLI command wired into `index.ts`
-  - Orphaned files analyzed (not deleted): `security-audit.ts`, `src/security/` (11 files), `session-capture-processor.ts`, `activate-kernel-pipeline.ts`
-- **Hermes-agent bridge backward compat**: all JS/Python bridge files check for both `strray-ai` (old) and `0xray` (new). Default paths updated to `0xray`.
-  - **Test suite**: 162 files, 2290 tests (+ 44 skipped), 0 failures. Build passes clean.
-  - **OpenClaw e2e**: Phase 13 validates `logs/framework/activity.log` via agent tool event → hooks → frameworkLogger pipeline — 2290 tests, 0 failures.
+xray enforces the Universal Development Codex (60 terms) via Dynamo governance. The codex lives in `.opencode/xray/codex.json`.
+
+Pure v16 MCPs. Clean. Complete.
+
+## Session: v3.0.13 Release Polish
+
+- Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `3.0.13`.
+- **All 182 test files pass**: 2527 tests, 0 failures, 36 skipped.
+- **Build fix**: removed stale `.opencode/plugin/` copy; `package.json` → `dist/plugin/xray-codex-injection.js`.
+- **default-plugins.ts**: monkey-patch `Server.prototype.setRequestHandler` to capture tool definitions from MCP Server instances; all registration functions async.
+- **8 failing test files fixed**: class name references (`StringRaySecurityAuditServer` → `XraySecurityAuditServer`, `XrayStateManager` → `StringRayStateManager`); added `calculateMetamorphosisScore`; delegation re-exports; source-inspection tests updated; infrastructure path fix; antigravity registry removed.
+- **CHANGELOG.md**: added v3.0.13 entry.
+- **Stale READMEs**: updated `StringRay` → `0xray` in 4 subdirectory READMEs.