specweave 0.18.1 → 0.20.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 (384) hide show
  1. package/CLAUDE.md +229 -1817
  2. package/README.md +68 -0
  3. package/bin/specweave.js +62 -6
  4. package/dist/plugins/specweave/lib/hooks/sync-living-docs.d.ts.map +1 -1
  5. package/dist/plugins/specweave/lib/hooks/sync-living-docs.js +3 -0
  6. package/dist/plugins/specweave/lib/hooks/sync-living-docs.js.map +1 -1
  7. package/dist/plugins/specweave/lib/hooks/update-ac-status.d.ts +21 -0
  8. package/dist/plugins/specweave/lib/hooks/update-ac-status.d.ts.map +1 -0
  9. package/dist/plugins/specweave/lib/hooks/update-ac-status.js +162 -0
  10. package/dist/plugins/specweave/lib/hooks/update-ac-status.js.map +1 -0
  11. package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.d.ts.map +1 -1
  12. package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.js +65 -6
  13. package/dist/plugins/specweave-ado/lib/ado-spec-content-sync.js.map +1 -1
  14. package/dist/plugins/specweave-github/lib/completion-calculator.d.ts +112 -0
  15. package/dist/plugins/specweave-github/lib/completion-calculator.d.ts.map +1 -0
  16. package/dist/plugins/specweave-github/lib/completion-calculator.js +301 -0
  17. package/dist/plugins/specweave-github/lib/completion-calculator.js.map +1 -0
  18. package/dist/plugins/specweave-github/lib/duplicate-detector.d.ts +3 -3
  19. package/dist/plugins/specweave-github/lib/duplicate-detector.js +3 -3
  20. package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts +7 -0
  21. package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts.map +1 -1
  22. package/dist/plugins/specweave-github/lib/epic-content-builder.js +42 -0
  23. package/dist/plugins/specweave-github/lib/epic-content-builder.js.map +1 -1
  24. package/dist/plugins/specweave-github/lib/github-client-v2.d.ts +14 -0
  25. package/dist/plugins/specweave-github/lib/github-client-v2.d.ts.map +1 -1
  26. package/dist/plugins/specweave-github/lib/github-client-v2.js +51 -0
  27. package/dist/plugins/specweave-github/lib/github-client-v2.js.map +1 -1
  28. package/dist/plugins/specweave-github/lib/github-epic-sync.js +1 -1
  29. package/dist/plugins/specweave-github/lib/github-epic-sync.js.map +1 -1
  30. package/dist/plugins/specweave-github/lib/github-feature-sync.d.ts +87 -0
  31. package/dist/plugins/specweave-github/lib/github-feature-sync.d.ts.map +1 -0
  32. package/dist/plugins/specweave-github/lib/github-feature-sync.js +412 -0
  33. package/dist/plugins/specweave-github/lib/github-feature-sync.js.map +1 -0
  34. package/dist/plugins/specweave-github/lib/github-spec-content-sync.d.ts.map +1 -1
  35. package/dist/plugins/specweave-github/lib/github-spec-content-sync.js +64 -13
  36. package/dist/plugins/specweave-github/lib/github-spec-content-sync.js.map +1 -1
  37. package/dist/plugins/specweave-github/lib/progress-comment-builder.d.ts +78 -0
  38. package/dist/plugins/specweave-github/lib/progress-comment-builder.d.ts.map +1 -0
  39. package/dist/plugins/specweave-github/lib/progress-comment-builder.js +237 -0
  40. package/dist/plugins/specweave-github/lib/progress-comment-builder.js.map +1 -0
  41. package/dist/plugins/specweave-github/lib/user-story-content-builder.d.ts +97 -0
  42. package/dist/plugins/specweave-github/lib/user-story-content-builder.d.ts.map +1 -0
  43. package/dist/plugins/specweave-github/lib/user-story-content-builder.js +301 -0
  44. package/dist/plugins/specweave-github/lib/user-story-content-builder.js.map +1 -0
  45. package/dist/plugins/specweave-github/lib/user-story-issue-builder.d.ts +83 -0
  46. package/dist/plugins/specweave-github/lib/user-story-issue-builder.d.ts.map +1 -0
  47. package/dist/plugins/specweave-github/lib/user-story-issue-builder.js +386 -0
  48. package/dist/plugins/specweave-github/lib/user-story-issue-builder.js.map +1 -0
  49. package/dist/plugins/specweave-jira/lib/enhanced-jira-sync.d.ts +8 -6
  50. package/dist/plugins/specweave-jira/lib/enhanced-jira-sync.d.ts.map +1 -1
  51. package/dist/plugins/specweave-jira/lib/enhanced-jira-sync.js +78 -117
  52. package/dist/plugins/specweave-jira/lib/enhanced-jira-sync.js.map +1 -1
  53. package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.d.ts +57 -0
  54. package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.d.ts.map +1 -0
  55. package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.js +248 -0
  56. package/dist/plugins/specweave-kafka/lib/cli/kcat-wrapper.js.map +1 -0
  57. package/dist/plugins/specweave-kafka/lib/cli/types.d.ts +82 -0
  58. package/dist/plugins/specweave-kafka/lib/cli/types.d.ts.map +1 -0
  59. package/dist/plugins/specweave-kafka/lib/cli/types.js +13 -0
  60. package/dist/plugins/specweave-kafka/lib/cli/types.js.map +1 -0
  61. package/dist/plugins/specweave-kafka/lib/mcp/detector.d.ts +49 -0
  62. package/dist/plugins/specweave-kafka/lib/mcp/detector.d.ts.map +1 -0
  63. package/dist/plugins/specweave-kafka/lib/mcp/detector.js +316 -0
  64. package/dist/plugins/specweave-kafka/lib/mcp/detector.js.map +1 -0
  65. package/dist/plugins/specweave-kafka/lib/mcp/types.d.ts +70 -0
  66. package/dist/plugins/specweave-kafka/lib/mcp/types.d.ts.map +1 -0
  67. package/dist/plugins/specweave-kafka/lib/mcp/types.js +23 -0
  68. package/dist/plugins/specweave-kafka/lib/mcp/types.js.map +1 -0
  69. package/dist/plugins/specweave-kafka/lib/utils/partitioning.d.ts +85 -0
  70. package/dist/plugins/specweave-kafka/lib/utils/partitioning.d.ts.map +1 -0
  71. package/dist/plugins/specweave-kafka/lib/utils/partitioning.js +281 -0
  72. package/dist/plugins/specweave-kafka/lib/utils/partitioning.js.map +1 -0
  73. package/dist/plugins/specweave-kafka/lib/utils/sizing.d.ts +75 -0
  74. package/dist/plugins/specweave-kafka/lib/utils/sizing.d.ts.map +1 -0
  75. package/dist/plugins/specweave-kafka/lib/utils/sizing.js +238 -0
  76. package/dist/plugins/specweave-kafka/lib/utils/sizing.js.map +1 -0
  77. package/dist/src/cli/commands/import-docs.js +4 -4
  78. package/dist/src/cli/commands/import-docs.js.map +1 -1
  79. package/dist/src/cli/commands/init-multiproject.d.ts.map +1 -1
  80. package/dist/src/cli/commands/init-multiproject.js +17 -18
  81. package/dist/src/cli/commands/init-multiproject.js.map +1 -1
  82. package/dist/src/cli/commands/migrate-to-multiproject.d.ts.map +1 -1
  83. package/dist/src/cli/commands/migrate-to-multiproject.js +8 -4
  84. package/dist/src/cli/commands/migrate-to-multiproject.js.map +1 -1
  85. package/dist/src/cli/commands/switch-project.d.ts.map +1 -1
  86. package/dist/src/cli/commands/switch-project.js +9 -26
  87. package/dist/src/cli/commands/switch-project.js.map +1 -1
  88. package/dist/src/cli/commands/sync-spec-content.js +3 -0
  89. package/dist/src/cli/commands/sync-spec-content.js.map +1 -1
  90. package/dist/src/core/deduplication/command-deduplicator.d.ts +166 -0
  91. package/dist/src/core/deduplication/command-deduplicator.d.ts.map +1 -0
  92. package/dist/src/core/deduplication/command-deduplicator.js +254 -0
  93. package/dist/src/core/deduplication/command-deduplicator.js.map +1 -0
  94. package/dist/src/core/increment/active-increment-manager.d.ts +42 -15
  95. package/dist/src/core/increment/active-increment-manager.d.ts.map +1 -1
  96. package/dist/src/core/increment/active-increment-manager.js +113 -46
  97. package/dist/src/core/increment/active-increment-manager.js.map +1 -1
  98. package/dist/src/core/increment/conflict-resolver.d.ts +40 -0
  99. package/dist/src/core/increment/conflict-resolver.d.ts.map +1 -0
  100. package/dist/src/core/increment/conflict-resolver.js +219 -0
  101. package/dist/src/core/increment/conflict-resolver.js.map +1 -0
  102. package/dist/src/core/increment/discipline-checker.d.ts.map +1 -1
  103. package/dist/src/core/increment/discipline-checker.js +7 -1
  104. package/dist/src/core/increment/discipline-checker.js.map +1 -1
  105. package/dist/src/core/increment/duplicate-detector.d.ts +52 -0
  106. package/dist/src/core/increment/duplicate-detector.d.ts.map +1 -0
  107. package/dist/src/core/increment/duplicate-detector.js +276 -0
  108. package/dist/src/core/increment/duplicate-detector.js.map +1 -0
  109. package/dist/src/core/increment/increment-archiver.d.ts +90 -0
  110. package/dist/src/core/increment/increment-archiver.d.ts.map +1 -0
  111. package/dist/src/core/increment/increment-archiver.js +368 -0
  112. package/dist/src/core/increment/increment-archiver.js.map +1 -0
  113. package/dist/src/core/increment/increment-reopener.d.ts +165 -0
  114. package/dist/src/core/increment/increment-reopener.d.ts.map +1 -0
  115. package/dist/src/core/increment/increment-reopener.js +390 -0
  116. package/dist/src/core/increment/increment-reopener.js.map +1 -0
  117. package/dist/src/core/increment/metadata-manager.d.ts +26 -1
  118. package/dist/src/core/increment/metadata-manager.d.ts.map +1 -1
  119. package/dist/src/core/increment/metadata-manager.js +143 -5
  120. package/dist/src/core/increment/metadata-manager.js.map +1 -1
  121. package/dist/src/core/increment/recent-work-scanner.d.ts +121 -0
  122. package/dist/src/core/increment/recent-work-scanner.d.ts.map +1 -0
  123. package/dist/src/core/increment/recent-work-scanner.js +303 -0
  124. package/dist/src/core/increment/recent-work-scanner.js.map +1 -0
  125. package/dist/src/core/increment/types.d.ts +1 -0
  126. package/dist/src/core/increment/types.d.ts.map +1 -1
  127. package/dist/src/core/increment-utils.d.ts +112 -0
  128. package/dist/src/core/increment-utils.d.ts.map +1 -0
  129. package/dist/src/core/increment-utils.js +210 -0
  130. package/dist/src/core/increment-utils.js.map +1 -0
  131. package/dist/src/core/living-docs/ac-project-specific-generator.d.ts +65 -0
  132. package/dist/src/core/living-docs/ac-project-specific-generator.d.ts.map +1 -0
  133. package/dist/src/core/living-docs/ac-project-specific-generator.js +175 -0
  134. package/dist/src/core/living-docs/ac-project-specific-generator.js.map +1 -0
  135. package/dist/src/core/living-docs/feature-archiver.d.ts +130 -0
  136. package/dist/src/core/living-docs/feature-archiver.d.ts.map +1 -0
  137. package/dist/src/core/living-docs/feature-archiver.js +549 -0
  138. package/dist/src/core/living-docs/feature-archiver.js.map +1 -0
  139. package/dist/src/core/living-docs/feature-id-manager.d.ts +81 -0
  140. package/dist/src/core/living-docs/feature-id-manager.d.ts.map +1 -0
  141. package/dist/src/core/living-docs/feature-id-manager.js +339 -0
  142. package/dist/src/core/living-docs/feature-id-manager.js.map +1 -0
  143. package/dist/src/core/living-docs/hierarchy-mapper.d.ts +144 -83
  144. package/dist/src/core/living-docs/hierarchy-mapper.d.ts.map +1 -1
  145. package/dist/src/core/living-docs/hierarchy-mapper.js +488 -270
  146. package/dist/src/core/living-docs/hierarchy-mapper.js.map +1 -1
  147. package/dist/src/core/living-docs/index.d.ts +6 -0
  148. package/dist/src/core/living-docs/index.d.ts.map +1 -1
  149. package/dist/src/core/living-docs/index.js +6 -0
  150. package/dist/src/core/living-docs/index.js.map +1 -1
  151. package/dist/src/core/living-docs/project-detector.d.ts +6 -0
  152. package/dist/src/core/living-docs/project-detector.d.ts.map +1 -1
  153. package/dist/src/core/living-docs/project-detector.js +35 -1
  154. package/dist/src/core/living-docs/project-detector.js.map +1 -1
  155. package/dist/src/core/living-docs/spec-distributor.d.ts +100 -26
  156. package/dist/src/core/living-docs/spec-distributor.d.ts.map +1 -1
  157. package/dist/src/core/living-docs/spec-distributor.js +1275 -258
  158. package/dist/src/core/living-docs/spec-distributor.js.map +1 -1
  159. package/dist/src/core/living-docs/task-project-specific-generator.d.ts +109 -0
  160. package/dist/src/core/living-docs/task-project-specific-generator.d.ts.map +1 -0
  161. package/dist/src/core/living-docs/task-project-specific-generator.js +221 -0
  162. package/dist/src/core/living-docs/task-project-specific-generator.js.map +1 -0
  163. package/dist/src/core/living-docs/types.d.ts +143 -0
  164. package/dist/src/core/living-docs/types.d.ts.map +1 -1
  165. package/dist/src/core/project-manager.d.ts +2 -17
  166. package/dist/src/core/project-manager.d.ts.map +1 -1
  167. package/dist/src/core/project-manager.js +68 -48
  168. package/dist/src/core/project-manager.js.map +1 -1
  169. package/dist/src/core/spec-content-sync.d.ts +1 -1
  170. package/dist/src/core/spec-content-sync.d.ts.map +1 -1
  171. package/dist/src/core/sync/enhanced-content-builder.d.ts.map +1 -1
  172. package/dist/src/core/sync/enhanced-content-builder.js +2 -1
  173. package/dist/src/core/sync/enhanced-content-builder.js.map +1 -1
  174. package/dist/src/core/sync/performance-optimizer.d.ts +153 -0
  175. package/dist/src/core/sync/performance-optimizer.d.ts.map +1 -0
  176. package/dist/src/core/sync/performance-optimizer.js +220 -0
  177. package/dist/src/core/sync/performance-optimizer.js.map +1 -0
  178. package/dist/src/core/sync/retry-handler.d.ts +98 -0
  179. package/dist/src/core/sync/retry-handler.d.ts.map +1 -0
  180. package/dist/src/core/sync/retry-handler.js +196 -0
  181. package/dist/src/core/sync/retry-handler.js.map +1 -0
  182. package/dist/src/core/types/config.d.ts +94 -0
  183. package/dist/src/core/types/config.d.ts.map +1 -1
  184. package/dist/src/core/types/config.js +16 -0
  185. package/dist/src/core/types/config.js.map +1 -1
  186. package/dist/src/core/types/increment-metadata.d.ts +6 -0
  187. package/dist/src/core/types/increment-metadata.d.ts.map +1 -1
  188. package/dist/src/core/types/increment-metadata.js +10 -1
  189. package/dist/src/core/types/increment-metadata.js.map +1 -1
  190. package/dist/src/integrations/jira/jira-incremental-mapper.d.ts.map +1 -1
  191. package/dist/src/integrations/jira/jira-incremental-mapper.js +4 -8
  192. package/dist/src/integrations/jira/jira-incremental-mapper.js.map +1 -1
  193. package/dist/src/integrations/jira/jira-mapper.d.ts.map +1 -1
  194. package/dist/src/integrations/jira/jira-mapper.js +4 -8
  195. package/dist/src/integrations/jira/jira-mapper.js.map +1 -1
  196. package/package.json +1 -1
  197. package/plugins/specweave/COMMANDS.md +13 -4
  198. package/plugins/specweave/commands/specweave-abandon.md +22 -20
  199. package/plugins/specweave/commands/specweave-archive-features.md +121 -0
  200. package/plugins/specweave/commands/specweave-archive-increments.md +82 -0
  201. package/plugins/specweave/commands/specweave-archive.md +363 -0
  202. package/plugins/specweave/commands/specweave-backlog.md +211 -0
  203. package/plugins/specweave/commands/specweave-fix-duplicates.md +517 -0
  204. package/plugins/specweave/commands/specweave-increment.md +4 -3
  205. package/plugins/specweave/commands/specweave-progress.md +176 -27
  206. package/plugins/specweave/commands/specweave-reopen.md +391 -0
  207. package/plugins/specweave/commands/specweave-restore-feature.md +90 -0
  208. package/plugins/specweave/commands/specweave-restore.md +309 -0
  209. package/plugins/specweave/commands/specweave-resume.md +51 -23
  210. package/plugins/specweave/commands/specweave-status.md +41 -7
  211. package/plugins/specweave/commands/specweave-sync-specs.md +425 -0
  212. package/plugins/specweave/hooks/hooks.json +4 -0
  213. package/plugins/specweave/hooks/lib/sync-spec-content.sh +2 -2
  214. package/plugins/specweave/hooks/post-task-completion.sh +39 -0
  215. package/plugins/specweave/hooks/pre-command-deduplication.sh +83 -0
  216. package/plugins/specweave/hooks/user-prompt-submit.sh +1 -1
  217. package/plugins/specweave/lib/hooks/sync-living-docs.js +2 -0
  218. package/plugins/specweave/lib/hooks/sync-living-docs.ts +4 -0
  219. package/plugins/specweave/lib/hooks/update-ac-status.js +102 -0
  220. package/plugins/specweave/lib/hooks/update-ac-status.ts +192 -0
  221. package/plugins/specweave/skills/archive-increments/SKILL.md +198 -0
  222. package/plugins/specweave/skills/increment-planner/scripts/feature-utils.js +14 -0
  223. package/plugins/specweave/skills/smart-reopen-detector/SKILL.md +244 -0
  224. package/plugins/specweave-ado/lib/ado-spec-content-sync.js +49 -5
  225. package/plugins/specweave-ado/lib/ado-spec-content-sync.ts +72 -6
  226. package/plugins/specweave-confluent/.claude-plugin/plugin.json +23 -0
  227. package/plugins/specweave-confluent/README.md +375 -0
  228. package/plugins/specweave-confluent/agents/confluent-architect/AGENT.md +306 -0
  229. package/plugins/specweave-confluent/skills/confluent-kafka-connect/SKILL.md +453 -0
  230. package/plugins/specweave-confluent/skills/confluent-ksqldb/SKILL.md +470 -0
  231. package/plugins/specweave-confluent/skills/confluent-schema-registry/SKILL.md +316 -0
  232. package/plugins/specweave-github/agents/github-task-splitter/AGENT.md +2 -2
  233. package/plugins/specweave-github/agents/user-story-updater/AGENT.md +148 -0
  234. package/plugins/specweave-github/commands/specweave-github-cleanup-duplicates.md +1 -1
  235. package/plugins/specweave-github/commands/specweave-github-update-user-story.md +156 -0
  236. package/plugins/specweave-github/hooks/post-task-completion.sh +10 -9
  237. package/plugins/specweave-github/lib/completion-calculator.js +262 -0
  238. package/plugins/specweave-github/lib/completion-calculator.ts +434 -0
  239. package/plugins/specweave-github/lib/duplicate-detector.js +3 -3
  240. package/plugins/specweave-github/lib/duplicate-detector.ts +4 -4
  241. package/plugins/specweave-github/lib/epic-content-builder.js +38 -0
  242. package/plugins/specweave-github/lib/epic-content-builder.ts +59 -0
  243. package/plugins/specweave-github/lib/github-client-v2.js +49 -0
  244. package/plugins/specweave-github/lib/github-client-v2.ts +59 -0
  245. package/plugins/specweave-github/lib/github-epic-sync.ts +1 -1
  246. package/plugins/specweave-github/lib/github-feature-sync.js +381 -0
  247. package/plugins/specweave-github/lib/github-feature-sync.ts +568 -0
  248. package/plugins/specweave-github/lib/github-spec-content-sync.js +40 -10
  249. package/plugins/specweave-github/lib/github-spec-content-sync.ts +82 -14
  250. package/plugins/specweave-github/lib/progress-comment-builder.js +229 -0
  251. package/plugins/specweave-github/lib/progress-comment-builder.ts +324 -0
  252. package/plugins/specweave-github/lib/user-story-content-builder.js +299 -0
  253. package/plugins/specweave-github/lib/user-story-content-builder.ts +413 -0
  254. package/plugins/specweave-github/lib/user-story-issue-builder.js +344 -0
  255. package/plugins/specweave-github/lib/user-story-issue-builder.ts +543 -0
  256. package/plugins/specweave-github/skills/github-issue-standard/SKILL.md +189 -0
  257. package/plugins/specweave-jira/lib/enhanced-jira-sync.js +134 -0
  258. package/plugins/specweave-jira/lib/{enhanced-jira-sync.ts.disabled → enhanced-jira-sync.ts} +26 -52
  259. package/plugins/specweave-kafka/.claude-plugin/plugin.json +26 -0
  260. package/plugins/specweave-kafka/IMPLEMENTATION-COMPLETE.md +483 -0
  261. package/plugins/specweave-kafka/README.md +242 -0
  262. package/plugins/specweave-kafka/agents/kafka-architect/AGENT.md +235 -0
  263. package/plugins/specweave-kafka/agents/kafka-devops/AGENT.md +209 -0
  264. package/plugins/specweave-kafka/agents/kafka-observability/AGENT.md +266 -0
  265. package/plugins/specweave-kafka/commands/deploy.md +99 -0
  266. package/plugins/specweave-kafka/commands/dev-env.md +176 -0
  267. package/plugins/specweave-kafka/commands/mcp-configure.md +101 -0
  268. package/plugins/specweave-kafka/commands/monitor-setup.md +96 -0
  269. package/plugins/specweave-kafka/docker/kafka-local/docker-compose.yml +187 -0
  270. package/plugins/specweave-kafka/docker/redpanda/docker-compose.yml +199 -0
  271. package/plugins/specweave-kafka/docker/templates/consumer-nodejs.js +225 -0
  272. package/plugins/specweave-kafka/docker/templates/consumer-python.py +220 -0
  273. package/plugins/specweave-kafka/docker/templates/producer-nodejs.js +168 -0
  274. package/plugins/specweave-kafka/docker/templates/producer-python.py +167 -0
  275. package/plugins/specweave-kafka/lib/adapters/apache-kafka-adapter.js +438 -0
  276. package/plugins/specweave-kafka/lib/adapters/apache-kafka-adapter.ts +541 -0
  277. package/plugins/specweave-kafka/lib/adapters/platform-adapter.js +47 -0
  278. package/plugins/specweave-kafka/lib/adapters/platform-adapter.ts +343 -0
  279. package/plugins/specweave-kafka/lib/cli/kcat-wrapper.js +258 -0
  280. package/plugins/specweave-kafka/lib/cli/kcat-wrapper.ts +298 -0
  281. package/plugins/specweave-kafka/lib/cli/types.js +10 -0
  282. package/plugins/specweave-kafka/lib/cli/types.ts +92 -0
  283. package/plugins/specweave-kafka/lib/connectors/connector-catalog.js +305 -0
  284. package/plugins/specweave-kafka/lib/connectors/connector-catalog.ts +528 -0
  285. package/plugins/specweave-kafka/lib/documentation/diagram-generator.js +114 -0
  286. package/plugins/specweave-kafka/lib/documentation/diagram-generator.ts +195 -0
  287. package/plugins/specweave-kafka/lib/documentation/exporter.js +210 -0
  288. package/plugins/specweave-kafka/lib/documentation/exporter.ts +338 -0
  289. package/plugins/specweave-kafka/lib/documentation/schema-catalog-generator.js +60 -0
  290. package/plugins/specweave-kafka/lib/documentation/schema-catalog-generator.ts +130 -0
  291. package/plugins/specweave-kafka/lib/documentation/topology-generator.js +143 -0
  292. package/plugins/specweave-kafka/lib/documentation/topology-generator.ts +290 -0
  293. package/plugins/specweave-kafka/lib/mcp/detector.js +298 -0
  294. package/plugins/specweave-kafka/lib/mcp/detector.ts +352 -0
  295. package/plugins/specweave-kafka/lib/mcp/types.js +21 -0
  296. package/plugins/specweave-kafka/lib/mcp/types.ts +77 -0
  297. package/plugins/specweave-kafka/lib/multi-cluster/cluster-config-manager.js +193 -0
  298. package/plugins/specweave-kafka/lib/multi-cluster/cluster-config-manager.ts +362 -0
  299. package/plugins/specweave-kafka/lib/multi-cluster/cluster-switcher.js +188 -0
  300. package/plugins/specweave-kafka/lib/multi-cluster/cluster-switcher.ts +359 -0
  301. package/plugins/specweave-kafka/lib/multi-cluster/health-aggregator.js +195 -0
  302. package/plugins/specweave-kafka/lib/multi-cluster/health-aggregator.ts +380 -0
  303. package/plugins/specweave-kafka/lib/observability/opentelemetry-kafka.js +209 -0
  304. package/plugins/specweave-kafka/lib/observability/opentelemetry-kafka.ts +358 -0
  305. package/plugins/specweave-kafka/lib/patterns/advanced-ksqldb-patterns.js +354 -0
  306. package/plugins/specweave-kafka/lib/patterns/advanced-ksqldb-patterns.ts +563 -0
  307. package/plugins/specweave-kafka/lib/patterns/circuit-breaker-resilience.js +259 -0
  308. package/plugins/specweave-kafka/lib/patterns/circuit-breaker-resilience.ts +516 -0
  309. package/plugins/specweave-kafka/lib/patterns/dead-letter-queue.js +233 -0
  310. package/plugins/specweave-kafka/lib/patterns/dead-letter-queue.ts +423 -0
  311. package/plugins/specweave-kafka/lib/patterns/exactly-once-semantics.js +266 -0
  312. package/plugins/specweave-kafka/lib/patterns/exactly-once-semantics.ts +445 -0
  313. package/plugins/specweave-kafka/lib/patterns/flink-kafka-integration.js +312 -0
  314. package/plugins/specweave-kafka/lib/patterns/flink-kafka-integration.ts +561 -0
  315. package/plugins/specweave-kafka/lib/patterns/multi-dc-replication.js +289 -0
  316. package/plugins/specweave-kafka/lib/patterns/multi-dc-replication.ts +607 -0
  317. package/plugins/specweave-kafka/lib/patterns/rate-limiting-backpressure.js +264 -0
  318. package/plugins/specweave-kafka/lib/patterns/rate-limiting-backpressure.ts +498 -0
  319. package/plugins/specweave-kafka/lib/patterns/stream-processing-optimization.js +263 -0
  320. package/plugins/specweave-kafka/lib/patterns/stream-processing-optimization.ts +549 -0
  321. package/plugins/specweave-kafka/lib/patterns/tiered-storage-compaction.js +205 -0
  322. package/plugins/specweave-kafka/lib/patterns/tiered-storage-compaction.ts +399 -0
  323. package/plugins/specweave-kafka/lib/performance/performance-optimizer.js +249 -0
  324. package/plugins/specweave-kafka/lib/performance/performance-optimizer.ts +427 -0
  325. package/plugins/specweave-kafka/lib/security/kafka-security.js +252 -0
  326. package/plugins/specweave-kafka/lib/security/kafka-security.ts +494 -0
  327. package/plugins/specweave-kafka/lib/utils/capacity-planner.js +203 -0
  328. package/plugins/specweave-kafka/lib/utils/capacity-planner.ts +469 -0
  329. package/plugins/specweave-kafka/lib/utils/config-validator.js +419 -0
  330. package/plugins/specweave-kafka/lib/utils/config-validator.ts +564 -0
  331. package/plugins/specweave-kafka/lib/utils/partitioning.js +329 -0
  332. package/plugins/specweave-kafka/lib/utils/partitioning.ts +473 -0
  333. package/plugins/specweave-kafka/lib/utils/sizing.js +221 -0
  334. package/plugins/specweave-kafka/lib/utils/sizing.ts +374 -0
  335. package/plugins/specweave-kafka/monitoring/grafana/dashboards/kafka-broker-metrics.json +628 -0
  336. package/plugins/specweave-kafka/monitoring/grafana/dashboards/kafka-cluster-overview.json +564 -0
  337. package/plugins/specweave-kafka/monitoring/grafana/dashboards/kafka-consumer-lag.json +509 -0
  338. package/plugins/specweave-kafka/monitoring/grafana/dashboards/kafka-jvm-metrics.json +674 -0
  339. package/plugins/specweave-kafka/monitoring/grafana/dashboards/kafka-topic-metrics.json +578 -0
  340. package/plugins/specweave-kafka/monitoring/grafana/provisioning/dashboards/kafka.yml +17 -0
  341. package/plugins/specweave-kafka/monitoring/grafana/provisioning/datasources/prometheus.yml +17 -0
  342. package/plugins/specweave-kafka/monitoring/prometheus/kafka-alerts.yml +415 -0
  343. package/plugins/specweave-kafka/monitoring/prometheus/kafka-jmx-exporter.yml +256 -0
  344. package/plugins/specweave-kafka/package.json +41 -0
  345. package/plugins/specweave-kafka/skills/kafka-architecture/SKILL.md +647 -0
  346. package/plugins/specweave-kafka/skills/kafka-cli-tools/SKILL.md +433 -0
  347. package/plugins/specweave-kafka/skills/kafka-iac-deployment/SKILL.md +449 -0
  348. package/plugins/specweave-kafka/skills/kafka-kubernetes/SKILL.md +667 -0
  349. package/plugins/specweave-kafka/skills/kafka-mcp-integration/SKILL.md +273 -0
  350. package/plugins/specweave-kafka/skills/kafka-observability/SKILL.md +576 -0
  351. package/plugins/specweave-kafka/templates/config/broker-production.properties +254 -0
  352. package/plugins/specweave-kafka/templates/config/consumer-low-latency.properties +112 -0
  353. package/plugins/specweave-kafka/templates/config/producer-high-throughput.properties +120 -0
  354. package/plugins/specweave-kafka/templates/migration/mirrormaker2-config.properties +234 -0
  355. package/plugins/specweave-kafka/templates/monitoring/grafana/multi-cluster-dashboard.json +686 -0
  356. package/plugins/specweave-kafka/terraform/apache-kafka/main.tf +347 -0
  357. package/plugins/specweave-kafka/terraform/apache-kafka/outputs.tf +107 -0
  358. package/plugins/specweave-kafka/terraform/apache-kafka/templates/kafka-broker-init.sh.tpl +216 -0
  359. package/plugins/specweave-kafka/terraform/apache-kafka/variables.tf +156 -0
  360. package/plugins/specweave-kafka/terraform/aws-msk/main.tf +362 -0
  361. package/plugins/specweave-kafka/terraform/aws-msk/outputs.tf +93 -0
  362. package/plugins/specweave-kafka/terraform/aws-msk/templates/server.properties.tpl +32 -0
  363. package/plugins/specweave-kafka/terraform/aws-msk/variables.tf +235 -0
  364. package/plugins/specweave-kafka/terraform/azure-event-hubs/main.tf +281 -0
  365. package/plugins/specweave-kafka/terraform/azure-event-hubs/outputs.tf +118 -0
  366. package/plugins/specweave-kafka/terraform/azure-event-hubs/variables.tf +148 -0
  367. package/plugins/specweave-kafka/tsconfig.json +21 -0
  368. package/plugins/specweave-kafka-streams/.claude-plugin/plugin.json +23 -0
  369. package/plugins/specweave-kafka-streams/README.md +310 -0
  370. package/plugins/specweave-kafka-streams/skills/kafka-streams-topology/SKILL.md +539 -0
  371. package/plugins/specweave-n8n/.claude-plugin/plugin.json +22 -0
  372. package/plugins/specweave-n8n/README.md +354 -0
  373. package/plugins/specweave-n8n/skills/n8n-kafka-workflows/SKILL.md +504 -0
  374. package/plugins/specweave-release/commands/specweave-release-platform.md +1 -1
  375. package/plugins/specweave-release/hooks/post-task-completion.sh +2 -2
  376. package/src/templates/AGENTS.md.template +601 -7
  377. package/src/templates/CLAUDE.md.template +188 -88
  378. package/plugins/specweave-ado/commands/specweave-ado-sync-spec.md +0 -255
  379. package/plugins/specweave-github/commands/specweave-github-sync-epic.md +0 -248
  380. package/plugins/specweave-github/commands/specweave-github-sync-from.md +0 -147
  381. package/plugins/specweave-github/commands/specweave-github-sync-spec.md +0 -208
  382. package/plugins/specweave-github/commands/specweave-github-sync-tasks.md +0 -530
  383. package/plugins/specweave-jira/commands/specweave-jira-sync-epic.md +0 -267
  384. package/plugins/specweave-jira/commands/specweave-jira-sync-spec.md +0 -240
@@ -0,0 +1,674 @@
1
+ {
2
+ "annotations": {
3
+ "list": [
4
+ {
5
+ "builtIn": 1,
6
+ "datasource": "-- Grafana --",
7
+ "enable": true,
8
+ "hide": true,
9
+ "iconColor": "rgba(0, 211, 255, 1)",
10
+ "name": "Annotations & Alerts",
11
+ "type": "dashboard"
12
+ }
13
+ ]
14
+ },
15
+ "editable": true,
16
+ "gnetId": null,
17
+ "graphTooltip": 1,
18
+ "id": null,
19
+ "links": [],
20
+ "panels": [
21
+ {
22
+ "datasource": "Prometheus",
23
+ "description": "JVM heap memory usage across all Kafka brokers",
24
+ "fieldConfig": {
25
+ "defaults": {
26
+ "color": {
27
+ "mode": "palette-classic"
28
+ },
29
+ "custom": {
30
+ "axisLabel": "",
31
+ "axisPlacement": "auto",
32
+ "barAlignment": 0,
33
+ "drawStyle": "line",
34
+ "fillOpacity": 10,
35
+ "gradientMode": "none",
36
+ "hideFrom": {
37
+ "tooltip": false,
38
+ "viz": false,
39
+ "legend": false
40
+ },
41
+ "lineInterpolation": "linear",
42
+ "lineWidth": 2,
43
+ "pointSize": 5,
44
+ "scaleDistribution": {
45
+ "type": "linear"
46
+ },
47
+ "showPoints": "never",
48
+ "spanNulls": true
49
+ },
50
+ "mappings": [],
51
+ "thresholds": {
52
+ "mode": "absolute",
53
+ "steps": [
54
+ {
55
+ "color": "green",
56
+ "value": null
57
+ },
58
+ {
59
+ "color": "yellow",
60
+ "value": 0.7
61
+ },
62
+ {
63
+ "color": "red",
64
+ "value": 0.9
65
+ }
66
+ ]
67
+ },
68
+ "unit": "bytes"
69
+ }
70
+ },
71
+ "gridPos": {
72
+ "h": 8,
73
+ "w": 12,
74
+ "x": 0,
75
+ "y": 0
76
+ },
77
+ "id": 1,
78
+ "options": {
79
+ "legend": {
80
+ "calcs": ["mean", "lastNotNull", "max"],
81
+ "displayMode": "table",
82
+ "placement": "bottom"
83
+ },
84
+ "tooltip": {
85
+ "mode": "multi"
86
+ }
87
+ },
88
+ "pluginVersion": "9.0.0",
89
+ "targets": [
90
+ {
91
+ "expr": "jvm_memory_heap_used_bytes{job=\"kafka\"}",
92
+ "legendFormat": "{{instance}} Heap Used",
93
+ "refId": "A"
94
+ },
95
+ {
96
+ "expr": "jvm_memory_heap_max_bytes{job=\"kafka\"}",
97
+ "legendFormat": "{{instance}} Heap Max",
98
+ "refId": "B"
99
+ }
100
+ ],
101
+ "title": "Heap Memory Usage",
102
+ "type": "timeseries"
103
+ },
104
+ {
105
+ "datasource": "Prometheus",
106
+ "description": "Heap memory utilization percentage",
107
+ "fieldConfig": {
108
+ "defaults": {
109
+ "color": {
110
+ "mode": "palette-classic"
111
+ },
112
+ "custom": {
113
+ "axisLabel": "",
114
+ "axisPlacement": "auto",
115
+ "barAlignment": 0,
116
+ "drawStyle": "line",
117
+ "fillOpacity": 10,
118
+ "gradientMode": "none",
119
+ "hideFrom": {
120
+ "tooltip": false,
121
+ "viz": false,
122
+ "legend": false
123
+ },
124
+ "lineInterpolation": "linear",
125
+ "lineWidth": 2,
126
+ "pointSize": 5,
127
+ "scaleDistribution": {
128
+ "type": "linear"
129
+ },
130
+ "showPoints": "never",
131
+ "spanNulls": true
132
+ },
133
+ "mappings": [],
134
+ "max": 1,
135
+ "min": 0,
136
+ "thresholds": {
137
+ "mode": "absolute",
138
+ "steps": [
139
+ {
140
+ "color": "green",
141
+ "value": null
142
+ },
143
+ {
144
+ "color": "yellow",
145
+ "value": 0.7
146
+ },
147
+ {
148
+ "color": "red",
149
+ "value": 0.9
150
+ }
151
+ ]
152
+ },
153
+ "unit": "percentunit"
154
+ }
155
+ },
156
+ "gridPos": {
157
+ "h": 8,
158
+ "w": 12,
159
+ "x": 12,
160
+ "y": 0
161
+ },
162
+ "id": 2,
163
+ "options": {
164
+ "legend": {
165
+ "calcs": ["mean", "lastNotNull", "max"],
166
+ "displayMode": "table",
167
+ "placement": "bottom"
168
+ },
169
+ "tooltip": {
170
+ "mode": "multi"
171
+ }
172
+ },
173
+ "pluginVersion": "9.0.0",
174
+ "targets": [
175
+ {
176
+ "expr": "jvm_memory_heap_used_bytes{job=\"kafka\"} / jvm_memory_heap_max_bytes{job=\"kafka\"}",
177
+ "legendFormat": "{{instance}} Heap %",
178
+ "refId": "A"
179
+ }
180
+ ],
181
+ "title": "Heap Utilization Percentage",
182
+ "type": "timeseries"
183
+ },
184
+ {
185
+ "datasource": "Prometheus",
186
+ "description": "Garbage collection count rate (collections per second)",
187
+ "fieldConfig": {
188
+ "defaults": {
189
+ "color": {
190
+ "mode": "palette-classic"
191
+ },
192
+ "custom": {
193
+ "axisLabel": "",
194
+ "axisPlacement": "auto",
195
+ "barAlignment": 0,
196
+ "drawStyle": "line",
197
+ "fillOpacity": 10,
198
+ "gradientMode": "none",
199
+ "hideFrom": {
200
+ "tooltip": false,
201
+ "viz": false,
202
+ "legend": false
203
+ },
204
+ "lineInterpolation": "linear",
205
+ "lineWidth": 2,
206
+ "pointSize": 5,
207
+ "scaleDistribution": {
208
+ "type": "linear"
209
+ },
210
+ "showPoints": "never",
211
+ "spanNulls": true
212
+ },
213
+ "mappings": [],
214
+ "thresholds": {
215
+ "mode": "absolute",
216
+ "steps": [
217
+ {
218
+ "color": "green",
219
+ "value": null
220
+ },
221
+ {
222
+ "color": "yellow",
223
+ "value": 1
224
+ },
225
+ {
226
+ "color": "red",
227
+ "value": 5
228
+ }
229
+ ]
230
+ },
231
+ "unit": "ops"
232
+ }
233
+ },
234
+ "gridPos": {
235
+ "h": 8,
236
+ "w": 12,
237
+ "x": 0,
238
+ "y": 8
239
+ },
240
+ "id": 3,
241
+ "options": {
242
+ "legend": {
243
+ "calcs": ["mean", "lastNotNull", "max"],
244
+ "displayMode": "table",
245
+ "placement": "bottom"
246
+ },
247
+ "tooltip": {
248
+ "mode": "multi"
249
+ }
250
+ },
251
+ "pluginVersion": "9.0.0",
252
+ "targets": [
253
+ {
254
+ "expr": "rate(jvm_gc_collection_count_total{job=\"kafka\"}[5m])",
255
+ "legendFormat": "{{instance}} {{gc}} GC Count/sec",
256
+ "refId": "A"
257
+ }
258
+ ],
259
+ "title": "GC Collection Rate",
260
+ "type": "timeseries",
261
+ "description": "High GC rate indicates memory pressure"
262
+ },
263
+ {
264
+ "datasource": "Prometheus",
265
+ "description": "Time spent in garbage collection per second",
266
+ "fieldConfig": {
267
+ "defaults": {
268
+ "color": {
269
+ "mode": "palette-classic"
270
+ },
271
+ "custom": {
272
+ "axisLabel": "",
273
+ "axisPlacement": "auto",
274
+ "barAlignment": 0,
275
+ "drawStyle": "line",
276
+ "fillOpacity": 10,
277
+ "gradientMode": "none",
278
+ "hideFrom": {
279
+ "tooltip": false,
280
+ "viz": false,
281
+ "legend": false
282
+ },
283
+ "lineInterpolation": "linear",
284
+ "lineWidth": 2,
285
+ "pointSize": 5,
286
+ "scaleDistribution": {
287
+ "type": "linear"
288
+ },
289
+ "showPoints": "never",
290
+ "spanNulls": true
291
+ },
292
+ "mappings": [],
293
+ "thresholds": {
294
+ "mode": "absolute",
295
+ "steps": [
296
+ {
297
+ "color": "green",
298
+ "value": null
299
+ },
300
+ {
301
+ "color": "yellow",
302
+ "value": 100
303
+ },
304
+ {
305
+ "color": "red",
306
+ "value": 500
307
+ }
308
+ ]
309
+ },
310
+ "unit": "ms"
311
+ }
312
+ },
313
+ "gridPos": {
314
+ "h": 8,
315
+ "w": 12,
316
+ "x": 12,
317
+ "y": 8
318
+ },
319
+ "id": 4,
320
+ "options": {
321
+ "legend": {
322
+ "calcs": ["mean", "lastNotNull", "max"],
323
+ "displayMode": "table",
324
+ "placement": "bottom"
325
+ },
326
+ "tooltip": {
327
+ "mode": "multi"
328
+ }
329
+ },
330
+ "pluginVersion": "9.0.0",
331
+ "targets": [
332
+ {
333
+ "expr": "rate(jvm_gc_collection_time_ms_total{job=\"kafka\"}[5m])",
334
+ "legendFormat": "{{instance}} {{gc}} GC Time (ms/sec)",
335
+ "refId": "A"
336
+ }
337
+ ],
338
+ "title": "GC Collection Time",
339
+ "type": "timeseries",
340
+ "description": "High GC time indicates application pauses (stop-the-world events)"
341
+ },
342
+ {
343
+ "datasource": "Prometheus",
344
+ "description": "JVM thread count (total and daemon threads)",
345
+ "fieldConfig": {
346
+ "defaults": {
347
+ "color": {
348
+ "mode": "palette-classic"
349
+ },
350
+ "custom": {
351
+ "axisLabel": "",
352
+ "axisPlacement": "auto",
353
+ "barAlignment": 0,
354
+ "drawStyle": "line",
355
+ "fillOpacity": 10,
356
+ "gradientMode": "none",
357
+ "hideFrom": {
358
+ "tooltip": false,
359
+ "viz": false,
360
+ "legend": false
361
+ },
362
+ "lineInterpolation": "linear",
363
+ "lineWidth": 2,
364
+ "pointSize": 5,
365
+ "scaleDistribution": {
366
+ "type": "linear"
367
+ },
368
+ "showPoints": "never",
369
+ "spanNulls": true
370
+ },
371
+ "mappings": [],
372
+ "thresholds": {
373
+ "mode": "absolute",
374
+ "steps": [
375
+ {
376
+ "color": "green",
377
+ "value": null
378
+ },
379
+ {
380
+ "color": "yellow",
381
+ "value": 500
382
+ },
383
+ {
384
+ "color": "red",
385
+ "value": 1000
386
+ }
387
+ ]
388
+ },
389
+ "unit": "short"
390
+ }
391
+ },
392
+ "gridPos": {
393
+ "h": 8,
394
+ "w": 12,
395
+ "x": 0,
396
+ "y": 16
397
+ },
398
+ "id": 5,
399
+ "options": {
400
+ "legend": {
401
+ "calcs": ["mean", "lastNotNull", "max"],
402
+ "displayMode": "table",
403
+ "placement": "bottom"
404
+ },
405
+ "tooltip": {
406
+ "mode": "multi"
407
+ }
408
+ },
409
+ "pluginVersion": "9.0.0",
410
+ "targets": [
411
+ {
412
+ "expr": "jvm_threads_count{job=\"kafka\"}",
413
+ "legendFormat": "{{instance}} Total Threads",
414
+ "refId": "A"
415
+ },
416
+ {
417
+ "expr": "jvm_threads_daemon_count{job=\"kafka\"}",
418
+ "legendFormat": "{{instance}} Daemon Threads",
419
+ "refId": "B"
420
+ }
421
+ ],
422
+ "title": "JVM Thread Count",
423
+ "type": "timeseries"
424
+ },
425
+ {
426
+ "datasource": "Prometheus",
427
+ "description": "Heap memory usage by pool (young gen, old gen, survivor)",
428
+ "fieldConfig": {
429
+ "defaults": {
430
+ "color": {
431
+ "mode": "palette-classic"
432
+ },
433
+ "custom": {
434
+ "axisLabel": "",
435
+ "axisPlacement": "auto",
436
+ "barAlignment": 0,
437
+ "drawStyle": "line",
438
+ "fillOpacity": 10,
439
+ "gradientMode": "none",
440
+ "hideFrom": {
441
+ "tooltip": false,
442
+ "viz": false,
443
+ "legend": false
444
+ },
445
+ "lineInterpolation": "linear",
446
+ "lineWidth": 2,
447
+ "pointSize": 5,
448
+ "scaleDistribution": {
449
+ "type": "linear"
450
+ },
451
+ "showPoints": "never",
452
+ "spanNulls": true
453
+ },
454
+ "mappings": [],
455
+ "thresholds": {
456
+ "mode": "absolute",
457
+ "steps": [
458
+ {
459
+ "color": "green",
460
+ "value": null
461
+ }
462
+ ]
463
+ },
464
+ "unit": "bytes"
465
+ }
466
+ },
467
+ "gridPos": {
468
+ "h": 8,
469
+ "w": 12,
470
+ "x": 12,
471
+ "y": 16
472
+ },
473
+ "id": 6,
474
+ "options": {
475
+ "legend": {
476
+ "calcs": ["mean", "lastNotNull", "max"],
477
+ "displayMode": "table",
478
+ "placement": "bottom"
479
+ },
480
+ "tooltip": {
481
+ "mode": "multi"
482
+ }
483
+ },
484
+ "pluginVersion": "9.0.0",
485
+ "targets": [
486
+ {
487
+ "expr": "jvm_memory_pool_bytes_used{job=\"kafka\", pool=~\".*Eden.*|.*Survivor.*|.*Old.*\"}",
488
+ "legendFormat": "{{instance}} {{pool}}",
489
+ "refId": "A"
490
+ }
491
+ ],
492
+ "title": "Heap Memory by Pool",
493
+ "type": "timeseries",
494
+ "description": "Track young generation (Eden, Survivor) vs old generation memory usage"
495
+ },
496
+ {
497
+ "datasource": "Prometheus",
498
+ "description": "Off-heap memory usage (direct buffers, metaspace)",
499
+ "fieldConfig": {
500
+ "defaults": {
501
+ "color": {
502
+ "mode": "palette-classic"
503
+ },
504
+ "custom": {
505
+ "axisLabel": "",
506
+ "axisPlacement": "auto",
507
+ "barAlignment": 0,
508
+ "drawStyle": "line",
509
+ "fillOpacity": 10,
510
+ "gradientMode": "none",
511
+ "hideFrom": {
512
+ "tooltip": false,
513
+ "viz": false,
514
+ "legend": false
515
+ },
516
+ "lineInterpolation": "linear",
517
+ "lineWidth": 2,
518
+ "pointSize": 5,
519
+ "scaleDistribution": {
520
+ "type": "linear"
521
+ },
522
+ "showPoints": "never",
523
+ "spanNulls": true
524
+ },
525
+ "mappings": [],
526
+ "thresholds": {
527
+ "mode": "absolute",
528
+ "steps": [
529
+ {
530
+ "color": "green",
531
+ "value": null
532
+ }
533
+ ]
534
+ },
535
+ "unit": "bytes"
536
+ }
537
+ },
538
+ "gridPos": {
539
+ "h": 8,
540
+ "w": 12,
541
+ "x": 0,
542
+ "y": 24
543
+ },
544
+ "id": 7,
545
+ "options": {
546
+ "legend": {
547
+ "calcs": ["mean", "lastNotNull", "max"],
548
+ "displayMode": "table",
549
+ "placement": "bottom"
550
+ },
551
+ "tooltip": {
552
+ "mode": "multi"
553
+ }
554
+ },
555
+ "pluginVersion": "9.0.0",
556
+ "targets": [
557
+ {
558
+ "expr": "jvm_memory_pool_bytes_used{job=\"kafka\", pool=~\".*Metaspace.*|.*Code Cache.*|.*Compressed.*\"}",
559
+ "legendFormat": "{{instance}} {{pool}}",
560
+ "refId": "A"
561
+ }
562
+ ],
563
+ "title": "Off-Heap Memory Usage",
564
+ "type": "timeseries",
565
+ "description": "Track metaspace, code cache, and compressed class space usage"
566
+ },
567
+ {
568
+ "datasource": "Prometheus",
569
+ "description": "GC pause time percentiles (p50, p95, p99, max)",
570
+ "fieldConfig": {
571
+ "defaults": {
572
+ "color": {
573
+ "mode": "palette-classic"
574
+ },
575
+ "custom": {
576
+ "axisLabel": "",
577
+ "axisPlacement": "auto",
578
+ "barAlignment": 0,
579
+ "drawStyle": "line",
580
+ "fillOpacity": 10,
581
+ "gradientMode": "none",
582
+ "hideFrom": {
583
+ "tooltip": false,
584
+ "viz": false,
585
+ "legend": false
586
+ },
587
+ "lineInterpolation": "linear",
588
+ "lineWidth": 2,
589
+ "pointSize": 5,
590
+ "scaleDistribution": {
591
+ "type": "linear"
592
+ },
593
+ "showPoints": "never",
594
+ "spanNulls": true
595
+ },
596
+ "mappings": [],
597
+ "thresholds": {
598
+ "mode": "absolute",
599
+ "steps": [
600
+ {
601
+ "color": "green",
602
+ "value": null
603
+ },
604
+ {
605
+ "color": "yellow",
606
+ "value": 100
607
+ },
608
+ {
609
+ "color": "red",
610
+ "value": 500
611
+ }
612
+ ]
613
+ },
614
+ "unit": "ms"
615
+ }
616
+ },
617
+ "gridPos": {
618
+ "h": 8,
619
+ "w": 12,
620
+ "x": 12,
621
+ "y": 24
622
+ },
623
+ "id": 8,
624
+ "options": {
625
+ "legend": {
626
+ "calcs": ["mean", "p95", "p99", "max"],
627
+ "displayMode": "table",
628
+ "placement": "bottom"
629
+ },
630
+ "tooltip": {
631
+ "mode": "multi"
632
+ }
633
+ },
634
+ "pluginVersion": "9.0.0",
635
+ "targets": [
636
+ {
637
+ "expr": "histogram_quantile(0.50, sum(rate(jvm_gc_pause_seconds_bucket{job=\"kafka\"}[5m])) by (le, instance)) * 1000",
638
+ "legendFormat": "{{instance}} p50",
639
+ "refId": "A"
640
+ },
641
+ {
642
+ "expr": "histogram_quantile(0.95, sum(rate(jvm_gc_pause_seconds_bucket{job=\"kafka\"}[5m])) by (le, instance)) * 1000",
643
+ "legendFormat": "{{instance}} p95",
644
+ "refId": "B"
645
+ },
646
+ {
647
+ "expr": "histogram_quantile(0.99, sum(rate(jvm_gc_pause_seconds_bucket{job=\"kafka\"}[5m])) by (le, instance)) * 1000",
648
+ "legendFormat": "{{instance}} p99",
649
+ "refId": "C"
650
+ }
651
+ ],
652
+ "title": "GC Pause Time Percentiles",
653
+ "type": "timeseries",
654
+ "description": "Track GC pause time distribution (lower is better)"
655
+ }
656
+ ],
657
+ "refresh": "30s",
658
+ "schemaVersion": 36,
659
+ "style": "dark",
660
+ "tags": ["kafka", "jvm", "metrics", "memory", "gc"],
661
+ "templating": {
662
+ "list": []
663
+ },
664
+ "time": {
665
+ "from": "now-1h",
666
+ "to": "now"
667
+ },
668
+ "timepicker": {},
669
+ "timezone": "",
670
+ "title": "Kafka JVM Metrics",
671
+ "uid": "kafka-jvm-metrics",
672
+ "version": 1,
673
+ "description": "Monitor Kafka JVM metrics including heap memory, garbage collection, and thread count"
674
+ }