0xray 3.0.14 → 3.1.1

package/src/opencode/codex.codex

@@ -1,5 +1,5 @@
 {
-  "version": "1.22.67",
+  "version": "3.1.0",
   "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
   ],

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": "1.22.67",
+      "version": "3.1.0",
       "severity": "high",
       "cve": "CVE-2021-23337",
       "description": "Command injection vulnerability"
@@ -85,14 +85,14 @@ Security-focused format for CI/CD integration:
 
 ```json
 {
-  "version": "1.22.67",
+  "version": "3.1.0",
   "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
   "runs": [
     {
       "tool": {
         "driver": {
           "name": "Dependency Audit",
-          "version": "1.22.67"
+          "version": "3.1.0"
         }
       },
       "results": [...]

package/src/opencode/commands/summary-logger.md

@@ -47,17 +47,17 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
 REFACTORING_LOG="${PROJECT_ROOT}/docs/REFACTORING_LOG.md"
 
-# Check if summary content is provided via environment variable or stdin (XRAY_ primary + STRRAY_ min compat fallback per Scope Rule)
+# Check if summary content is provided via environment variable or stdin (XRAY_ primary)
 
 if [ -n "$XRAY_SUMMARY_CONTENT" ]; then
 SUMMARY_CONTENT="$XRAY_SUMMARY_CONTENT"
-elif [ -n "$STRRAY_SUMMARY_CONTENT" ]; then
-SUMMARY_CONTENT="$STRRAY_SUMMARY_CONTENT"
+elif [ -n "$XRAY_SUMMARY_CONTENT" ]; then
+SUMMARY_CONTENT="$XRAY_SUMMARY_CONTENT"
 elif [ ! -t 0 ]; then
     # Read from stdin
     SUMMARY_CONTENT=$(cat)
 else
-echo "❌ No summary content provided. Use XRAY_SUMMARY_CONTENT (or STRRAY_ compat) environment variable or pipe content."
+echo "❌ No summary content provided. Use XRAY_SUMMARY_CONTENT environment variable or pipe content."
 echo "Usage:"
 echo " export XRAY_SUMMARY_CONTENT='summary content' && bash .opencode/commands/summary-logger.md"
 echo " echo 'summary content' | bash .opencode/commands/summary-logger.md"

package/src/opencode/enforcer-config.json

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

package/src/skills/api-design/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: api-design
 description: RESTful API design and validation
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [design, api, design]

package/src/skills/architect-tools/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: architect-tools
 description: System design and technical architecture tools
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [design, architect, tools]

package/src/skills/architecture-patterns/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: architecture-patterns
 description: Software architecture patterns and best practices
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [design, architecture, patterns]

package/src/skills/auto-format/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: auto-format
 description: Automated code formatting and style consistency
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [formatting, auto, format]

package/src/skills/boot-orchestrator/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: boot-orchestrator
 description: Framework initialization and boot orchestration
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [infrastructure, boot, orchestrator]

package/src/skills/bug-triage/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: bug-triage
 description: Bug triage, debugging analysis, and issue prioritization
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [debugging, bug-fix, triage, error-analysis]

package/src/skills/code-analyzer/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: code-analyzer
 description: Deep code analysis, metrics extraction, and pattern detection (CONSOLIDATED - combines analyzer, explore, and original code-analyzer)
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [analysis, metrics, code-quality, patterns]

package/src/skills/code-review/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: code-review
 description: Perform comprehensive code quality assessment and provide improvement suggestions
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [review, quality, assessment, improvement]

package/src/skills/enforcer/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: enforcer
 description: Codex compliance validation and error prevention
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [quality, enforcer]

package/src/skills/framework-compliance-audit/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: framework-compliance-audit
 description: Framework compliance auditing and validation
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [compliance, framework, compliance, audit]

package/src/skills/git-workflow/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: git-workflow
 description: Git workflow management and collaboration tools
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [collaboration, git, workflow]

package/src/skills/hermes-agent/SKILL.md

@@ -1,21 +1,21 @@
 ---
 name: hermes-agent
-description: Manage StringRay framework from Hermes Agent via the native strray-hermes plugin. Covers the 4 plugin tools (validate, codex_check, health, hooks), lifecycle hooks, slash commands, bridge architecture, and CLI fallback.
+description: Manage 0xRay framework from Hermes Agent via the native xray-hermes plugin. Covers the 4 plugin tools (validate, codex_check, health, hooks), lifecycle hooks, slash commands, bridge architecture, and CLI fallback.
 version: 2.1.0
-author: StringRay AI
+author: 0xRay AI
 metadata:
   hermes:
-    tags: [StringRay, Plugin, Validation, Codex, GitHooks, Bridge]
+    tags: [0xRay, Plugin, Validation, Codex, GitHooks, Bridge]
     related_skills: []
 ---
 
-# StringRay Hermes Plugin (strray-hermes)
+# 0xRay Hermes Plugin (xray-hermes)
 
-Native Hermes plugin providing StringRay framework integration — quality gates, codex enforcement, git hooks, and full pre/post processing pipeline. Runs via a Node.js bridge to compiled framework components.
+Native Hermes plugin providing 0xRay framework integration — quality gates, codex enforcement, git hooks, and full pre/post processing pipeline. Runs via a Node.js bridge to compiled framework components.
 
 ## When to Use
 
-- User asks about StringRay health, validation, or codex checks
+- User asks about 0xRay health, validation, or codex checks
 - User wants to install/manage git hooks for automated enforcement
 - User asks about the plugin's tools, hooks, or slash commands
 - User asks about bridge errors or framework not loading
@@ -24,11 +24,11 @@ Native Hermes plugin providing StringRay framework integration — quality gates
 ## Plugin Architecture
 
 ```
-~/.hermes/plugins/strray-hermes/
+~/.hermes/plugins/xray-hermes/
 ├── __init__.py         # Plugin registration, hooks, slash commands
 ├── tools.py            # 4 tool handlers (validate, codex_check, health, hooks)
 ├── schemas.py          # JSON schemas the LLM sees
-├── bridge.mjs          # Node.js bridge to compiled StringRay framework
+├── bridge.mjs          # Node.js bridge to compiled 0xRay framework
 ├── plugin.yaml         # Plugin metadata (name, version, tools, hooks)
 ├── types.py            # TypeScript-equivalent type definitions
 ├── after-install.md    # Post-install instructions
@@ -43,17 +43,17 @@ Native Hermes plugin providing StringRay framework integration — quality gates
 
 **Fallback:** When bridge is unavailable, tools fall back to `npx 0xray` CLI commands.
 
-**Config path resolution:** `STRRAY_CONFIG_DIR/` > `.strray/` > `.opencode/strray/` > built-in defaults.
+**Config path resolution:** `XRAY_CONFIG_DIR/` > `.xray/` > built-in defaults.
 
 ## 4 Tools
 
-### strray_validate
+### xray_validate
 
 Run pre-commit validation on files. Uses bridge quality gate + processor pipeline, falls back to CLI.
 
 ```
-strray_validate(files=["src/my-module.ts"], operation="commit")
-strray_validate(files=["src/auth.ts", "src/auth.test.ts"], operation="modify")
+xray_validate(files=["src/my-module.ts"], operation="commit")
+xray_validate(files=["src/auth.ts", "src/auth.test.ts"], operation="modify")
 ```
 
 Parameters:
@@ -62,13 +62,13 @@ Parameters:
 
 Returns: pass/fail with per-file results and violations.
 
-### strray_codex_check
+### xray_codex_check
 
 Validate code against the 60-term Universal Development Codex. Checks error-handling, type-safety, performance, security, architecture.
 
 ```
-strray_codex_check(code="const x: any = foo()", operation="create")
-strray_codex_check(code=snippet, operation="modify", focus_areas=["security", "error-handling"])
+xray_codex_check(code="const x: any = foo()", operation="create")
+xray_codex_check(code=snippet, operation="modify", focus_areas=["security", "error-handling"])
 ```
 
 Parameters:
@@ -78,25 +78,25 @@ Parameters:
 
 Returns: violations list with actionable remediation.
 
-### strray_health
+### xray_health
 
 Framework health check. Returns version, loaded components, project root.
 
 ```
-strray_health()
+xray_health()
 ```
 
 Returns: framework status, version, component availability, node version.
 
-### strray_hooks
+### xray_hooks
 
-Manage StringRay git hooks (install, uninstall, list, status).
+Manage 0xRay git hooks (install, uninstall, list, status).
 
 ```
-strray_hooks(action="install")
-strray_hooks(action="status")
-strray_hooks(action="list")
-strray_hooks(action="uninstall", hooks=["pre-commit"])
+xray_hooks(action="install")
+xray_hooks(action="status")
+xray_hooks(action="list")
+xray_hooks(action="uninstall", hooks=["pre-commit"])
 ```
 
 Parameters:
@@ -122,7 +122,7 @@ Fires before ANY tool executes:
 1. Tracks session stats
 2. Logs tool-start event to `logs/framework/plugin-tool-events.log`
 3. For code-producing tools (write_file, patch, execute_code, write, edit): runs quality gate + pre-processors via bridge
-4. For other tools: nudges when a StringRay MCP alternative exists (e.g., grep → search_codebase, eslint → strray_lint)
+4. For other tools: nudges when a 0xRay MCP alternative exists (e.g., grep → search_codebase, eslint → xray_lint)
 
 ### post_tool_call
 
@@ -137,16 +137,16 @@ Fires when a new session starts. Resets stats and logs to disk. Registration is
 ## Slash Command
 
 ```
-/strray status    — Plugin and framework health (calls bridge)
-/strray stats     — Session pipeline statistics
-/strray help      — Show available commands
+/xray status    — Plugin and framework health (calls bridge)
+/xray stats     — Session pipeline statistics
+/xray help      — Show available commands
 /sr status        — Alias
 ```
 
 ## Session Stats (tracked automatically)
 
-The plugin tracks per-session counters visible via `/strray stats`:
-- total_tool_calls, code_operations, strray_mcp_calls, native_tool_calls
+The plugin tracks per-session counters visible via `/xray stats`:
+- total_tool_calls, code_operations, xray_mcp_calls, native_tool_calls
 - quality_gate_runs, quality_gate_blocks
 - pre_processor_runs, post_processor_runs
 - bridge_calls, bridge_errors
@@ -164,13 +164,13 @@ All logs go to `logs/framework/` in the project root:
 
 | User Says | Tool / Command |
 |----------|---------------|
-| "Is StringRay working?" | `strray_health()` or `/strray status` |
-| "Check these files before I commit" | `strray_validate(files=[...], operation="commit")` |
-| "Is this code codex compliant?" | `strray_codex_check(code=..., operation="create")` |
-| "Set up git hooks" | `strray_hooks(action="install")` |
-| "What hooks are installed?" | `strray_hooks(action="status")` |
-| "Show session stats" | `/strray stats` |
-| "Why is the bridge failing?" | Check `strray_health()` → if `framework: "not_loaded"`, verify `dist/` symlink |
+| "Is 0xRay working?" | `xray_health()` or `/xray status` |
+| "Check these files before I commit" | `xray_validate(files=[...], operation="commit")` |
+| "Is this code codex compliant?" | `xray_codex_check(code=..., operation="create")` |
+| "Set up git hooks" | `xray_hooks(action="install")` |
+| "What hooks are installed?" | `xray_hooks(action="status")` |
+| "Show session stats" | `/xray stats` |
+| "Why is the bridge failing?" | Check `xray_health()` → if `framework: "not_loaded"`, verify `dist/` symlink |
 
 ## Bridge Commands (internal)
 
@@ -188,8 +188,8 @@ These are called by the Python tools via `bridge.mjs`, not directly by the LLM:
 
 Bridge can be invoked directly for debugging:
 ```bash
-echo '{"command":"health"}' | node ~/.hermes/plugins/strray-hermes/bridge.mjs
-node ~/.hermes/plugins/strray-hermes/bridge.mjs health --cwd /path/to/project
+echo '{"command":"health"}' | node ~/.hermes/plugins/xray-hermes/bridge.mjs
+node ~/.hermes/plugins/xray-hermes/bridge.mjs health --cwd /path/to/project
 ```
 
 ## Relationship to MCP Servers
@@ -198,15 +198,15 @@ The plugin and MCP servers are complementary:
 - **Plugin tools** = offline-first, always available, lightweight (validate, codex check, health, hooks)
 - **MCP servers** = deeper analysis requiring running Node.js (lint, security scan, architecture assessment, orchestration, codebase search)
 
-The plugin's pre_tool_call hook nudges when an MCP alternative exists (e.g., "use mcp_strray_lint_lint instead of raw eslint"). This is advisory, not blocking.
+The plugin's pre_tool_call hook nudges when an MCP alternative exists (e.g., "use mcp_xray_lint_lint instead of raw eslint"). This is advisory, not blocking.
 
 ## Pitfalls
 
 - Plugin requires restart after install/edit: Hermes loads plugins once at session start.
 - Bridge needs `dist/` symlink: The bridge loads compiled `.js` from `dist/` → `node_modules/0xray/dist/`. If the symlink breaks, bridge returns `framework: "not_loaded"`.
-- `strray_codex_check` without `code` param returns health, not a codex check. Pass `code` for actual validation.
+- `xray_codex_check` without `code` param returns health, not a codex check. Pass `code` for actual validation.
 - CLI fallback requires `npx 0xray` in PATH. If bridge fails and CLI isn't available, tools return errors.
 - Quality gate blocks are logged but NOT enforced (advisory). The tool returns violations; the agent decides what to do.
-- Git hooks use symlinks from `.git/hooks/` → `hooks/`. If the `hooks/` directory doesn't exist in the project, `strray_hooks(action="install")` skips those hooks.
-- Project root detection walks up from CWD looking for `node_modules/0xray`, `.opencode/strray/features.json`, or `package.json`. Override with `STRRAY_PROJECT_ROOT` env var.
+- Git hooks use symlinks from `.git/hooks/` → `hooks/`. If the `hooks/` directory doesn't exist in the project, `xray_hooks(action="install")` skips those hooks.
+- Project root detection walks up from CWD looking for `node_modules/0xray`, `.xray/features.json`, or `package.json`. Override with `XRAY_PROJECT_ROOT` env var.
 - `logs/framework/` is created automatically. Never breaks the agent if permissions fail.

package/src/skills/inference-improve/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: inference-improve
 description: Autonomous inference improvement through collaborative agent analysis
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [inference, improvement, autonomous, learning]

package/src/skills/lint/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: lint
 description: Code linting and static analysis
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [quality, lint]

package/src/skills/log-monitor/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: log-monitor
 description: Log analysis, pattern detection, and alerting
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [monitoring, logging, alerting, observability]

package/src/skills/model-health-check/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: model-health-check
 description: AI model health monitoring and diagnostics
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [monitoring, model, health, check]

package/src/skills/multimodal-looker/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: multimodal-looker
 description: Visual content analysis for diagrams, screenshots, and UI mockups
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [visual, diagrams, screenshots, accessibility, ui-analysis]

package/src/skills/orchestrator/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: orchestrator
 description: Multi-agent workflow coordination and task delegation
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [orchestration, orchestrator]

package/src/skills/performance-analysis/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: performance-analysis
 description: System performance analysis and optimization
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [performance, performance, analysis]

package/src/skills/performance-optimization/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: performance-optimization
 description: Application performance optimization and tuning
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [performance, performance, optimization]

package/src/skills/processor-pipeline/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: processor-pipeline
 description: Data processing pipeline management
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [processing, processor, pipeline]

package/src/skills/project-analysis/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: project-analysis
 description: Analyze project structure, complexity, and health metrics
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [analysis, project, complexity, health]

package/src/skills/refactoring-strategies/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: refactoring-strategies
 description: Code refactoring techniques and strategies
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [refactoring, refactoring, strategies]

package/src/skills/registry.json

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

package/src/skills/researcher/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: researcher
 description: Multi-repo analysis, documentation lookup, and implementation examples
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [research, researcher]

package/src/skills/security-audit/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: security-audit
 description: Security auditing and compliance validation
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [security, security, audit]

package/src/skills/security-scan/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: security-scan
 description: Security vulnerability scanning and assessment
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [security, security, scan]

package/src/skills/session-management/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: session-management
 description: Manage user sessions and persistent state
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [infrastructure, session, management]

package/src/skills/state-manager/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: state-manager
 description: Application state management and persistence
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [infrastructure, state, manager]

package/src/skills/storyteller/SKILL.md

@@ -96,7 +96,7 @@ codex_terms: [5, 7, 32]  # Related Codex term numbers
 ```markdown
 ## What Next?
 
-- Related Codex terms: [codex.json](../../.opencode/strray/codex.json)
+- Related Codex terms: [codex.json](../../../../.xray/codex.json)
 - Next story to write: [suggestion]
 ```
 

package/src/skills/testing-best-practices/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: testing-best-practices
 description: Testing best practices and quality assurance
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [testing, testing, best, practices]

package/src/skills/testing-strategy/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: testing-strategy
 description: Design comprehensive testing strategies and optimize test coverage
-author: StrRay Framework
+author: Xray Framework
 version: 1.0.0
 schema_version: "1.0"
 tags: [testing, strategy, coverage, quality]

package/src/skills/ui-ux-design/SKILL.md

@@ -2,7 +2,7 @@
 source: framework
 name: ui-ux-design
 description: User interface and user experience design with mobile-first approach, cognitive simplicity, and accessibility-first principles
-author: StrRay Framework
+author: Xray Framework
 version: 2.1.0
 schema_version: "1.0"
 tags: [design, ui, ux, accessibility, mobile-first, visual-hierarchy, wcag, contrast, color-theory, dont-make-me-think]

package/xray/agents_template.md

@@ -0,0 +1,46 @@
+# 0xRay AI Agents
+
+Quick reference for the 0xRay AI orchestration framework (v16 MCPs-centric three-subsystem).
+
+## Available MCP Servers
+
+| Server | Role |
+|--------|------|
+| `xray-governance` | Proposal governance, codex snapshot, quality gates |
+| `xray-skills` | Skill invocation, agent-specific knowledge servers |
+| `xray-enforcer` | Codex compliance enforcement, rule validation |
+| `xray-orchestrator` | Multi-agent workflow coordination, task delegation |
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `xray setup` | Full framework setup (hooks, Hermes, symlinks) |
+| `xray validate` | Validate codex compliance |
+| `xray codex check` | Check codex rules |
+| `xray health` | Framework health check |
+| `xray hooks` | Manage lifecycle hooks |
+
+## Governance
+
+xray operates under the three-subsystem model: Inference + External Governance (Dynamo Solar SSOT) + Autonomous Engine (thinDispatch 7-flow in MCP orchestrator). All actions are validated against the Universal Development Codex before execution.
+
+**Codex**: The codex lives in `.xray/codex.json` and enforces 60 terms across all agent interactions.
+
+## thinDispatch Routing
+
+- Simple (≤15): Single agent
+- Moderate (≤25): Single agent with tools
+- Complex (≤50): Multi-agent coordination
+- Enterprise (>50): Orchestrator-led team
+
+## File Organization
+
+| File Type | Save To |
+|-----------|---------|
+| Reflections | `docs/reflections/` |
+| Logs | `logs/` |
+| Scripts | `scripts/` or `scripts/bash/` |
+| Test Files | `src/__tests__/` |
+| Source Code | `src/` |
+| Config | `config/` or `.xray/` |