blockmine 1.21.0 → 1.22.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 (433) hide show
  1. package/.claude/agents/README.md +469 -0
  2. package/.claude/agents/auth-route-debugger.md +118 -0
  3. package/.claude/agents/auth-route-tester.md +93 -0
  4. package/.claude/agents/auto-error-resolver.md +97 -0
  5. package/.claude/agents/build-optimizer.md +236 -0
  6. package/.claude/agents/code-architecture-reviewer.md +83 -0
  7. package/.claude/agents/code-refactor-master.md +94 -0
  8. package/.claude/agents/cost-optimizer.md +134 -0
  9. package/.claude/agents/deployment-orchestrator.md +113 -0
  10. package/.claude/agents/documentation-architect.md +82 -0
  11. package/.claude/agents/frontend-error-fixer.md +77 -0
  12. package/.claude/agents/iac-code-generator.md +71 -0
  13. package/.claude/agents/incident-responder.md +346 -0
  14. package/.claude/agents/infrastructure-architect.md +31 -0
  15. package/.claude/agents/kubernetes-specialist.md +56 -0
  16. package/.claude/agents/migration-planner.md +181 -0
  17. package/.claude/agents/network-architect.md +196 -0
  18. package/.claude/agents/plan-reviewer.md +52 -0
  19. package/.claude/agents/refactor-planner.md +63 -0
  20. package/.claude/agents/security-scanner.md +102 -0
  21. package/.claude/agents/web-research-specialist.md +78 -0
  22. package/.claude/commands/cost-analysis.md +315 -0
  23. package/.claude/commands/dev-docs-update.md +55 -0
  24. package/.claude/commands/dev-docs.md +51 -0
  25. package/.claude/commands/incident-debug.md +247 -0
  26. package/.claude/commands/infra-plan.md +81 -0
  27. package/.claude/commands/migration-plan.md +478 -0
  28. package/.claude/commands/route-research-for-testing.md +37 -0
  29. package/.claude/commands/security-review.md +66 -0
  30. package/.claude/hooks/CONFIG.md +448 -0
  31. package/.claude/hooks/README.md +163 -0
  32. package/.claude/hooks/SKILL_ACTIVATION_COMPLETE.md +226 -0
  33. package/.claude/hooks/WINDOWS_HOOKS_README.md +151 -0
  34. package/.claude/hooks/add-skill-activation-banners.ts +132 -0
  35. package/.claude/hooks/comprehensive-skill-test.ts +1315 -0
  36. package/.claude/hooks/error-handling-reminder.sh +12 -0
  37. package/.claude/hooks/error-handling-reminder.ts +222 -0
  38. package/.claude/hooks/k8s-manifest-validator.sh +56 -0
  39. package/.claude/hooks/package-lock.json +556 -0
  40. package/.claude/hooks/package.json +16 -0
  41. package/.claude/hooks/post-tool-use-tracker.ps1 +174 -0
  42. package/.claude/hooks/post-tool-use-tracker.sh +183 -0
  43. package/.claude/hooks/security-policy-check.sh +247 -0
  44. package/.claude/hooks/skill-activation-prompt.ps1 +10 -0
  45. package/.claude/hooks/skill-activation-prompt.sh +10 -0
  46. package/.claude/hooks/skill-activation-prompt.ts +141 -0
  47. package/.claude/hooks/stop-build-check-enhanced.sh +130 -0
  48. package/.claude/hooks/terraform-validator.sh +53 -0
  49. package/.claude/hooks/test-input.json +7 -0
  50. package/.claude/hooks/test-skill-activation.ts +427 -0
  51. package/.claude/hooks/trigger-build-resolver.sh +79 -0
  52. package/.claude/hooks/tsc-check.sh +173 -0
  53. package/.claude/hooks/tsconfig.json +19 -0
  54. package/.claude/settings.json +55 -0
  55. package/.claude/settings.local.json +27 -14
  56. package/.claude/skills/README.md +507 -0
  57. package/.claude/skills/api-engineering/SKILL.md +63 -0
  58. package/.claude/skills/api-engineering/resources/api-versioning.md +88 -0
  59. package/.claude/skills/api-engineering/resources/graphql-patterns.md +106 -0
  60. package/.claude/skills/api-engineering/resources/rate-limiting.md +118 -0
  61. package/.claude/skills/api-engineering/resources/rest-api-design.md +105 -0
  62. package/.claude/skills/backend-dev-guidelines/SKILL.md +306 -0
  63. package/.claude/skills/backend-dev-guidelines/resources/architecture-overview.md +451 -0
  64. package/.claude/skills/backend-dev-guidelines/resources/async-and-errors.md +307 -0
  65. package/.claude/skills/backend-dev-guidelines/resources/complete-examples.md +638 -0
  66. package/.claude/skills/backend-dev-guidelines/resources/configuration.md +275 -0
  67. package/.claude/skills/backend-dev-guidelines/resources/database-patterns.md +224 -0
  68. package/.claude/skills/backend-dev-guidelines/resources/middleware-guide.md +213 -0
  69. package/.claude/skills/backend-dev-guidelines/resources/routing-and-controllers.md +756 -0
  70. package/.claude/skills/backend-dev-guidelines/resources/sentry-and-monitoring.md +336 -0
  71. package/.claude/skills/backend-dev-guidelines/resources/services-and-repositories.md +789 -0
  72. package/.claude/skills/backend-dev-guidelines/resources/testing-guide.md +235 -0
  73. package/.claude/skills/backend-dev-guidelines/resources/validation-patterns.md +754 -0
  74. package/.claude/skills/budget-and-cost-management/SKILL.md +850 -0
  75. package/.claude/skills/build-engineering/SKILL.md +431 -0
  76. package/.claude/skills/build-engineering/resources/artifact-repositories.md +72 -0
  77. package/.claude/skills/build-engineering/resources/build-caching.md +96 -0
  78. package/.claude/skills/build-engineering/resources/build-pipelines.md +105 -0
  79. package/.claude/skills/build-engineering/resources/build-security.md +95 -0
  80. package/.claude/skills/build-engineering/resources/build-systems.md +389 -0
  81. package/.claude/skills/build-engineering/resources/compilation-optimization.md +201 -0
  82. package/.claude/skills/build-engineering/resources/dependency-management.md +73 -0
  83. package/.claude/skills/build-engineering/resources/monorepo-builds.md +110 -0
  84. package/.claude/skills/build-engineering/resources/performance-optimization.md +113 -0
  85. package/.claude/skills/build-engineering/resources/reproducible-builds.md +82 -0
  86. package/.claude/skills/cloud-engineering/SKILL.md +675 -0
  87. package/.claude/skills/cloud-engineering/resources/aws-patterns.md +742 -0
  88. package/.claude/skills/cloud-engineering/resources/azure-patterns.md +714 -0
  89. package/.claude/skills/cloud-engineering/resources/cleared-cloud-environments.md +987 -0
  90. package/.claude/skills/cloud-engineering/resources/cloud-cost-optimization.md +757 -0
  91. package/.claude/skills/cloud-engineering/resources/cloud-networking.md +1058 -0
  92. package/.claude/skills/cloud-engineering/resources/cloud-security-tools.md +1530 -0
  93. package/.claude/skills/cloud-engineering/resources/cloud-security.md +990 -0
  94. package/.claude/skills/cloud-engineering/resources/gcp-patterns.md +758 -0
  95. package/.claude/skills/cloud-engineering/resources/migration-strategies.md +820 -0
  96. package/.claude/skills/cloud-engineering/resources/multi-cloud-strategies.md +670 -0
  97. package/.claude/skills/cloud-engineering/resources/oci-patterns.md +1198 -0
  98. package/.claude/skills/cloud-engineering/resources/serverless-patterns.md +795 -0
  99. package/.claude/skills/cloud-engineering/resources/well-architected-frameworks.md +966 -0
  100. package/.claude/skills/cybersecurity/SKILL.md +409 -0
  101. package/.claude/skills/cybersecurity/resources/security-architecture.md +266 -0
  102. package/.claude/skills/database-engineering/SKILL.md +61 -0
  103. package/.claude/skills/database-engineering/resources/backup-and-recovery.md +72 -0
  104. package/.claude/skills/database-engineering/resources/database-replication.md +63 -0
  105. package/.claude/skills/database-engineering/resources/postgresql-fundamentals.md +70 -0
  106. package/.claude/skills/database-engineering/resources/query-optimization.md +68 -0
  107. package/.claude/skills/devsecops/SKILL.md +374 -0
  108. package/.claude/skills/devsecops/resources/ci-cd-security.md +204 -0
  109. package/.claude/skills/devsecops/resources/compliance-automation.md +530 -0
  110. package/.claude/skills/devsecops/resources/compliance-frameworks.md +2322 -0
  111. package/.claude/skills/devsecops/resources/container-security.md +915 -0
  112. package/.claude/skills/devsecops/resources/cspm-integration.md +1440 -0
  113. package/.claude/skills/devsecops/resources/policy-enforcement.md +619 -0
  114. package/.claude/skills/devsecops/resources/secrets-management.md +755 -0
  115. package/.claude/skills/devsecops/resources/security-monitoring.md +146 -0
  116. package/.claude/skills/devsecops/resources/security-scanning.md +887 -0
  117. package/.claude/skills/devsecops/resources/security-testing.md +203 -0
  118. package/.claude/skills/devsecops/resources/supply-chain-security.md +518 -0
  119. package/.claude/skills/devsecops/resources/vulnerability-management.md +481 -0
  120. package/.claude/skills/devsecops/resources/zero-trust-architecture.md +177 -0
  121. package/.claude/skills/documentation-as-code/SKILL.md +323 -0
  122. package/.claude/skills/documentation-as-code/resources/api-documentation.md +90 -0
  123. package/.claude/skills/documentation-as-code/resources/changelog-management.md +79 -0
  124. package/.claude/skills/documentation-as-code/resources/diagram-generation.md +44 -0
  125. package/.claude/skills/documentation-as-code/resources/docs-as-code-workflow.md +99 -0
  126. package/.claude/skills/documentation-as-code/resources/documentation-automation.md +68 -0
  127. package/.claude/skills/documentation-as-code/resources/documentation-sites.md +79 -0
  128. package/.claude/skills/documentation-as-code/resources/markdown-best-practices.md +162 -0
  129. package/.claude/skills/documentation-as-code/resources/openapi-specification.md +77 -0
  130. package/.claude/skills/documentation-as-code/resources/readme-engineering.md +60 -0
  131. package/.claude/skills/documentation-as-code/resources/technical-writing-guide.md +202 -0
  132. package/.claude/skills/engineering-management/SKILL.md +356 -0
  133. package/.claude/skills/engineering-management/resources/career-ladders.md +609 -0
  134. package/.claude/skills/engineering-management/resources/hiring-and-assessment.md +555 -0
  135. package/.claude/skills/engineering-management/resources/one-on-one-guides.md +609 -0
  136. package/.claude/skills/engineering-management/resources/resource-planning.md +557 -0
  137. package/.claude/skills/engineering-management/resources/team-organization-patterns.md +491 -0
  138. package/.claude/skills/engineering-management/resources/technical-interviews.md +474 -0
  139. package/.claude/skills/engineering-operations-management/SKILL.md +817 -0
  140. package/.claude/skills/error-tracking/SKILL.md +379 -0
  141. package/.claude/skills/frontend-dev-guidelines/SKILL.md +403 -0
  142. package/.claude/skills/frontend-dev-guidelines/resources/common-patterns.md +331 -0
  143. package/.claude/skills/frontend-dev-guidelines/resources/complete-examples.md +872 -0
  144. package/.claude/skills/frontend-dev-guidelines/resources/component-patterns.md +502 -0
  145. package/.claude/skills/frontend-dev-guidelines/resources/data-fetching.md +767 -0
  146. package/.claude/skills/frontend-dev-guidelines/resources/file-organization.md +502 -0
  147. package/.claude/skills/frontend-dev-guidelines/resources/loading-and-error-states.md +501 -0
  148. package/.claude/skills/frontend-dev-guidelines/resources/performance.md +406 -0
  149. package/.claude/skills/frontend-dev-guidelines/resources/routing-guide.md +364 -0
  150. package/.claude/skills/frontend-dev-guidelines/resources/styling-guide.md +428 -0
  151. package/.claude/skills/frontend-dev-guidelines/resources/typescript-standards.md +418 -0
  152. package/.claude/skills/general-it-engineering/SKILL.md +393 -0
  153. package/.claude/skills/general-it-engineering/resources/asset-management.md +712 -0
  154. package/.claude/skills/general-it-engineering/resources/automation-orchestration.md +817 -0
  155. package/.claude/skills/general-it-engineering/resources/business-continuity.md +786 -0
  156. package/.claude/skills/general-it-engineering/resources/change-management.md +715 -0
  157. package/.claude/skills/general-it-engineering/resources/enterprise-monitoring.md +729 -0
  158. package/.claude/skills/general-it-engineering/resources/help-desk-operations.md +738 -0
  159. package/.claude/skills/general-it-engineering/resources/incident-service-management.md +834 -0
  160. package/.claude/skills/general-it-engineering/resources/it-governance.md +753 -0
  161. package/.claude/skills/general-it-engineering/resources/itil-framework.md +503 -0
  162. package/.claude/skills/general-it-engineering/resources/service-management.md +669 -0
  163. package/.claude/skills/infrastructure-architecture/SKILL.md +328 -0
  164. package/.claude/skills/infrastructure-architecture/resources/architecture-decision-records.md +505 -0
  165. package/.claude/skills/infrastructure-architecture/resources/architecture-patterns.md +528 -0
  166. package/.claude/skills/infrastructure-architecture/resources/capacity-planning.md +453 -0
  167. package/.claude/skills/infrastructure-architecture/resources/cleared-environment-architecture.md +773 -0
  168. package/.claude/skills/infrastructure-architecture/resources/cost-architecture.md +499 -0
  169. package/.claude/skills/infrastructure-architecture/resources/data-architecture.md +501 -0
  170. package/.claude/skills/infrastructure-architecture/resources/disaster-recovery.md +535 -0
  171. package/.claude/skills/infrastructure-architecture/resources/migration-architecture.md +512 -0
  172. package/.claude/skills/infrastructure-architecture/resources/multi-region-design.md +608 -0
  173. package/.claude/skills/infrastructure-architecture/resources/reference-architectures.md +562 -0
  174. package/.claude/skills/infrastructure-architecture/resources/security-architecture.md +538 -0
  175. package/.claude/skills/infrastructure-architecture/resources/system-design-principles.md +489 -0
  176. package/.claude/skills/infrastructure-architecture/resources/workload-classification.md +1000 -0
  177. package/.claude/skills/infrastructure-strategy/SKILL.md +924 -0
  178. package/.claude/skills/network-engineering/SKILL.md +385 -0
  179. package/.claude/skills/network-engineering/resources/dns-management.md +738 -0
  180. package/.claude/skills/network-engineering/resources/load-balancing.md +820 -0
  181. package/.claude/skills/network-engineering/resources/network-architecture.md +546 -0
  182. package/.claude/skills/network-engineering/resources/network-security.md +921 -0
  183. package/.claude/skills/network-engineering/resources/network-troubleshooting.md +749 -0
  184. package/.claude/skills/network-engineering/resources/routing-switching.md +373 -0
  185. package/.claude/skills/network-engineering/resources/sdn-networking.md +695 -0
  186. package/.claude/skills/network-engineering/resources/service-mesh-networking.md +777 -0
  187. package/.claude/skills/network-engineering/resources/tcp-ip-protocols.md +444 -0
  188. package/.claude/skills/network-engineering/resources/vpn-connectivity.md +672 -0
  189. package/.claude/skills/observability-engineering/SKILL.md +101 -0
  190. package/.claude/skills/observability-engineering/resources/apm-tools.md +97 -0
  191. package/.claude/skills/observability-engineering/resources/correlation-strategies.md +87 -0
  192. package/.claude/skills/observability-engineering/resources/distributed-tracing.md +98 -0
  193. package/.claude/skills/observability-engineering/resources/logs-aggregation.md +118 -0
  194. package/.claude/skills/observability-engineering/resources/observability-cost-optimization.md +141 -0
  195. package/.claude/skills/observability-engineering/resources/opentelemetry.md +110 -0
  196. package/.claude/skills/platform-engineering/SKILL.md +555 -0
  197. package/.claude/skills/platform-engineering/resources/architecture-overview.md +600 -0
  198. package/.claude/skills/platform-engineering/resources/container-orchestration.md +916 -0
  199. package/.claude/skills/platform-engineering/resources/cost-optimization.md +634 -0
  200. package/.claude/skills/platform-engineering/resources/developer-platforms.md +670 -0
  201. package/.claude/skills/platform-engineering/resources/gitops-automation.md +650 -0
  202. package/.claude/skills/platform-engineering/resources/infrastructure-as-code.md +778 -0
  203. package/.claude/skills/platform-engineering/resources/infrastructure-standards.md +708 -0
  204. package/.claude/skills/platform-engineering/resources/multi-tenancy.md +602 -0
  205. package/.claude/skills/platform-engineering/resources/platform-security.md +711 -0
  206. package/.claude/skills/platform-engineering/resources/resource-management.md +592 -0
  207. package/.claude/skills/platform-engineering/resources/service-mesh.md +628 -0
  208. package/.claude/skills/release-engineering/SKILL.md +393 -0
  209. package/.claude/skills/release-engineering/resources/artifact-management.md +108 -0
  210. package/.claude/skills/release-engineering/resources/build-optimization.md +84 -0
  211. package/.claude/skills/release-engineering/resources/ci-cd-pipelines.md +411 -0
  212. package/.claude/skills/release-engineering/resources/deployment-strategies.md +197 -0
  213. package/.claude/skills/release-engineering/resources/pipeline-security.md +62 -0
  214. package/.claude/skills/release-engineering/resources/progressive-delivery.md +83 -0
  215. package/.claude/skills/release-engineering/resources/release-automation.md +68 -0
  216. package/.claude/skills/release-engineering/resources/release-orchestration.md +77 -0
  217. package/.claude/skills/release-engineering/resources/rollback-strategies.md +66 -0
  218. package/.claude/skills/release-engineering/resources/versioning-strategies.md +59 -0
  219. package/.claude/skills/route-tester/SKILL.md +392 -0
  220. package/.claude/skills/skill-developer/ADVANCED.md +197 -0
  221. package/.claude/skills/skill-developer/HOOK_MECHANISMS.md +306 -0
  222. package/.claude/skills/skill-developer/PATTERNS_LIBRARY.md +152 -0
  223. package/.claude/skills/skill-developer/SKILL.md +430 -0
  224. package/.claude/skills/skill-developer/SKILL_RULES_REFERENCE.md +315 -0
  225. package/.claude/skills/skill-developer/TRIGGER_TYPES.md +305 -0
  226. package/.claude/skills/skill-developer/TROUBLESHOOTING.md +514 -0
  227. package/.claude/skills/skill-rules.json +2940 -0
  228. package/.claude/skills/sre/SKILL.md +464 -0
  229. package/.claude/skills/sre/resources/alerting-best-practices.md +282 -0
  230. package/.claude/skills/sre/resources/capacity-planning.md +226 -0
  231. package/.claude/skills/sre/resources/chaos-engineering.md +193 -0
  232. package/.claude/skills/sre/resources/disaster-recovery.md +232 -0
  233. package/.claude/skills/sre/resources/incident-management.md +436 -0
  234. package/.claude/skills/sre/resources/observability-stack.md +240 -0
  235. package/.claude/skills/sre/resources/on-call-runbooks.md +167 -0
  236. package/.claude/skills/sre/resources/performance-optimization.md +108 -0
  237. package/.claude/skills/sre/resources/reliability-patterns.md +183 -0
  238. package/.claude/skills/sre/resources/slo-sli-sla.md +464 -0
  239. package/.claude/skills/sre/resources/toil-reduction.md +145 -0
  240. package/.claude/skills/systems-engineering/SKILL.md +648 -0
  241. package/.claude/skills/systems-engineering/resources/automation-patterns.md +771 -0
  242. package/.claude/skills/systems-engineering/resources/configuration-management.md +998 -0
  243. package/.claude/skills/systems-engineering/resources/linux-administration.md +672 -0
  244. package/.claude/skills/systems-engineering/resources/networking-fundamentals.md +982 -0
  245. package/.claude/skills/systems-engineering/resources/performance-tuning.md +871 -0
  246. package/.claude/skills/systems-engineering/resources/powershell-scripting.md +482 -0
  247. package/.claude/skills/systems-engineering/resources/security-hardening.md +739 -0
  248. package/.claude/skills/systems-engineering/resources/shell-scripting.md +915 -0
  249. package/.claude/skills/systems-engineering/resources/storage-management.md +628 -0
  250. package/.claude/skills/systems-engineering/resources/system-monitoring.md +787 -0
  251. package/.claude/skills/systems-engineering/resources/troubleshooting-guide.md +753 -0
  252. package/.claude/skills/systems-engineering/resources/windows-administration.md +738 -0
  253. package/.claude/skills/technical-leadership/SKILL.md +728 -0
  254. package/CHANGELOG.md +90 -54
  255. package/README.md +94 -0
  256. package/backend/docs/SECRETS_DOCUMENTATION.md +327 -0
  257. package/backend/jest.config.js +59 -0
  258. package/backend/package-lock.json +6129 -0
  259. package/backend/package.json +16 -4
  260. package/backend/prisma/migrations/20251026104609_add_websocket_api/migration.sql +33 -0
  261. package/backend/prisma/schema.prisma +33 -0
  262. package/backend/src/__tests__/core/DependencyService.test.js +336 -0
  263. package/backend/src/__tests__/core/UserService.test.js +875 -0
  264. package/backend/src/__tests__/repositories/BaseRepository.test.js +146 -0
  265. package/backend/src/__tests__/repositories/BotRepository.test.js +118 -0
  266. package/backend/src/__tests__/repositories/CommandRepository.test.js +132 -0
  267. package/backend/src/__tests__/repositories/EventGraphRepository.test.js +93 -0
  268. package/backend/src/__tests__/repositories/GroupRepository.test.js +155 -0
  269. package/backend/src/__tests__/repositories/PermissionRepository.test.js +130 -0
  270. package/backend/src/__tests__/repositories/PluginRepository.test.js +107 -0
  271. package/backend/src/__tests__/repositories/ServerRepository.test.js +80 -0
  272. package/backend/src/__tests__/repositories/UserRepository.test.js +128 -0
  273. package/backend/src/__tests__/secretsFilter.test.js +425 -0
  274. package/backend/src/__tests__/services/BotLifecycleService.test.js +411 -0
  275. package/backend/src/__tests__/services/BotProcessManager.test.js +285 -0
  276. package/backend/src/__tests__/services/CacheManager.test.js +125 -0
  277. package/backend/src/__tests__/services/CommandExecutionService.test.js +460 -0
  278. package/backend/src/__tests__/services/ResourceMonitorService.test.js +207 -0
  279. package/backend/src/__tests__/services/TelemetryService.test.js +291 -0
  280. package/backend/src/__tests__/setup.js +25 -0
  281. package/backend/src/api/routes/apiKeys.js +181 -0
  282. package/backend/src/api/routes/bots.js +49 -7
  283. package/backend/src/api/routes/plugins.js +2 -1
  284. package/backend/src/api/routes/system.js +174 -0
  285. package/backend/src/container.js +82 -0
  286. package/backend/src/core/BotManager.js +142 -871
  287. package/backend/src/core/BotManager.old.js +1093 -0
  288. package/backend/src/core/BotProcess.js +1092 -858
  289. package/backend/src/core/EventGraphManager.js +280 -198
  290. package/backend/src/core/GraphExecutionEngine.js +321 -325
  291. package/backend/src/core/MessageQueue.js +27 -6
  292. package/backend/src/core/NodeRegistry.js +37 -1134
  293. package/backend/src/core/PluginManager.js +62 -12
  294. package/backend/src/core/PrismaService.js +32 -0
  295. package/backend/src/core/UserService.js +3 -3
  296. package/backend/src/core/__tests__/PrismaService.test.js +24 -0
  297. package/backend/src/core/commands/README.md +305 -0
  298. package/backend/src/core/commands/dev.js +13 -7
  299. package/backend/src/core/commands/ping.js +10 -4
  300. package/backend/src/core/commands/whois.js +63 -0
  301. package/backend/src/core/config/validation.js +27 -0
  302. package/backend/src/core/constants/graphTypes.js +21 -0
  303. package/backend/src/core/node-registries/actions.js +132 -0
  304. package/backend/src/core/node-registries/arrays.js +137 -0
  305. package/backend/src/core/node-registries/bot.js +23 -0
  306. package/backend/src/core/node-registries/data.js +290 -0
  307. package/backend/src/core/node-registries/debug.js +26 -0
  308. package/backend/src/core/node-registries/events.js +187 -0
  309. package/backend/src/core/node-registries/flow.js +139 -0
  310. package/backend/src/core/node-registries/logic.js +45 -0
  311. package/backend/src/core/node-registries/math.js +42 -0
  312. package/backend/src/core/node-registries/objects.js +98 -0
  313. package/backend/src/core/node-registries/strings.js +153 -0
  314. package/backend/src/core/node-registries/time.js +113 -0
  315. package/backend/src/core/node-registries/users.js +79 -0
  316. package/backend/src/core/nodes/{action_bot_look_at.js → actions/bot_look_at.js} +36 -36
  317. package/backend/src/core/nodes/{action_bot_set_variable.js → actions/bot_set_variable.js} +32 -32
  318. package/backend/src/core/nodes/{action_send_log.js → actions/send_log.js} +28 -23
  319. package/backend/src/core/nodes/{action_send_message.js → actions/send_message.js} +32 -32
  320. package/backend/src/core/nodes/actions/send_websocket_response.js +33 -0
  321. package/backend/src/core/nodes/arrays/get_next.js +35 -0
  322. package/backend/src/core/nodes/{data_cast.js → data/cast.js} +8 -0
  323. package/backend/src/core/nodes/data/datetime_literal.js +27 -0
  324. package/backend/src/core/nodes/data/entity_info.js +69 -0
  325. package/backend/src/core/nodes/data/get_nearby_entities.js +32 -0
  326. package/backend/src/core/nodes/data/get_nearby_players.js +64 -0
  327. package/backend/src/core/nodes/{data_get_user_field.js → data/get_user_field.js} +1 -1
  328. package/backend/src/core/nodes/data/type_check.js +53 -0
  329. package/backend/src/core/nodes/{debug_log.js → debug/log.js} +16 -16
  330. package/backend/src/core/nodes/{flow_branch.js → flow/branch.js} +15 -15
  331. package/backend/src/core/nodes/{flow_break.js → flow/break.js} +14 -14
  332. package/backend/src/core/nodes/flow/delay.js +43 -0
  333. package/backend/src/core/nodes/{flow_for_each.js → flow/for_each.js} +39 -39
  334. package/backend/src/core/nodes/{flow_sequence.js → flow/sequence.js} +16 -16
  335. package/backend/src/core/nodes/{flow_switch.js → flow/switch.js} +47 -47
  336. package/backend/src/core/nodes/{flow_while.js → flow/while.js} +1 -1
  337. package/backend/src/core/nodes/logic/__tests__/compare.test.js +83 -0
  338. package/backend/src/core/nodes/math/__tests__/operation.test.js +65 -0
  339. package/backend/src/core/nodes/strings/__tests__/concat.test.js +89 -0
  340. package/backend/src/core/nodes/time/__tests__/now.test.js +24 -0
  341. package/backend/src/core/nodes/time/add.js +33 -0
  342. package/backend/src/core/nodes/time/compare.js +35 -0
  343. package/backend/src/core/nodes/time/diff.js +29 -0
  344. package/backend/src/core/nodes/time/format.js +32 -0
  345. package/backend/src/core/nodes/time/now.js +18 -0
  346. package/backend/src/core/nodes/{user_check_blacklist.js → users/check_blacklist.js} +37 -37
  347. package/backend/src/core/nodes/{user_get_groups.js → users/get_groups.js} +36 -36
  348. package/backend/src/core/nodes/{user_get_permissions.js → users/get_permissions.js} +36 -36
  349. package/backend/src/core/nodes/{user_set_blacklist.js → users/set_blacklist.js} +37 -37
  350. package/backend/src/core/services/BotLifecycleService.js +596 -0
  351. package/backend/src/core/services/BotProcessManager.js +163 -0
  352. package/backend/src/core/services/CacheManager.js +111 -0
  353. package/backend/src/core/services/CommandExecutionService.js +351 -0
  354. package/backend/src/core/services/ResourceMonitorService.js +90 -0
  355. package/backend/src/core/services/TelemetryService.js +124 -0
  356. package/backend/src/core/services/ValidationService.js +132 -0
  357. package/backend/src/core/services/__tests__/ValidationService.test.js +148 -0
  358. package/backend/src/core/services.js +20 -5
  359. package/backend/src/core/system/CommandContext.js +84 -0
  360. package/backend/src/core/system/Transport.js +78 -0
  361. package/backend/src/core/utils/__tests__/jsonParser.test.js +44 -0
  362. package/backend/src/core/utils/jsonParser.js +18 -0
  363. package/backend/src/core/utils/secretsFilter.js +262 -0
  364. package/backend/src/core/utils/variableParser.js +89 -0
  365. package/backend/src/core/validation/__tests__/nodeSchemas.test.js +175 -0
  366. package/backend/src/core/validation/nodeSchemas.js +112 -0
  367. package/backend/src/lib/prisma.js +2 -4
  368. package/backend/src/real-time/botApi/handlers/commandHandlers.js +28 -0
  369. package/backend/src/real-time/botApi/handlers/graphHandlers.js +99 -0
  370. package/backend/src/real-time/botApi/handlers/graphWebSocketHandlers.js +147 -0
  371. package/backend/src/real-time/botApi/handlers/index.js +43 -0
  372. package/backend/src/real-time/botApi/handlers/messageHandlers.js +66 -0
  373. package/backend/src/real-time/botApi/handlers/statusHandlers.js +17 -0
  374. package/backend/src/real-time/botApi/handlers/userHandlers.js +141 -0
  375. package/backend/src/real-time/botApi/index.js +40 -0
  376. package/backend/src/real-time/botApi/middleware.js +79 -0
  377. package/backend/src/real-time/botApi/utils.js +54 -0
  378. package/backend/src/real-time/socketHandler.js +6 -2
  379. package/backend/src/repositories/BaseRepository.js +43 -0
  380. package/backend/src/repositories/BotRepository.js +42 -0
  381. package/backend/src/repositories/CommandRepository.js +53 -0
  382. package/backend/src/repositories/EventGraphRepository.js +40 -0
  383. package/backend/src/repositories/GroupRepository.js +69 -0
  384. package/backend/src/repositories/PermissionRepository.js +48 -0
  385. package/backend/src/repositories/PluginRepository.js +42 -0
  386. package/backend/src/repositories/ServerRepository.js +27 -0
  387. package/backend/src/repositories/UserRepository.js +48 -0
  388. package/backend/src/server.js +3 -0
  389. package/backend/src/test-refactor.js +85 -0
  390. package/frontend/dist/assets/index-CfTo92bP.css +1 -0
  391. package/frontend/dist/assets/index-CiFD5X9Z.js +8344 -0
  392. package/frontend/dist/index.html +2 -2
  393. package/frontend/package.json +0 -5
  394. package/package.json +2 -1
  395. package/frontend/dist/assets/index-B9GedHEa.js +0 -8352
  396. package/frontend/dist/assets/index-zLiy9MDx.css +0 -1
  397. package/nul +0 -0
  398. /package/backend/src/core/nodes/{action_http_request.js → actions/http_request.js} +0 -0
  399. /package/backend/src/core/nodes/{array_add_element.js → arrays/add_element.js} +0 -0
  400. /package/backend/src/core/nodes/{array_contains.js → arrays/contains.js} +0 -0
  401. /package/backend/src/core/nodes/{array_find_index.js → arrays/find_index.js} +0 -0
  402. /package/backend/src/core/nodes/{array_get_by_index.js → arrays/get_by_index.js} +0 -0
  403. /package/backend/src/core/nodes/{array_get_random_element.js → arrays/get_random_element.js} +0 -0
  404. /package/backend/src/core/nodes/{array_remove_by_index.js → arrays/remove_by_index.js} +0 -0
  405. /package/backend/src/core/nodes/{bot_get_position.js → bot/get_position.js} +0 -0
  406. /package/backend/src/core/nodes/{data_array_literal.js → data/array_literal.js} +0 -0
  407. /package/backend/src/core/nodes/{data_boolean_literal.js → data/boolean_literal.js} +0 -0
  408. /package/backend/src/core/nodes/{data_get_argument.js → data/get_argument.js} +0 -0
  409. /package/backend/src/core/nodes/{data_get_bot_look.js → data/get_bot_look.js} +0 -0
  410. /package/backend/src/core/nodes/{data_get_entity_field.js → data/get_entity_field.js} +0 -0
  411. /package/backend/src/core/nodes/{data_get_server_players.js → data/get_server_players.js} +0 -0
  412. /package/backend/src/core/nodes/{data_get_variable.js → data/get_variable.js} +0 -0
  413. /package/backend/src/core/nodes/{data_length.js → data/length.js} +0 -0
  414. /package/backend/src/core/nodes/{data_make_object.js → data/make_object.js} +0 -0
  415. /package/backend/src/core/nodes/{data_number_literal.js → data/number_literal.js} +0 -0
  416. /package/backend/src/core/nodes/{data_string_literal.js → data/string_literal.js} +0 -0
  417. /package/backend/src/core/nodes/{logic_compare.js → logic/compare.js} +0 -0
  418. /package/backend/src/core/nodes/{logic_operation.js → logic/operation.js} +0 -0
  419. /package/backend/src/core/nodes/{math_operation.js → math/operation.js} +0 -0
  420. /package/backend/src/core/nodes/{math_random_number.js → math/random_number.js} +0 -0
  421. /package/backend/src/core/nodes/{object_create.js → objects/create.js} +0 -0
  422. /package/backend/src/core/nodes/{object_delete.js → objects/delete.js} +0 -0
  423. /package/backend/src/core/nodes/{object_get.js → objects/get.js} +0 -0
  424. /package/backend/src/core/nodes/{object_has_key.js → objects/has_key.js} +0 -0
  425. /package/backend/src/core/nodes/{object_set.js → objects/set.js} +0 -0
  426. /package/backend/src/core/nodes/{string_concat.js → strings/concat.js} +0 -0
  427. /package/backend/src/core/nodes/{string_contains.js → strings/contains.js} +0 -0
  428. /package/backend/src/core/nodes/{string_ends_with.js → strings/ends_with.js} +0 -0
  429. /package/backend/src/core/nodes/{string_equals.js → strings/equals.js} +0 -0
  430. /package/backend/src/core/nodes/{string_length.js → strings/length.js} +0 -0
  431. /package/backend/src/core/nodes/{string_matches.js → strings/matches.js} +0 -0
  432. /package/backend/src/core/nodes/{string_split.js → strings/split.js} +0 -0
  433. /package/backend/src/core/nodes/{string_starts_with.js → strings/starts_with.js} +0 -0
@@ -0,0 +1,444 @@
1
+ # TCP/IP Protocols
2
+
3
+ Comprehensive guide to TCP/IP protocols covering OSI model, TCP/UDP, IP addressing, subnetting, CIDR, routing protocols, and packet flow analysis.
4
+
5
+ ## OSI and TCP/IP Models
6
+
7
+ ### Layer Comparison
8
+
9
+ ```
10
+ OSI Model TCP/IP Model Protocols/Examples
11
+ ─────────────────────────────────────────────────────────
12
+ 7. Application ┐
13
+ 6. Presentation │→ Application HTTP, HTTPS, FTP, SSH,
14
+ 5. Session ┘ DNS, SMTP, TLS
15
+
16
+ 4. Transport → Transport TCP, UDP, SCTP
17
+
18
+ 3. Network → Internet IP, ICMP, IGMP, IPsec
19
+
20
+ 2. Data Link ┐
21
+ 1. Physical ┘→ Network Access Ethernet, WiFi, ARP
22
+ ```
23
+
24
+ ## Transport Layer Protocols
25
+
26
+ ### TCP (Transmission Control Protocol)
27
+
28
+ **Characteristics:**
29
+ - Connection-oriented
30
+ - Reliable delivery (acknowledgments)
31
+ - Ordered delivery
32
+ - Flow control
33
+ - Congestion control
34
+
35
+ **Three-Way Handshake:**
36
+ ```
37
+ Client Server
38
+ │ │
39
+ │──── SYN ───────────→│ (Sequence = X)
40
+ │ │
41
+ │←─── SYN-ACK ───────│ (Sequence = Y, Ack = X+1)
42
+ │ │
43
+ │──── ACK ───────────→│ (Ack = Y+1)
44
+ │ │
45
+ │ Connection Open │
46
+ ```
47
+
48
+ **TCP Header:**
49
+ ```
50
+ 0 1 2 3
51
+ 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
52
+ ├───────────────────────────────────────────────────────────────┤
53
+ │ Source Port │ Destination Port │
54
+ ├───────────────────────────────────────────────────────────────┤
55
+ │ Sequence Number │
56
+ ├───────────────────────────────────────────────────────────────┤
57
+ │ Acknowledgment Number │
58
+ ├───────┬───┬───────┬───────────────────────────────────────────┤
59
+ │Offset │Res│ Flags │ Window Size │
60
+ ├───────┴───┴───────┼───────────────────────────────────────────┤
61
+ │ Checksum │ Urgent Pointer │
62
+ └───────────────────┴───────────────────────────────────────────┘
63
+
64
+ Flags: URG, ACK, PSH, RST, SYN, FIN
65
+ ```
66
+
67
+ ### UDP (User Datagram Protocol)
68
+
69
+ **Characteristics:**
70
+ - Connectionless
71
+ - No reliability guarantees
72
+ - No ordering
73
+ - Low overhead
74
+ - Fast
75
+
76
+ **UDP Header (8 bytes):**
77
+ ```
78
+ 0 7 8 15 16 23 24 31
79
+ ├────────┼────────┼────────┼────────┤
80
+ │ Source │ Dest │ Length │Checksum│
81
+ │ Port │ Port │ │ │
82
+ └────────┴────────┴────────┴────────┘
83
+ ```
84
+
85
+ **Use Cases:**
86
+ - DNS queries
87
+ - Video streaming (loss acceptable)
88
+ - Gaming (low latency critical)
89
+ - VoIP
90
+ - IoT sensors
91
+
92
+ ## Network Layer (IP)
93
+
94
+ ### IPv4
95
+
96
+ **IPv4 Address:**
97
+ ```
98
+ Format: 32 bits (4 octets)
99
+ Example: 192.168.1.100
100
+ Binary: 11000000.10101000.00000001.01100100
101
+ ```
102
+
103
+ **IPv4 Classes:**
104
+ ```
105
+ Class A: 0.0.0.0 - 127.255.255.255 (/8) 16M hosts
106
+ Class B: 128.0.0.0 - 191.255.255.255 (/16) 65K hosts
107
+ Class C: 192.0.0.0 - 223.255.255.255 (/24) 254 hosts
108
+ Class D: 224.0.0.0 - 239.255.255.255 (Multicast)
109
+ Class E: 240.0.0.0 - 255.255.255.255 (Reserved)
110
+ ```
111
+
112
+ **Private IP Ranges (RFC 1918):**
113
+ ```
114
+ 10.0.0.0 - 10.255.255.255 (10.0.0.0/8) 16M IPs
115
+ 172.16.0.0 - 172.31.255.255 (172.16.0.0/12) 1M IPs
116
+ 192.168.0.0 - 192.168.255.255 (192.168.0.0/16) 65K IPs
117
+ ```
118
+
119
+ ### IPv6
120
+
121
+ **IPv6 Address:**
122
+ ```
123
+ Format: 128 bits (8 groups of 4 hex digits)
124
+ Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
125
+
126
+ Compressed: 2001:db8:85a3::8a2e:370:7334
127
+ (Leading zeros omitted, :: replaces consecutive zeros)
128
+ ```
129
+
130
+ **IPv6 Types:**
131
+ ```
132
+ Global Unicast: 2000::/3 (Internet routable)
133
+ Link-Local: fe80::/10 (Local network only)
134
+ Unique Local: fc00::/7 (Private, like RFC 1918)
135
+ Multicast: ff00::/8
136
+ Loopback: ::1/128
137
+ Unspecified: ::/128
138
+ ```
139
+
140
+ ## Subnetting and CIDR
141
+
142
+ ### Subnet Mask
143
+
144
+ ```
145
+ Subnet Mask: 255.255.255.0 = /24
146
+ Binary: 11111111.11111111.11111111.00000000
147
+
148
+ Network portion: First 24 bits
149
+ Host portion: Last 8 bits
150
+ Total hosts: 2^8 - 2 = 254 usable
151
+ ```
152
+
153
+ ### CIDR Notation
154
+
155
+ ```
156
+ CIDR Subnet Mask Hosts Subnet Count
157
+ /8 255.0.0.0 16,777,214 1
158
+ /16 255.255.0.0 65,534 256
159
+ /24 255.255.255.0 254 65,536
160
+ /25 255.255.255.128 126 131,072
161
+ /26 255.255.255.192 62 262,144
162
+ /27 255.255.255.224 30 524,288
163
+ /28 255.255.255.240 14 1,048,576
164
+ /29 255.255.255.248 6 2,097,152
165
+ /30 255.255.255.252 2 4,194,304
166
+ /32 255.255.255.255 1 (host) -
167
+ ```
168
+
169
+ ### Subnetting Example
170
+
171
+ **Subnet 192.168.1.0/24 into 4 equal subnets:**
172
+ ```
173
+ Original: 192.168.1.0/24 (254 hosts)
174
+ New mask: /26 (2 borrowed bits, 2^2 = 4 subnets)
175
+
176
+ Subnet 1: 192.168.1.0/26 (192.168.1.1 - 192.168.1.62)
177
+ Subnet 2: 192.168.1.64/26 (192.168.1.65 - 192.168.1.126)
178
+ Subnet 3: 192.168.1.128/26 (192.168.1.129 - 192.168.1.190)
179
+ Subnet 4: 192.168.1.192/26 (192.168.1.193 - 192.168.1.254)
180
+
181
+ Each subnet: 64 IPs (62 usable)
182
+ ```
183
+
184
+ ### VLSM (Variable Length Subnet Mask)
185
+
186
+ ```
187
+ Network: 192.168.1.0/24
188
+
189
+ Requirements:
190
+ - Sales: 100 hosts → /25 (126 hosts)
191
+ - IT: 50 hosts → /26 (62 hosts)
192
+ - HR: 20 hosts → /27 (30 hosts)
193
+ - Mgmt: 10 hosts → /28 (14 hosts)
194
+
195
+ Allocation:
196
+ Sales: 192.168.1.0/25 (192.168.1.0 - 192.168.1.127)
197
+ IT: 192.168.1.128/26 (192.168.1.128 - 192.168.1.191)
198
+ HR: 192.168.1.192/27 (192.168.1.192 - 192.168.1.223)
199
+ Mgmt: 192.168.1.224/28 (192.168.1.224 - 192.168.1.239)
200
+ ```
201
+
202
+ ## ICMP (Internet Control Message Protocol)
203
+
204
+ ### Common ICMP Types
205
+
206
+ ```
207
+ Type 0: Echo Reply (Ping response)
208
+ Type 3: Destination Unreachable
209
+ Type 5: Redirect
210
+ Type 8: Echo Request (Ping)
211
+ Type 11: Time Exceeded (TTL=0)
212
+ Type 30: Traceroute
213
+ ```
214
+
215
+ ### Ping Example
216
+
217
+ ```bash
218
+ $ ping -c 4 8.8.8.8
219
+
220
+ PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
221
+ 64 bytes from 8.8.8.8: icmp_seq=1 ttl=117 time=12.3 ms
222
+ 64 bytes from 8.8.8.8: icmp_seq=2 ttl=117 time=11.8 ms
223
+ 64 bytes from 8.8.8.8: icmp_seq=3 ttl=117 time=12.1 ms
224
+ 64 bytes from 8.8.8.8: icmp_seq=4 ttl=117 time=12.0 ms
225
+
226
+ --- 8.8.8.8 ping statistics ---
227
+ 4 packets transmitted, 4 received, 0% packet loss, time 3004ms
228
+ rtt min/avg/max/mdev = 11.849/12.050/12.301/0.174 ms
229
+ ```
230
+
231
+ ### Traceroute
232
+
233
+ ```bash
234
+ $ traceroute google.com
235
+
236
+ 1 gateway (192.168.1.1) 1.234 ms
237
+ 2 10.0.0.1 (10.0.0.1) 8.456 ms
238
+ 3 isp-router.net (203.0.113.1) 12.789 ms
239
+ 4 * * * (timeout)
240
+ 5 google-peer.net (172.217.1.1) 15.234 ms
241
+ 6 google.com (142.250.185.46) 16.123 ms
242
+ ```
243
+
244
+ ## Routing Protocols
245
+
246
+ ### Static Routing
247
+
248
+ ```bash
249
+ # Linux
250
+ ip route add 10.0.2.0/24 via 10.0.1.1
251
+
252
+ # Cisco
253
+ ip route 10.0.2.0 255.255.255.0 10.0.1.1
254
+
255
+ # Default route
256
+ ip route add default via 192.168.1.1
257
+ ```
258
+
259
+ ### Dynamic Routing Protocols
260
+
261
+ **RIP (Routing Information Protocol):**
262
+ - Distance vector protocol
263
+ - Metric: Hop count (max 15)
264
+ - Updates every 30 seconds
265
+ - Legacy, rarely used
266
+
267
+ **OSPF (Open Shortest Path First):**
268
+ - Link-state protocol
269
+ - Metric: Cost (based on bandwidth)
270
+ - Fast convergence
271
+ - Scalable (areas)
272
+ - Widely used in enterprises
273
+
274
+ **BGP (Border Gateway Protocol):**
275
+ - Path vector protocol
276
+ - Metric: AS path, policies
277
+ - Internet routing protocol
278
+ - Scalable to internet size
279
+
280
+ ### OSPF Areas
281
+
282
+ ```
283
+ ┌────────────────────────────────────┐
284
+ │ Backbone Area 0 │
285
+ │ (All routers) │
286
+ └──────┬─────────┬──────────┬────────┘
287
+ │ │ │
288
+ ┌───▼───┐ ┌───▼───┐ ┌───▼───┐
289
+ │Area 1 │ │Area 2 │ │Area 3 │
290
+ │ │ │ │ │ │
291
+ └───────┘ └───────┘ └───────┘
292
+ ```
293
+
294
+ ## Packet Flow Analysis
295
+
296
+ ### TCP Packet Capture
297
+
298
+ ```bash
299
+ # Capture with tcpdump
300
+ sudo tcpdump -i eth0 -nn port 80
301
+
302
+ # Sample output
303
+ 12:34:56.789012 IP 192.168.1.100.51234 > 93.184.216.34.80: Flags [S], seq 123456, win 65535
304
+ 12:34:56.801234 IP 93.184.216.34.80 > 192.168.1.100.51234: Flags [S.], seq 789012, ack 123457, win 65535
305
+ 12:34:56.801456 IP 192.168.1.100.51234 > 93.184.216.34.80: Flags [.], ack 789013, win 65535
306
+ 12:34:56.801678 IP 192.168.1.100.51234 > 93.184.216.34.80: Flags [P.], seq 123457:123557
307
+ ```
308
+
309
+ ### HTTP Request Flow
310
+
311
+ ```
312
+ 1. DNS Resolution
313
+ Client → DNS Server: "What is example.com?"
314
+ DNS Server → Client: "93.184.216.34"
315
+
316
+ 2. TCP Handshake
317
+ Client → Server: SYN
318
+ Server → Client: SYN-ACK
319
+ Client → Server: ACK
320
+
321
+ 3. HTTP Request
322
+ Client → Server: GET / HTTP/1.1
323
+ Host: example.com
324
+
325
+ 4. HTTP Response
326
+ Server → Client: HTTP/1.1 200 OK
327
+ Content-Type: text/html
328
+ <html>...</html>
329
+
330
+ 5. Connection Close
331
+ Client → Server: FIN
332
+ Server → Client: ACK
333
+ Server → Client: FIN
334
+ Client → Server: ACK
335
+ ```
336
+
337
+ ## Network Address Translation (NAT)
338
+
339
+ ### NAT Types
340
+
341
+ **SNAT (Source NAT):**
342
+ ```
343
+ Internal → External
344
+ 10.0.1.5:12345 → 203.0.113.1:54321
345
+ (Private IP → Public IP)
346
+ ```
347
+
348
+ **DNAT (Destination NAT / Port Forwarding):**
349
+ ```
350
+ External → Internal
351
+ 203.0.113.1:80 → 10.0.1.10:8080
352
+ (Public → Private web server)
353
+ ```
354
+
355
+ **PAT (Port Address Translation):**
356
+ ```
357
+ Multiple internal hosts share one public IP
358
+ 10.0.1.5:12345 → 203.0.113.1:54321
359
+ 10.0.1.6:12346 → 203.0.113.1:54322
360
+ 10.0.1.7:12347 → 203.0.113.1:54323
361
+ ```
362
+
363
+ ## Quality of Service (QoS)
364
+
365
+ ### DSCP (Differentiated Services Code Point)
366
+
367
+ ```
368
+ ToS Field in IP Header (8 bits)
369
+ ┌──────────┬────┐
370
+ │ DSCP (6) │ECN │
371
+ └──────────┴────┘
372
+
373
+ DSCP Values:
374
+ EF (Expedited Forwarding): 46 - VoIP, real-time
375
+ AF41 (Assured Forwarding): 34 - Video
376
+ AF31: 26 - High-priority data
377
+ BE (Best Effort): 0 - Default
378
+ ```
379
+
380
+ ### Traffic Shaping
381
+
382
+ ```bash
383
+ # Linux tc (traffic control)
384
+ tc qdisc add dev eth0 root tbf rate 1mbit burst 32kbit latency 400ms
385
+
386
+ # Prioritize SSH traffic
387
+ tc filter add dev eth0 protocol ip parent 1:0 prio 1 u32 \
388
+ match ip dport 22 0xffff flowid 1:1
389
+ ```
390
+
391
+ ## Protocol Encapsulation
392
+
393
+ ### Packet Structure
394
+
395
+ ```
396
+ ┌─────────────────────────────────────┐
397
+ │ Ethernet Header (14 bytes) │
398
+ ├─────────────────────────────────────┤
399
+ │ IP Header (20+ bytes) │
400
+ ├─────────────────────────────────────┤
401
+ │ TCP Header (20+ bytes) │
402
+ ├─────────────────────────────────────┤
403
+ │ Application Data │
404
+ └─────────────────────────────────────┘
405
+
406
+ MTU: 1500 bytes (Ethernet)
407
+ MSS: 1460 bytes (MTU - IP - TCP headers)
408
+ ```
409
+
410
+ ### Tunneling Protocols
411
+
412
+ **GRE (Generic Routing Encapsulation):**
413
+ ```
414
+ ┌──────────┐
415
+ │ Outer IP │
416
+ ├──────────┤
417
+ │ GRE │
418
+ ├──────────┤
419
+ │ Inner IP │
420
+ ├──────────┤
421
+ │ Data │
422
+ └──────────┘
423
+ ```
424
+
425
+ **IPsec:**
426
+ ```
427
+ Transport Mode:
428
+ ┌──────────┬─────────┬──────────┐
429
+ │ IP Header│ESP/AH │ Payload │
430
+ └──────────┴─────────┴──────────┘
431
+
432
+ Tunnel Mode:
433
+ ┌──────────┬────────┬──────────┬──────────┐
434
+ │ New IP │ESP/AH │ Orig IP │ Payload │
435
+ └──────────┴────────┴──────────┴──────────┘
436
+ ```
437
+
438
+ ---
439
+
440
+ **Related Topics:**
441
+ - See [network-architecture.md](network-architecture.md) for network design
442
+ - See [routing-switching.md](routing-switching.md) for routing protocols
443
+ - See [network-troubleshooting.md](network-troubleshooting.md) for packet analysis
444
+ - See [vpn-connectivity.md](vpn-connectivity.md) for VPN protocols