0xray 2.1.2 → 2.1.4

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 (250) 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 +2 -1
  5. package/README.md +12 -11
  6. package/dist/AGENTS.md +2 -1
  7. package/dist/CHANGELOG.md +38 -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 +13 -10
  168. package/scripts/node/universal-version-manager.js +11 -11
  169. package/src/mcps/architect-tools.server.ts +112 -215
  170. package/src/mcps/auto-format.server.ts +50 -110
  171. package/src/mcps/boot-orchestrator.server.ts +75 -121
  172. package/src/mcps/config/__tests__/server-config-registry.test.ts +21 -12
  173. package/src/mcps/config/server-config-registry.ts +3 -3
  174. package/src/mcps/enforcer-tools.server.ts +212 -310
  175. package/src/mcps/estimation.server.ts +62 -122
  176. package/src/mcps/framework-compliance-audit.server.ts +52 -97
  177. package/src/mcps/framework-help.server.ts +64 -114
  178. package/src/mcps/governance.server.ts +2 -2
  179. package/src/mcps/knowledge-skills/api-design.server.ts +32 -77
  180. package/src/mcps/knowledge-skills/architecture-patterns.server.ts +31 -87
  181. package/src/mcps/knowledge-skills/bug-triage-specialist.server.ts +165 -193
  182. package/src/mcps/knowledge-skills/code-analyzer.server.ts +20 -55
  183. package/src/mcps/knowledge-skills/code-review.server.ts +114 -161
  184. package/src/mcps/knowledge-skills/content-creator.server.ts +218 -255
  185. package/src/mcps/knowledge-skills/database-design.server.ts +118 -165
  186. package/src/mcps/knowledge-skills/devops-deployment.server.ts +67 -172
  187. package/src/mcps/knowledge-skills/git-workflow.server.ts +32 -77
  188. package/src/mcps/knowledge-skills/growth-strategist.server.ts +324 -361
  189. package/src/mcps/knowledge-skills/log-monitor.server.ts +160 -187
  190. package/src/mcps/knowledge-skills/mobile-development.server.ts +89 -223
  191. package/src/mcps/knowledge-skills/multimodal-looker.server.ts +128 -175
  192. package/src/mcps/knowledge-skills/performance-optimization.server.ts +156 -329
  193. package/src/mcps/knowledge-skills/project-analysis.server.ts +72 -248
  194. package/src/mcps/knowledge-skills/refactoring-strategies.server.ts +59 -171
  195. package/src/mcps/knowledge-skills/security-audit.server.ts +104 -151
  196. package/src/mcps/knowledge-skills/seo-consultant.server.ts +80 -220
  197. package/src/mcps/knowledge-skills/session-management.server.ts +51 -232
  198. package/src/mcps/knowledge-skills/skill-invocation.server.ts +165 -372
  199. package/src/mcps/knowledge-skills/strategist.server.ts +72 -143
  200. package/src/mcps/knowledge-skills/tech-writer.server.ts +85 -350
  201. package/src/mcps/knowledge-skills/testing-best-practices.server.ts +146 -195
  202. package/src/mcps/knowledge-skills/testing-strategy.server.ts +75 -161
  203. package/src/mcps/knowledge-skills/ui-ux-design.server.ts +93 -487
  204. package/src/mcps/lint.server.ts +53 -107
  205. package/src/mcps/mcp-client.ts +2 -2
  206. package/src/mcps/model-health-check.server.ts +34 -71
  207. package/src/mcps/performance-analysis.server.ts +60 -104
  208. package/src/mcps/processor-pipeline.server.ts +72 -110
  209. package/src/mcps/registry.json +1 -1
  210. package/src/mcps/researcher.server.ts +88 -177
  211. package/src/mcps/security-scan.server.ts +55 -104
  212. package/src/mcps/shared/knowledge-skill-base.ts +62 -0
  213. package/src/mcps/shared/prompt-security-validator.ts +199 -0
  214. package/src/mcps/shared/security-scanner.ts +599 -0
  215. package/src/mcps/state-manager.server.ts +117 -175
  216. package/src/opencode/codex.codex +1 -1
  217. package/src/opencode/commands/dependency-audit.md +3 -3
  218. package/src/opencode/enforcer-config.json +2 -2
  219. package/src/skills/registry.json +1 -1
  220. package/xray/codex.json +1 -1
  221. package/xray/config.json +1 -1
  222. package/xray/features.json +1 -1
  223. package/xray/integrations.json +3 -3
  224. package/dist/integrations/hermes-agent/__pycache__/__init__.cpython-313.pyc +0 -0
  225. package/dist/integrations/hermes-agent/__pycache__/conftest.cpython-313-pytest-9.0.2.pyc +0 -0
  226. package/dist/integrations/hermes-agent/__pycache__/schemas.cpython-313.pyc +0 -0
  227. package/dist/integrations/hermes-agent/__pycache__/test_plugin.cpython-313-pytest-9.0.2.pyc +0 -0
  228. package/dist/integrations/hermes-agent/__pycache__/test_plugin.cpython-313.pyc +0 -0
  229. package/dist/integrations/hermes-agent/__pycache__/tools.cpython-313.pyc +0 -0
  230. package/dist/integrations/hermes-agent/conftest.py +0 -14
  231. package/dist/integrations/hermes-agent/test_plugin.py +0 -1103
  232. package/dist/processors/implementations/refactoring-logging-processor.d.ts +0 -31
  233. package/dist/processors/implementations/refactoring-logging-processor.js +0 -96
  234. package/dist/processors/implementations/session-capture-processor.d.ts +0 -14
  235. package/dist/processors/implementations/session-capture-processor.js +0 -37
  236. package/dist/scripts/activate-kernel-pipeline.d.ts +0 -7
  237. package/dist/scripts/activate-kernel-pipeline.js +0 -101
  238. package/dist/security/index.d.ts +0 -13
  239. package/dist/security/index.js +0 -13
  240. package/dist/security/security-agent-coordinator.d.ts +0 -72
  241. package/dist/security/security-agent-coordinator.js +0 -204
  242. package/dist/security/security-auditor.d.ts +0 -56
  243. package/dist/security/security-auditor.js +0 -584
  244. package/dist/security/security-hardening-system.d.ts +0 -239
  245. package/dist/security/security-hardening-system.js +0 -727
  246. package/dist/security/security-orchestration-layer.d.ts +0 -119
  247. package/dist/security/security-orchestration-layer.js +0 -496
  248. /package/dist/{security → mcps/shared}/prompt-security-validator.d.ts +0 -0
  249. /package/dist/{security → mcps/shared}/prompt-security-validator.js +0 -0
  250. /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 };