blockmine 1.24.0 → 1.27.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 (476) hide show
  1. package/CHANGELOG.md +76 -1
  2. package/README.en.md +427 -0
  3. package/README.md +40 -0
  4. package/backend/package.json +2 -2
  5. package/backend/prisma/migrations/20260328173000_add_plugin_source_ref/migration.sql +2 -0
  6. package/backend/prisma/migrations/migration_lock.toml +2 -2
  7. package/backend/prisma/schema.prisma +2 -0
  8. package/backend/src/ai/plugin-assistant-system-prompt.md +664 -5
  9. package/backend/src/api/routes/apiKeys.js +8 -0
  10. package/backend/src/api/routes/bots.js +271 -9
  11. package/backend/src/api/routes/eventGraphs.js +151 -1
  12. package/backend/src/api/routes/health.js +38 -0
  13. package/backend/src/api/routes/nodeRegistry.js +63 -0
  14. package/backend/src/api/routes/plugins.js +254 -29
  15. package/backend/src/api/routes/servers.js +14 -2
  16. package/backend/src/container.js +11 -8
  17. package/backend/src/core/BotCommandLoader.js +161 -0
  18. package/backend/src/core/BotConnection.js +125 -0
  19. package/backend/src/core/BotEventHandlers.js +234 -0
  20. package/backend/src/core/BotIPCHandler.js +445 -0
  21. package/backend/src/core/BotManager.js +15 -7
  22. package/backend/src/core/BotProcess.js +169 -140
  23. package/backend/src/core/EventGraphManager.js +7 -3
  24. package/backend/src/core/GraphDebugHandler.js +229 -0
  25. package/backend/src/core/GraphDebugIPC.js +117 -0
  26. package/backend/src/core/GraphExecutionEngine.js +545 -978
  27. package/backend/src/core/GraphTraversal.js +80 -0
  28. package/backend/src/core/GraphValidation.js +73 -0
  29. package/backend/src/core/NodeDefinition.js +138 -0
  30. package/backend/src/core/NodeRegistry.js +153 -141
  31. package/backend/src/core/PluginLoader.js +83 -3
  32. package/backend/src/core/PluginManager.js +346 -35
  33. package/backend/src/core/RewindSignal.js +9 -0
  34. package/backend/src/core/config/ConfigValidator.js +72 -0
  35. package/backend/src/core/config/FeatureFlags.js +52 -0
  36. package/backend/src/core/config/__tests__/ConfigValidator.test.js +232 -0
  37. package/backend/src/core/domain/entities/Bot.js +39 -0
  38. package/backend/src/core/domain/entities/Command.js +41 -0
  39. package/backend/src/core/domain/entities/EventGraph.js +39 -0
  40. package/backend/src/core/domain/entities/Plugin.js +45 -0
  41. package/backend/src/core/domain/entities/User.js +40 -0
  42. package/backend/src/core/domain/services/DependencyResolver.js +168 -0
  43. package/backend/src/core/domain/services/GraphValidator.js +117 -0
  44. package/backend/src/core/domain/services/PermissionChecker.js +34 -0
  45. package/backend/src/core/domain/services/__tests__/DependencyResolver.test.js +126 -0
  46. package/backend/src/core/domain/valueObjects/BotConfig.js +27 -0
  47. package/backend/src/core/domain/valueObjects/DependencyGraph.js +86 -0
  48. package/backend/src/core/domain/valueObjects/PluginManifest.js +36 -0
  49. package/backend/src/core/errors/BaseError.js +29 -0
  50. package/backend/src/core/errors/ErrorHandler.js +81 -0
  51. package/backend/src/core/errors/__tests__/ErrorHandler.test.js +188 -0
  52. package/backend/src/core/errors/index.js +68 -0
  53. package/backend/src/core/infrastructure/BatchingUtility.js +66 -0
  54. package/backend/src/core/infrastructure/CircuitBreaker.js +103 -0
  55. package/backend/src/core/infrastructure/ConnectionPool.js +81 -0
  56. package/backend/src/core/infrastructure/RateLimiter.js +64 -0
  57. package/backend/src/core/infrastructure/__tests__/BatchingUtility.test.js +86 -0
  58. package/backend/src/core/infrastructure/__tests__/CircuitBreaker.test.js +156 -0
  59. package/backend/src/core/infrastructure/__tests__/ConnectionPool.test.js +146 -0
  60. package/backend/src/core/infrastructure/__tests__/RateLimiter.test.js +171 -0
  61. package/backend/src/core/ipc/botApiFactory.js +72 -0
  62. package/backend/src/core/ipc/ipcMessageTypes.js +115 -0
  63. package/backend/src/core/logging/AuditLogger.js +61 -0
  64. package/backend/src/core/logging/StructuredLogger.js +80 -0
  65. package/backend/src/core/logging/__tests__/StructuredLogger.test.js +213 -0
  66. package/backend/src/core/logging/index.js +7 -0
  67. package/backend/src/core/metrics/MetricsCollector.js +104 -0
  68. package/backend/src/core/metrics/__tests__/MetricsCollector.test.js +131 -0
  69. package/backend/src/core/node-registries/actionsNodes.js +191 -0
  70. package/backend/src/core/node-registries/arraysNodes.js +152 -0
  71. package/backend/src/core/node-registries/botNodes.js +48 -0
  72. package/backend/src/core/node-registries/containerNodes.js +141 -0
  73. package/backend/src/core/node-registries/dataNodes.js +284 -0
  74. package/backend/src/core/node-registries/debugNodes.js +23 -0
  75. package/backend/src/core/node-registries/eventsNodes.js +223 -0
  76. package/backend/src/core/node-registries/flowNodes.js +151 -0
  77. package/backend/src/core/node-registries/furnaceNodes.js +123 -0
  78. package/backend/src/core/node-registries/index.js +108 -0
  79. package/backend/src/core/node-registries/inventory.js +102 -106
  80. package/backend/src/core/node-registries/logicNodes.js +54 -0
  81. package/backend/src/core/node-registries/mathNodes.js +38 -0
  82. package/backend/src/core/node-registries/navigationNodes.js +109 -0
  83. package/backend/src/core/node-registries/objectsNodes.js +90 -0
  84. package/backend/src/core/node-registries/stringsNodes.js +165 -0
  85. package/backend/src/core/node-registries/timeNodes.js +105 -0
  86. package/backend/src/core/node-registries/typeNodes.js +22 -0
  87. package/backend/src/core/node-registries/usersNodes.js +126 -0
  88. package/backend/src/core/nodes/arrays/shuffle.js +14 -0
  89. package/backend/src/core/nodes/bot/get_name.js +8 -0
  90. package/backend/src/core/nodes/bot/stop_bot.js +5 -0
  91. package/backend/src/core/nodes/container/open.js +101 -111
  92. package/backend/src/core/nodes/data/store_read.js +26 -0
  93. package/backend/src/core/nodes/data/store_write.js +23 -0
  94. package/backend/src/core/nodes/event/call_event.js +31 -0
  95. package/backend/src/core/nodes/event/custom_event.js +8 -0
  96. package/backend/src/core/nodes/flow/timer.js +35 -0
  97. package/backend/src/core/nodes/inventory/drop.js +73 -65
  98. package/backend/src/core/nodes/inventory/equip.js +54 -45
  99. package/backend/src/core/nodes/inventory/select_slot.js +48 -46
  100. package/backend/src/core/nodes/navigation/follow.js +54 -51
  101. package/backend/src/core/nodes/navigation/go_to.js +41 -53
  102. package/backend/src/core/nodes/navigation/go_to_entity.js +65 -69
  103. package/backend/src/core/nodes/navigation/go_to_player.js +65 -70
  104. package/backend/src/core/nodes/navigation/stop.js +17 -26
  105. package/backend/src/core/nodes/users/add_to_group.js +24 -0
  106. package/backend/src/core/nodes/users/check_permission.js +26 -0
  107. package/backend/src/core/nodes/users/remove_from_group.js +24 -0
  108. package/backend/src/core/services/BotIPCMessageRouter.js +337 -0
  109. package/backend/src/core/services/BotLifecycleService.js +43 -450
  110. package/backend/src/core/services/CacheManager.js +83 -23
  111. package/backend/src/core/services/CrashRestartManager.js +42 -0
  112. package/backend/src/core/services/DebugSessionManager.js +114 -12
  113. package/backend/src/core/services/EventGraphService.js +69 -0
  114. package/backend/src/core/services/MinecraftBotManager.js +9 -1
  115. package/backend/src/core/services/PluginManagementService.js +84 -0
  116. package/backend/src/core/services/TestModeContext.js +65 -0
  117. package/backend/src/core/services/__tests__/CacheManager.test.js +168 -0
  118. package/backend/src/core/services.js +1 -11
  119. package/backend/src/core/validation/InputValidator.js +167 -0
  120. package/backend/src/core/validation/__tests__/InputValidator.test.js +296 -0
  121. package/backend/src/real-time/botApi/index.js +1 -1
  122. package/backend/src/real-time/socketHandler.js +26 -0
  123. package/backend/src/server.js +21 -6
  124. package/frontend/dist/assets/browser-ponyfill-D8y0Ty7C.js +2 -0
  125. package/frontend/dist/assets/index-CFJLS0dk.css +32 -0
  126. package/frontend/dist/assets/index-D91UGNMG.js +11260 -0
  127. package/frontend/dist/flags/en.svg +32 -0
  128. package/frontend/dist/flags/ru.svg +5 -0
  129. package/frontend/dist/index.html +2 -2
  130. package/frontend/dist/locales/en/admin.json +100 -0
  131. package/frontend/dist/locales/en/api-keys.json +58 -0
  132. package/frontend/dist/locales/en/bots.json +113 -0
  133. package/frontend/dist/locales/en/common.json +53 -0
  134. package/frontend/dist/locales/en/configuration.json +22 -0
  135. package/frontend/dist/locales/en/console.json +10 -0
  136. package/frontend/dist/locales/en/dashboard.json +85 -0
  137. package/frontend/dist/locales/en/dialogs.json +70 -0
  138. package/frontend/dist/locales/en/event-graphs.json +50 -0
  139. package/frontend/dist/locales/en/graph-store.json +70 -0
  140. package/frontend/dist/locales/en/login.json +36 -0
  141. package/frontend/dist/locales/en/management.json +192 -0
  142. package/frontend/dist/locales/en/minecraft-viewer.json +27 -0
  143. package/frontend/dist/locales/en/nodes.json +1132 -0
  144. package/frontend/dist/locales/en/permissions.json +50 -0
  145. package/frontend/dist/locales/en/plugin-detail.json +69 -0
  146. package/frontend/dist/locales/en/plugins.json +329 -0
  147. package/frontend/dist/locales/en/proxies.json +81 -0
  148. package/frontend/dist/locales/en/servers.json +39 -0
  149. package/frontend/dist/locales/en/setup.json +19 -0
  150. package/frontend/dist/locales/en/sidebar.json +195 -0
  151. package/frontend/dist/locales/en/tasks.json +62 -0
  152. package/frontend/dist/locales/en/visual-editor.json +418 -0
  153. package/frontend/dist/locales/en/websocket.json +86 -0
  154. package/frontend/dist/locales/ru/admin.json +100 -0
  155. package/frontend/dist/locales/ru/api-keys.json +58 -0
  156. package/frontend/dist/locales/ru/bots.json +113 -0
  157. package/frontend/dist/locales/ru/common.json +49 -0
  158. package/frontend/dist/locales/ru/configuration.json +22 -0
  159. package/frontend/dist/locales/ru/console.json +10 -0
  160. package/frontend/dist/locales/ru/dashboard.json +85 -0
  161. package/frontend/dist/locales/ru/dialogs.json +70 -0
  162. package/frontend/dist/locales/ru/event-graphs.json +50 -0
  163. package/frontend/dist/locales/ru/graph-store.json +70 -0
  164. package/frontend/dist/locales/ru/login.json +36 -0
  165. package/frontend/dist/locales/ru/management.json +192 -0
  166. package/frontend/dist/locales/ru/minecraft-viewer.json +30 -0
  167. package/frontend/dist/locales/ru/nodes.json +1131 -0
  168. package/frontend/dist/locales/ru/permissions.json +50 -0
  169. package/frontend/dist/locales/ru/plugin-detail.json +49 -0
  170. package/frontend/dist/locales/ru/plugins.json +209 -0
  171. package/frontend/dist/locales/ru/proxies.json +81 -0
  172. package/frontend/dist/locales/ru/servers.json +39 -0
  173. package/frontend/dist/locales/ru/setup.json +19 -0
  174. package/frontend/dist/locales/ru/sidebar.json +195 -0
  175. package/frontend/dist/locales/ru/tasks.json +62 -0
  176. package/frontend/dist/locales/ru/visual-editor.json +420 -0
  177. package/frontend/dist/locales/ru/websocket.json +86 -0
  178. package/frontend/dist/monacoeditorwork/css.worker.bundle.js +7 -7
  179. package/frontend/dist/monacoeditorwork/html.worker.bundle.js +7 -7
  180. package/frontend/dist/monacoeditorwork/json.worker.bundle.js +7 -7
  181. package/frontend/dist/monacoeditorwork/ts.worker.bundle.js +3 -3
  182. package/frontend/package.json +6 -0
  183. package/nul +12 -0
  184. package/package.json +3 -3
  185. package/screen/3dviewer.png +0 -0
  186. package/screen/console.png +0 -0
  187. package/screen/dashboard.png +0 -0
  188. package/screen/graph_collabe.png +0 -0
  189. package/screen/graph_live_debug.png +0 -0
  190. package/screen/language_selector.png +0 -0
  191. package/screen/management_command.png +0 -0
  192. package/screen/node_debug_trace.png +0 -0
  193. package/screen/plugin_/320/276/320/261/320/267/320/276/321/200.png +0 -0
  194. package/screen/websocket.png +0 -0
  195. package/screen//320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270_/320/276/321/202/320/264/320/265/320/273/321/214/320/275/321/213/321/205_/320/272/320/276/320/274/320/260/320/275/320/264_/320/272/320/260/320/266/320/264/321/203_/320/272/320/276/320/274/320/260/320/275/320/273/320/264/321/203_/320/274/320/276/320/266/320/275/320/276_/320/275/320/260/321/201/321/202/321/200/320/260/320/270/320/262/320/260/321/202/321/214.png +0 -0
  196. package/screen//320/277/320/273/320/260/320/275/320/270/321/200/320/276/320/262/321/211/320/270/320/272_/320/274/320/276/320/266/320/275/320/276_/320/267/320/260/320/264/320/260/320/262/320/260/321/202/321/214_/320/264/320/265/320/271/321/201/321/202/320/262/320/270/321/217_/320/277/320/276_/320/262/321/200/320/265/320/274/320/265/320/275/320/270.png +0 -0
  197. package/.claude/agents/README.md +0 -469
  198. package/.claude/agents/auth-route-debugger.md +0 -118
  199. package/.claude/agents/auth-route-tester.md +0 -93
  200. package/.claude/agents/auto-error-resolver.md +0 -97
  201. package/.claude/agents/build-optimizer.md +0 -236
  202. package/.claude/agents/code-architect.md +0 -34
  203. package/.claude/agents/code-architecture-reviewer.md +0 -83
  204. package/.claude/agents/code-explorer.md +0 -51
  205. package/.claude/agents/code-refactor-master.md +0 -94
  206. package/.claude/agents/code-reviewer.md +0 -46
  207. package/.claude/agents/cost-optimizer.md +0 -134
  208. package/.claude/agents/deployment-orchestrator.md +0 -113
  209. package/.claude/agents/documentation-architect.md +0 -82
  210. package/.claude/agents/frontend-error-fixer.md +0 -77
  211. package/.claude/agents/iac-code-generator.md +0 -71
  212. package/.claude/agents/incident-responder.md +0 -346
  213. package/.claude/agents/infrastructure-architect.md +0 -31
  214. package/.claude/agents/kubernetes-specialist.md +0 -56
  215. package/.claude/agents/migration-planner.md +0 -181
  216. package/.claude/agents/network-architect.md +0 -196
  217. package/.claude/agents/plan-reviewer.md +0 -52
  218. package/.claude/agents/refactor-planner.md +0 -63
  219. package/.claude/agents/security-scanner.md +0 -102
  220. package/.claude/agents/web-research-specialist.md +0 -78
  221. package/.claude/commands/cost-analysis.md +0 -315
  222. package/.claude/commands/dev-docs-update.md +0 -55
  223. package/.claude/commands/dev-docs.md +0 -51
  224. package/.claude/commands/feature-dev.md +0 -125
  225. package/.claude/commands/incident-debug.md +0 -247
  226. package/.claude/commands/infra-plan.md +0 -81
  227. package/.claude/commands/migration-plan.md +0 -478
  228. package/.claude/commands/route-research-for-testing.md +0 -37
  229. package/.claude/commands/security-review.md +0 -66
  230. package/.claude/hooks/CONFIG.md +0 -448
  231. package/.claude/hooks/README.md +0 -163
  232. package/.claude/hooks/SKILL_ACTIVATION_COMPLETE.md +0 -226
  233. package/.claude/hooks/WINDOWS_HOOKS_README.md +0 -151
  234. package/.claude/hooks/add-skill-activation-banners.ts +0 -132
  235. package/.claude/hooks/comprehensive-skill-test.ts +0 -1315
  236. package/.claude/hooks/error-handling-reminder.sh +0 -12
  237. package/.claude/hooks/error-handling-reminder.ts +0 -222
  238. package/.claude/hooks/k8s-manifest-validator.sh +0 -56
  239. package/.claude/hooks/package-lock.json +0 -556
  240. package/.claude/hooks/package.json +0 -16
  241. package/.claude/hooks/post-tool-use-tracker.ps1 +0 -174
  242. package/.claude/hooks/post-tool-use-tracker.sh +0 -183
  243. package/.claude/hooks/security-policy-check.sh +0 -247
  244. package/.claude/hooks/skill-activation-prompt.ps1 +0 -10
  245. package/.claude/hooks/skill-activation-prompt.sh +0 -10
  246. package/.claude/hooks/skill-activation-prompt.ts +0 -141
  247. package/.claude/hooks/stop-build-check-enhanced.sh +0 -130
  248. package/.claude/hooks/terraform-validator.sh +0 -53
  249. package/.claude/hooks/test-input.json +0 -7
  250. package/.claude/hooks/test-skill-activation.ts +0 -427
  251. package/.claude/hooks/trigger-build-resolver.sh +0 -79
  252. package/.claude/hooks/tsc-check.sh +0 -173
  253. package/.claude/hooks/tsconfig.json +0 -19
  254. package/.claude/settings.json +0 -59
  255. package/.claude/settings.local.json +0 -67
  256. package/.claude/skills/README.md +0 -507
  257. package/.claude/skills/api-engineering/SKILL.md +0 -63
  258. package/.claude/skills/api-engineering/resources/api-versioning.md +0 -88
  259. package/.claude/skills/api-engineering/resources/graphql-patterns.md +0 -106
  260. package/.claude/skills/api-engineering/resources/rate-limiting.md +0 -118
  261. package/.claude/skills/api-engineering/resources/rest-api-design.md +0 -105
  262. package/.claude/skills/backend-dev-guidelines/SKILL.md +0 -306
  263. package/.claude/skills/backend-dev-guidelines/resources/architecture-overview.md +0 -451
  264. package/.claude/skills/backend-dev-guidelines/resources/async-and-errors.md +0 -307
  265. package/.claude/skills/backend-dev-guidelines/resources/complete-examples.md +0 -638
  266. package/.claude/skills/backend-dev-guidelines/resources/configuration.md +0 -275
  267. package/.claude/skills/backend-dev-guidelines/resources/database-patterns.md +0 -224
  268. package/.claude/skills/backend-dev-guidelines/resources/middleware-guide.md +0 -213
  269. package/.claude/skills/backend-dev-guidelines/resources/routing-and-controllers.md +0 -756
  270. package/.claude/skills/backend-dev-guidelines/resources/sentry-and-monitoring.md +0 -336
  271. package/.claude/skills/backend-dev-guidelines/resources/services-and-repositories.md +0 -789
  272. package/.claude/skills/backend-dev-guidelines/resources/testing-guide.md +0 -235
  273. package/.claude/skills/backend-dev-guidelines/resources/validation-patterns.md +0 -754
  274. package/.claude/skills/budget-and-cost-management/SKILL.md +0 -850
  275. package/.claude/skills/build-engineering/SKILL.md +0 -431
  276. package/.claude/skills/build-engineering/resources/artifact-repositories.md +0 -72
  277. package/.claude/skills/build-engineering/resources/build-caching.md +0 -96
  278. package/.claude/skills/build-engineering/resources/build-pipelines.md +0 -105
  279. package/.claude/skills/build-engineering/resources/build-security.md +0 -95
  280. package/.claude/skills/build-engineering/resources/build-systems.md +0 -389
  281. package/.claude/skills/build-engineering/resources/compilation-optimization.md +0 -201
  282. package/.claude/skills/build-engineering/resources/dependency-management.md +0 -73
  283. package/.claude/skills/build-engineering/resources/monorepo-builds.md +0 -110
  284. package/.claude/skills/build-engineering/resources/performance-optimization.md +0 -113
  285. package/.claude/skills/build-engineering/resources/reproducible-builds.md +0 -82
  286. package/.claude/skills/cloud-engineering/SKILL.md +0 -675
  287. package/.claude/skills/cloud-engineering/resources/aws-patterns.md +0 -742
  288. package/.claude/skills/cloud-engineering/resources/azure-patterns.md +0 -714
  289. package/.claude/skills/cloud-engineering/resources/cleared-cloud-environments.md +0 -987
  290. package/.claude/skills/cloud-engineering/resources/cloud-cost-optimization.md +0 -757
  291. package/.claude/skills/cloud-engineering/resources/cloud-networking.md +0 -1058
  292. package/.claude/skills/cloud-engineering/resources/cloud-security-tools.md +0 -1530
  293. package/.claude/skills/cloud-engineering/resources/cloud-security.md +0 -990
  294. package/.claude/skills/cloud-engineering/resources/gcp-patterns.md +0 -758
  295. package/.claude/skills/cloud-engineering/resources/migration-strategies.md +0 -820
  296. package/.claude/skills/cloud-engineering/resources/multi-cloud-strategies.md +0 -670
  297. package/.claude/skills/cloud-engineering/resources/oci-patterns.md +0 -1198
  298. package/.claude/skills/cloud-engineering/resources/serverless-patterns.md +0 -795
  299. package/.claude/skills/cloud-engineering/resources/well-architected-frameworks.md +0 -966
  300. package/.claude/skills/cybersecurity/SKILL.md +0 -409
  301. package/.claude/skills/cybersecurity/resources/security-architecture.md +0 -266
  302. package/.claude/skills/database-engineering/SKILL.md +0 -61
  303. package/.claude/skills/database-engineering/resources/backup-and-recovery.md +0 -72
  304. package/.claude/skills/database-engineering/resources/database-replication.md +0 -63
  305. package/.claude/skills/database-engineering/resources/postgresql-fundamentals.md +0 -70
  306. package/.claude/skills/database-engineering/resources/query-optimization.md +0 -68
  307. package/.claude/skills/devsecops/SKILL.md +0 -374
  308. package/.claude/skills/devsecops/resources/ci-cd-security.md +0 -204
  309. package/.claude/skills/devsecops/resources/compliance-automation.md +0 -530
  310. package/.claude/skills/devsecops/resources/compliance-frameworks.md +0 -2322
  311. package/.claude/skills/devsecops/resources/container-security.md +0 -915
  312. package/.claude/skills/devsecops/resources/cspm-integration.md +0 -1440
  313. package/.claude/skills/devsecops/resources/policy-enforcement.md +0 -619
  314. package/.claude/skills/devsecops/resources/secrets-management.md +0 -755
  315. package/.claude/skills/devsecops/resources/security-monitoring.md +0 -146
  316. package/.claude/skills/devsecops/resources/security-scanning.md +0 -887
  317. package/.claude/skills/devsecops/resources/security-testing.md +0 -203
  318. package/.claude/skills/devsecops/resources/supply-chain-security.md +0 -518
  319. package/.claude/skills/devsecops/resources/vulnerability-management.md +0 -481
  320. package/.claude/skills/devsecops/resources/zero-trust-architecture.md +0 -177
  321. package/.claude/skills/documentation-as-code/SKILL.md +0 -323
  322. package/.claude/skills/documentation-as-code/resources/api-documentation.md +0 -90
  323. package/.claude/skills/documentation-as-code/resources/changelog-management.md +0 -79
  324. package/.claude/skills/documentation-as-code/resources/diagram-generation.md +0 -44
  325. package/.claude/skills/documentation-as-code/resources/docs-as-code-workflow.md +0 -99
  326. package/.claude/skills/documentation-as-code/resources/documentation-automation.md +0 -68
  327. package/.claude/skills/documentation-as-code/resources/documentation-sites.md +0 -79
  328. package/.claude/skills/documentation-as-code/resources/markdown-best-practices.md +0 -162
  329. package/.claude/skills/documentation-as-code/resources/openapi-specification.md +0 -77
  330. package/.claude/skills/documentation-as-code/resources/readme-engineering.md +0 -60
  331. package/.claude/skills/documentation-as-code/resources/technical-writing-guide.md +0 -202
  332. package/.claude/skills/engineering-management/SKILL.md +0 -356
  333. package/.claude/skills/engineering-management/resources/career-ladders.md +0 -609
  334. package/.claude/skills/engineering-management/resources/hiring-and-assessment.md +0 -555
  335. package/.claude/skills/engineering-management/resources/one-on-one-guides.md +0 -609
  336. package/.claude/skills/engineering-management/resources/resource-planning.md +0 -557
  337. package/.claude/skills/engineering-management/resources/team-organization-patterns.md +0 -491
  338. package/.claude/skills/engineering-management/resources/technical-interviews.md +0 -474
  339. package/.claude/skills/engineering-operations-management/SKILL.md +0 -817
  340. package/.claude/skills/error-tracking/SKILL.md +0 -379
  341. package/.claude/skills/frontend-design/SKILL.md +0 -42
  342. package/.claude/skills/frontend-dev-guidelines/SKILL.md +0 -403
  343. package/.claude/skills/frontend-dev-guidelines/resources/common-patterns.md +0 -331
  344. package/.claude/skills/frontend-dev-guidelines/resources/complete-examples.md +0 -872
  345. package/.claude/skills/frontend-dev-guidelines/resources/component-patterns.md +0 -502
  346. package/.claude/skills/frontend-dev-guidelines/resources/data-fetching.md +0 -767
  347. package/.claude/skills/frontend-dev-guidelines/resources/file-organization.md +0 -502
  348. package/.claude/skills/frontend-dev-guidelines/resources/loading-and-error-states.md +0 -501
  349. package/.claude/skills/frontend-dev-guidelines/resources/performance.md +0 -406
  350. package/.claude/skills/frontend-dev-guidelines/resources/routing-guide.md +0 -364
  351. package/.claude/skills/frontend-dev-guidelines/resources/styling-guide.md +0 -428
  352. package/.claude/skills/frontend-dev-guidelines/resources/typescript-standards.md +0 -418
  353. package/.claude/skills/general-it-engineering/SKILL.md +0 -393
  354. package/.claude/skills/general-it-engineering/resources/asset-management.md +0 -712
  355. package/.claude/skills/general-it-engineering/resources/automation-orchestration.md +0 -817
  356. package/.claude/skills/general-it-engineering/resources/business-continuity.md +0 -786
  357. package/.claude/skills/general-it-engineering/resources/change-management.md +0 -715
  358. package/.claude/skills/general-it-engineering/resources/enterprise-monitoring.md +0 -729
  359. package/.claude/skills/general-it-engineering/resources/help-desk-operations.md +0 -738
  360. package/.claude/skills/general-it-engineering/resources/incident-service-management.md +0 -834
  361. package/.claude/skills/general-it-engineering/resources/it-governance.md +0 -753
  362. package/.claude/skills/general-it-engineering/resources/itil-framework.md +0 -503
  363. package/.claude/skills/general-it-engineering/resources/service-management.md +0 -669
  364. package/.claude/skills/infrastructure-architecture/SKILL.md +0 -328
  365. package/.claude/skills/infrastructure-architecture/resources/architecture-decision-records.md +0 -505
  366. package/.claude/skills/infrastructure-architecture/resources/architecture-patterns.md +0 -528
  367. package/.claude/skills/infrastructure-architecture/resources/capacity-planning.md +0 -453
  368. package/.claude/skills/infrastructure-architecture/resources/cleared-environment-architecture.md +0 -773
  369. package/.claude/skills/infrastructure-architecture/resources/cost-architecture.md +0 -499
  370. package/.claude/skills/infrastructure-architecture/resources/data-architecture.md +0 -501
  371. package/.claude/skills/infrastructure-architecture/resources/disaster-recovery.md +0 -535
  372. package/.claude/skills/infrastructure-architecture/resources/migration-architecture.md +0 -512
  373. package/.claude/skills/infrastructure-architecture/resources/multi-region-design.md +0 -608
  374. package/.claude/skills/infrastructure-architecture/resources/reference-architectures.md +0 -562
  375. package/.claude/skills/infrastructure-architecture/resources/security-architecture.md +0 -538
  376. package/.claude/skills/infrastructure-architecture/resources/system-design-principles.md +0 -489
  377. package/.claude/skills/infrastructure-architecture/resources/workload-classification.md +0 -1000
  378. package/.claude/skills/infrastructure-strategy/SKILL.md +0 -924
  379. package/.claude/skills/network-engineering/SKILL.md +0 -385
  380. package/.claude/skills/network-engineering/resources/dns-management.md +0 -738
  381. package/.claude/skills/network-engineering/resources/load-balancing.md +0 -820
  382. package/.claude/skills/network-engineering/resources/network-architecture.md +0 -546
  383. package/.claude/skills/network-engineering/resources/network-security.md +0 -921
  384. package/.claude/skills/network-engineering/resources/network-troubleshooting.md +0 -749
  385. package/.claude/skills/network-engineering/resources/routing-switching.md +0 -373
  386. package/.claude/skills/network-engineering/resources/sdn-networking.md +0 -695
  387. package/.claude/skills/network-engineering/resources/service-mesh-networking.md +0 -777
  388. package/.claude/skills/network-engineering/resources/tcp-ip-protocols.md +0 -444
  389. package/.claude/skills/network-engineering/resources/vpn-connectivity.md +0 -672
  390. package/.claude/skills/node-development/SKILL.md +0 -317
  391. package/.claude/skills/observability-engineering/SKILL.md +0 -101
  392. package/.claude/skills/observability-engineering/resources/apm-tools.md +0 -97
  393. package/.claude/skills/observability-engineering/resources/correlation-strategies.md +0 -87
  394. package/.claude/skills/observability-engineering/resources/distributed-tracing.md +0 -98
  395. package/.claude/skills/observability-engineering/resources/logs-aggregation.md +0 -118
  396. package/.claude/skills/observability-engineering/resources/observability-cost-optimization.md +0 -141
  397. package/.claude/skills/observability-engineering/resources/opentelemetry.md +0 -110
  398. package/.claude/skills/platform-engineering/SKILL.md +0 -555
  399. package/.claude/skills/platform-engineering/resources/architecture-overview.md +0 -600
  400. package/.claude/skills/platform-engineering/resources/container-orchestration.md +0 -916
  401. package/.claude/skills/platform-engineering/resources/cost-optimization.md +0 -634
  402. package/.claude/skills/platform-engineering/resources/developer-platforms.md +0 -670
  403. package/.claude/skills/platform-engineering/resources/gitops-automation.md +0 -650
  404. package/.claude/skills/platform-engineering/resources/infrastructure-as-code.md +0 -778
  405. package/.claude/skills/platform-engineering/resources/infrastructure-standards.md +0 -708
  406. package/.claude/skills/platform-engineering/resources/multi-tenancy.md +0 -602
  407. package/.claude/skills/platform-engineering/resources/platform-security.md +0 -711
  408. package/.claude/skills/platform-engineering/resources/resource-management.md +0 -592
  409. package/.claude/skills/platform-engineering/resources/service-mesh.md +0 -628
  410. package/.claude/skills/release-engineering/SKILL.md +0 -393
  411. package/.claude/skills/release-engineering/resources/artifact-management.md +0 -108
  412. package/.claude/skills/release-engineering/resources/build-optimization.md +0 -84
  413. package/.claude/skills/release-engineering/resources/ci-cd-pipelines.md +0 -411
  414. package/.claude/skills/release-engineering/resources/deployment-strategies.md +0 -197
  415. package/.claude/skills/release-engineering/resources/pipeline-security.md +0 -62
  416. package/.claude/skills/release-engineering/resources/progressive-delivery.md +0 -83
  417. package/.claude/skills/release-engineering/resources/release-automation.md +0 -68
  418. package/.claude/skills/release-engineering/resources/release-orchestration.md +0 -77
  419. package/.claude/skills/release-engineering/resources/rollback-strategies.md +0 -66
  420. package/.claude/skills/release-engineering/resources/versioning-strategies.md +0 -59
  421. package/.claude/skills/route-tester/SKILL.md +0 -392
  422. package/.claude/skills/skill-developer/ADVANCED.md +0 -197
  423. package/.claude/skills/skill-developer/HOOK_MECHANISMS.md +0 -306
  424. package/.claude/skills/skill-developer/PATTERNS_LIBRARY.md +0 -152
  425. package/.claude/skills/skill-developer/SKILL.md +0 -430
  426. package/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md +0 -315
  427. package/.claude/skills/skill-developer/TRIGGER_TYPES.md +0 -305
  428. package/.claude/skills/skill-developer/TROUBLESHOOTING.md +0 -514
  429. package/.claude/skills/skill-rules.json +0 -2989
  430. package/.claude/skills/sre/SKILL.md +0 -464
  431. package/.claude/skills/sre/resources/alerting-best-practices.md +0 -282
  432. package/.claude/skills/sre/resources/capacity-planning.md +0 -226
  433. package/.claude/skills/sre/resources/chaos-engineering.md +0 -193
  434. package/.claude/skills/sre/resources/disaster-recovery.md +0 -232
  435. package/.claude/skills/sre/resources/incident-management.md +0 -436
  436. package/.claude/skills/sre/resources/observability-stack.md +0 -240
  437. package/.claude/skills/sre/resources/on-call-runbooks.md +0 -167
  438. package/.claude/skills/sre/resources/performance-optimization.md +0 -108
  439. package/.claude/skills/sre/resources/reliability-patterns.md +0 -183
  440. package/.claude/skills/sre/resources/slo-sli-sla.md +0 -464
  441. package/.claude/skills/sre/resources/toil-reduction.md +0 -145
  442. package/.claude/skills/systems-engineering/SKILL.md +0 -648
  443. package/.claude/skills/systems-engineering/resources/automation-patterns.md +0 -771
  444. package/.claude/skills/systems-engineering/resources/configuration-management.md +0 -998
  445. package/.claude/skills/systems-engineering/resources/linux-administration.md +0 -672
  446. package/.claude/skills/systems-engineering/resources/networking-fundamentals.md +0 -982
  447. package/.claude/skills/systems-engineering/resources/performance-tuning.md +0 -871
  448. package/.claude/skills/systems-engineering/resources/powershell-scripting.md +0 -482
  449. package/.claude/skills/systems-engineering/resources/security-hardening.md +0 -739
  450. package/.claude/skills/systems-engineering/resources/shell-scripting.md +0 -915
  451. package/.claude/skills/systems-engineering/resources/storage-management.md +0 -628
  452. package/.claude/skills/systems-engineering/resources/system-monitoring.md +0 -787
  453. package/.claude/skills/systems-engineering/resources/troubleshooting-guide.md +0 -753
  454. package/.claude/skills/systems-engineering/resources/windows-administration.md +0 -738
  455. package/.claude/skills/technical-leadership/SKILL.md +0 -728
  456. package/backend/docs/SECRETS_DOCUMENTATION.md +0 -327
  457. package/backend/package-lock.json +0 -6801
  458. package/backend/src/core/node-registries/actions.js +0 -202
  459. package/backend/src/core/node-registries/arrays.js +0 -155
  460. package/backend/src/core/node-registries/bot.js +0 -23
  461. package/backend/src/core/node-registries/container.js +0 -162
  462. package/backend/src/core/node-registries/data.js +0 -290
  463. package/backend/src/core/node-registries/debug.js +0 -26
  464. package/backend/src/core/node-registries/events.js +0 -201
  465. package/backend/src/core/node-registries/flow.js +0 -139
  466. package/backend/src/core/node-registries/furnace.js +0 -143
  467. package/backend/src/core/node-registries/logic.js +0 -62
  468. package/backend/src/core/node-registries/math.js +0 -42
  469. package/backend/src/core/node-registries/navigation.js +0 -111
  470. package/backend/src/core/node-registries/objects.js +0 -98
  471. package/backend/src/core/node-registries/strings.js +0 -187
  472. package/backend/src/core/node-registries/time.js +0 -113
  473. package/backend/src/core/node-registries/type.js +0 -25
  474. package/backend/src/core/node-registries/users.js +0 -79
  475. package/frontend/dist/assets/index-BC-NbKXi.css +0 -32
  476. package/frontend/dist/assets/index-DqJXZMHY.js +0 -11266
@@ -22379,10 +22379,10 @@
22379
22379
  }, format: function(t4) {
22380
22380
  if (null === t4 || "object" != typeof t4)
22381
22381
  throw new TypeError('The "pathObject" argument must be of type Object. Received type ' + typeof t4);
22382
- return function(t5, e3) {
22382
+ return (function(t5, e3) {
22383
22383
  var r3 = e3.dir || e3.root, n3 = e3.base || (e3.name || "") + (e3.ext || "");
22384
22384
  return r3 ? r3 === e3.root ? r3 + n3 : r3 + "/" + n3 : n3;
22385
- }(0, t4);
22385
+ })(0, t4);
22386
22386
  }, parse: function(t4) {
22387
22387
  e2(t4);
22388
22388
  var r3 = { root: "", dir: "", base: "", ext: "", name: "" };
@@ -22448,9 +22448,9 @@
22448
22448
  query;
22449
22449
  fragment;
22450
22450
  constructor(t4, e3, r2, n2, i2, o2 = false) {
22451
- "object" == typeof t4 ? (this.scheme = t4.scheme || h, this.authority = t4.authority || h, this.path = t4.path || h, this.query = t4.query || h, this.fragment = t4.fragment || h) : (this.scheme = /* @__PURE__ */ function(t5, e4) {
22451
+ "object" == typeof t4 ? (this.scheme = t4.scheme || h, this.authority = t4.authority || h, this.path = t4.path || h, this.query = t4.query || h, this.fragment = t4.fragment || h) : (this.scheme = /* @__PURE__ */ (function(t5, e4) {
22452
22452
  return t5 || e4 ? t5 : "file";
22453
- }(t4, o2), this.authority = e3 || h, this.path = function(t5, e4) {
22453
+ })(t4, o2), this.authority = e3 || h, this.path = (function(t5, e4) {
22454
22454
  switch (t5) {
22455
22455
  case "https":
22456
22456
  case "http":
@@ -22458,7 +22458,7 @@
22458
22458
  e4 ? e4[0] !== a && (e4 = a + e4) : e4 = a;
22459
22459
  }
22460
22460
  return e4;
22461
- }(this.scheme, r2 || h), this.query = n2 || h, this.fragment = i2 || h, s(this, o2));
22461
+ })(this.scheme, r2 || h), this.query = n2 || h, this.fragment = i2 || h, s(this, o2));
22462
22462
  }
22463
22463
  get fsPath() {
22464
22464
  return m(this, false);
@@ -22582,7 +22582,7 @@
22582
22582
  var A = r(470);
22583
22583
  const w = A.posix || A, x = "/";
22584
22584
  var P;
22585
- !function(t4) {
22585
+ !(function(t4) {
22586
22586
  t4.joinPath = function(t5, ...e3) {
22587
22587
  return t5.with({ path: w.join(t5.path, ...e3) });
22588
22588
  }, t4.resolvePath = function(t5, ...e3) {
@@ -22600,7 +22600,7 @@
22600
22600
  }, t4.extname = function(t5) {
22601
22601
  return w.extname(t5.path);
22602
22602
  };
22603
- }(P || (P = {}));
22603
+ })(P || (P = {}));
22604
22604
  })(), LIB = n;
22605
22605
  })();
22606
22606
  var { URI: URI22, Utils } = LIB;
@@ -19625,10 +19625,10 @@
19625
19625
  }, format: function(t4) {
19626
19626
  if (null === t4 || "object" != typeof t4)
19627
19627
  throw new TypeError('The "pathObject" argument must be of type Object. Received type ' + typeof t4);
19628
- return function(t5, e3) {
19628
+ return (function(t5, e3) {
19629
19629
  var r3 = e3.dir || e3.root, n3 = e3.base || (e3.name || "") + (e3.ext || "");
19630
19630
  return r3 ? r3 === e3.root ? r3 + n3 : r3 + "/" + n3 : n3;
19631
- }(0, t4);
19631
+ })(0, t4);
19632
19632
  }, parse: function(t4) {
19633
19633
  e2(t4);
19634
19634
  var r3 = { root: "", dir: "", base: "", ext: "", name: "" };
@@ -19694,9 +19694,9 @@
19694
19694
  query;
19695
19695
  fragment;
19696
19696
  constructor(t4, e3, r2, n2, i2, o2 = false) {
19697
- "object" == typeof t4 ? (this.scheme = t4.scheme || h, this.authority = t4.authority || h, this.path = t4.path || h, this.query = t4.query || h, this.fragment = t4.fragment || h) : (this.scheme = /* @__PURE__ */ function(t5, e4) {
19697
+ "object" == typeof t4 ? (this.scheme = t4.scheme || h, this.authority = t4.authority || h, this.path = t4.path || h, this.query = t4.query || h, this.fragment = t4.fragment || h) : (this.scheme = /* @__PURE__ */ (function(t5, e4) {
19698
19698
  return t5 || e4 ? t5 : "file";
19699
- }(t4, o2), this.authority = e3 || h, this.path = function(t5, e4) {
19699
+ })(t4, o2), this.authority = e3 || h, this.path = (function(t5, e4) {
19700
19700
  switch (t5) {
19701
19701
  case "https":
19702
19702
  case "http":
@@ -19704,7 +19704,7 @@
19704
19704
  e4 ? e4[0] !== a2 && (e4 = a2 + e4) : e4 = a2;
19705
19705
  }
19706
19706
  return e4;
19707
- }(this.scheme, r2 || h), this.query = n2 || h, this.fragment = i2 || h, s(this, o2));
19707
+ })(this.scheme, r2 || h), this.query = n2 || h, this.fragment = i2 || h, s(this, o2));
19708
19708
  }
19709
19709
  get fsPath() {
19710
19710
  return m(this, false);
@@ -19828,7 +19828,7 @@
19828
19828
  var A2 = r(470);
19829
19829
  const w = A2.posix || A2, x = "/";
19830
19830
  var P;
19831
- !function(t4) {
19831
+ !(function(t4) {
19832
19832
  t4.joinPath = function(t5, ...e3) {
19833
19833
  return t5.with({ path: w.join(t5.path, ...e3) });
19834
19834
  }, t4.resolvePath = function(t5, ...e3) {
@@ -19846,7 +19846,7 @@
19846
19846
  }, t4.extname = function(t5) {
19847
19847
  return w.extname(t5.path);
19848
19848
  };
19849
- }(P || (P = {}));
19849
+ })(P || (P = {}));
19850
19850
  })(), LIB = n;
19851
19851
  })();
19852
19852
  var { URI: URI22, Utils } = LIB;
@@ -81262,9 +81262,9 @@ ${lanes.join("\n")}
81262
81262
  const elem = getElaborationElementForJsxChild(child, childrenNameType, getInvalidTextualChildDiagnostic);
81263
81263
  if (elem) {
81264
81264
  result = elaborateElementwise(
81265
- function* () {
81265
+ (function* () {
81266
81266
  yield elem;
81267
- }(),
81267
+ })(),
81268
81268
  source,
81269
81269
  target,
81270
81270
  relation,
@@ -183773,7 +183773,7 @@ ${newComment.split("\n").map((c) => ` * ${c}`).join("\n")}
183773
183773
  return !!(symbol2.flags & 1920) && !((_a2 = symbol2.declarations) == null ? void 0 : _a2.every((d) => d.parent === node.parent));
183774
183774
  } : isRhsOfImportDeclaration ? (
183775
183775
  // Any kind is allowed when dotting off namespace in internal import equals declaration
183776
- (symbol2) => isValidTypeAccess(symbol2) || isValidValueAccess(symbol2)
183776
+ ((symbol2) => isValidTypeAccess(symbol2) || isValidValueAccess(symbol2))
183777
183777
  ) : isTypeLocation || insideJsDocTagTypeExpression ? isValidTypeAccess : isValidValueAccess;
183778
183778
  for (const exportedSymbol of exportedSymbols) {
183779
183779
  if (isValidAccess(exportedSymbol)) {
@@ -41,6 +41,11 @@
41
41
  "cmdk": "^1.1.1",
42
42
  "cron-parser": "^5.3.0",
43
43
  "diff": "^8.0.2",
44
+ "dompurify": "^3.3.3",
45
+ "github-markdown-css": "^5.9.0",
46
+ "i18next": "^25.7.1",
47
+ "i18next-browser-languagedetector": "^8.2.0",
48
+ "i18next-http-backend": "^3.0.2",
44
49
  "immer": "^10.1.1",
45
50
  "lucide-react": "^0.514.0",
46
51
  "minecraft-data": "^3.100.0",
@@ -49,6 +54,7 @@
49
54
  "prismarine-viewer": "^1.33.0",
50
55
  "react": "^19.1.0",
51
56
  "react-dom": "^19.1.0",
57
+ "react-i18next": "^16.4.0",
52
58
  "react-markdown": "^10.1.0",
53
59
  "react-resizable-panels": "^3.0.2",
54
60
  "react-router-dom": "^7.6.2",
package/nul ADDED
@@ -0,0 +1,12 @@
1
+ D\:\\webstormproject\\blockmine\\backend\\src\\core:
2
+ __tests__ GraphExecutionEngine.js PluginService.js
3
+ BotHistoryStore.js ipc PrismaService.js
4
+ BotManager.js MessageQueue.js services
5
+ BotManager.old.js node-registries services.js
6
+ BotProcess.js nodeRegistry system
7
+ BreakLoopSignal.js NodeRegistry.js TaskScheduler.js
8
+ commands nodes UserService.js
9
+ config PermissionManager.js utils
10
+ constants PluginHooks.js validation
11
+ DependencyService.js PluginLoader.js
12
+ EventGraphManager.js PluginManager.js
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "blockmine",
3
- "version": "1.24.0",
3
+ "version": "1.27.0",
4
4
  "description": "Мощная панель управления ботами для Майнкрафта.",
5
5
  "author": "merka",
6
6
  "license": "MIT",
@@ -25,7 +25,7 @@
25
25
  ],
26
26
  "scripts": {
27
27
  "dev": "concurrently \"npm run dev --workspace=backend\" \"npm run dev --workspace=frontend\"",
28
- "postinstall": "npm install --workspace=frontend --ignore-scripts && prisma generate --schema=./backend/prisma/schema.prisma",
28
+ "postinstall": "node scripts/postinstall.js",
29
29
  "build": "npm run build --workspace=frontend",
30
30
  "prepublishOnly": "npm run build",
31
31
  "prepare": "husky",
@@ -36,7 +36,7 @@
36
36
  },
37
37
  "dependencies": {
38
38
  "@monaco-editor/react": "^4.7.0",
39
- "@octokit/rest": "^22.0.1",
39
+ "@octokit/rest": "^20.1.1",
40
40
  "@prisma/client": "^5.14.0",
41
41
  "@radix-ui/react-icons": "^1.3.2",
42
42
  "adm-zip": "^0.5.16",
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
@@ -1,469 +0,0 @@
1
- # Agents
2
-
3
- Specialized agents for complex, multi-step tasks.
4
-
5
- ---
6
-
7
- ## What Are Agents?
8
-
9
- Agents are autonomous Claude instances that handle specific complex tasks. Unlike skills (which provide inline guidance), agents:
10
- - Run as separate sub-tasks
11
- - Work autonomously with minimal supervision
12
- - Have specialized tool access
13
- - Return comprehensive reports when complete
14
-
15
- **Key advantage:** Agents are **standalone** - just copy the `.md` file and use immediately!
16
-
17
- ---
18
-
19
- ## Available Agents (21 Total)
20
-
21
- All agents are standalone - just copy the `.md` file and use immediately!
22
-
23
- ---
24
-
25
- ## Development Agents (10)
26
-
27
- ### code-architecture-reviewer
28
- **Purpose:** Review code for architectural consistency and best practices
29
-
30
- **When to use:**
31
- - After implementing a new feature
32
- - Before merging significant changes
33
- - When refactoring code
34
- - To validate architectural decisions
35
-
36
- **Integration:** ✅ Copy as-is
37
-
38
- ---
39
-
40
- ### code-refactor-master
41
- **Purpose:** Plan and execute comprehensive refactoring
42
-
43
- **When to use:**
44
- - Reorganizing file structures
45
- - Breaking down large components
46
- - Updating import paths after moves
47
- - Improving code maintainability
48
-
49
- **Integration:** ✅ Copy as-is
50
-
51
- ---
52
-
53
- ### documentation-architect
54
- **Purpose:** Create comprehensive documentation
55
-
56
- **When to use:**
57
- - Documenting new features
58
- - Creating API documentation
59
- - Writing developer guides
60
- - Generating architectural overviews
61
-
62
- **Integration:** ✅ Copy as-is
63
-
64
- ---
65
-
66
- ### frontend-error-fixer
67
- **Purpose:** Debug and fix frontend errors
68
-
69
- **When to use:**
70
- - Browser console errors
71
- - TypeScript compilation errors in frontend
72
- - React errors
73
- - Build failures
74
-
75
- **Integration:** ⚠️ May reference screenshot paths - update if needed
76
-
77
- ---
78
-
79
- ### plan-reviewer
80
- **Purpose:** Review development plans before implementation
81
-
82
- **When to use:**
83
- - Before starting complex features
84
- - Validating architectural plans
85
- - Identifying potential issues early
86
- - Getting second opinion on approach
87
-
88
- **Integration:** ✅ Copy as-is
89
-
90
- ---
91
-
92
- ### refactor-planner
93
- **Purpose:** Create comprehensive refactoring strategies
94
-
95
- **When to use:**
96
- - Planning code reorganization
97
- - Modernizing legacy code
98
- - Breaking down large files
99
- - Improving code structure
100
-
101
- **Integration:** ✅ Copy as-is
102
-
103
- ---
104
-
105
- ### web-research-specialist
106
- **Purpose:** Research technical issues online
107
-
108
- **When to use:**
109
- - Debugging obscure errors
110
- - Finding solutions to problems
111
- - Researching best practices
112
- - Comparing implementation approaches
113
-
114
- **Integration:** ✅ Copy as-is
115
-
116
- ---
117
-
118
- ### auth-route-tester
119
- **Purpose:** Test authenticated API endpoints
120
-
121
- **When to use:**
122
- - Testing routes with JWT cookie auth
123
- - Validating endpoint functionality
124
- - Debugging authentication issues
125
-
126
- **Integration:** ⚠️ Requires JWT cookie-based auth
127
-
128
- ---
129
-
130
- ### auth-route-debugger
131
- **Purpose:** Debug authentication issues
132
-
133
- **When to use:**
134
- - Auth failures
135
- - Token issues
136
- - Cookie problems
137
- - Permission errors
138
-
139
- **Integration:** ⚠️ Requires JWT cookie-based auth
140
-
141
- ---
142
-
143
- ### auto-error-resolver
144
- **Purpose:** Automatically fix TypeScript compilation errors
145
-
146
- **When to use:**
147
- - Build failures with TypeScript errors
148
- - After refactoring that breaks types
149
- - Systematic error resolution needed
150
-
151
- **Integration:** ⚠️ May need path updates
152
-
153
- ---
154
-
155
- ## Infrastructure Agents (11)
156
-
157
- ### infrastructure-architect
158
- **Purpose:** Design and review cloud-native architectures
159
-
160
- **When to use:**
161
- - Designing new infrastructure
162
- - Reviewing architecture decisions
163
- - Validating infrastructure patterns
164
- - Getting recommendations for improvements
165
-
166
- **Integration:** ✅ Copy as-is
167
-
168
- ---
169
-
170
- ### kubernetes-specialist
171
- **Purpose:** Kubernetes troubleshooting, manifest generation, and cluster management
172
-
173
- **When to use:**
174
- - Troubleshooting Kubernetes issues
175
- - Creating or reviewing Kubernetes manifests
176
- - Debugging pod/deployment problems
177
- - Cluster architecture questions
178
-
179
- **Integration:** ✅ Copy as-is
180
-
181
- ---
182
-
183
- ### iac-code-generator
184
- **Purpose:** Generate Infrastructure as Code (Terraform, Pulumi, CloudFormation)
185
-
186
- **When to use:**
187
- - Creating new infrastructure modules
188
- - Generating IaC from requirements
189
- - Converting between IaC tools
190
- - Creating complete infrastructure stacks
191
-
192
- **Integration:** ✅ Copy as-is
193
-
194
- ---
195
-
196
- ### security-scanner
197
- **Purpose:** Security vulnerability analysis and remediation recommendations
198
-
199
- **When to use:**
200
- - Analyzing infrastructure for security issues
201
- - Reviewing IaC for misconfigurations
202
- - Compliance checking
203
- - Security best practice validation
204
-
205
- **Integration:** ✅ Copy as-is
206
-
207
- ---
208
-
209
- ### deployment-orchestrator
210
- **Purpose:** Design deployment pipelines and progressive delivery strategies
211
-
212
- **When to use:**
213
- - Designing CI/CD pipelines
214
- - Implementing blue-green or canary deployments
215
- - Planning rollout strategies
216
- - Creating deployment automation
217
-
218
- **Integration:** ✅ Copy as-is
219
-
220
- ---
221
-
222
- ### cost-optimizer
223
- **Purpose:** Cloud cost analysis and optimization recommendations
224
-
225
- **When to use:**
226
- - Analyzing infrastructure costs
227
- - Finding cost optimization opportunities
228
- - Right-sizing resources
229
- - Implementing FinOps practices
230
-
231
- **Integration:** ✅ Copy as-is
232
-
233
- ---
234
-
235
- ### migration-planner
236
- **Purpose:** Cloud migration and modernization planning
237
-
238
- **When to use:**
239
- - Planning cloud migrations
240
- - Modernizing legacy applications
241
- - Assessing migration strategies
242
- - Creating migration roadmaps
243
-
244
- **Integration:** ✅ Copy as-is
245
-
246
- ---
247
-
248
- ### network-architect
249
- **Purpose:** Network design and architecture
250
-
251
- **When to use:**
252
- - Designing network topologies
253
- - Planning load balancing strategies
254
- - Network security architecture
255
- - Troubleshooting network issues
256
-
257
- **Integration:** ✅ Copy as-is
258
-
259
- ---
260
-
261
- ### build-optimizer
262
- **Purpose:** Build performance analysis and optimization
263
-
264
- **When to use:**
265
- - Optimizing slow builds
266
- - Implementing build caching
267
- - Improving CI/CD pipeline performance
268
- - Build system recommendations
269
-
270
- **Integration:** ✅ Copy as-is
271
-
272
- ---
273
-
274
- ### incident-responder
275
- **Purpose:** Incident response and debugging guidance
276
-
277
- **When to use:**
278
- - During production incidents
279
- - Root cause analysis
280
- - Creating runbooks
281
- - Debugging complex issues
282
-
283
- **Integration:** ✅ Copy as-is
284
-
285
- ---
286
-
287
- ### plan-reviewer
288
- **Purpose:** Review technical plans and proposals
289
-
290
- **When to use:**
291
- - Reviewing infrastructure plans
292
- - Validating technical proposals
293
- - Risk assessment
294
- - Identifying potential issues
295
-
296
- **Integration:** ✅ Copy as-is
297
-
298
- ---
299
-
300
- ## How to Integrate an Agent
301
-
302
- ### Standard Integration (Most Agents)
303
-
304
- **Step 1: Copy the file**
305
- ```bash
306
- cp showcase/.claude/agents/agent-name.md \\
307
- your-project/.claude/agents/
308
- ```
309
-
310
- **Step 2: Verify (optional)**
311
- ```bash
312
- # Check for hardcoded paths
313
- grep -n "~/git/\|/root/git/\|/Users/" your-project/.claude/agents/agent-name.md
314
- ```
315
-
316
- **Step 3: Use it**
317
- Ask Claude: "Use the [agent-name] agent to [task]"
318
-
319
- That's it! Agents work immediately.
320
-
321
- ---
322
-
323
- ### Agents Requiring Customization
324
-
325
- **frontend-error-fixer:**
326
- - May reference screenshot paths
327
- - Ask user: "Where should screenshots be saved?"
328
- - Update paths in agent file
329
-
330
- **auth-route-tester / auth-route-debugger:**
331
- - Require JWT cookie authentication
332
- - Update service URLs from examples
333
- - Customize for user's auth setup
334
-
335
- **auto-error-resolver:**
336
- - May have hardcoded project paths
337
- - Update to use `$CLAUDE_PROJECT_DIR` or relative paths
338
-
339
- ---
340
-
341
- ## When to Use Agents vs Skills
342
-
343
- | Use Agents When... | Use Skills When... |
344
- |-------------------|-------------------|
345
- | Task requires multiple steps | Need inline guidance |
346
- | Complex analysis needed | Checking best practices |
347
- | Autonomous work preferred | Want to maintain control |
348
- | Task has clear end goal | Ongoing development work |
349
- | Example: "Review all controllers" | Example: "Creating a new route" |
350
-
351
- **Both can work together:**
352
- - Skill provides patterns during development
353
- - Agent reviews the result when complete
354
-
355
- ---
356
-
357
- ## Agent Quick Reference
358
-
359
- ### Development Agents
360
-
361
- | Agent | Complexity | Customization | Auth Required |
362
- |-------|-----------|---------------|---------------|
363
- | code-architecture-reviewer | Medium | ✅ None | No |
364
- | code-refactor-master | High | ✅ None | No |
365
- | documentation-architect | Medium | ✅ None | No |
366
- | frontend-error-fixer | Medium | ⚠️ Screenshot paths | No |
367
- | plan-reviewer | Low | ✅ None | No |
368
- | refactor-planner | Medium | ✅ None | No |
369
- | web-research-specialist | Low | ✅ None | No |
370
- | auth-route-tester | Medium | ⚠️ Auth setup | JWT cookies |
371
- | auth-route-debugger | Medium | ⚠️ Auth setup | JWT cookies |
372
- | auto-error-resolver | Low | ⚠️ Paths | No |
373
-
374
- ### Infrastructure Agents
375
-
376
- | Agent | Complexity | Customization | Auth Required |
377
- |-------|-----------|---------------|---------------|
378
- | infrastructure-architect | Medium | ✅ None | No |
379
- | kubernetes-specialist | Medium | ✅ None | No |
380
- | iac-code-generator | Medium | ✅ None | No |
381
- | security-scanner | Medium | ✅ None | No |
382
- | deployment-orchestrator | Medium | ✅ None | No |
383
- | cost-optimizer | Low | ✅ None | No |
384
- | migration-planner | Medium | ✅ None | No |
385
- | network-architect | Medium | ✅ None | No |
386
- | build-optimizer | Low | ✅ None | No |
387
- | incident-responder | Medium | ✅ None | No |
388
- | plan-reviewer | Low | ✅ None | No |
389
-
390
- ---
391
-
392
- ## For Claude Code
393
-
394
- **When integrating agents for a user:**
395
-
396
- 1. **Read [CLAUDE_INTEGRATION_GUIDE.md](../../CLAUDE_INTEGRATION_GUIDE.md)**
397
- 2. **Just copy the .md file** - agents are standalone
398
- 3. **Check for hardcoded paths:**
399
- ```bash
400
- grep "~/git/\|/root/" agent-name.md
401
- ```
402
- 4. **Update paths if found** to `$CLAUDE_PROJECT_DIR` or `.`
403
- 5. **For auth agents:** Ask if they use JWT cookie auth first
404
-
405
- **That's it!** Agents are the easiest components to integrate.
406
-
407
- ---
408
-
409
- ## Creating Your Own Agents
410
-
411
- Agents are markdown files with optional YAML frontmatter:
412
-
413
- ```markdown
414
- # Agent Name
415
-
416
- ## Purpose
417
- What this agent does
418
-
419
- ## Instructions
420
- Step-by-step instructions for autonomous execution
421
-
422
- ## Tools Available
423
- List of tools this agent can use
424
-
425
- ## Expected Output
426
- What format to return results in
427
- ```
428
-
429
- **Tips:**
430
- - Be very specific in instructions
431
- - Break complex tasks into numbered steps
432
- - Specify exactly what to return
433
- - Include examples of good output
434
- - List available tools explicitly
435
-
436
- ---
437
-
438
- ## Troubleshooting
439
-
440
- ### Agent not found
441
-
442
- **Check:**
443
- ```bash
444
- # Is agent file present?
445
- ls -la .claude/agents/[agent-name].md
446
- ```
447
-
448
- ### Agent fails with path errors
449
-
450
- **Check for hardcoded paths:**
451
- ```bash
452
- grep "~/\|/root/\|/Users/" .claude/agents/[agent-name].md
453
- ```
454
-
455
- **Fix:**
456
- ```bash
457
- sed -i 's|~/git/.*project|$CLAUDE_PROJECT_DIR|g' .claude/agents/[agent-name].md
458
- ```
459
-
460
- ---
461
-
462
- ## Next Steps
463
-
464
- 1. **Browse agents above** - Find ones useful for your work
465
- 2. **Copy what you need** - Just the .md file
466
- 3. **Ask Claude to use them** - "Use [agent] to [task]"
467
- 4. **Create your own** - Follow the pattern for your specific needs
468
-
469
- **Questions?** See [CLAUDE_INTEGRATION_GUIDE.md](../../CLAUDE_INTEGRATION_GUIDE.md)