0xray 2.1.1 → 2.1.3

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 (254) hide show
  1. package/.opencode/codex.codex +1 -1
  2. package/.opencode/commands/dependency-audit.md +3 -3
  3. package/.opencode/enforcer-config.json +2 -2
  4. package/AGENTS.md +3 -2
  5. package/README.md +12 -11
  6. package/dist/AGENTS.md +3 -2
  7. package/dist/CHANGELOG.md +26 -0
  8. package/dist/README.md +12 -11
  9. package/dist/agents/code-reviewer.js +1 -1
  10. package/dist/analytics/routing-refiner.js +1 -1
  11. package/dist/cli/index.js +11 -1
  12. package/dist/cli/server.js +3 -3
  13. package/dist/core/activity-logger.d.ts +2 -2
  14. package/dist/core/activity-logger.js +4 -4
  15. package/dist/core/boot-orchestrator.d.ts +1 -1
  16. package/dist/core/boot-orchestrator.js +13 -28
  17. package/dist/core/bridge.mjs +3 -3
  18. package/dist/core/codex-formatter.js +2 -2
  19. package/dist/core/codex-injector.d.ts +0 -1
  20. package/dist/core/codex-injector.js +2 -3
  21. package/dist/core/config-loader.d.ts +1 -1
  22. package/dist/core/config-loader.js +1 -1
  23. package/dist/core/config-paths.d.ts +0 -2
  24. package/dist/core/config-paths.js +7 -8
  25. package/dist/core/context-loader.d.ts +1 -1
  26. package/dist/core/context-loader.js +1 -1
  27. package/dist/core/errors.d.ts +3 -0
  28. package/dist/core/errors.js +10 -0
  29. package/dist/core/features-config.js +1 -1
  30. package/dist/core/framework-logger.d.ts +3 -3
  31. package/dist/core/framework-logger.js +17 -9
  32. package/dist/core/index.d.ts +2 -2
  33. package/dist/core/index.js +4 -2
  34. package/dist/core/logging-config.d.ts +2 -1
  35. package/dist/core/logging-config.js +7 -7
  36. package/dist/enforcement/loaders/codex-loader.js +1 -1
  37. package/dist/execution/opencode-cli-invoker.js +5 -5
  38. package/dist/governance/governance-service.js +1 -1
  39. package/dist/index.d.ts +3 -3
  40. package/dist/index.js +3 -3
  41. package/dist/inference/inference-cycle.d.ts +1 -1
  42. package/dist/inference/inference-cycle.js +10 -10
  43. package/dist/integrations/base/Integration.js +1 -1
  44. package/dist/integrations/base/registry.js +19 -19
  45. package/dist/integrations/grok/grok-cli.js +17 -17
  46. package/dist/integrations/grok/hooks/pre-tool-use.js +1 -1
  47. package/dist/integrations/hermes-agent/bridge.mjs +1 -1
  48. package/dist/integrations/openclaw/api-server.d.ts +0 -1
  49. package/dist/integrations/openclaw/api-server.js +7 -10
  50. package/dist/integrations/openclaw/client.d.ts +0 -1
  51. package/dist/integrations/openclaw/client.js +22 -24
  52. package/dist/integrations/openclaw/hooks/xray-hooks.d.ts +0 -1
  53. package/dist/integrations/openclaw/hooks/xray-hooks.js +17 -18
  54. package/dist/integrations/plugins/plugin-registry.js +5 -5
  55. package/dist/mcps/architect-tools.server.d.ts +2 -4
  56. package/dist/mcps/architect-tools.server.js +112 -195
  57. package/dist/mcps/auto-format.server.d.ts +2 -4
  58. package/dist/mcps/auto-format.server.js +49 -95
  59. package/dist/mcps/boot-orchestrator.server.d.ts +2 -4
  60. package/dist/mcps/boot-orchestrator.server.js +73 -105
  61. package/dist/mcps/config/server-config-registry.js +3 -3
  62. package/dist/mcps/enforcer-tools.server.d.ts +2 -4
  63. package/dist/mcps/enforcer-tools.server.js +202 -285
  64. package/dist/mcps/estimation.server.d.ts +2 -4
  65. package/dist/mcps/estimation.server.js +63 -107
  66. package/dist/mcps/framework-compliance-audit.server.d.ts +2 -4
  67. package/dist/mcps/framework-compliance-audit.server.js +53 -82
  68. package/dist/mcps/framework-help.server.d.ts +2 -4
  69. package/dist/mcps/framework-help.server.js +63 -101
  70. package/dist/mcps/governance.server.js +2 -2
  71. package/dist/mcps/knowledge-skills/api-design.server.d.ts +2 -4
  72. package/dist/mcps/knowledge-skills/api-design.server.js +35 -67
  73. package/dist/mcps/knowledge-skills/architecture-patterns.server.d.ts +2 -10
  74. package/dist/mcps/knowledge-skills/architecture-patterns.server.js +35 -74
  75. package/dist/mcps/knowledge-skills/bug-triage-specialist.server.d.ts +2 -4
  76. package/dist/mcps/knowledge-skills/bug-triage-specialist.server.js +143 -162
  77. package/dist/mcps/knowledge-skills/code-analyzer.server.d.ts +3 -4
  78. package/dist/mcps/knowledge-skills/code-analyzer.server.js +20 -45
  79. package/dist/mcps/knowledge-skills/code-review.server.d.ts +2 -4
  80. package/dist/mcps/knowledge-skills/code-review.server.js +109 -143
  81. package/dist/mcps/knowledge-skills/content-creator.server.d.ts +2 -4
  82. package/dist/mcps/knowledge-skills/content-creator.server.js +205 -226
  83. package/dist/mcps/knowledge-skills/database-design.server.d.ts +2 -4
  84. package/dist/mcps/knowledge-skills/database-design.server.js +117 -151
  85. package/dist/mcps/knowledge-skills/devops-deployment.server.d.ts +2 -4
  86. package/dist/mcps/knowledge-skills/devops-deployment.server.js +71 -160
  87. package/dist/mcps/knowledge-skills/git-workflow.server.d.ts +2 -4
  88. package/dist/mcps/knowledge-skills/git-workflow.server.js +36 -68
  89. package/dist/mcps/knowledge-skills/growth-strategist.server.d.ts +2 -4
  90. package/dist/mcps/knowledge-skills/growth-strategist.server.js +303 -324
  91. package/dist/mcps/knowledge-skills/log-monitor.server.d.ts +2 -4
  92. package/dist/mcps/knowledge-skills/log-monitor.server.js +141 -160
  93. package/dist/mcps/knowledge-skills/mobile-development.server.d.ts +2 -4
  94. package/dist/mcps/knowledge-skills/mobile-development.server.js +92 -209
  95. package/dist/mcps/knowledge-skills/multimodal-looker.server.d.ts +2 -4
  96. package/dist/mcps/knowledge-skills/multimodal-looker.server.js +123 -159
  97. package/dist/mcps/knowledge-skills/performance-optimization.server.d.ts +2 -5
  98. package/dist/mcps/knowledge-skills/performance-optimization.server.js +155 -296
  99. package/dist/mcps/knowledge-skills/project-analysis.server.d.ts +2 -4
  100. package/dist/mcps/knowledge-skills/project-analysis.server.js +75 -226
  101. package/dist/mcps/knowledge-skills/refactoring-strategies.server.d.ts +2 -4
  102. package/dist/mcps/knowledge-skills/refactoring-strategies.server.js +63 -156
  103. package/dist/mcps/knowledge-skills/security-audit.server.d.ts +2 -4
  104. package/dist/mcps/knowledge-skills/security-audit.server.js +102 -136
  105. package/dist/mcps/knowledge-skills/seo-consultant.server.d.ts +2 -4
  106. package/dist/mcps/knowledge-skills/seo-consultant.server.js +80 -203
  107. package/dist/mcps/knowledge-skills/session-management.server.d.ts +2 -4
  108. package/dist/mcps/knowledge-skills/session-management.server.js +50 -203
  109. package/dist/mcps/knowledge-skills/skill-invocation.server.d.ts +2 -4
  110. package/dist/mcps/knowledge-skills/skill-invocation.server.js +168 -347
  111. package/dist/mcps/knowledge-skills/strategist.server.d.ts +2 -11
  112. package/dist/mcps/knowledge-skills/strategist.server.js +72 -122
  113. package/dist/mcps/knowledge-skills/tech-writer.server.d.ts +2 -4
  114. package/dist/mcps/knowledge-skills/tech-writer.server.js +87 -300
  115. package/dist/mcps/knowledge-skills/testing-best-practices.server.d.ts +2 -4
  116. package/dist/mcps/knowledge-skills/testing-best-practices.server.js +147 -182
  117. package/dist/mcps/knowledge-skills/testing-strategy.server.d.ts +2 -4
  118. package/dist/mcps/knowledge-skills/testing-strategy.server.js +78 -153
  119. package/dist/mcps/knowledge-skills/ui-ux-design.server.d.ts +2 -5
  120. package/dist/mcps/knowledge-skills/ui-ux-design.server.js +90 -399
  121. package/dist/mcps/lint.server.d.ts +2 -4
  122. package/dist/mcps/lint.server.js +51 -92
  123. package/dist/mcps/mcp-client.js +2 -2
  124. package/dist/mcps/model-health-check.server.d.ts +2 -4
  125. package/dist/mcps/model-health-check.server.js +32 -60
  126. package/dist/mcps/performance-analysis.server.d.ts +2 -4
  127. package/dist/mcps/performance-analysis.server.js +57 -88
  128. package/dist/mcps/processor-pipeline.server.d.ts +2 -4
  129. package/dist/mcps/processor-pipeline.server.js +69 -100
  130. package/dist/mcps/registry.json +1 -1
  131. package/dist/mcps/researcher.server.d.ts +3 -5
  132. package/dist/mcps/researcher.server.js +81 -154
  133. package/dist/mcps/security-scan.server.d.ts +2 -4
  134. package/dist/mcps/security-scan.server.js +54 -96
  135. package/dist/mcps/shared/knowledge-skill-base.d.ts +14 -0
  136. package/dist/mcps/shared/knowledge-skill-base.js +45 -0
  137. package/dist/{security → mcps/shared}/security-scanner.js +1 -1
  138. package/dist/mcps/state-manager.server.d.ts +2 -4
  139. package/dist/mcps/state-manager.server.js +115 -160
  140. package/dist/orchestrator/orchestrator.d.ts +1 -1
  141. package/dist/orchestrator/orchestrator.js +1 -1
  142. package/dist/orchestrator/universal-registry-bridge.js +1 -1
  143. package/dist/plugin/xray-codex-injection.d.ts +1 -1
  144. package/dist/plugin/xray-codex-injection.js +1 -1
  145. package/dist/postprocessor/PostProcessor.d.ts +4 -44
  146. package/dist/postprocessor/PostProcessor.js +39 -553
  147. package/dist/postprocessor/analysis/CodeChangeAnalyzer.d.ts +11 -0
  148. package/dist/postprocessor/analysis/CodeChangeAnalyzer.js +50 -0
  149. package/dist/postprocessor/compliance/ArchitecturalComplianceChecker.d.ts +11 -0
  150. package/dist/postprocessor/compliance/ArchitecturalComplianceChecker.js +356 -0
  151. package/dist/postprocessor/config/ProcessorConfigLoader.d.ts +44 -0
  152. package/dist/postprocessor/config/ProcessorConfigLoader.js +21 -0
  153. package/dist/postprocessor/reporting/PostProcessorReporter.d.ts +19 -0
  154. package/dist/postprocessor/reporting/PostProcessorReporter.js +96 -0
  155. package/dist/postprocessor/triggers/GitHookTrigger.js +11 -11
  156. package/dist/processors/implementations/refactoring-logging-processor-wrapper.d.ts +32 -0
  157. package/dist/processors/implementations/refactoring-logging-processor-wrapper.js +95 -1
  158. package/dist/processors/processor-manager.js +346 -314
  159. package/dist/reporting/report-formatter.js +1 -1
  160. package/dist/security/security-hardener.d.ts +69 -2
  161. package/dist/security/security-hardener.js +129 -1
  162. package/dist/skills/registry.json +1 -1
  163. package/dist/state/index.d.ts +3 -5
  164. package/dist/state/index.js +1 -7
  165. package/dist/state/state-manager.d.ts +1 -1
  166. package/dist/state/state-manager.js +2 -3
  167. package/package.json +14 -10
  168. package/scripts/node/setup.cjs +32 -0
  169. package/scripts/node/universal-version-manager.js +11 -11
  170. package/src/mcps/architect-tools.server.ts +112 -215
  171. package/src/mcps/auto-format.server.ts +50 -110
  172. package/src/mcps/boot-orchestrator.server.ts +75 -121
  173. package/src/mcps/config/__tests__/server-config-registry.test.ts +21 -12
  174. package/src/mcps/config/server-config-registry.ts +3 -3
  175. package/src/mcps/enforcer-tools.server.ts +212 -310
  176. package/src/mcps/estimation.server.ts +62 -122
  177. package/src/mcps/framework-compliance-audit.server.ts +52 -97
  178. package/src/mcps/framework-help.server.ts +64 -114
  179. package/src/mcps/governance.server.ts +2 -2
  180. package/src/mcps/knowledge-skills/api-design.server.ts +32 -77
  181. package/src/mcps/knowledge-skills/architecture-patterns.server.ts +31 -87
  182. package/src/mcps/knowledge-skills/bug-triage-specialist.server.ts +165 -193
  183. package/src/mcps/knowledge-skills/code-analyzer.server.ts +20 -55
  184. package/src/mcps/knowledge-skills/code-review.server.ts +114 -161
  185. package/src/mcps/knowledge-skills/content-creator.server.ts +218 -255
  186. package/src/mcps/knowledge-skills/database-design.server.ts +118 -165
  187. package/src/mcps/knowledge-skills/devops-deployment.server.ts +67 -172
  188. package/src/mcps/knowledge-skills/git-workflow.server.ts +32 -77
  189. package/src/mcps/knowledge-skills/growth-strategist.server.ts +324 -361
  190. package/src/mcps/knowledge-skills/log-monitor.server.ts +160 -187
  191. package/src/mcps/knowledge-skills/mobile-development.server.ts +89 -223
  192. package/src/mcps/knowledge-skills/multimodal-looker.server.ts +128 -175
  193. package/src/mcps/knowledge-skills/performance-optimization.server.ts +156 -329
  194. package/src/mcps/knowledge-skills/project-analysis.server.ts +72 -248
  195. package/src/mcps/knowledge-skills/refactoring-strategies.server.ts +59 -171
  196. package/src/mcps/knowledge-skills/security-audit.server.ts +104 -151
  197. package/src/mcps/knowledge-skills/seo-consultant.server.ts +80 -220
  198. package/src/mcps/knowledge-skills/session-management.server.ts +51 -232
  199. package/src/mcps/knowledge-skills/skill-invocation.server.ts +165 -372
  200. package/src/mcps/knowledge-skills/strategist.server.ts +72 -143
  201. package/src/mcps/knowledge-skills/tech-writer.server.ts +85 -350
  202. package/src/mcps/knowledge-skills/testing-best-practices.server.ts +146 -195
  203. package/src/mcps/knowledge-skills/testing-strategy.server.ts +75 -161
  204. package/src/mcps/knowledge-skills/ui-ux-design.server.ts +93 -487
  205. package/src/mcps/lint.server.ts +53 -107
  206. package/src/mcps/mcp-client.ts +2 -2
  207. package/src/mcps/model-health-check.server.ts +34 -71
  208. package/src/mcps/performance-analysis.server.ts +60 -104
  209. package/src/mcps/processor-pipeline.server.ts +72 -110
  210. package/src/mcps/registry.json +1 -1
  211. package/src/mcps/researcher.server.ts +88 -177
  212. package/src/mcps/security-scan.server.ts +55 -104
  213. package/src/mcps/shared/knowledge-skill-base.ts +62 -0
  214. package/src/mcps/shared/prompt-security-validator.ts +199 -0
  215. package/src/mcps/shared/security-scanner.ts +599 -0
  216. package/src/mcps/state-manager.server.ts +117 -175
  217. package/src/opencode/codex.codex +1 -1
  218. package/src/opencode/commands/dependency-audit.md +3 -3
  219. package/src/opencode/enforcer-config.json +2 -2
  220. package/src/skills/registry.json +1 -1
  221. package/xray/agents_template.md +109 -0
  222. package/xray/codex.json +598 -0
  223. package/xray/config.json +26 -0
  224. package/xray/features.json +132 -0
  225. package/xray/integrations.json +23 -0
  226. package/xray/routing-mappings.json +752 -0
  227. package/xray/workflow_state.json +28 -0
  228. package/dist/integrations/hermes-agent/__pycache__/__init__.cpython-313.pyc +0 -0
  229. package/dist/integrations/hermes-agent/__pycache__/conftest.cpython-313-pytest-9.0.2.pyc +0 -0
  230. package/dist/integrations/hermes-agent/__pycache__/schemas.cpython-313.pyc +0 -0
  231. package/dist/integrations/hermes-agent/__pycache__/test_plugin.cpython-313-pytest-9.0.2.pyc +0 -0
  232. package/dist/integrations/hermes-agent/__pycache__/test_plugin.cpython-313.pyc +0 -0
  233. package/dist/integrations/hermes-agent/__pycache__/tools.cpython-313.pyc +0 -0
  234. package/dist/integrations/hermes-agent/conftest.py +0 -14
  235. package/dist/integrations/hermes-agent/test_plugin.py +0 -1103
  236. package/dist/processors/implementations/refactoring-logging-processor.d.ts +0 -31
  237. package/dist/processors/implementations/refactoring-logging-processor.js +0 -96
  238. package/dist/processors/implementations/session-capture-processor.d.ts +0 -14
  239. package/dist/processors/implementations/session-capture-processor.js +0 -37
  240. package/dist/scripts/activate-kernel-pipeline.d.ts +0 -7
  241. package/dist/scripts/activate-kernel-pipeline.js +0 -101
  242. package/dist/security/index.d.ts +0 -13
  243. package/dist/security/index.js +0 -13
  244. package/dist/security/security-agent-coordinator.d.ts +0 -72
  245. package/dist/security/security-agent-coordinator.js +0 -204
  246. package/dist/security/security-auditor.d.ts +0 -56
  247. package/dist/security/security-auditor.js +0 -584
  248. package/dist/security/security-hardening-system.d.ts +0 -239
  249. package/dist/security/security-hardening-system.js +0 -727
  250. package/dist/security/security-orchestration-layer.d.ts +0 -119
  251. package/dist/security/security-orchestration-layer.js +0 -496
  252. /package/dist/{security → mcps/shared}/prompt-security-validator.d.ts +0 -0
  253. /package/dist/{security → mcps/shared}/prompt-security-validator.js +0 -0
  254. /package/dist/{security → mcps/shared}/security-scanner.d.ts +0 -0
@@ -9,9 +9,9 @@
9
9
  * This is the SINGLE source for code-level analysis.
10
10
  * Use project-analysis for project-level (structure, health).
11
11
  */
12
- declare class CodeAnalyzerServer {
13
- private server;
14
- private tools;
12
+ import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
13
+ declare class CodeAnalyzerServer extends XrayKnowledgeSkillBase {
14
+ private toolDefinitions;
15
15
  constructor();
16
16
  private handleAnalyzeCode;
17
17
  private calculateCodeMetrics;
@@ -26,6 +26,5 @@ declare class CodeAnalyzerServer {
26
26
  private handleGetFileStructure;
27
27
  private handleAnalyzeDependencies;
28
28
  private handleFindDuplicates;
29
- run(): Promise<void>;
30
29
  }
31
30
  export default CodeAnalyzerServer;
@@ -9,15 +9,12 @@
9
9
  * This is the SINGLE source for code-level analysis.
10
10
  * Use project-analysis for project-level (structure, health).
11
11
  */
12
- import { Server } from "@modelcontextprotocol/sdk/server/index.js";
13
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
14
- import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
12
+ import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
13
+ import { frameworkLogger } from "../../core/framework-logger.js";
15
14
  import * as fs from "fs";
16
15
  import * as path from "path";
17
- import { createGracefulShutdown } from "../../utils/shutdown-handler.js";
18
- class CodeAnalyzerServer {
19
- server;
20
- tools = [
16
+ class CodeAnalyzerServer extends XrayKnowledgeSkillBase {
17
+ toolDefinitions = [
21
18
  // ===== CODE ANALYSIS =====
22
19
  {
23
20
  name: "analyze_code",
@@ -242,34 +239,21 @@ class CodeAnalyzerServer {
242
239
  },
243
240
  ];
244
241
  constructor() {
245
- this.server = new Server({ name: "code-analyzer", version: "2.0.1" }, { capabilities: { tools: {} } });
246
- this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
247
- tools: this.tools,
248
- }));
249
- this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
250
- const { name, arguments: args = {} } = request.params;
251
- try {
252
- switch (name) {
253
- case "analyze_code": return this.handleAnalyzeCode(args);
254
- case "calculate_complexity": return this.handleCalculateComplexity(args);
255
- case "detect_code_smells": return this.handleDetectCodeSmells(args);
256
- case "extract_metrics": return this.handleExtractMetrics(args);
257
- case "explore_codebase": return this.handleExploreCodebase(args);
258
- case "find_patterns": return this.handleFindPatterns(args);
259
- case "find_function": return this.handleFindFunction(args);
260
- case "get_file_structure": return this.handleGetFileStructure(args);
261
- case "analyze_dependencies": return this.handleAnalyzeDependencies(args);
262
- case "find_duplicates": return this.handleFindDuplicates(args);
263
- default: throw new Error(`Unknown tool: ${name}`);
264
- }
265
- }
266
- catch (error) {
267
- return {
268
- content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
269
- isError: true,
270
- };
271
- }
272
- });
242
+ super("code-analyzer", "2.0.1");
243
+ this.tools = this.toolDefinitions;
244
+ this.handlers = {
245
+ "analyze_code": async (args) => this.handleAnalyzeCode(args),
246
+ "calculate_complexity": async (args) => this.handleCalculateComplexity(args),
247
+ "detect_code_smells": async (args) => this.handleDetectCodeSmells(args),
248
+ "extract_metrics": async (args) => this.handleExtractMetrics(args),
249
+ "explore_codebase": async (args) => this.handleExploreCodebase(args),
250
+ "find_patterns": async (args) => this.handleFindPatterns(args),
251
+ "find_function": async (args) => this.handleFindFunction(args),
252
+ "get_file_structure": async (args) => this.handleGetFileStructure(args),
253
+ "analyze_dependencies": async (args) => this.handleAnalyzeDependencies(args),
254
+ "find_duplicates": async (args) => this.handleFindDuplicates(args),
255
+ };
256
+ this.setupToolHandlers();
273
257
  }
274
258
  handleAnalyzeCode(args) {
275
259
  const { files = [], language = "typescript" } = args;
@@ -589,17 +573,8 @@ class CodeAnalyzerServer {
589
573
  const duplicates = [...blocks.entries()].filter(([_, f]) => f.length > 1).map(([block, files]) => ({ block: block.substring(0, 100) + "...", files, length: block.split("\n").length }));
590
574
  return { content: [{ type: "text", text: JSON.stringify({ totalDuplicates: duplicates.length, duplicates }, null, 2) }] };
591
575
  }
592
- async run() {
593
- const transport = new StdioServerTransport();
594
- await this.server.connect(transport);
595
- // Use centralized shutdown handler
596
- createGracefulShutdown({
597
- serverName: "code-analyzer.server",
598
- server: this.server,
599
- });
600
- }
601
576
  }
602
577
  if (import.meta.url === `file://${process.argv[1]}`) {
603
- new CodeAnalyzerServer().run().catch(() => { });
578
+ new CodeAnalyzerServer().run("code-analyzer.server").catch((err) => { frameworkLogger.log("code-analyzer", "run", "error", { error: err instanceof Error ? err.message : String(err) }); });
604
579
  }
605
580
  export default CodeAnalyzerServer;
@@ -4,16 +4,15 @@
4
4
  * Knowledge skill for automated code review, quality assessment,
5
5
  * and best practices validation - provides comprehensive code quality analysis
6
6
  */
7
+ import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
7
8
  interface AnalyzeProposalArgs {
8
9
  proposalTitle?: string;
9
10
  proposalDescription?: string;
10
11
  evidence?: string[];
11
12
  proposalType?: string;
12
13
  }
13
- declare class XrayCodeReviewServer {
14
- private server;
14
+ declare class XrayCodeReviewServer extends XrayKnowledgeSkillBase {
15
15
  constructor();
16
- private setupToolHandlers;
17
16
  private analyzeCodeQuality;
18
17
  private reviewPullRequest;
19
18
  private checkBestPractices;
@@ -41,6 +40,5 @@ declare class XrayCodeReviewServer {
41
40
  private checkStandardsCompliance;
42
41
  private generateStandardsRecommendations;
43
42
  private calculateComplianceScore;
44
- run(): Promise<void>;
45
43
  }
46
44
  export { XrayCodeReviewServer };
@@ -4,151 +4,126 @@
4
4
  * Knowledge skill for automated code review, quality assessment,
5
5
  * and best practices validation - provides comprehensive code quality analysis
6
6
  */
7
- import { Server } from "@modelcontextprotocol/sdk/server/index.js";
8
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
9
- import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
7
+ import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
8
+ import { frameworkLogger } from "../../core/framework-logger.js";
10
9
  import * as fs from "fs";
11
10
  import * as path from "path";
12
- import { createGracefulShutdown } from "../../utils/shutdown-handler.js";
13
- class XrayCodeReviewServer {
14
- server;
11
+ class XrayCodeReviewServer extends XrayKnowledgeSkillBase {
15
12
  constructor() {
16
- this.server = new Server({
17
- name: "code-review", version: "2.0.1",
18
- }, {
19
- capabilities: {
20
- tools: {},
21
- },
22
- });
23
- this.setupToolHandlers();
24
- // Server initialization - removed unnecessary startup logging
25
- }
26
- setupToolHandlers() {
27
- this.server.setRequestHandler(ListToolsRequestSchema, async () => {
28
- return {
29
- tools: [
30
- {
31
- name: "analyze_code_quality",
32
- description: "Analyze code quality metrics, identify issues, and provide improvement suggestions",
33
- inputSchema: {
34
- type: "object",
35
- properties: {
36
- filePath: {
37
- type: "string",
38
- description: "Path to the file to analyze",
39
- },
40
- includeMetrics: {
41
- type: "boolean",
42
- description: "Include detailed code metrics in the analysis",
43
- default: true,
44
- },
45
- focusAreas: {
46
- type: "array",
47
- items: {
48
- type: "string",
49
- enum: [
50
- "security",
51
- "performance",
52
- "maintainability",
53
- "style",
54
- "logic",
55
- ],
56
- },
57
- description: "Specific areas to focus the review on",
58
- },
59
- },
60
- required: ["filePath"],
13
+ super("code-review", "2.0.1");
14
+ this.tools = [
15
+ {
16
+ name: "analyze_code_quality",
17
+ description: "Analyze code quality metrics, identify issues, and provide improvement suggestions",
18
+ inputSchema: {
19
+ type: "object",
20
+ properties: {
21
+ filePath: {
22
+ type: "string",
23
+ description: "Path to the file to analyze",
61
24
  },
62
- },
63
- {
64
- name: "review_pull_request",
65
- description: "Review a pull request by analyzing changed files and providing comprehensive feedback",
66
- inputSchema: {
67
- type: "object",
68
- properties: {
69
- files: {
70
- type: "array",
71
- items: { type: "string" },
72
- description: "List of file paths to review",
73
- },
74
- baseBranch: {
75
- type: "string",
76
- description: "Base branch for comparison",
77
- default: "main",
78
- },
79
- focusAreas: {
80
- type: "array",
81
- items: {
82
- type: "string",
83
- enum: [
84
- "security",
85
- "performance",
86
- "maintainability",
87
- "style",
88
- "logic",
89
- ],
90
- },
91
- description: "Specific areas to focus the review on",
92
- },
25
+ includeMetrics: {
26
+ type: "boolean",
27
+ description: "Include detailed code metrics in the analysis",
28
+ default: true,
29
+ },
30
+ focusAreas: {
31
+ type: "array",
32
+ items: {
33
+ type: "string",
34
+ enum: [
35
+ "security",
36
+ "performance",
37
+ "maintainability",
38
+ "style",
39
+ "logic",
40
+ ],
93
41
  },
94
- required: ["files"],
42
+ description: "Specific areas to focus the review on",
95
43
  },
96
44
  },
97
- {
98
- name: "check_best_practices",
99
- description: "Check adherence to coding best practices and standards",
100
- inputSchema: {
101
- type: "object",
102
- properties: {
103
- filePath: {
104
- type: "string",
105
- description: "Path to the file to check",
106
- },
107
- language: {
108
- type: "string",
109
- description: "Programming language (typescript, javascript, python, etc.)",
110
- },
111
- standards: {
112
- type: "array",
113
- items: { type: "string" },
114
- description: "Specific standards to check (airbnb, google, microsoft, etc.)",
115
- },
45
+ required: ["filePath"],
46
+ },
47
+ },
48
+ {
49
+ name: "review_pull_request",
50
+ description: "Review a pull request by analyzing changed files and providing comprehensive feedback",
51
+ inputSchema: {
52
+ type: "object",
53
+ properties: {
54
+ files: {
55
+ type: "array",
56
+ items: { type: "string" },
57
+ description: "List of file paths to review",
58
+ },
59
+ baseBranch: {
60
+ type: "string",
61
+ description: "Base branch for comparison",
62
+ default: "main",
63
+ },
64
+ focusAreas: {
65
+ type: "array",
66
+ items: {
67
+ type: "string",
68
+ enum: [
69
+ "security",
70
+ "performance",
71
+ "maintainability",
72
+ "style",
73
+ "logic",
74
+ ],
116
75
  },
117
- required: ["filePath"],
76
+ description: "Specific areas to focus the review on",
118
77
  },
119
78
  },
120
- {
121
- name: "analyze_proposal",
122
- description: "Analyze an inference proposal (pattern/bug/refactor) from a code-review perspective and return a structured governance decision",
123
- inputSchema: {
124
- type: "object",
125
- properties: {
126
- proposalTitle: { type: "string" },
127
- proposalDescription: { type: "string" },
128
- evidence: { type: "array", items: { type: "string" } },
129
- proposalType: { type: "string" },
130
- },
131
- required: ["proposalTitle", "proposalDescription"],
79
+ required: ["files"],
80
+ },
81
+ },
82
+ {
83
+ name: "check_best_practices",
84
+ description: "Check adherence to coding best practices and standards",
85
+ inputSchema: {
86
+ type: "object",
87
+ properties: {
88
+ filePath: {
89
+ type: "string",
90
+ description: "Path to the file to check",
91
+ },
92
+ language: {
93
+ type: "string",
94
+ description: "Programming language (typescript, javascript, python, etc.)",
95
+ },
96
+ standards: {
97
+ type: "array",
98
+ items: { type: "string" },
99
+ description: "Specific standards to check (airbnb, google, microsoft, etc.)",
132
100
  },
133
101
  },
134
- ],
135
- };
136
- });
137
- this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
138
- const { name, arguments: args } = request.params;
139
- switch (name) {
140
- case "analyze_code_quality":
141
- return await this.analyzeCodeQuality(args);
142
- case "review_pull_request":
143
- return await this.reviewPullRequest(args);
144
- case "check_best_practices":
145
- return await this.checkBestPractices(args);
146
- case "analyze_proposal":
147
- return await this.analyzeProposal(args);
148
- default:
149
- throw new Error(`Unknown tool: ${name}`);
150
- }
151
- });
102
+ required: ["filePath"],
103
+ },
104
+ },
105
+ {
106
+ name: "analyze_proposal",
107
+ description: "Analyze an inference proposal (pattern/bug/refactor) from a code-review perspective and return a structured governance decision",
108
+ inputSchema: {
109
+ type: "object",
110
+ properties: {
111
+ proposalTitle: { type: "string" },
112
+ proposalDescription: { type: "string" },
113
+ evidence: { type: "array", items: { type: "string" } },
114
+ proposalType: { type: "string" },
115
+ },
116
+ required: ["proposalTitle", "proposalDescription"],
117
+ },
118
+ },
119
+ ];
120
+ this.handlers = {
121
+ "analyze_code_quality": async (args) => this.analyzeCodeQuality(args),
122
+ "review_pull_request": async (args) => this.reviewPullRequest(args),
123
+ "check_best_practices": async (args) => this.checkBestPractices(args),
124
+ "analyze_proposal": async (args) => this.analyzeProposal(args),
125
+ };
126
+ this.setupToolHandlers();
152
127
  }
153
128
  async analyzeCodeQuality(args) {
154
129
  const { filePath, includeMetrics = true, focusAreas } = args;
@@ -829,19 +804,10 @@ class XrayCodeReviewServer {
829
804
  }, 0);
830
805
  return Math.max(0, baseScore - deductions);
831
806
  }
832
- async run() {
833
- const transport = new StdioServerTransport();
834
- await this.server.connect(transport);
835
- // Use centralized shutdown handler
836
- createGracefulShutdown({
837
- serverName: "code-review.server",
838
- server: this.server,
839
- });
840
- }
841
807
  }
842
808
  // Run the server if this file is executed directly
843
809
  if (import.meta.url === `file://${process.argv[1]}`) {
844
810
  const server = new XrayCodeReviewServer();
845
- server.run().catch(() => { });
811
+ server.run("code-review").catch((err) => { frameworkLogger.log("code-review", "run", "error", { error: err instanceof Error ? err.message : String(err) }); });
846
812
  }
847
813
  export { XrayCodeReviewServer };
@@ -4,10 +4,8 @@
4
4
  * Content-focused SEO for both human readers and AI search engines.
5
5
  * Provides keyword optimization, meta descriptions, headlines, and conversion copy.
6
6
  */
7
- declare class SEOCopywriterServer {
8
- private server;
9
- private tools;
7
+ import { XrayKnowledgeSkillBase } from "../shared/knowledge-skill-base.js";
8
+ declare class SEOCopywriterServer extends XrayKnowledgeSkillBase {
10
9
  constructor();
11
- run(): Promise<void>;
12
10
  }
13
11
  export { SEOCopywriterServer };