0xray 3.0.12 → 3.1.0

package/dist/README.md

@@ -1,364 +1,126 @@
-# 0xRay — Self-Healing AI Governance OS
+# xray — MCP-Centric AI Governance OS
 
-**v3.0.12** — 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.11",
-  "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/architect.js

@@ -54,4 +54,3 @@ Stop after giving your answer. Do not loop.`,
         },
     },
 };
-//# sourceMappingURL=architect.js.map

package/dist/agents/backend-engineer.js

@@ -79,4 +79,3 @@ Use database-engineer skills for:
 
 Tone: Systematic, secure, performance-oriented.`,
 };
-//# sourceMappingURL=backend-engineer.js.map

package/dist/agents/bug-triage-specialist.js

@@ -72,4 +72,3 @@ Your goal is to eliminate bugs through systematic investigation and implement fi
         },
     },
 };
-//# sourceMappingURL=bug-triage-specialist.js.map

package/dist/agents/code-analyzer.js

@@ -148,4 +148,3 @@ Provide comprehensive analysis of code, systems, and technical artifacts across
         bash: "ask",
     },
 };
-//# sourceMappingURL=code-analyzer.js.map

package/dist/agents/code-reviewer.js

@@ -15,7 +15,7 @@ export const codeReviewer = {
 
 ## Framework Context
 - Universal Development Codex v1.2.0
-- Validate against all 20 codex terms
+- Validate against all 60 codex terms
 
 ## Rules (STRICT)
 - MAX 3 file reads, then review
@@ -67,4 +67,3 @@ Stop after giving your answer. Do not loop.`,
         },
     },
 };
-//# sourceMappingURL=code-reviewer.js.map

package/dist/agents/content-creator.js

@@ -70,4 +70,3 @@ Copy Principles:
 - Strong CTAs above fold
 - Social proof integrated naturally`,
 };
-//# sourceMappingURL=content-creator.js.map

package/dist/agents/database-engineer.js

@@ -74,4 +74,3 @@ Use database-design MCP server for:
 
 Tone: Technical, precise, performance-oriented.`,
 };
-//# sourceMappingURL=database-engineer.js.map

package/dist/agents/devops-engineer.js

@@ -82,4 +82,3 @@ Use git-workflow MCP server for:
 
 Tone: Reliability-focused, security-conscious, automated.`,
 };
-//# sourceMappingURL=devops-engineer.js.map

package/dist/agents/frontend-engineer.js

@@ -76,4 +76,3 @@ Use ui-ux-design MCP server for:
 
 Tone: User-experience focused, accessible, performant.`,
 };
-//# sourceMappingURL=frontend-engineer.js.map

package/dist/agents/frontend-ui-ux-engineer.js

@@ -62,4 +62,3 @@ Use these MCP servers:
 
 Tone: User-experience focused, accessible, visually appealing.`,
 };
-//# sourceMappingURL=frontend-ui-ux-engineer.js.map

package/dist/agents/growth-strategist.js

@@ -109,4 +109,3 @@ Output Format:
 
 Tone: Professional, strategic, actionable. Zero fluff.`,
 };
-//# sourceMappingURL=growth-strategist.js.map

package/dist/agents/index.js

@@ -43,4 +43,3 @@ export const builtinAgents = {
     "tech-writer": techWriter,
 };
 export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, };
-//# sourceMappingURL=index.js.map

package/dist/agents/known-names.js

@@ -0,0 +1,72 @@
+/**
+ * Known Names — Single combined vocabulary for agent names, skill names,
+ * system service names, and opencode built-in types. All consumers import
+ * from here instead of defining their own hardcoded lists.
+ *
+ * Imports:
+ *   - registry.ts (AGENT_REGISTRY, AGENT_KEYS) — canonical agent definitions
+ *   - mcps/index.ts (MCP_SERVERS) — canonical MCP server manifest
+ */
+import { AGENT_KEYS } from "./registry.js";
+import { MCP_SERVERS } from "../mcps/index.js";
+// ── Agent names (from SSOT) ──
+export { AGENT_KEYS };
+/** All agent names as a mutable array */
+export function getAgentNames() {
+    return [...AGENT_KEYS];
+}
+// ── System service names (not in AGENT_REGISTRY) ──
+export const SYSTEM_SERVICE_NAMES = [
+    "enforcer",
+    "orchestrator",
+    "analyzer",
+];
+// ── Opencode CLI built-in types ──
+export const OPENCODE_BUILTIN_TYPES = [
+    "explore",
+    "general",
+];
+// ── Combined vocabulary ──
+export const ALL_KNOWN_NAMES = [
+    ...AGENT_KEYS,
+    ...SYSTEM_SERVICE_NAMES,
+    ...OPENCODE_BUILTIN_TYPES,
+];
+// ── Boot-priority agents (loaded first by boot-orchestrator) ──
+export const BOOT_AGENTS = [
+    "enforcer",
+    "architect",
+    "bug-triage-specialist",
+    "code-reviewer",
+    "security-auditor",
+    "refactorer",
+    "testing-lead",
+];
+// ── Validation ──
+export function isValidType(name) {
+    return ALL_KNOWN_NAMES.includes(name);
+}
+// ── Agent → Skill alias map (single source) ──
+export const AGENT_TO_SKILL_MAP = {
+    "architect": "architecture-patterns",
+    "backend-engineer": "api-design",
+    "code-reviewer": "code-review",
+    "database-engineer": "database-design",
+    "devops-engineer": "devops-deployment",
+    "mobile-developer": "mobile-development",
+    "performance-engineer": "performance-optimization",
+    "security-auditor": "security-audit",
+    "testing-lead": "testing-strategy",
+    "tech-writer": "documentation-generation",
+    "frontend-ui-ux-engineer": "ui-ux-design",
+    "frontend-engineer": "project-analysis",
+};
+/** Resolve agent name to skill name via alias map, fallback to identity */
+export function resolveSkill(agentOrSkill) {
+    return AGENT_TO_SKILL_MAP[agentOrSkill] || agentOrSkill;
+}
+// ── MCP server names (for consumers that need them) ──
+export { MCP_SERVERS };
+export function getSkillNames() {
+    return MCP_SERVERS.map(s => s.serverName);
+}

package/dist/agents/librarian-agents-updater.js

@@ -331,4 +331,3 @@ export class LibrarianAgentsUpdater {
 }
 // Export singleton instance
 export const librarianAgentsUpdater = new LibrarianAgentsUpdater();
-//# sourceMappingURL=librarian-agents-updater.js.map

package/dist/agents/log-monitor.js

@@ -107,4 +107,3 @@ Your mission is to maintain constant vigilance over system health, detect anomal
         },
     },
 };
-//# sourceMappingURL=log-monitor.js.map

package/dist/agents/mobile-developer.js

@@ -100,4 +100,3 @@ Use mobile-development MCP server for:
 
 Tone: Platform-native, user-experience focused, performance-conscious.`,
 };
-//# sourceMappingURL=mobile-developer.js.map