0xray 3.1.0 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (437) hide show
  1. package/.gitignore.default +59 -0
  2. package/.mcp.json +35 -0
  3. package/.opencode/codex.codex +1 -1
  4. package/.opencode/commands/auto-format.md +3 -3
  5. package/.opencode/commands/auto-summary-capture.md +2 -2
  6. package/.opencode/commands/dependency-audit.md +3 -3
  7. package/.opencode/commands/enforcer-daily-scan.md +3 -3
  8. package/.opencode/commands/framework-compliance-audit.md +4 -4
  9. package/.opencode/commands/interactive-validator.md +2 -2
  10. package/.opencode/commands/job-summary-logger.md +2 -2
  11. package/.opencode/commands/mode-switch.md +1 -1
  12. package/.opencode/commands/model-health-check.md +2 -2
  13. package/.opencode/commands/performance-analysis.md +2 -2
  14. package/.opencode/commands/pre-commit-introspection.md +3 -3
  15. package/.opencode/commands/security-scan.md +3 -3
  16. package/.opencode/commands/sisyphus-validation.md +3 -3
  17. package/.opencode/commands/summary-logger.md +6 -6
  18. package/.opencode/enforcer-config.json +2 -2
  19. package/.opencode/hooks/post-commit +1 -1
  20. package/.opencode/init.sh +6 -0
  21. package/.plugin/plugin.json +11 -0
  22. package/AGENTS-consumer.md +46 -0
  23. package/AGENTS.md +2 -12
  24. package/LICENSE +1 -1
  25. package/README.md +6 -6
  26. package/SKILLS.md +140 -0
  27. package/dist/.gitignore.default +59 -0
  28. package/dist/AGENTS.md +2 -12
  29. package/dist/CHANGELOG.md +54 -0
  30. package/dist/LICENSE +1 -1
  31. package/dist/README.md +6 -6
  32. package/dist/SKILLS.md +140 -0
  33. package/dist/agents/index.js +3 -1
  34. package/dist/agents/registry.js +13 -0
  35. package/dist/analytics/consent-manager.js +0 -1
  36. package/dist/analytics/emerging-pattern-detector.js +0 -1
  37. package/dist/analytics/pattern-learning-engine.js +0 -1
  38. package/dist/analytics/pattern-performance-tracker.js +0 -1
  39. package/dist/analytics/predictive-analytics.js +0 -1
  40. package/dist/analytics/prompt-pattern-analyzer.js +0 -1
  41. package/dist/analytics/routing-performance-analyzer.js +0 -1
  42. package/dist/analytics/routing-refiner.js +1 -2
  43. package/dist/analytics/simple-pattern-analyzer.js +0 -1
  44. package/dist/architect/architectural-integrity.js +3 -3
  45. package/dist/benchmark/performance-benchmark.js +1 -2
  46. package/dist/cli/commands/antigravity-status.js +23 -23
  47. package/dist/cli/commands/archive-logs.js +0 -1
  48. package/dist/cli/commands/credible-init.js +1 -1
  49. package/dist/cli/commands/hermes-install.js +8 -0
  50. package/dist/cli/commands/mcp-install.js +1 -1
  51. package/dist/cli/commands/openclaw-install.js +9 -0
  52. package/dist/cli/commands/opencode-install.js +35 -0
  53. package/dist/cli/commands/plugin-commands.js +0 -1
  54. package/dist/cli/commands/skill-install.js +39 -2
  55. package/dist/cli/commands/status.js +16 -13
  56. package/dist/cli/commands/storyteller.js +1 -1
  57. package/dist/cli/index.js +14 -13
  58. package/dist/core/activity-logger.js +4 -5
  59. package/dist/core/adaptive-kernel.js +0 -1
  60. package/dist/core/agent-spawn-gate.js +1 -1
  61. package/dist/core/boot-orchestrator.js +14 -25
  62. package/dist/core/bridge.mjs +4 -5
  63. package/dist/core/codex-formatter.js +1 -3
  64. package/dist/core/codex-injector.js +3 -4
  65. package/dist/core/config-loader.js +36 -29
  66. package/dist/core/config-paths.js +30 -23
  67. package/dist/core/context-loader.js +0 -4
  68. package/dist/core/context-validator.js +0 -1
  69. package/dist/core/features-config.js +38 -2
  70. package/dist/core/index.js +2 -2
  71. package/dist/core/kernel-patterns.js +0 -1
  72. package/dist/core/logging-config.js +7 -7
  73. package/dist/core/model-router.js +23 -64
  74. package/dist/core/orchestrator.js +1 -1
  75. package/dist/core/system-prompt-generator.js +0 -1
  76. package/dist/core/xray-activation.js +3 -4
  77. package/dist/delegation/agent-delegator.js +2 -3
  78. package/dist/delegation/agent-expertise.js +0 -1
  79. package/dist/delegation/analytics/index.js +0 -1
  80. package/dist/delegation/analytics/learning-engine.js +0 -1
  81. package/dist/delegation/analytics/outcome-tracker.js +0 -1
  82. package/dist/delegation/analytics/routing-analytics.js +0 -1
  83. package/dist/delegation/ast-code-parser.js +0 -1
  84. package/dist/delegation/complexity-analyzer.js +0 -1
  85. package/dist/delegation/dependency-graph-builder.js +0 -1
  86. package/dist/delegation/index.js +0 -1
  87. package/dist/delegation/metrics-aggregator.js +0 -1
  88. package/dist/delegation/session-coordinator.js +0 -1
  89. package/dist/delegation/strategy-selector.js +0 -1
  90. package/dist/delegation/voting-coordinator.js +0 -1
  91. package/dist/delegation/voting-types.js +0 -1
  92. package/dist/delegation/weighted-voting-aggregator.js +0 -1
  93. package/dist/enforcement/core/index.js +0 -1
  94. package/dist/enforcement/core/rule-executor.js +0 -1
  95. package/dist/enforcement/core/rule-hierarchy.js +0 -1
  96. package/dist/enforcement/core/rule-registry.js +0 -1
  97. package/dist/enforcement/core/violation-fixer.js +0 -1
  98. package/dist/enforcement/enforcer-tools.js +2 -2
  99. package/dist/enforcement/index.js +0 -1
  100. package/dist/enforcement/loaders/agent-triage-loader.js +0 -1
  101. package/dist/enforcement/loaders/agents-md-validation-loader.js +0 -1
  102. package/dist/enforcement/loaders/base-loader.js +0 -1
  103. package/dist/enforcement/loaders/codex-loader.js +2 -3
  104. package/dist/enforcement/loaders/index.js +0 -1
  105. package/dist/enforcement/loaders/loader-orchestrator.js +0 -1
  106. package/dist/enforcement/loaders/processor-loader.js +0 -1
  107. package/dist/enforcement/types.js +0 -1
  108. package/dist/enforcement/validators/architecture-validators.js +0 -1
  109. package/dist/enforcement/validators/base-validator.js +0 -1
  110. package/dist/enforcement/validators/code-quality-validators.js +0 -1
  111. package/dist/enforcement/validators/index.js +0 -1
  112. package/dist/enforcement/validators/security-validators.js +0 -1
  113. package/dist/enforcement/validators/testing-validators.js +0 -1
  114. package/dist/enforcement/validators/validator-registry.js +0 -1
  115. package/dist/execution/opencode-cli-invoker.js +1 -1
  116. package/dist/governance/codex-policy.service.js +0 -1
  117. package/dist/governance/governance-service.js +1 -1
  118. package/dist/governance/llm-governance-provider.js +14 -1
  119. package/dist/index.js +3 -5
  120. package/dist/inference/inference-agent-invoker.js +67 -0
  121. package/dist/inference/inference-applier.js +178 -0
  122. package/dist/inference/inference-cycle.js +52 -828
  123. package/dist/inference/inference-proposal-generator.js +149 -0
  124. package/dist/infrastructure/iac-validator.js +465 -0
  125. package/dist/infrastructure/schemas/cloud-schemas.js +488 -0
  126. package/dist/integrations/base/ExampleIntegration.js +0 -1
  127. package/dist/integrations/base/Integration.js +0 -1
  128. package/dist/integrations/base/README.md +1 -1
  129. package/dist/integrations/base/index.js +0 -1
  130. package/dist/integrations/base/registry.js +0 -1
  131. package/dist/integrations/base/types.js +0 -1
  132. package/dist/integrations/enforcement-gate.js +5 -5
  133. package/dist/integrations/governance/governance-client.js +0 -1
  134. package/dist/integrations/governance/index.js +11 -19
  135. package/dist/integrations/governance/types.js +0 -1
  136. package/dist/integrations/grok/grok-cli.js +20 -6
  137. package/dist/integrations/grok/hooks/pre-tool-use.js +3 -3
  138. package/dist/integrations/grok/plugin/0xray/.mcp.json +16 -4
  139. package/dist/integrations/grok/plugin/0xray/hooks/hooks.json +2 -2
  140. package/dist/integrations/hermes-agent/__init__.py +29 -14
  141. package/dist/integrations/hermes-agent/bridge.mjs +76 -4
  142. package/dist/integrations/hermes-agent/schemas.py +49 -0
  143. package/dist/integrations/hermes-agent/test_plugin.py +7 -7
  144. package/dist/integrations/hermes-agent/tools.py +107 -3
  145. package/dist/integrations/openclaw/README.md +6 -6
  146. package/dist/integrations/openclaw/api-server.js +0 -1
  147. package/dist/integrations/openclaw/client.js +0 -1
  148. package/dist/integrations/openclaw/config.js +1 -2
  149. package/dist/integrations/openclaw/hooks/{strray-hooks.js → xray-hooks.js} +0 -1
  150. package/dist/integrations/openclaw/index.js +2 -3
  151. package/dist/integrations/openclaw/types.js +3 -4
  152. package/dist/integrations/plugins/index.js +0 -1
  153. package/dist/integrations/plugins/plugin-integration.js +1 -2
  154. package/dist/integrations/plugins/plugin-registry.js +1 -2
  155. package/dist/mcps/agent-resolver.js +0 -1
  156. package/dist/mcps/architect-tools.server.js +121 -186
  157. package/dist/mcps/auto-format.server.js +57 -75
  158. package/dist/mcps/boot-orchestrator.server.js +68 -86
  159. package/dist/mcps/config/config-loader.js +46 -9
  160. package/dist/mcps/config/plugin-server-registry.js +0 -1
  161. package/dist/mcps/enforcer-tools.server.js +208 -274
  162. package/dist/mcps/estimation.server.js +65 -108
  163. package/dist/mcps/framework-compliance-audit.server.js +53 -82
  164. package/dist/mcps/framework-help.server.js +73 -90
  165. package/dist/mcps/governance.server.js +104 -152
  166. package/dist/mcps/knowledge-skills/api-design.server.js +35 -66
  167. package/dist/mcps/knowledge-skills/architecture-patterns.server.js +35 -66
  168. package/dist/mcps/knowledge-skills/bug-triage-specialist.server.js +125 -165
  169. package/dist/mcps/knowledge-skills/code-analyzer.server.js +211 -238
  170. package/dist/mcps/knowledge-skills/code-review.server.js +109 -143
  171. package/dist/mcps/knowledge-skills/content-creator.server.js +205 -227
  172. package/dist/mcps/knowledge-skills/database-design.server.js +117 -151
  173. package/dist/mcps/knowledge-skills/devops-deployment.server.js +125 -158
  174. package/dist/mcps/knowledge-skills/git-workflow.server.js +36 -68
  175. package/dist/mcps/knowledge-skills/growth-strategist.server.js +303 -325
  176. package/dist/mcps/knowledge-skills/log-monitor.server.js +141 -161
  177. package/dist/mcps/knowledge-skills/mobile-development.server.js +172 -202
  178. package/dist/mcps/knowledge-skills/multimodal-looker.server.js +124 -160
  179. package/dist/mcps/knowledge-skills/performance-optimization.server.js +89 -139
  180. package/dist/mcps/knowledge-skills/project-analysis.server.js +132 -219
  181. package/dist/mcps/knowledge-skills/refactoring-strategies.server.js +117 -151
  182. package/dist/mcps/knowledge-skills/security-audit.server.js +17 -144
  183. package/dist/mcps/knowledge-skills/seo-consultant.server.js +22 -214
  184. package/dist/mcps/knowledge-skills/session-management.server.js +15 -91
  185. package/dist/mcps/knowledge-skills/skill-invocation.server.js +83 -359
  186. package/dist/mcps/knowledge-skills/strategist.server.js +12 -57
  187. package/dist/mcps/knowledge-skills/tech-writer.server.js +18 -193
  188. package/dist/mcps/knowledge-skills/testing-best-practices.server.js +20 -192
  189. package/dist/mcps/knowledge-skills/testing-strategy.server.js +19 -157
  190. package/dist/mcps/knowledge-skills/ui-ux-design.server.js +24 -297
  191. package/dist/mcps/lint.server.js +51 -92
  192. package/dist/mcps/model-health-check.server.js +34 -61
  193. package/dist/mcps/orchestrator/aside-context.js +207 -0
  194. package/dist/mcps/orchestrator/handlers/complexity-handler.js +5 -1
  195. package/dist/mcps/orchestrator/handlers/status-handler.js +8 -1
  196. package/dist/mcps/orchestrator/handlers/task-handler.js +5 -0
  197. package/dist/mcps/orchestrator/index.js +5 -0
  198. package/dist/mcps/orchestrator/server.js +65 -9
  199. package/dist/mcps/orchestrator.server.js +2 -1
  200. package/dist/mcps/performance-analysis.server.js +57 -88
  201. package/dist/mcps/processor-pipeline.server.js +70 -100
  202. package/dist/mcps/registry.json +1 -1
  203. package/dist/mcps/researcher.server.js +81 -154
  204. package/dist/mcps/security-scan.server.js +57 -71
  205. package/dist/mcps/shared/knowledge-skill-base.js +11 -4
  206. package/dist/mcps/state-manager.server.js +127 -155
  207. package/dist/metrics/agent-metrics.js +1 -1
  208. package/dist/monitoring/nudge-watchdog.js +0 -1
  209. package/dist/nucleus/default-plugins.js +13 -19
  210. package/dist/nucleus/index.js +0 -1
  211. package/dist/orchestrator/agent-spawn-governor.js +0 -1
  212. package/dist/orchestrator/enhanced-multi-agent-orchestrator.js +2 -2
  213. package/dist/orchestrator/intelligent-commit-batcher.js +2 -11
  214. package/dist/orchestrator/multi-agent-orchestration-coordinator.js +1 -2
  215. package/dist/orchestrator/orchestrator.js +8 -19
  216. package/dist/orchestrator/self-direction-activation.js +0 -1
  217. package/dist/orchestrator/universal-registry-bridge.js +1 -2
  218. package/dist/performance/performance-budget-enforcer.js +0 -1
  219. package/dist/performance/performance-regression-tester.js +0 -1
  220. package/dist/plugin/plugin-codex-context.js +87 -0
  221. package/dist/plugin/plugin-helpers.js +155 -0
  222. package/dist/plugin/plugin-logger.js +46 -0
  223. package/dist/plugin/plugin-modules.js +144 -0
  224. package/dist/plugin/plugin-quality-gate.js +88 -0
  225. package/dist/plugin/plugin-types.js +1 -0
  226. package/dist/plugin/xray-codex-injection.js +39 -558
  227. package/dist/postprocessor/PostProcessor.js +7 -13
  228. package/dist/postprocessor/analysis/CodeChangeAnalyzer.js +50 -0
  229. package/dist/postprocessor/config/ProcessorConfigLoader.js +16 -0
  230. package/dist/postprocessor/integration.js +194 -0
  231. package/dist/postprocessor/metamorphosis/SelfProposalEngine.js +472 -0
  232. package/dist/postprocessor/metamorphosis/index.js +1 -0
  233. package/dist/postprocessor/redeploy/RetryHandler.js +118 -0
  234. package/dist/postprocessor/services/RegressionAnalysisService.js +2 -3
  235. package/dist/postprocessor/triggers/APITrigger.js +0 -1
  236. package/dist/postprocessor/triggers/GitHookTrigger.js +4 -4
  237. package/dist/postprocessor/triggers/WebhookTrigger.js +0 -1
  238. package/dist/processors/implementations/agents-md-validation-processor.js +0 -1
  239. package/dist/processors/implementations/async-pattern-processor.js +0 -1
  240. package/dist/processors/implementations/console-log-guard-processor.js +0 -1
  241. package/dist/processors/implementations/coverage-analysis-processor.js +0 -1
  242. package/dist/processors/implementations/inference-improvement-processor.js +2 -10
  243. package/dist/processors/implementations/log-protection-processor.js +0 -1
  244. package/dist/processors/implementations/nudge-processor.js +0 -1
  245. package/dist/processors/implementations/performance-budget-processor.js +0 -1
  246. package/dist/processors/implementations/postprocessor-chain-validator.js +0 -1
  247. package/dist/processors/implementations/publish-preflight-processor.js +4 -13
  248. package/dist/processors/implementations/session-summary-processor.js +8 -16
  249. package/dist/processors/implementations/spawn-governance-processor.js +0 -1
  250. package/dist/processors/implementations/storytelling-trigger-processor.js +3 -29
  251. package/dist/processors/implementations/test-auto-creation-processor.js +0 -1
  252. package/dist/processors/implementations/typescript-compilation-processor.js +0 -1
  253. package/dist/processors/implementations/version-compliance-processor.js +0 -1
  254. package/dist/processors/processor-interfaces.js +0 -1
  255. package/dist/processors/processor-types.js +0 -1
  256. package/dist/public/about.html +6 -6
  257. package/dist/public/enterprise.html +1 -1
  258. package/dist/public/features.html +2 -2
  259. package/dist/public/index.html +4 -4
  260. package/dist/reporting/report-formatter.js +1 -1
  261. package/dist/scripts/activate-kernel-pipeline.js +2 -2
  262. package/dist/scripts/integration.js +0 -1
  263. package/dist/scripts/pre-command +1 -1
  264. package/dist/security/comprehensive-security-audit.js +0 -1
  265. package/dist/security/security-agent-coordinator.js +0 -1
  266. package/dist/security/security-auditor.js +0 -1
  267. package/dist/security/security-hardener.js +0 -1
  268. package/dist/security/security-hardening-system.js +0 -1
  269. package/dist/security/security-headers.js +0 -1
  270. package/dist/security/security-orchestration-layer.js +0 -1
  271. package/dist/services/inference-tuner.js +1 -2
  272. package/dist/session/session-cleanup-manager.js +0 -1
  273. package/dist/session/session-monitor.js +0 -1
  274. package/dist/session/session-state-manager.js +0 -1
  275. package/dist/skills/api-design/SKILL.md +1 -1
  276. package/dist/skills/architect-tools/SKILL.md +1 -1
  277. package/dist/skills/architecture-patterns/SKILL.md +1 -1
  278. package/dist/skills/auto-format/SKILL.md +1 -1
  279. package/dist/skills/boot-orchestrator/SKILL.md +1 -1
  280. package/dist/skills/bug-triage/SKILL.md +1 -1
  281. package/dist/skills/code-analyzer/SKILL.md +1 -1
  282. package/dist/skills/code-review/SKILL.md +1 -1
  283. package/dist/skills/enforcer/SKILL.md +1 -1
  284. package/dist/skills/framework-compliance-audit/SKILL.md +1 -1
  285. package/dist/skills/git-workflow/SKILL.md +1 -1
  286. package/dist/skills/hermes-agent/SKILL.md +2 -2
  287. package/dist/skills/inference-improve/SKILL.md +1 -1
  288. package/dist/skills/lint/SKILL.md +1 -1
  289. package/dist/skills/log-monitor/SKILL.md +1 -1
  290. package/dist/skills/model-health-check/SKILL.md +1 -1
  291. package/dist/skills/multimodal-looker/SKILL.md +1 -1
  292. package/dist/skills/orchestrator/SKILL.md +1 -1
  293. package/dist/skills/performance-analysis/SKILL.md +1 -1
  294. package/dist/skills/performance-optimization/SKILL.md +1 -1
  295. package/dist/skills/processor-pipeline/SKILL.md +1 -1
  296. package/dist/skills/project-analysis/SKILL.md +1 -1
  297. package/dist/skills/refactoring-strategies/SKILL.md +1 -1
  298. package/dist/skills/registry.json +1 -1
  299. package/dist/skills/researcher/SKILL.md +1 -1
  300. package/dist/skills/security-audit/SKILL.md +1 -1
  301. package/dist/skills/security-scan/SKILL.md +1 -1
  302. package/dist/skills/session-management/SKILL.md +1 -1
  303. package/dist/skills/state-manager/SKILL.md +1 -1
  304. package/dist/skills/storyteller/SKILL.md +1 -1
  305. package/dist/skills/testing-best-practices/SKILL.md +1 -1
  306. package/dist/skills/testing-strategy/SKILL.md +1 -1
  307. package/dist/skills/ui-ux-design/SKILL.md +1 -1
  308. package/dist/skills/xray-orchestrator/index.js +0 -1
  309. package/dist/state/index.js +0 -1
  310. package/dist/state/state-manager.js +1 -2
  311. package/dist/utils/codex-parser.js +0 -1
  312. package/dist/utils/import-resolver.js +1 -1
  313. package/dist/utils/language-detector.js +0 -1
  314. package/dist/utils/path-resolver.js +2 -2
  315. package/dist/utils/shutdown-handler.js +0 -1
  316. package/dist/validation/agent-config-validator.js +280 -0
  317. package/dist/validation/orchestration-flow-validator.js +606 -0
  318. package/package.json +10 -3
  319. package/scripts/hooks/pre-command +1 -1
  320. package/scripts/hooks/run-hook.js +2 -2
  321. package/scripts/node/auto-reflection-generator.mjs +30 -36
  322. package/scripts/node/govern-reflection.mjs +1 -1
  323. package/scripts/node/postinstall.cjs +37 -2
  324. package/scripts/node/release.mjs +2 -2
  325. package/scripts/node/setup-xai-oauth.mjs +244 -0
  326. package/scripts/node/setup.cjs +28 -0
  327. package/scripts/node/universal-version-manager.js +8 -8
  328. package/scripts/node/version-manager.mjs +1 -1
  329. package/src/integrations/grok/plugin/0xray/.mcp.json +16 -4
  330. package/src/integrations/grok/plugin/0xray/hooks/hooks.json +2 -2
  331. package/src/mcps/agent-resolver.ts +0 -1
  332. package/src/mcps/architect-tools.server.ts +130 -212
  333. package/src/mcps/auto-format.server.ts +75 -104
  334. package/src/mcps/boot-orchestrator.server.ts +72 -97
  335. package/src/mcps/config/__tests__/config-loader.test.ts +33 -37
  336. package/src/mcps/config/config-loader.ts +57 -11
  337. package/src/mcps/config/plugin-server-registry.ts +0 -1
  338. package/src/mcps/enforcer-tools.server.ts +218 -295
  339. package/src/mcps/estimation.server.ts +64 -123
  340. package/src/mcps/framework-compliance-audit.server.ts +54 -96
  341. package/src/mcps/framework-help.server.ts +76 -97
  342. package/src/mcps/governance.server.ts +104 -164
  343. package/src/mcps/knowledge-skills/api-design.server.ts +35 -73
  344. package/src/mcps/knowledge-skills/architecture-patterns.server.ts +34 -73
  345. package/src/mcps/knowledge-skills/bug-triage-specialist.server.ts +149 -194
  346. package/src/mcps/knowledge-skills/code-analyzer.server.ts +223 -255
  347. package/src/mcps/knowledge-skills/code-review.server.ts +116 -158
  348. package/src/mcps/knowledge-skills/content-creator.server.ts +221 -248
  349. package/src/mcps/knowledge-skills/database-design.server.ts +120 -161
  350. package/src/mcps/knowledge-skills/devops-deployment.server.ts +128 -168
  351. package/src/mcps/knowledge-skills/git-workflow.server.ts +34 -78
  352. package/src/mcps/knowledge-skills/growth-strategist.server.ts +324 -362
  353. package/src/mcps/knowledge-skills/log-monitor.server.ts +70 -97
  354. package/src/mcps/knowledge-skills/mobile-development.server.ts +18 -58
  355. package/src/mcps/knowledge-skills/multimodal-looker.server.ts +15 -61
  356. package/src/mcps/knowledge-skills/performance-optimization.server.ts +14 -75
  357. package/src/mcps/knowledge-skills/project-analysis.server.ts +14 -121
  358. package/src/mcps/knowledge-skills/refactoring-strategies.server.ts +15 -61
  359. package/src/mcps/knowledge-skills/security-audit.server.ts +20 -158
  360. package/src/mcps/knowledge-skills/seo-consultant.server.ts +25 -228
  361. package/src/mcps/knowledge-skills/session-management.server.ts +19 -107
  362. package/src/mcps/knowledge-skills/skill-invocation.server.ts +89 -380
  363. package/src/mcps/knowledge-skills/strategist.server.ts +15 -65
  364. package/src/mcps/knowledge-skills/tech-writer.server.ts +21 -206
  365. package/src/mcps/knowledge-skills/testing-best-practices.server.ts +23 -205
  366. package/src/mcps/knowledge-skills/testing-strategy.server.ts +22 -166
  367. package/src/mcps/knowledge-skills/ui-ux-design.server.ts +27 -343
  368. package/src/mcps/lint.server.ts +53 -106
  369. package/src/mcps/model-health-check.server.ts +35 -71
  370. package/src/mcps/orchestrator/aside-context.ts +245 -0
  371. package/src/mcps/orchestrator/handlers/complexity-handler.ts +9 -3
  372. package/src/mcps/orchestrator/handlers/status-handler.ts +11 -1
  373. package/src/mcps/orchestrator/handlers/task-handler.ts +8 -1
  374. package/src/mcps/orchestrator/index.ts +29 -0
  375. package/src/mcps/orchestrator/server.ts +81 -25
  376. package/src/mcps/orchestrator/types.ts +37 -0
  377. package/src/mcps/orchestrator.server.ts +2 -1
  378. package/src/mcps/performance-analysis.server.ts +60 -103
  379. package/src/mcps/processor-pipeline.server.ts +72 -109
  380. package/src/mcps/registry.json +1 -1
  381. package/src/mcps/researcher.server.ts +88 -176
  382. package/src/mcps/security-scan.server.ts +58 -77
  383. package/src/mcps/shared/knowledge-skill-base.ts +12 -4
  384. package/src/mcps/state-manager.server.ts +132 -172
  385. package/src/opencode/codex.codex +1 -1
  386. package/src/opencode/commands/auto-format.md +3 -3
  387. package/src/opencode/commands/auto-summary-capture.md +2 -2
  388. package/src/opencode/commands/dependency-audit.md +3 -3
  389. package/src/opencode/commands/enforcer-daily-scan.md +3 -3
  390. package/src/opencode/commands/framework-compliance-audit.md +4 -4
  391. package/src/opencode/commands/interactive-validator.md +2 -2
  392. package/src/opencode/commands/job-summary-logger.md +2 -2
  393. package/src/opencode/commands/mode-switch.md +1 -1
  394. package/src/opencode/commands/model-health-check.md +2 -2
  395. package/src/opencode/commands/performance-analysis.md +2 -2
  396. package/src/opencode/commands/pre-commit-introspection.md +3 -3
  397. package/src/opencode/commands/security-scan.md +3 -3
  398. package/src/opencode/commands/sisyphus-validation.md +3 -3
  399. package/src/opencode/commands/summary-logger.md +6 -6
  400. package/src/opencode/enforcer-config.json +2 -2
  401. package/src/skills/api-design/SKILL.md +1 -1
  402. package/src/skills/architect-tools/SKILL.md +1 -1
  403. package/src/skills/architecture-patterns/SKILL.md +1 -1
  404. package/src/skills/auto-format/SKILL.md +1 -1
  405. package/src/skills/boot-orchestrator/SKILL.md +1 -1
  406. package/src/skills/bug-triage/SKILL.md +1 -1
  407. package/src/skills/code-analyzer/SKILL.md +1 -1
  408. package/src/skills/code-review/SKILL.md +1 -1
  409. package/src/skills/enforcer/SKILL.md +1 -1
  410. package/src/skills/framework-compliance-audit/SKILL.md +1 -1
  411. package/src/skills/git-workflow/SKILL.md +1 -1
  412. package/src/skills/hermes-agent/SKILL.md +2 -2
  413. package/src/skills/inference-improve/SKILL.md +1 -1
  414. package/src/skills/lint/SKILL.md +1 -1
  415. package/src/skills/log-monitor/SKILL.md +1 -1
  416. package/src/skills/model-health-check/SKILL.md +1 -1
  417. package/src/skills/multimodal-looker/SKILL.md +1 -1
  418. package/src/skills/orchestrator/SKILL.md +1 -1
  419. package/src/skills/performance-analysis/SKILL.md +1 -1
  420. package/src/skills/performance-optimization/SKILL.md +1 -1
  421. package/src/skills/processor-pipeline/SKILL.md +1 -1
  422. package/src/skills/project-analysis/SKILL.md +1 -1
  423. package/src/skills/refactoring-strategies/SKILL.md +1 -1
  424. package/src/skills/registry.json +1 -1
  425. package/src/skills/researcher/SKILL.md +1 -1
  426. package/src/skills/security-audit/SKILL.md +1 -1
  427. package/src/skills/security-scan/SKILL.md +1 -1
  428. package/src/skills/session-management/SKILL.md +1 -1
  429. package/src/skills/state-manager/SKILL.md +1 -1
  430. package/src/skills/storyteller/SKILL.md +1 -1
  431. package/src/skills/testing-best-practices/SKILL.md +1 -1
  432. package/src/skills/testing-strategy/SKILL.md +1 -1
  433. package/src/skills/ui-ux-design/SKILL.md +1 -1
  434. package/src/skills/xray-orchestrator/index.ts +0 -1
  435. package/xray/agents_template.md +46 -0
  436. package/xray/codex.json +598 -0
  437. package/dist/nucleus/orchestrator.js +0 -479
package/SKILLS.md ADDED
@@ -0,0 +1,140 @@
1
+ # 0xray Skills
2
+
3
+ xray ships **46 skills** that provide domain expertise across the full software lifecycle. Skills are loaded on demand and invoked via MCP servers, agents, or direct API.
4
+
5
+ ---
6
+
7
+ ## Governance & Compliance
8
+
9
+ | Skill | Agent | Description |
10
+ |-------|-------|-------------|
11
+ | `code-review` | @code-reviewer | Proposal quality, code analysis, best practices |
12
+ | `security-audit` | @security-auditor | Vulnerability detection, threat modeling |
13
+ | `security-scan` | — | Security vulnerability scanning and assessment |
14
+ | `enforcer` | @enforcer | Codex compliance validation and error prevention |
15
+ | `framework-compliance-audit` | — | Framework compliance auditing and validation |
16
+
17
+ ## Architecture & Design
18
+
19
+ | Skill | Agent | Description |
20
+ |-------|-------|-------------|
21
+ | `architect-tools` | — | System design and technical architecture tools |
22
+ | `architecture-patterns` | — | Software architecture patterns and best practices |
23
+ | `api-design` | — | RESTful API design and validation |
24
+ | `database-engineer` | — | SQL/NoSQL schema design, query optimization, migrations |
25
+ | `state-manager` | — | Application state management and persistence |
26
+ | `session-management` | — | Manage user sessions and persistent state |
27
+
28
+ ## Engineering
29
+
30
+ | Skill | Agent | Description |
31
+ |-------|-------|-------------|
32
+ | `backend-engineer` | — | REST/GraphQL APIs, microservices, auth, server architecture |
33
+ | `frontend-engineer` | — | React/Vue/Angular/Svelte, responsive design, accessibility |
34
+ | `frontend-ui-ux-engineer` | — | Visual design, CSS systems, accessibility, UX |
35
+ | `mobile-developer` | — | iOS (Swift/SwiftUI), Android (Kotlin/Compose), RN, Flutter |
36
+ | `devops-engineer` | — | CI/CD, IaaC, containers, cloud deployment, reliability |
37
+
38
+ ## Code Quality & Analysis
39
+
40
+ | Skill | Agent | Description |
41
+ |-------|-------|-------------|
42
+ | `code-analyzer` | — | Deep code analysis, metrics extraction, pattern detection |
43
+ | `project-analysis` | — | Analyze project structure, complexity, and health metrics |
44
+ | `lint` | — | Code linting and static analysis |
45
+ | `auto-format` | — | Automated code formatting and style consistency |
46
+ | `refactoring-strategies` | @refactorer | Code refactoring techniques and strategies |
47
+
48
+ ## Testing
49
+
50
+ | Skill | Agent | Description |
51
+ |-------|-------|-------------|
52
+ | `testing-strategy` | @testing-lead | Comprehensive testing strategies and coverage |
53
+ | `testing-best-practices` | — | Testing best practices and patterns |
54
+
55
+ ## Performance
56
+
57
+ | Skill | Agent | Description |
58
+ |-------|-------|-------------|
59
+ | `performance-analysis` | — | System performance analysis and optimization |
60
+ | `performance-engineer` | — | Profiling, benchmarking, load testing, optimization |
61
+ | `performance-optimization` | — | Application performance optimization and tuning |
62
+
63
+ ## Debugging & Monitoring
64
+
65
+ | Skill | Agent | Description |
66
+ |-------|-------|-------------|
67
+ | `bug-triage` | @bug-triage-specialist | Bug triage, debugging analysis, issue prioritization |
68
+ | `log-monitor` | — | Log analysis, pattern detection, alerting |
69
+ | `model-health-check` | — | AI model health monitoring and diagnostics |
70
+
71
+ ## Orchestration & Workflow
72
+
73
+ | Skill | Agent | Description |
74
+ |-------|-------|-------------|
75
+ | `orchestrator` | @orchestrator | Multi-agent workflow coordination and task delegation |
76
+ | `xray-orchestrator` | — | Main orchestration skill for xray agents |
77
+ | `processor-pipeline` | — | Data processing pipeline management |
78
+ | `boot-orchestrator` | — | Framework initialization and boot orchestration |
79
+
80
+ ## Research & Content
81
+
82
+ | Skill | Agent | Description |
83
+ |-------|-------|-------------|
84
+ | `researcher` | @researcher | Codebase exploration, implementation lookup |
85
+ | `content-creator` | — | Marketing copy, technical docs, blog posts, social media |
86
+ | `tech-writer` | — | API docs, READMEs, ADRs, changelogs, DX |
87
+ | `storyteller` | — | Deep narrative reflections, sagas, technical stories |
88
+ | `seo-consultant` | — | Technical SEO, schema markup, Core Web Vitals |
89
+ | `growth-strategist` | — | Campaign strategy, market analysis, brand positioning |
90
+
91
+ ## UX & Design
92
+
93
+ | Skill | Agent | Description |
94
+ |-------|-------|-------------|
95
+ | `ui-ux-design` | — | Mobile-first, cognitive simplicity, accessibility-first |
96
+ | `multimodal-looker` | — | Visual content analysis for diagrams, screenshots, UI mockups |
97
+
98
+ ## Strategy
99
+
100
+ | Skill | Agent | Description |
101
+ |-------|-------|-------------|
102
+ | `strategist` | @strategist | Strategic guidance, architectural decisions, risk analysis |
103
+ | `inference-improve` | — | Autonomous inference improvement through collaborative analysis |
104
+
105
+ ## Git & Workflow
106
+
107
+ | Skill | Agent | Description |
108
+ |-------|-------|-------------|
109
+ | `git-workflow` | — | Git workflow management and collaboration tools |
110
+
111
+ ## Integration
112
+
113
+ | Skill | Agent | Description |
114
+ |-------|-------|-------------|
115
+ | `hermes-agent` | — | Manage xray from Hermes Agent via native plugin |
116
+
117
+ ---
118
+
119
+ ## Invoking Skills
120
+
121
+ Skills are invoked automatically by agents or via MCP:
122
+
123
+ ```bash
124
+ # Via agent mention (in any chat)
125
+ @code-reviewer review this PR
126
+
127
+ # Via MCP tool call
128
+ npx xray mcp call code-review analyze_code_quality --args '{"path": "src/"}'
129
+
130
+ # Via direct agent
131
+ npx xray agent run @refactorer "optimize src/core/"
132
+ ```
133
+
134
+ ## Skill Locations
135
+
136
+ Each skill has a `SKILL.md` with full reference:
137
+
138
+ - **Source**: `src/skills/<name>/SKILL.md`
139
+ - **Consumer**: `node_modules/0xray/dist/skills/<name>/SKILL.md`
140
+ - **Opend**: `.opencode/skills/<name>/SKILL.md` (copied on `npx xray setup`)
@@ -0,0 +1,59 @@
1
+ # 0xray — Default .gitignore
2
+ # Generated by 0xray postinstall. Edit as needed.
3
+
4
+ # Dependencies
5
+ node_modules/
6
+
7
+ # Build artifacts
8
+ dist/
9
+ build/
10
+ *.tsbuildinfo
11
+
12
+ # Environment & secrets
13
+ .env
14
+ .env.*
15
+ .env.local
16
+ *.local
17
+ **/auth.json
18
+ .hermes/
19
+ credentials.json
20
+ *.pem
21
+ *.key
22
+
23
+ # Runtime state (xray inference workflows, session state)
24
+ .xray/
25
+ .strray/
26
+ strray/
27
+ xray/inference/
28
+
29
+ # Generated xray config files
30
+ .opencode/agents/*.yml
31
+ .opencode/agents/
32
+ .opencode/commands/
33
+ .opencode/workflows/
34
+ .opencode/codex.codex
35
+ .opencode/enforcer-config.json
36
+ .opencode/skills/
37
+ .opencode/scripts/
38
+ .opencode/logs/
39
+ .opencode/validation/
40
+ .opencode/triage/
41
+
42
+ # Logs
43
+ logs/
44
+ *.log
45
+
46
+ # OS files
47
+ .DS_Store
48
+ Thumbs.db
49
+
50
+ # IDE
51
+ .idea/
52
+ .vscode/
53
+ *.swp
54
+ *.swo
55
+ *~
56
+
57
+ # Temp
58
+ *.tmp
59
+ *.tgz
package/dist/AGENTS.md CHANGED
@@ -39,7 +39,7 @@ xray operates under the pure three-subsystem model: Inference + External Governa
39
39
  | **Scripts** | `scripts/` or `scripts/bash/` | `scripts/bash/my-script.sh` |
40
40
  | **Test Files** | `src/__tests__/` | `src/__tests__/unit/my-test.test.ts` |
41
41
  | **Source Code** | `src/` | `src/my-module.ts` |
42
- | **Config** | `config/` or `.opencode/xray/` | `.opencode/xray/config.json` |
42
+ | **Config** | `config/` or `.xray/` | `.xray/config.json` |
43
43
 
44
44
  **Never save to root** - Root directory is for essential files only:
45
45
  - `README.md`, `CHANGELOG.md`, `package.json`, `tsconfig.json`
@@ -82,16 +82,6 @@ The Autonomous Engine routes via complexity:
82
82
 
83
83
  ## Codex
84
84
 
85
- xray enforces the Universal Development Codex (60 terms) via Dynamo governance. The codex lives in `.opencode/xray/codex.json`.
85
+ xray enforces the Universal Development Codex (60 terms) via Dynamo governance. The codex lives in `.xray/codex.json`.
86
86
 
87
87
  Pure v16 MCPs. Clean. Complete.
88
-
89
- ## Session: v3.0.14 Rename Polish
90
-
91
- - Package: `0xray` (npm), `github.com/0xRayAI/xray`. Version `3.0.14`.
92
- - **All 182 test files pass**: 2527 tests, 0 failures, 36 skipped.
93
- - **Build fix**: removed stale `.opencode/plugin/` copy; `package.json` → `dist/plugin/xray-codex-injection.js`.
94
- - **default-plugins.ts**: monkey-patch `Server.prototype.setRequestHandler` to capture tool definitions from MCP Server instances; all registration functions async.
95
- - **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.
96
- - **CHANGELOG.md**: added v3.0.13 entry.
97
- - **Stale READMEs**: updated `StringRay` → `0xray` in 4 subdirectory READMEs.
package/dist/CHANGELOG.md CHANGED
@@ -4,6 +4,60 @@ All notable changes to this project will be documented in this file.
4
4
 
5
5
  The format is based on [Conventional Commits](https://www.conventionalcommits.org/).
6
6
 
7
+ ## [3.1.1] - 2026-06-17
8
+
9
+ ### 🔄 Changes
10
+
11
+ ### ✨ Features
12
+ - feat: AsideContext restoration + plugin module split + Hermes e2e 44/0/0 (3a917b7c3)
13
+ - feat: config consolidation, MCP base class, test coverage, Hermes e2e fix (8b3f0500f)
14
+ - feat: add root .mcp.json and .grok-plugin/plugin.json for marketplace discovery (f8d084cc0)
15
+ - feat: ship .gitignore.default template + SKILLS.md to consumers via postinstall (44bba8c4c)
16
+
17
+ ### 🐛 Bug Fixes
18
+ - fix: publish guard fixes - 4 test files, plugin build, ConfigLoader.clearConfigPaths() (5a5edfa42)
19
+ - fix: restore .mcp.json (deleted by test writing to same path) (e22202cfc)
20
+ - fix: support mcpServers format in ConfigLoader, fix tests for real .mcp.json (a930aa034)
21
+ - fix: add missing fs imports, process.argv[1]! assertions, and vitest v4 config (0dffc5683)
22
+ - fix: remove .opencode/xray/ fallback from auto-reflection-generator.mjs (de7633152)
23
+ - fix: Railway deployment - MCP host, in-process skills, Hermes OAuth decode, OAuth daemon mode (a519338c3)
24
+ - fix: pre-publish-guard handles missing features.json (855e3cfdb)
25
+
26
+ ### ♻️ Refactoring
27
+ - refactor: complete StringRay→0xRay rename, archive cleanup, skill syncing, MCP tools (d78bc3763)
28
+
29
+ ### 🔎 Other Changes
30
+ - v3.1.1 (825105795)
31
+ - Revert "Add marketplace files: .grok-plugin/plugin.json and .mcp.json for xAI plugin catalog" (05feb6fba)
32
+ - Add marketplace files: .grok-plugin/plugin.json and .mcp.json for xAI plugin catalog (5824d5776)
33
+
34
+ ---
35
+
36
+ ## [3.1.1] - 2026-06-16
37
+
38
+ ### 🔄 Changes
39
+
40
+ ### ✨ Features
41
+ - feat: add root .mcp.json and .grok-plugin/plugin.json for marketplace discovery (f8d084cc0)
42
+ - feat: ship .gitignore.default template + SKILLS.md to consumers via postinstall (44bba8c4c)
43
+
44
+ ### 🐛 Bug Fixes
45
+ - fix: restore .mcp.json (deleted by test writing to same path) (e22202cfc)
46
+ - fix: support mcpServers format in ConfigLoader, fix tests for real .mcp.json (a930aa034)
47
+ - fix: add missing fs imports, process.argv[1]! assertions, and vitest v4 config (0dffc5683)
48
+ - fix: remove .opencode/xray/ fallback from auto-reflection-generator.mjs (de7633152)
49
+ - fix: Railway deployment - MCP host, in-process skills, Hermes OAuth decode, OAuth daemon mode (a519338c3)
50
+ - fix: pre-publish-guard handles missing features.json (855e3cfdb)
51
+
52
+ ### ♻️ Refactoring
53
+ - refactor: complete StringRay→0xRay rename, archive cleanup, skill syncing, MCP tools (d78bc3763)
54
+
55
+ ### 🔎 Other Changes
56
+ - Revert "Add marketplace files: .grok-plugin/plugin.json and .mcp.json for xAI plugin catalog" (05feb6fba)
57
+ - Add marketplace files: .grok-plugin/plugin.json and .mcp.json for xAI plugin catalog (5824d5776)
58
+
59
+ ---
60
+
7
61
  ## [3.1.0] - 2026-06-15
8
62
 
9
63
  ### 🔄 Changes
package/dist/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 StrRay Framework Team
3
+ Copyright (c) 2026 Xray Framework Team
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/dist/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # xray — MCP-Centric AI Governance OS
2
2
 
3
- **v2.0.0** — 9 agents · 44 skills · 16 MCPs governance servers · 60 codex terms · 2,2527 tests
3
+ 9 agents · 44 skills · 16 MCPs governance servers · 60 codex terms
4
4
 
5
5
  xray is the pure v2 three-subsystem AI orchestration framework, now **MCP-centric** with dedicated skill servers for governance deliberation:
6
6
 
@@ -98,17 +98,17 @@ Codex enforcement is integrated at every level:
98
98
  - frameworkLogger structured logging throughout (never console.*)
99
99
  - Active codex snapshot available via `get_active_codex` MCP tool
100
100
 
101
- ## Testing (2,2527 tests)
101
+ ## Testing (2,2500 tests)
102
102
 
103
103
  | Suite | Status |
104
104
  |-------|--------|
105
105
  | Unit / Integration | 158 files, all pass |
106
- | Performance | 2527 tests, all pass |
107
- | Infrastructure | 2527 tests, all pass |
106
+ | Performance | 2500 tests, all pass |
107
+ | Infrastructure | 2500 tests, all pass |
108
108
  | Consumer E2E | 4 platforms, all pass |
109
109
  | OpenCode E2E | 42/42 solo, 34/34 orchestrator, all pass |
110
- | OpenClaw E2E | 2527 tests, all pass |
111
- | Hermes E2E | 2527 tests, all pass |
110
+ | OpenClaw E2E | 2500 tests, all pass |
111
+ | Hermes E2E | 2500 tests, all pass |
112
112
  | Grok CLI E2E | 60/60 solo, 59/59 orchestrator, all pass |
113
113
 
114
114
  ## Release
package/dist/SKILLS.md ADDED
@@ -0,0 +1,140 @@
1
+ # 0xray Skills
2
+
3
+ xray ships **46 skills** that provide domain expertise across the full software lifecycle. Skills are loaded on demand and invoked via MCP servers, agents, or direct API.
4
+
5
+ ---
6
+
7
+ ## Governance & Compliance
8
+
9
+ | Skill | Agent | Description |
10
+ |-------|-------|-------------|
11
+ | `code-review` | @code-reviewer | Proposal quality, code analysis, best practices |
12
+ | `security-audit` | @security-auditor | Vulnerability detection, threat modeling |
13
+ | `security-scan` | — | Security vulnerability scanning and assessment |
14
+ | `enforcer` | @enforcer | Codex compliance validation and error prevention |
15
+ | `framework-compliance-audit` | — | Framework compliance auditing and validation |
16
+
17
+ ## Architecture & Design
18
+
19
+ | Skill | Agent | Description |
20
+ |-------|-------|-------------|
21
+ | `architect-tools` | — | System design and technical architecture tools |
22
+ | `architecture-patterns` | — | Software architecture patterns and best practices |
23
+ | `api-design` | — | RESTful API design and validation |
24
+ | `database-engineer` | — | SQL/NoSQL schema design, query optimization, migrations |
25
+ | `state-manager` | — | Application state management and persistence |
26
+ | `session-management` | — | Manage user sessions and persistent state |
27
+
28
+ ## Engineering
29
+
30
+ | Skill | Agent | Description |
31
+ |-------|-------|-------------|
32
+ | `backend-engineer` | — | REST/GraphQL APIs, microservices, auth, server architecture |
33
+ | `frontend-engineer` | — | React/Vue/Angular/Svelte, responsive design, accessibility |
34
+ | `frontend-ui-ux-engineer` | — | Visual design, CSS systems, accessibility, UX |
35
+ | `mobile-developer` | — | iOS (Swift/SwiftUI), Android (Kotlin/Compose), RN, Flutter |
36
+ | `devops-engineer` | — | CI/CD, IaaC, containers, cloud deployment, reliability |
37
+
38
+ ## Code Quality & Analysis
39
+
40
+ | Skill | Agent | Description |
41
+ |-------|-------|-------------|
42
+ | `code-analyzer` | — | Deep code analysis, metrics extraction, pattern detection |
43
+ | `project-analysis` | — | Analyze project structure, complexity, and health metrics |
44
+ | `lint` | — | Code linting and static analysis |
45
+ | `auto-format` | — | Automated code formatting and style consistency |
46
+ | `refactoring-strategies` | @refactorer | Code refactoring techniques and strategies |
47
+
48
+ ## Testing
49
+
50
+ | Skill | Agent | Description |
51
+ |-------|-------|-------------|
52
+ | `testing-strategy` | @testing-lead | Comprehensive testing strategies and coverage |
53
+ | `testing-best-practices` | — | Testing best practices and patterns |
54
+
55
+ ## Performance
56
+
57
+ | Skill | Agent | Description |
58
+ |-------|-------|-------------|
59
+ | `performance-analysis` | — | System performance analysis and optimization |
60
+ | `performance-engineer` | — | Profiling, benchmarking, load testing, optimization |
61
+ | `performance-optimization` | — | Application performance optimization and tuning |
62
+
63
+ ## Debugging & Monitoring
64
+
65
+ | Skill | Agent | Description |
66
+ |-------|-------|-------------|
67
+ | `bug-triage` | @bug-triage-specialist | Bug triage, debugging analysis, issue prioritization |
68
+ | `log-monitor` | — | Log analysis, pattern detection, alerting |
69
+ | `model-health-check` | — | AI model health monitoring and diagnostics |
70
+
71
+ ## Orchestration & Workflow
72
+
73
+ | Skill | Agent | Description |
74
+ |-------|-------|-------------|
75
+ | `orchestrator` | @orchestrator | Multi-agent workflow coordination and task delegation |
76
+ | `xray-orchestrator` | — | Main orchestration skill for xray agents |
77
+ | `processor-pipeline` | — | Data processing pipeline management |
78
+ | `boot-orchestrator` | — | Framework initialization and boot orchestration |
79
+
80
+ ## Research & Content
81
+
82
+ | Skill | Agent | Description |
83
+ |-------|-------|-------------|
84
+ | `researcher` | @researcher | Codebase exploration, implementation lookup |
85
+ | `content-creator` | — | Marketing copy, technical docs, blog posts, social media |
86
+ | `tech-writer` | — | API docs, READMEs, ADRs, changelogs, DX |
87
+ | `storyteller` | — | Deep narrative reflections, sagas, technical stories |
88
+ | `seo-consultant` | — | Technical SEO, schema markup, Core Web Vitals |
89
+ | `growth-strategist` | — | Campaign strategy, market analysis, brand positioning |
90
+
91
+ ## UX & Design
92
+
93
+ | Skill | Agent | Description |
94
+ |-------|-------|-------------|
95
+ | `ui-ux-design` | — | Mobile-first, cognitive simplicity, accessibility-first |
96
+ | `multimodal-looker` | — | Visual content analysis for diagrams, screenshots, UI mockups |
97
+
98
+ ## Strategy
99
+
100
+ | Skill | Agent | Description |
101
+ |-------|-------|-------------|
102
+ | `strategist` | @strategist | Strategic guidance, architectural decisions, risk analysis |
103
+ | `inference-improve` | — | Autonomous inference improvement through collaborative analysis |
104
+
105
+ ## Git & Workflow
106
+
107
+ | Skill | Agent | Description |
108
+ |-------|-------|-------------|
109
+ | `git-workflow` | — | Git workflow management and collaboration tools |
110
+
111
+ ## Integration
112
+
113
+ | Skill | Agent | Description |
114
+ |-------|-------|-------------|
115
+ | `hermes-agent` | — | Manage xray from Hermes Agent via native plugin |
116
+
117
+ ---
118
+
119
+ ## Invoking Skills
120
+
121
+ Skills are invoked automatically by agents or via MCP:
122
+
123
+ ```bash
124
+ # Via agent mention (in any chat)
125
+ @code-reviewer review this PR
126
+
127
+ # Via MCP tool call
128
+ npx xray mcp call code-review analyze_code_quality --args '{"path": "src/"}'
129
+
130
+ # Via direct agent
131
+ npx xray agent run @refactorer "optimize src/core/"
132
+ ```
133
+
134
+ ## Skill Locations
135
+
136
+ Each skill has a `SKILL.md` with full reference:
137
+
138
+ - **Source**: `src/skills/<name>/SKILL.md`
139
+ - **Consumer**: `node_modules/0xray/dist/skills/<name>/SKILL.md`
140
+ - **Opend**: `.opencode/skills/<name>/SKILL.md` (copied on `npx xray setup`)
@@ -19,6 +19,7 @@ import { performanceEngineer } from "./performance-engineer.js";
19
19
  import { seoConsultant } from "./seo-consultant.js";
20
20
  import { strategist } from "./strategist.js";
21
21
  import { techWriter } from "./tech-writer.js";
22
+ import { multimodalLooker } from "./multimodal-looker.js";
22
23
  export const builtinAgents = {
23
24
  architect,
24
25
  "bug-triage-specialist": bugTriageSpecialist,
@@ -41,5 +42,6 @@ export const builtinAgents = {
41
42
  "seo-consultant": seoConsultant,
42
43
  strategist,
43
44
  "tech-writer": techWriter,
45
+ "multimodal-looker": multimodalLooker,
44
46
  };
45
- export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, };
47
+ export { architect, bugTriageSpecialist, codeReviewer, securityAuditor, refactorer, testingLead, logMonitor, researcher, codeAnalyzer, backendEngineer, contentCreator, databaseEngineer, devopsEngineer, frontendEngineer, frontendUiUxEngineer, growthStrategist, mobileDeveloper, performanceEngineer, seoConsultant, strategist, techWriter, multimodalLooker, };
@@ -285,6 +285,19 @@ export const AGENT_REGISTRY = {
285
285
  performance: 85,
286
286
  expertise: "technical documentation and writing",
287
287
  },
288
+ "multimodal-looker": {
289
+ name: "multimodal-looker",
290
+ description: "Visual content analysis for images, diagrams, PDFs, and screenshots",
291
+ capabilities: ["visual-analysis", "image-processing", "document-analysis", "multimodal-data-processing"],
292
+ capacity: 60,
293
+ specialties: ["image", "visual", "diagram", "screenshot", "pdf"],
294
+ mode: "subagent",
295
+ maxComplexity: 35,
296
+ concurrentTasks: 2,
297
+ status: "active",
298
+ performance: 80,
299
+ expertise: "multimodal content analysis and interpretation",
300
+ },
288
301
  };
289
302
  export function getActiveAgents() {
290
303
  return Object.values(AGENT_REGISTRY)
@@ -4,7 +4,6 @@
4
4
  * Manages user consent for analytics data submission with granular
5
5
  * control over what categories can be shared.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-06
9
8
  */
10
9
  import * as fs from "fs/promises";
@@ -4,7 +4,6 @@
4
4
  * Discovers new routing patterns from recent task requests,
5
5
  * identifies emergent behaviors, and suggests new pattern candidates.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-05
9
8
  */
10
9
  import { frameworkLogger } from "../core/framework-logger.js";
@@ -4,7 +4,6 @@
4
4
  * Learns from performance data, generates adaptive modifications,
5
5
  * and creates self-improving pattern definitions.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-05
9
8
  */
10
9
  import { frameworkLogger } from "../core/framework-logger.js";
@@ -4,7 +4,6 @@
4
4
  * Monitors pattern effectiveness over time, detects pattern drift,
5
5
  * and provides metrics for adaptive kernel modifications.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-05
9
8
  */
10
9
  import { frameworkLogger } from "../core/framework-logger.js";
@@ -4,7 +4,6 @@
4
4
  * Predicts the best agent to route a task to based on historical
5
5
  * success rates using simple keyword overlap scoring.
6
6
  *
7
- * @version 1.0.0
8
7
  */
9
8
  import { routingOutcomeTracker } from '../delegation/analytics/outcome-tracker.js';
10
9
  /**
@@ -4,7 +4,6 @@
4
4
  * Analyzes actual vs. template prompts to detect gaps and emerging patterns.
5
5
  * Integrates with RoutingOutcomeTracker to provide insights for template optimization.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-05
9
8
  */
10
9
  import { routingOutcomeTracker } from "../delegation/analytics/outcome-tracker.js";
@@ -4,7 +4,6 @@
4
4
  * Analyzes routing success rates, keyword effectiveness, and confidence thresholds.
5
5
  * Integrates with RoutingOutcomeTracker to provide comprehensive routing metrics.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-05
9
8
  */
10
9
  import { routingOutcomeTracker } from "../delegation/analytics/outcome-tracker.js";
@@ -4,7 +4,6 @@
4
4
  * Suggests new keyword mappings, optimizes existing mappings, and generates
5
5
  * configuration updates based on analytics data from the routing system.
6
6
  *
7
- * @version 1.0.0
8
7
  * @since 2026-03-05
9
8
  */
10
9
  import { promptPatternAnalyzer, } from "./prompt-pattern-analyzer.js";
@@ -36,7 +35,7 @@ class RoutingRefiner {
36
35
  const optimizations = this.suggestMappingOptimizations(promptAnalysis, performanceReport);
37
36
  const warnings = this.generateWarnings(newMappings, optimizations);
38
37
  return {
39
- version: "1.22.67",
38
+ version: "3.1.0",
40
39
  generatedAt: new Date(),
41
40
  summary: {
42
41
  newMappings: newMappings.length,
@@ -5,7 +5,6 @@
5
5
  *
6
6
  * This is the "learning" system - simple pattern matching, not ML.
7
7
  *
8
- * @version 1.0.0
9
8
  */
10
9
  import * as fs from "fs";
11
10
  import * as path from "path";
@@ -20,17 +20,17 @@ export async function verifyArchitecturalIntegrity() {
20
20
  const issues = [];
21
21
  const recommendations = [];
22
22
  // Check state manager
23
- const stateManager = globalThis.strRayStateManager;
23
+ const stateManager = globalThis.xrayStateManager;
24
24
  if (!stateManager) {
25
25
  issues.push("State manager not initialized");
26
26
  recommendations.push("Ensure boot orchestrator runs before framework activation");
27
27
  }
28
- const postProcessor = globalThis.strRayPostProcessor;
28
+ const postProcessor = globalThis.xrayPostProcessor;
29
29
  if (!postProcessor) {
30
30
  issues.push("Post-processor not activated");
31
31
  recommendations.push("Add post-processor activation to xray-activation.ts");
32
32
  }
33
- const codexInjector = globalThis.strRayCodexInjector;
33
+ const codexInjector = globalThis.xrayCodexInjector;
34
34
  if (!codexInjector) {
35
35
  issues.push("Codex injector not initialized");
36
36
  recommendations.push("Ensure codex injection is active in plugin context");
@@ -1,4 +1,4 @@
1
- // Consumer runtime compat shim from prior StringRay releases (1-line min per Scope Rule; primary xray paths + XRAY_||STRRAY_ env + .strray fallbacks)
1
+ // Consumer runtime compat shim from prior 0xRay releases (1-line min per Scope Rule; primary xray paths + .xray fallbacks)
2
2
  import { frameworkLogger } from "../core/framework-logger.js";
3
3
  import crypto from "crypto";
4
4
  export class XrayPerformanceBenchmark {
@@ -371,4 +371,3 @@ export class XrayPerformanceBenchmark {
371
371
  // Export singleton instance
372
372
  export const performanceBenchmark = new XrayPerformanceBenchmark();
373
373
  // Backward compat alias
374
- export { XrayPerformanceBenchmark as StringRayPerformanceBenchmark };