agentvibes 3.0.0 → 3.2.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 (350) hide show
  1. package/.bmad/_cfg/agent-manifest.csv +9 -9
  2. package/.bmad/_cfg/agent-voice-map.csv +11 -11
  3. package/.bmad/_cfg/agents/bmm-quick-flow-solo-dev.customize.yaml +42 -0
  4. package/.bmad/_cfg/files-manifest.csv +286 -242
  5. package/.bmad/_cfg/ides/claude-code.yaml +1 -1
  6. package/.bmad/_cfg/manifest.yaml +5 -3
  7. package/.bmad/_cfg/task-manifest.csv +1 -0
  8. package/.bmad/_cfg/workflow-manifest.csv +37 -38
  9. package/.bmad/bmm/agents/analyst.md +40 -41
  10. package/.bmad/bmm/agents/{frame-expert.md → analyst.md.bak} +23 -16
  11. package/.bmad/bmm/agents/architect.md +34 -42
  12. package/.bmad/bmm/agents/dev.md +38 -34
  13. package/.bmad/bmm/agents/pm.md +34 -46
  14. package/.bmad/bmm/agents/quick-flow-solo-dev.md +64 -0
  15. package/.bmad/bmm/agents/sm.md +47 -53
  16. package/.bmad/bmm/agents/tea.md +41 -42
  17. package/.bmad/bmm/agents/tech-writer.md +37 -39
  18. package/.bmad/bmm/agents/ux-designer.md +42 -41
  19. package/.bmad/bmm/config.yaml +7 -5
  20. package/.bmad/bmm/data/README.md +29 -0
  21. package/.bmad/bmm/data/project-context-template.md +40 -0
  22. package/.bmad/bmm/docs/README.md +48 -10
  23. package/.bmad/bmm/docs/agents-guide.md +80 -53
  24. package/.bmad/bmm/docs/bmad-quick-flow.md +528 -0
  25. package/.bmad/bmm/docs/brownfield-guide.md +25 -39
  26. package/.bmad/bmm/docs/enterprise-agentic-development.md +3 -3
  27. package/.bmad/bmm/docs/faq.md +6 -39
  28. package/.bmad/bmm/docs/glossary.md +12 -25
  29. package/.bmad/bmm/docs/images/README.md +37 -0
  30. package/.bmad/bmm/docs/images/workflow-method-greenfield.excalidraw +5034 -0
  31. package/.bmad/bmm/docs/images/workflow-method-greenfield.svg +4 -0
  32. package/.bmad/bmm/docs/quick-flow-solo-dev.md +337 -0
  33. package/.bmad/bmm/docs/quick-spec-flow.md +5 -5
  34. package/.bmad/bmm/docs/quick-start.md +15 -25
  35. package/.bmad/bmm/docs/scale-adaptive-system.md +11 -5
  36. package/.bmad/bmm/docs/test-architecture.md +90 -24
  37. package/.bmad/bmm/docs/troubleshooting.md +680 -0
  38. package/.bmad/bmm/docs/workflow-document-project-reference.md +1 -1
  39. package/.bmad/bmm/docs/workflows-analysis.md +36 -140
  40. package/.bmad/bmm/docs/workflows-implementation.md +182 -157
  41. package/.bmad/bmm/docs/workflows-planning.md +51 -212
  42. package/.bmad/bmm/docs/workflows-solutioning.md +26 -71
  43. package/.bmad/bmm/tasks/daily-standup.xml +85 -0
  44. package/.bmad/bmm/teams/default-party.csv +15 -14
  45. package/.bmad/bmm/teams/team-fullstack.yaml +0 -1
  46. package/.bmad/bmm/testarch/knowledge/api-request.md +303 -0
  47. package/.bmad/bmm/testarch/knowledge/auth-session.md +356 -0
  48. package/.bmad/bmm/testarch/knowledge/burn-in.md +273 -0
  49. package/.bmad/bmm/testarch/knowledge/ci-burn-in.md +1 -1
  50. package/.bmad/bmm/testarch/knowledge/file-utils.md +260 -0
  51. package/.bmad/bmm/testarch/knowledge/fixtures-composition.md +382 -0
  52. package/.bmad/bmm/testarch/knowledge/intercept-network-call.md +280 -0
  53. package/.bmad/bmm/testarch/knowledge/log.md +294 -0
  54. package/.bmad/bmm/testarch/knowledge/network-error-monitor.md +272 -0
  55. package/.bmad/bmm/testarch/knowledge/network-recorder.md +265 -0
  56. package/.bmad/bmm/testarch/knowledge/overview.md +284 -0
  57. package/.bmad/bmm/testarch/knowledge/recurse.md +296 -0
  58. package/.bmad/bmm/testarch/tea-index.csv +11 -0
  59. package/.bmad/bmm/workflows/1-analysis/product-brief/product-brief.template.md +8 -0
  60. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-01-init.md +192 -0
  61. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-01b-continue.md +167 -0
  62. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-02-vision.md +203 -0
  63. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-03-users.md +206 -0
  64. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-04-metrics.md +209 -0
  65. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-05-scope.md +223 -0
  66. package/.bmad/bmm/workflows/1-analysis/product-brief/steps/step-06-complete.md +199 -0
  67. package/.bmad/bmm/workflows/1-analysis/product-brief/workflow.md +58 -0
  68. package/.bmad/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +136 -0
  69. package/.bmad/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +228 -0
  70. package/.bmad/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +237 -0
  71. package/.bmad/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +205 -0
  72. package/.bmad/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +233 -0
  73. package/.bmad/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +442 -0
  74. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +181 -0
  75. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +236 -0
  76. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +199 -0
  77. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +248 -0
  78. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +258 -0
  79. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +176 -0
  80. package/.bmad/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +474 -0
  81. package/.bmad/bmm/workflows/1-analysis/research/research.template.md +15 -0
  82. package/.bmad/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +136 -0
  83. package/.bmad/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +238 -0
  84. package/.bmad/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +247 -0
  85. package/.bmad/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +201 -0
  86. package/.bmad/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +238 -0
  87. package/.bmad/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +485 -0
  88. package/.bmad/bmm/workflows/1-analysis/research/workflow.md +204 -0
  89. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +159 -0
  90. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +126 -0
  91. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +209 -0
  92. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +215 -0
  93. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +218 -0
  94. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +233 -0
  95. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +251 -0
  96. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +253 -0
  97. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +223 -0
  98. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +223 -0
  99. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +240 -0
  100. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +247 -0
  101. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +236 -0
  102. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +263 -0
  103. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +226 -0
  104. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +6 -138
  105. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +59 -0
  106. package/.bmad/bmm/workflows/2-plan-workflows/prd/prd-template.md +12 -200
  107. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md +243 -0
  108. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md +165 -0
  109. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md +420 -0
  110. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md +289 -0
  111. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md +290 -0
  112. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md +270 -0
  113. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md +261 -0
  114. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md +257 -0
  115. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md +298 -0
  116. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md +269 -0
  117. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md +293 -0
  118. package/.bmad/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md +223 -0
  119. package/.bmad/bmm/workflows/2-plan-workflows/prd/workflow.md +61 -0
  120. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-decision-template.md +13 -0
  121. package/.bmad/bmm/workflows/3-solutioning/architecture/data/domain-complexity.csv +11 -0
  122. package/.bmad/bmm/workflows/3-solutioning/architecture/data/project-types.csv +7 -0
  123. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-01-init.md +194 -0
  124. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-01b-continue.md +163 -0
  125. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-02-context.md +223 -0
  126. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-03-starter.md +330 -0
  127. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-04-decisions.md +317 -0
  128. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-05-patterns.md +358 -0
  129. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-06-structure.md +378 -0
  130. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-07-validation.md +358 -0
  131. package/.bmad/bmm/workflows/3-solutioning/architecture/steps/step-08-complete.md +351 -0
  132. package/.bmad/bmm/workflows/3-solutioning/architecture/workflow.md +49 -0
  133. package/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +258 -0
  134. package/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +232 -0
  135. package/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +271 -0
  136. package/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +144 -0
  137. package/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
  138. package/.bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +58 -0
  139. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/steps/step-01-document-discovery.md +189 -0
  140. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/steps/step-02-prd-analysis.md +177 -0
  141. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/steps/step-03-epic-coverage-validation.md +178 -0
  142. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/steps/step-04-ux-alignment.md +138 -0
  143. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/steps/step-05-epic-quality-review.md +251 -0
  144. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/steps/step-06-final-assessment.md +132 -0
  145. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/templates/readiness-report-template.md +4 -0
  146. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.md +54 -0
  147. package/.bmad/bmm/workflows/4-implementation/code-review/checklist.md +2 -1
  148. package/.bmad/bmm/workflows/4-implementation/code-review/instructions.xml +224 -0
  149. package/.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +4 -11
  150. package/.bmad/bmm/workflows/4-implementation/create-story/checklist.md +332 -214
  151. package/.bmad/bmm/workflows/4-implementation/create-story/instructions.xml +354 -0
  152. package/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +21 -34
  153. package/.bmad/bmm/workflows/4-implementation/dev-story/checklist.md +65 -23
  154. package/.bmad/bmm/workflows/4-implementation/dev-story/instructions.xml +406 -0
  155. package/.bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +6 -37
  156. package/.bmad/bmm/workflows/4-implementation/retrospective/instructions.md +3 -3
  157. package/.bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +19 -21
  158. package/.bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +11 -10
  159. package/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +2 -0
  160. package/.bmad/bmm/workflows/4-implementation/sprint-status/instructions.md +174 -0
  161. package/.bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml +34 -0
  162. package/.bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/instructions.md +115 -0
  163. package/.bmad/bmm/workflows/bmad-quick-flow/create-tech-spec/workflow.yaml +25 -0
  164. package/.bmad/bmm/workflows/bmad-quick-flow/quick-dev/checklist.md +25 -0
  165. package/.bmad/bmm/workflows/bmad-quick-flow/quick-dev/instructions.md +202 -0
  166. package/.bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml +32 -0
  167. package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-dataflow/instructions.md +7 -8
  168. package/.bmad/bmm/workflows/diagrams/create-dataflow/workflow.yaml +26 -0
  169. package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-diagram/instructions.md +9 -10
  170. package/.bmad/bmm/workflows/diagrams/create-diagram/workflow.yaml +26 -0
  171. package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-flowchart/instructions.md +4 -5
  172. package/.bmad/bmm/workflows/diagrams/create-flowchart/workflow.yaml +26 -0
  173. package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-wireframe/instructions.md +3 -3
  174. package/.bmad/bmm/workflows/diagrams/create-wireframe/workflow.yaml +26 -0
  175. package/.bmad/bmm/workflows/document-project/instructions.md +1 -1
  176. package/.bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +2 -2
  177. package/.bmad/bmm/workflows/generate-project-context/project-context-template.md +20 -0
  178. package/.bmad/bmm/workflows/generate-project-context/steps/step-01-discover.md +193 -0
  179. package/.bmad/bmm/workflows/generate-project-context/steps/step-02-generate.md +317 -0
  180. package/.bmad/bmm/workflows/generate-project-context/steps/step-03-complete.md +277 -0
  181. package/.bmad/bmm/workflows/generate-project-context/workflow.md +48 -0
  182. package/.bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +1 -1
  183. package/.bmad/bmm/workflows/testarch/atdd/instructions.md +23 -3
  184. package/.bmad/bmm/workflows/testarch/automate/instructions.md +23 -2
  185. package/.bmad/bmm/workflows/testarch/ci/checklist.md +1 -1
  186. package/.bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +36 -3
  187. package/.bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +25 -4
  188. package/.bmad/bmm/workflows/testarch/ci/instructions.md +20 -3
  189. package/.bmad/bmm/workflows/testarch/framework/instructions.md +27 -1
  190. package/.bmad/bmm/workflows/testarch/test-design/instructions.md +8 -2
  191. package/.bmad/bmm/workflows/testarch/test-review/instructions.md +29 -9
  192. package/.bmad/bmm/workflows/workflow-status/init/instructions.md +66 -54
  193. package/.bmad/bmm/workflows/workflow-status/instructions.md +11 -4
  194. package/.bmad/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +22 -38
  195. package/.bmad/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +6 -22
  196. package/.bmad/bmm/workflows/workflow-status/paths/method-brownfield.yaml +6 -22
  197. package/.bmad/bmm/workflows/workflow-status/paths/method-greenfield.yaml +6 -23
  198. package/.bmad/core/agents/bmad-master.md +12 -17
  199. package/.bmad/core/agents/bmad-web-orchestrator.agent.xml +1 -1
  200. package/.bmad/core/config.yaml +11 -0
  201. package/.bmad/core/resources/excalidraw/README.md +160 -0
  202. package/.bmad/core/resources/excalidraw/library-loader.md +50 -0
  203. package/.bmad/core/tasks/advanced-elicitation-methods.csv +51 -21
  204. package/.bmad/core/tasks/advanced-elicitation.xml +18 -8
  205. package/.bmad/core/tasks/workflow.xml +36 -71
  206. package/.bmad/core/workflows/brainstorming/brain-methods.csv +62 -36
  207. package/.bmad/core/workflows/brainstorming/steps/step-01-session-setup.md +196 -0
  208. package/.bmad/core/workflows/brainstorming/steps/step-01b-continue.md +121 -0
  209. package/.bmad/core/workflows/brainstorming/steps/step-02a-user-selected.md +224 -0
  210. package/.bmad/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +236 -0
  211. package/.bmad/core/workflows/brainstorming/steps/step-02c-random-selection.md +208 -0
  212. package/.bmad/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +263 -0
  213. package/.bmad/core/workflows/brainstorming/steps/step-03-technique-execution.md +339 -0
  214. package/.bmad/core/workflows/brainstorming/steps/step-04-idea-organization.md +302 -0
  215. package/.bmad/core/workflows/brainstorming/template.md +13 -104
  216. package/.bmad/core/workflows/brainstorming/workflow.md +51 -0
  217. package/.bmad/core/workflows/party-mode/instructions.md.bak +205 -0
  218. package/.bmad/core/workflows/party-mode/steps/step-01-agent-loading.md +140 -0
  219. package/.bmad/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +205 -0
  220. package/.bmad/core/workflows/party-mode/steps/step-03-graceful-exit.md +158 -0
  221. package/.bmad/core/workflows/party-mode/workflow.md +225 -0
  222. package/.claude/commands/bmad/bmm/agents/{frame-expert.md → quick-flow-solo-dev.md} +3 -3
  223. package/.claude/commands/bmad/bmm/workflows/check-implementation-readiness.md +5 -0
  224. package/.claude/commands/bmad/bmm/workflows/code-review.md +1 -1
  225. package/.claude/commands/bmad/bmm/workflows/create-architecture.md +5 -0
  226. package/.claude/commands/bmad/bmm/workflows/create-epics-stories.md +5 -0
  227. package/.claude/commands/bmad/bmm/workflows/{create-dataflow.md → create-excalidraw-dataflow.md} +2 -2
  228. package/.claude/commands/bmad/bmm/workflows/{create-diagram.md → create-excalidraw-diagram.md} +2 -2
  229. package/.claude/commands/bmad/bmm/workflows/{create-flowchart.md → create-excalidraw-flowchart.md} +2 -2
  230. package/.claude/commands/bmad/bmm/workflows/{create-wireframe.md → create-excalidraw-wireframe.md} +2 -2
  231. package/.claude/commands/bmad/bmm/workflows/create-prd.md +5 -0
  232. package/.claude/commands/bmad/bmm/workflows/create-product-brief.md +5 -0
  233. package/.claude/commands/bmad/bmm/workflows/create-story.md +1 -1
  234. package/.claude/commands/bmad/bmm/workflows/create-tech-spec.md +13 -0
  235. package/.claude/commands/bmad/bmm/workflows/create-ux-design.md +2 -10
  236. package/.claude/commands/bmad/bmm/workflows/generate-project-context.md +5 -0
  237. package/.claude/commands/bmad/bmm/workflows/{domain-research.md → quick-dev.md} +3 -3
  238. package/.claude/commands/bmad/bmm/workflows/research.md +2 -10
  239. package/.claude/commands/bmad/bmm/workflows/{story-context.md → sprint-status.md} +3 -3
  240. package/.claude/commands/bmad/bmm/workflows/testarch-atdd.md +13 -0
  241. package/.claude/commands/bmad/bmm/workflows/testarch-automate.md +13 -0
  242. package/.claude/commands/bmad/bmm/workflows/testarch-ci.md +13 -0
  243. package/.claude/commands/bmad/bmm/workflows/testarch-framework.md +13 -0
  244. package/.claude/commands/bmad/bmm/workflows/testarch-nfr.md +13 -0
  245. package/.claude/commands/bmad/bmm/workflows/{prd.md → testarch-test-design.md} +3 -3
  246. package/.claude/commands/bmad/bmm/workflows/testarch-test-review.md +13 -0
  247. package/.claude/commands/bmad/bmm/workflows/testarch-trace.md +13 -0
  248. package/.claude/commands/bmad/core/workflows/brainstorming-session.md +5 -0
  249. package/.claude/config/tts-speech-rate.txt +1 -0
  250. package/.claude/github-star-reminder.txt +1 -1
  251. package/.claude/hooks/audio-processor.sh +12 -3
  252. package/.claude/hooks/piper-installer.sh +17 -0
  253. package/.claude/hooks/play-tts-piper.sh +4 -0
  254. package/.claude/hooks/termux-installer.sh +224 -0
  255. package/.clawdbot/README.md +105 -0
  256. package/.clawdbot/skill/SKILL.md +432 -0
  257. package/README.md +167 -11
  258. package/RELEASE_NOTES.md +255 -249
  259. package/package.json +4 -2
  260. package/src/installer.js +75 -21
  261. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/instructions.md +0 -112
  262. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/project-context.md +0 -25
  263. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +0 -26
  264. package/.bmad/bmm/workflows/1-analysis/domain-research/instructions.md +0 -425
  265. package/.bmad/bmm/workflows/1-analysis/domain-research/template.md +0 -180
  266. package/.bmad/bmm/workflows/1-analysis/domain-research/workflow.yaml +0 -28
  267. package/.bmad/bmm/workflows/1-analysis/product-brief/checklist.md +0 -115
  268. package/.bmad/bmm/workflows/1-analysis/product-brief/instructions.md +0 -524
  269. package/.bmad/bmm/workflows/1-analysis/product-brief/template.md +0 -181
  270. package/.bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml +0 -45
  271. package/.bmad/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +0 -144
  272. package/.bmad/bmm/workflows/1-analysis/research/checklist-technical.md +0 -249
  273. package/.bmad/bmm/workflows/1-analysis/research/checklist.md +0 -299
  274. package/.bmad/bmm/workflows/1-analysis/research/claude-code/injections.yaml +0 -114
  275. package/.bmad/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +0 -438
  276. package/.bmad/bmm/workflows/1-analysis/research/instructions-market.md +0 -675
  277. package/.bmad/bmm/workflows/1-analysis/research/instructions-router.md +0 -134
  278. package/.bmad/bmm/workflows/1-analysis/research/instructions-technical.md +0 -534
  279. package/.bmad/bmm/workflows/1-analysis/research/template-deep-prompt.md +0 -94
  280. package/.bmad/bmm/workflows/1-analysis/research/template-market.md +0 -347
  281. package/.bmad/bmm/workflows/1-analysis/research/template-technical.md +0 -245
  282. package/.bmad/bmm/workflows/1-analysis/research/workflow.yaml +0 -44
  283. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md +0 -80
  284. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md +0 -616
  285. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml +0 -53
  286. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/checklist.md +0 -310
  287. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +0 -1308
  288. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +0 -61
  289. package/.bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +0 -346
  290. package/.bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +0 -703
  291. package/.bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +0 -52
  292. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +0 -217
  293. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +0 -74
  294. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-generate-stories.md +0 -436
  295. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +0 -980
  296. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +0 -181
  297. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +0 -90
  298. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +0 -58
  299. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +0 -321
  300. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-template.md +0 -103
  301. package/.bmad/bmm/workflows/3-solutioning/architecture/checklist.md +0 -240
  302. package/.bmad/bmm/workflows/3-solutioning/architecture/decision-catalog.yaml +0 -222
  303. package/.bmad/bmm/workflows/3-solutioning/architecture/instructions.md +0 -768
  304. package/.bmad/bmm/workflows/3-solutioning/architecture/pattern-categories.csv +0 -13
  305. package/.bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml +0 -55
  306. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/checklist.md +0 -169
  307. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/instructions.md +0 -332
  308. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/template.md +0 -146
  309. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.yaml +0 -62
  310. package/.bmad/bmm/workflows/4-implementation/code-review/backlog_template.md +0 -12
  311. package/.bmad/bmm/workflows/4-implementation/code-review/instructions.md +0 -398
  312. package/.bmad/bmm/workflows/4-implementation/create-story/instructions.md +0 -256
  313. package/.bmad/bmm/workflows/4-implementation/dev-story/instructions.md +0 -267
  314. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/checklist.md +0 -17
  315. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/instructions.md +0 -164
  316. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/template.md +0 -76
  317. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +0 -57
  318. package/.bmad/bmm/workflows/4-implementation/story-context/checklist.md +0 -16
  319. package/.bmad/bmm/workflows/4-implementation/story-context/context-template.xml +0 -34
  320. package/.bmad/bmm/workflows/4-implementation/story-context/instructions.md +0 -209
  321. package/.bmad/bmm/workflows/4-implementation/story-context/workflow.yaml +0 -61
  322. package/.bmad/bmm/workflows/4-implementation/story-done/instructions.md +0 -111
  323. package/.bmad/bmm/workflows/4-implementation/story-done/workflow.yaml +0 -26
  324. package/.bmad/bmm/workflows/4-implementation/story-ready/instructions.md +0 -117
  325. package/.bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml +0 -23
  326. package/.bmad/bmm/workflows/frame-expert/create-dataflow/workflow.yaml +0 -23
  327. package/.bmad/bmm/workflows/frame-expert/create-diagram/workflow.yaml +0 -24
  328. package/.bmad/bmm/workflows/frame-expert/create-flowchart/workflow.yaml +0 -27
  329. package/.bmad/bmm/workflows/frame-expert/create-wireframe/workflow.yaml +0 -23
  330. package/.bmad/bmm/workflows/workflow-status/paths/game-design.yaml +0 -52
  331. package/.bmad/bmm/workflows/workflow-status/paths/quick-flow-brownfield.yaml +0 -58
  332. package/.bmad/bmm/workflows/workflow-status/paths/quick-flow-greenfield.yaml +0 -47
  333. package/.claude/commands/bmad/bmm/workflows/architecture.md +0 -13
  334. package/.claude/commands/bmad/bmm/workflows/brainstorm-project.md +0 -13
  335. package/.claude/commands/bmad/bmm/workflows/create-epics-and-stories.md +0 -13
  336. package/.claude/commands/bmad/bmm/workflows/epic-tech-context.md +0 -13
  337. package/.claude/commands/bmad/bmm/workflows/implementation-readiness.md +0 -13
  338. package/.claude/commands/bmad/bmm/workflows/product-brief.md +0 -13
  339. package/.claude/commands/bmad/bmm/workflows/story-done.md +0 -13
  340. package/.claude/commands/bmad/bmm/workflows/story-ready.md +0 -13
  341. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +0 -13
  342. /package/.bmad/bmm/{workflows/techdoc → data}/documentation-standards.md +0 -0
  343. /package/.bmad/bmm/workflows/{frame-expert → diagrams}/_shared/excalidraw-library.json +0 -0
  344. /package/.bmad/bmm/workflows/{frame-expert → diagrams}/_shared/excalidraw-templates.yaml +0 -0
  345. /package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-dataflow/checklist.md +0 -0
  346. /package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-diagram/checklist.md +0 -0
  347. /package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-flowchart/checklist.md +0 -0
  348. /package/.bmad/bmm/workflows/{frame-expert → diagrams}/create-wireframe/checklist.md +0 -0
  349. /package/.bmad/{bmm/workflows/frame-expert/_shared → core/resources/excalidraw}/excalidraw-helpers.md +0 -0
  350. /package/.bmad/{bmm/workflows/frame-expert/_shared → core/resources/excalidraw}/validate-json-instructions.md +0 -0
package/RELEASE_NOTES.md CHANGED
@@ -1,5 +1,260 @@
1
1
  # AgentVibes Release Notes
2
2
 
3
+ ## 📦 v3.2.0 - Clawdbot Integration: AI Assistants on Any Messenger
4
+
5
+ **Release Date:** January 27, 2026
6
+
7
+ ### 🎯 Why v3.2.0?
8
+
9
+ This minor release adds **native Clawdbot integration** to AgentVibes, bringing professional TTS to the revolutionary AI assistant you can access via any instant messenger. Clawdbot connects Claude AI to WhatsApp, Telegram, Discord, and more—and now with AgentVibes, your Clawdbot can speak with 50+ professional voices in 30+ languages. This release also includes SonarCloud quality gate improvements and CI/CD workflow enhancements.
10
+
11
+ ### 🤖 AI Summary
12
+
13
+ AgentVibes v3.2.0 introduces seamless integration with Clawdbot, the revolutionary AI assistant accessible via any instant messenger. With this release, Clawdbot users get professional TTS with 50+ voices, remote SSH audio support for server deployments, and zero-configuration setup—just install AgentVibes and the Clawdbot skill is ready. The release also includes quality improvements: SonarCloud workflow fixes, enhanced documentation for disabling quality gate checks, and improved test coverage validation.
14
+
15
+ **Key Highlights:**
16
+ - 🤖 **Clawdbot Integration** - Native TTS support for Clawdbot AI assistant framework
17
+ - 💬 **Messenger Platforms** - Works with WhatsApp, Telegram, Discord via Clawdbot
18
+ - 🔊 **Remote SSH Audio** - Perfect for Clawdbot on remote servers with PulseAudio tunneling
19
+ - 📦 **Simple Install** - Just `npx agentvibes install` and it works
20
+ - 🛡️ **SonarCloud Fixes** - Quality gate workflow improvements and documentation
21
+ - ✅ **Full Test Coverage** - All 213 BATS + 47 Node tests passing
22
+
23
+ ### ✨ New Features
24
+
25
+ **Clawdbot Skill (`.clawdbot/`):**
26
+ - New `.clawdbot/` directory with skill integration files
27
+ - `README.md` - Clawdbot integration overview and setup guide
28
+ - `skill/SKILL.md` - Comprehensive skill documentation with voice selection, background music, effects, personalities, and remote SSH audio setup
29
+ - Automatically distributed via npm package
30
+ - Zero-configuration when AgentVibes is installed
31
+
32
+ **README Updates:**
33
+ - Added "🤖 Clawdbot Integration" section with full documentation
34
+ - Updated header to include Clawdbot alongside Claude Code, Claude Desktop, and Warp Terminal
35
+ - Added Clawdbot to Quick Links table
36
+ - Clawdbot description: "A revolutionary AI assistant you can access via any instant messenger"
37
+ - Website link: https://clawd.bot
38
+
39
+ **package.json Updates:**
40
+ - Added `.clawdbot/` to npm files array for distribution
41
+ - Added `clawdbot` to keywords for npm discoverability
42
+ - Updated description to mention Clawdbot support
43
+
44
+ ### 🐛 Bug Fixes
45
+
46
+ - **SonarCloud Quality Gate** - Disabled quality gate status reporting to GitHub to prevent false CI failures
47
+ - **Coverage File Generation** - Ensured coverage file is generated before SonarCloud scan
48
+ - **CLI Test Coverage** - Added CLI tests and excluded CLI entry point from coverage requirements
49
+ - **macOS Runner** - Removed macos-15-large runner to avoid GitHub billing limits
50
+ - **Piper Voice Test** - Updated installation test to match current voice list
51
+
52
+ ### 📚 Documentation
53
+
54
+ - Added step-by-step SonarCloud dashboard configuration guide
55
+ - Added guide to disable SonarCloud GitHub App checks
56
+ - Comprehensive Clawdbot integration documentation with SSH audio examples
57
+
58
+ ### 🔒 Security & Quality
59
+
60
+ - ✅ All Sonar quality gates validated
61
+ - ✅ No hardcoded credentials in changes
62
+ - ✅ New Clawdbot files are documentation only (no executable code)
63
+ - ✅ All 213 BATS + 47 Node tests passing
64
+
65
+ ### 📊 Changes Summary
66
+
67
+ - **Files Added:** 2 (`.clawdbot/README.md`, `.clawdbot/skill/SKILL.md`)
68
+ - **Files Modified:** 2 (`README.md`, `package.json`)
69
+ - **Commits Since v3.1.0:** 11 (5 fixes, 4 docs, 1 test, 1 debug)
70
+
71
+ ### 🎯 User Impact
72
+
73
+ **For Clawdbot Users:**
74
+ - Professional TTS with 50+ voices in 30+ languages
75
+ - Works on remote servers with SSH audio tunneling
76
+ - Zero API costs—Piper TTS is free and offline
77
+ - Automatic integration when AgentVibes is installed
78
+
79
+ **For Existing Users:**
80
+ - Zero breaking changes
81
+ - All existing features work exactly the same
82
+ - Clawdbot support is additive
83
+
84
+ ### 🚀 Migration Notes
85
+
86
+ No migration required! This is a fully backward-compatible minor release.
87
+
88
+ **To Use with Clawdbot:**
89
+ 1. Install: `npx agentvibes install`
90
+ 2. Speak: `npx agentvibes speak "Hello!"`
91
+
92
+ ### 📦 Full Changelog
93
+
94
+ **Feature Commits:**
95
+ - `(pending)` feat: Add Clawdbot integration
96
+
97
+ **Bug Fix Commits:**
98
+ - `5cd97d52` fix: Disable SonarCloud quality gate status reporting to GitHub
99
+ - `12f822e6` fix: Disable quality gate failure in SonarCloud workflow
100
+ - `0d26ccc2` fix: Ensure coverage file is generated before SonarCloud scan
101
+ - `c2465508` fix: Add CLI tests and exclude CLI entry point from coverage
102
+ - `c673afe1` fix: Remove macos-15-large runner to avoid GitHub billing limits
103
+ - `92271732` fix: Update Piper installation test to match current voice list
104
+
105
+ **Documentation Commits:**
106
+ - `f72dd977` docs: Add guide to disable SonarCloud GitHub App checks
107
+ - `6587519b` docs: Add step-by-step SonarCloud dashboard configuration guide
108
+ - `ba765f50` docs: Add SonarCloud quality gate configuration guidance
109
+
110
+ **Test Commits:**
111
+ - `47f08a79` test: Trigger workflow to verify SonarCloud quality gate fix
112
+
113
+ **Debug Commits:**
114
+ - `84945d25` debug: Add coverage file verification to SonarCloud workflow
115
+
116
+ ---
117
+
118
+ ## 📦 v3.1.0 - Android Native Support: Run Claude Code on Your Phone
119
+
120
+ **Release Date:** January 22, 2026
121
+
122
+ ### 🎯 Why v3.1.0?
123
+
124
+ This minor release brings **native Android support** to AgentVibes, enabling developers to run Claude Code with professional TTS voices directly on Android devices via Termux. No SSH required, no remote server needed—just install Termux on your Android phone or tablet and get the full AgentVibes experience locally. This complements the v3.0.0 termux-ssh provider by offering a **complete mobile development solution**: use native Termux for local Android development, or use termux-ssh when connecting to remote servers.
125
+
126
+ ### 🤖 AI Summary
127
+
128
+ AgentVibes v3.1.0 introduces native Android/Termux support, enabling developers to run Claude Code with professional TTS voices directly on their Android devices. Through automatic detection and a specialized installer, AgentVibes now runs Piper TTS via proot-distro with Debian (solving Android's glibc compatibility issues), uses termux-media-player for audio playback, and includes comprehensive Android-specific documentation. Perfect for developers who want to code on-the-go with their Android phone or tablet using the full power of Claude Code and AgentVibes.
129
+
130
+ **Key Highlights:**
131
+ - 🤖 **Native Android Support** - Run Claude Code with TTS directly on Android devices via Termux
132
+ - 📦 **Automatic Termux Detection** - AgentVibes auto-detects Android and runs specialized installation
133
+ - 🎯 **Proot-Distro Integration** - Solves glibc compatibility with proot Debian environment
134
+ - 🔊 **Android Audio Playback** - Uses termux-media-player for native Android audio routing
135
+ - 📚 **Comprehensive Documentation** - Complete Android setup guide with troubleshooting and F-Droid instructions
136
+ - ✅ **Full Test Coverage** - All 213 BATS + 38 Node tests passing with Android compatibility
137
+
138
+ ### ✨ New Features
139
+
140
+ **Termux Installer (`.claude/hooks/termux-installer.sh`):**
141
+ - New 224-line installer specifically for Android/Termux environments
142
+ - Automatically installs proot-distro with Debian (for glibc compatibility)
143
+ - Downloads and configures Piper TTS binary in proot environment
144
+ - Creates `/usr/bin/piper` wrapper that routes through proot
145
+ - Installs audio dependencies: ffmpeg, sox, bc, termux-api
146
+ - Interactive voice selection with 50+ language options
147
+ - Validates Termux environment before proceeding
148
+
149
+ **Termux Detection (`src/installer.js`):**
150
+ - New `isTermux()` function checks for `/data/data/com.termux` directory
151
+ - New `detectAndNotifyTermux()` displays Android detection messages
152
+ - Auto-configures piper provider with Termux-compatible voice
153
+ - Shows Termux-specific installation instructions
154
+ - Piper installer automatically redirects to termux-installer.sh on Android
155
+
156
+ **Audio Processor Updates (`.claude/hooks/audio-processor.sh`):**
157
+ - Detects Termux environment for temp directory selection
158
+ - Uses `${PREFIX}/tmp` on Termux, `/tmp` on standard systems
159
+ - Ensures audio effects work correctly on Android
160
+ - Cross-platform compatibility maintained
161
+
162
+ **Piper Installer Updates (`.claude/hooks/piper-installer.sh`):**
163
+ - Auto-detects Termux and redirects to specialized installer
164
+ - Shows clear message when routing to Termux-specific setup
165
+
166
+ **Android Audio Playback (`.claude/hooks/play-tts-piper.sh`):**
167
+ - Detects Android/Termux environment
168
+ - Uses `termux-media-player` instead of `paplay` on Android
169
+ - Audio routes through Android's native media system
170
+
171
+ ### 📚 Documentation
172
+
173
+ **New Android Setup Section (`README.md`):**
174
+ - Added "🤖 Android / Termux" section to System Requirements
175
+ - Complete 3-step installation guide for Android devices
176
+ - Explanation of why Termux needs special handling (bionic vs glibc)
177
+ - Requirements: Termux app from F-Droid, Termux:API, Android 7.0+
178
+ - Audio playback architecture explanation
179
+ - Setup verification commands
180
+ - Troubleshooting table for common issues
181
+ - Clear explanation of why F-Droid version is required (not Google Play)
182
+ - Updated Quick Links table with direct link to Android setup
183
+
184
+ ### 🐛 Bug Fixes
185
+
186
+ - **Test #90 Fix** - Added termux-ssh provider to test cleanup list for "no providers found" edge case
187
+ - **Temp Directory Detection** - Fixed audio-processor.sh defaulting to Termux paths on non-Termux systems
188
+ - **Sonar Compliance** - Added `set -euo pipefail` strict mode to termux-installer.sh for security
189
+
190
+ ### 🔒 Security & Quality
191
+
192
+ - ✅ All Sonar quality gates validated
193
+ - ✅ Strict mode (`set -euo pipefail`) on all new bash scripts
194
+ - ✅ No hardcoded credentials
195
+ - ✅ Proper variable quoting and input validation
196
+ - ✅ Cross-platform temp directory handling
197
+ - ✅ All 213 BATS + 38 Node tests passing
198
+
199
+ ### 📊 Changes Summary
200
+
201
+ - **Files Modified:** 7
202
+ - **Lines Added:** +391
203
+ - **Lines Removed:** -8
204
+ - **New Files:** 1 (termux-installer.sh)
205
+ - **Commits:** 8 (5 fixes, 1 feature, 1 docs, 1 merge)
206
+
207
+ ### 🎯 User Impact
208
+
209
+ **For Android Users:**
210
+ - Can now run Claude Code directly on Android phones/tablets
211
+ - Full TTS support with 50+ voices and languages
212
+ - No remote server required for basic usage
213
+ - Works offline after initial voice downloads
214
+
215
+ **For Developers:**
216
+ - Complete mobile development solution (native + SSH)
217
+ - Native Termux for local Android development
218
+ - Termux-SSH provider for remote server connections
219
+ - Seamless integration with existing AgentVibes workflows
220
+
221
+ **For Existing Users:**
222
+ - Zero breaking changes
223
+ - All existing features work exactly the same
224
+ - New Android support is opt-in via Termux installation
225
+
226
+ ### 🚀 Migration Notes
227
+
228
+ No migration required! This is a fully backward-compatible minor release.
229
+
230
+ **To Try Android Support:**
231
+ 1. Install [Termux from F-Droid](https://f-droid.org/en/packages/com.termux/)
232
+ 2. Install [Termux:API](https://f-droid.org/en/packages/com.termux.api/)
233
+ 3. In Termux: `pkg install nodejs-lts`
234
+ 4. Run: `npx agentvibes install`
235
+
236
+ AgentVibes will auto-detect Termux and run the specialized installer.
237
+
238
+ ### 📦 Full Changelog
239
+
240
+ **Feature Commits:**
241
+ - `e9d4cf95` feat: Add Android/Termux support for Piper TTS
242
+
243
+ **Bug Fix Commits:**
244
+ - `aa4d3cdd` fix: Add termux-ssh provider to test #90 cleanup list
245
+ - `c1b00c6d` fix: Use termux-media-player for audio playback on Android
246
+ - `f96ab89a` fix: Properly detect Termux environment for temp directory
247
+ - `e2efeb06` fix: Add strict mode to termux-installer.sh for Sonar compliance
248
+
249
+ **Documentation Commits:**
250
+ - `701a9412` docs: Add comprehensive Android/Termux setup section to README
251
+
252
+ **Merge Commits:**
253
+ - `a5d3f546` Merge feature/android-termux into master
254
+ - `95f04e70` Merge origin/master into feature/pulseaudio-reverse-tunnel
255
+
256
+ ---
257
+
3
258
  ## 📦 v3.0.0 - Cross-Platform Remote Audio: Termux SSH Provider
4
259
 
5
260
  **Release Date:** January 8, 2026
@@ -48,252 +303,3 @@ See the termux-ssh provider in action—fully interactive, hands-free conversati
48
303
  - Supports mixed-provider mode (Piper + Termux)
49
304
 
50
305
  **MCP Server Integration (`mcp-server/server.py`):**
51
- - Added termux-ssh to provider validation
52
- - Provider name mapping: "Termux SSH"
53
- - JSON schema enum includes termux-ssh
54
- - Full compatibility with all slash commands
55
-
56
- ### 📝 Documentation
57
-
58
- **New File: `.claude/docs/TERMUX_SETUP.md`**
59
- - 409 lines of comprehensive setup documentation
60
- - Prerequisites for Android (Termux, termux-api, openssh)
61
- - Prerequisites for server/desktop (SSH config)
62
- - **Tailscale Integration Guide:**
63
- - Why Tailscale solves cross-network access
64
- - Step-by-step installation (Android + Server)
65
- - Benefits comparison table
66
- - Example configurations with sanitized IPs
67
- - Multiple device configuration
68
- - Custom TTS voices
69
- - Security considerations
70
- - Troubleshooting section
71
- - Architecture diagram
72
-
73
- ### 🐛 Bug Fixes & Improvements
74
-
75
- **Git Log Bug Fix (`src/installer.js`):**
76
- - Check for .git directory before running git log
77
- - Prevents showing parent repository commits
78
- - Falls back to RELEASE_NOTES.md for npm installs
79
-
80
- **Provider Timeout Fix:**
81
- - Added timeout to set_provider TTS confirmation to prevent hanging
82
- - Improves user experience when switching providers
83
-
84
- **NPM Package Improvements:**
85
- - Include templates/ directory in npm package for welcome audio
86
- - Include RELEASE_NOTES.md in npm package
87
- - Include .claude/docs/ directory for setup guides
88
- - Syntax validation added to test suite
89
-
90
- **Documentation IP Sanitization:**
91
- - All example IPs changed to clearly fake: 100.100.100.x
92
- - Removed potentially sensitive information from examples
93
-
94
- **Audio Effects Handling:**
95
- - Skip audio effects for termux-ssh provider (mobile devices)
96
- - Skip welcome message for termux-ssh to reduce initial setup noise
97
- - Optimize mobile experience with appropriate defaults
98
-
99
- **Release Process Quality Gates:**
100
- - Integrated Sonar quality gate validation into /release command
101
- - Automated test suite execution before all releases
102
- - Security validation for bash scripts and JavaScript code
103
-
104
- ### 🔧 Technical Details
105
-
106
- **Files Changed:**
107
- - `.claude/hooks/play-tts-termux-ssh.sh`: New provider implementation (+196 lines)
108
- - `.claude/hooks/play-tts.sh`: Added termux-ssh routing (+6 lines)
109
- - `.claude/docs/TERMUX_SETUP.md`: Complete setup guide (+409 lines)
110
- - `src/installer.js`: Provider selection + SSH config + git fix (+100 lines)
111
- - `mcp-server/server.py`: Provider validation updates (+8 lines)
112
- - `package.json`: Version bump + docs folder inclusion
113
- - `sonar-project.properties`: Version sync
114
-
115
- **Installation:**
116
- ```bash
117
- npx agentvibes@latest install
118
- ```
119
-
120
- ### 📊 Impact
121
-
122
- **User Experience:**
123
- - Work on remote servers while hearing TTS on Android phone
124
- - No PulseAudio or complex audio forwarding configuration
125
- - Uses familiar SSH workflow
126
- - Works from anywhere in the world with Tailscale VPN
127
- - True location-independent development experience
128
-
129
- **Developer Experience:**
130
- - Simple SSH host alias configuration via installer
131
- - Tailscale eliminates network complexity, NAT traversal, and port forwarding
132
- - Native Android TTS voices with language support
133
- - Full MCP integration for all workflows
134
- - Seamless provider switching between local (Piper/macOS) and remote (termux-ssh)
135
-
136
- **Use Cases:**
137
- - 🎙️ **Interactive Mobile Conversations** - Have true back-and-forth conversations with Claude Code using just your Android phone (no computer speakers needed)
138
- - 💻 **Local Development with Mobile Audio** - Code on your laptop/desktop but hear and interact with Claude via your phone
139
- - ☁️ **Remote Server Development** - Work on cloud servers, VPS, or corporate servers with audio delivered to your mobile device anywhere in the world
140
- - 🚶 **Mobile-First Workflow** - Walk around while conversing with Claude, freed from your workstation
141
- - 🎧 **Private Conversations** - Use phone earbuds for private AI interactions in shared workspaces
142
- - ♿ **Enhanced Accessibility** - Hands-free voice interaction with AI while maintaining visual focus on code
143
- - 📱 **Distributed Teams** - Team members can hear Claude updates on their phones regardless of location or network
144
-
145
- ---
146
-
147
- ## 📦 v2.18.0 - Uninstall Command & CI Improvements
148
-
149
- **Release Date:** December 30, 2025
150
-
151
- ### 🤖 AI Summary
152
-
153
- AgentVibes v2.18.0 introduces a comprehensive uninstall command that makes it easy to cleanly remove AgentVibes from your projects. The new `agentvibes uninstall` command provides interactive confirmation, flexible removal options (project-level, global, or complete including Piper TTS), and clear documentation. This release also improves CI test reliability by adjusting timeouts for slower build environments, ensuring more consistent test results across different systems.
154
-
155
- **Key Highlights:**
156
- - 🗑️ **Comprehensive Uninstall Command** - New `agentvibes uninstall` with interactive confirmation and preview of what will be removed
157
- - 🎛️ **Flexible Removal Options** - Support for `--yes` (auto-confirm), `--global` (remove global config), and `--with-piper` (remove TTS engine) flags
158
- - 📚 **Complete Documentation** - New uninstall section in README with examples, options, and what gets removed at each level
159
- - 🧪 **Improved CI Reliability** - Increased party-mode TTS test timeout from 10s to 15s for slower CI systems
160
-
161
- ### ✨ New Features
162
-
163
- **Uninstall Command (`src/installer.js`):**
164
- - Added `agentvibes uninstall` command with ~194 lines of new functionality
165
- - Interactive confirmation prompt (skippable with `--yes` flag)
166
- - Preview display showing exactly what will be removed before uninstalling
167
- - Project-level uninstall (default): Removes `.claude/`, `.agentvibes/` directories
168
- - Global uninstall (with `--global`): Also removes `~/.claude/`, `~/.agentvibes/`
169
- - Complete uninstall (with `--with-piper`): Also removes `~/piper/` TTS engine
170
- - Safety check: Verifies installation exists before proceeding
171
- - Colored output with spinner, progress indicators, and feedback prompts
172
- - Helpful messaging with reinstall instructions and feedback link
173
-
174
- ### 📝 Documentation
175
-
176
- **README.md:**
177
- - Added new "🗑️ Uninstalling" section to Table of Contents
178
- - Complete uninstall documentation with:
179
- - Quick uninstall command: `npx agentvibes uninstall`
180
- - All command options with descriptions
181
- - Clear breakdown of what gets removed at each level (project/global/Piper)
182
- - Tips and best practices
183
- - Reinstall instructions
184
-
185
- ### 🐛 Bug Fixes & Improvements
186
-
187
- **Test Reliability (`test/unit/party-mode-tts.bats`):**
188
- - Increased timeout for party mode multi-agent TTS test from 10s to 15s
189
- - Accommodates slower CI systems while still catching real performance issues
190
- - Updated test comment to explain the timeout adjustment
191
-
192
- ### 🔧 Technical Details
193
-
194
- **Files Changed:**
195
- - `README.md`: Added uninstall documentation section (+56 lines)
196
- - `src/installer.js`: Implemented uninstall command (+194 lines)
197
- - `test/unit/party-mode-tts.bats`: Adjusted timeout for CI compatibility (+2 lines, -2 lines)
198
-
199
- **Command Usage:**
200
- ```bash
201
- # Interactive uninstall (confirms before removing)
202
- npx agentvibes uninstall
203
-
204
- # Auto-confirm (skip confirmation prompt)
205
- npx agentvibes uninstall --yes
206
-
207
- # Also remove global configuration
208
- npx agentvibes uninstall --global
209
-
210
- # Complete uninstall including Piper TTS
211
- npx agentvibes uninstall --global --with-piper
212
- ```
213
-
214
- ### 📊 Impact
215
-
216
- **User Experience:**
217
- - Users can now cleanly uninstall AgentVibes at their preferred scope
218
- - Clear visibility into what will be removed before taking action
219
- - Safety confirmation prevents accidental uninstalls
220
- - Easy reinstallation path with `npx agentvibes install`
221
-
222
- **Developer Experience:**
223
- - More reliable CI builds with adjusted test timeouts
224
- - Better test failure signal-to-noise ratio
225
- - Clearer test comments explaining timeout rationale
226
-
227
- ---
228
-
229
- ## 📦 v2.17.9 - Documentation Accuracy Update
230
-
231
- **Release Date:** December 20, 2024
232
-
233
- ### 🤖 AI Summary
234
-
235
- AgentVibes v2.17.9 is a documentation accuracy release that removes all outdated ElevenLabs references and updates documentation to reflect the current architecture. This release corrects the voice library documentation (removing fake piper.io URLs), updates provider documentation to accurately describe Piper TTS and macOS Say (removing references to the no-longer-supported ElevenLabs provider), and completely rewrites the technical deep dive to reflect the current startup hook architecture instead of the deprecated output styles system.
236
-
237
- **Key Highlights:**
238
- - 📚 **Voice Library Accuracy** - Replaced fake voice URLs with actual Piper TTS voice names and accurate language support (18+ languages)
239
- - 🔧 **Provider Documentation** - Removed ElevenLabs section, added macOS Say provider details, corrected feature comparison tables
240
- - 🏗️ **Architecture Update** - Technical deep dive rewritten: "Output Style System" → "Startup Hook Protocol", updated from 4 to 3 core systems
241
- - ✅ **Code Example Accuracy** - All code snippets now match current implementation (Piper TTS local generation, macOS Say integration)
242
-
243
- ### 📝 Documentation Updates
244
-
245
- **docs/voice-library.md:**
246
- - Removed fake "piper.io/voice-library" URLs (formatted like old ElevenLabs links)
247
- - Updated from "30+ languages" to accurate "18+ languages"
248
- - Replaced character voice list with actual Piper voice names (en_US-lessac-medium, en_GB-alan-medium, etc.)
249
- - Added commands to preview and list voices
250
-
251
- **docs/providers.md:**
252
- - Removed entire "Piper TTS (Premium AI Voices)" section with ElevenLabs references
253
- - Added "macOS Say (Built-in, Free)" provider section
254
- - Updated provider comparison table: Piper TTS vs macOS Say (was incorrectly "Piper TTS vs Piper TTS")
255
- - Removed outdated pricing information ($0-99/month)
256
- - Removed API key requirements
257
- - Updated recommendations for cross-platform vs macOS-specific use cases
258
-
259
- **docs/technical-deep-dive.md** (Major Rewrite):
260
- - Architecture: Changed from "4 Core Systems" to "3 Core Systems" (removed Output Style System)
261
- - System 1: "Output Style System" → "Startup Hook Protocol"
262
- - Explained how `.claude/hooks/startup.sh` injects TTS instructions
263
- - Removed references to `.claude/output-styles/agent-vibes.md`
264
- - Added actual startup hook code examples
265
- - Provider Implementation:
266
- - Removed fake ElevenLabs API curl examples
267
- - Removed SSH audio conversion (MP3→OGG, only needed for API streaming)
268
- - Added macOS Say provider implementation with actual code
269
- - Updated Piper implementation to show local voice generation
270
- - Data Flow: Updated all examples to use startup hook instead of output style
271
- - Installation: Removed `output-styles/` from directory structure, added `startup.sh`
272
- - Performance: Updated latency numbers (removed API latency, added local generation times)
273
- - Error Handling: "API Failure Handling" → "TTS Generation Failure Handling"
274
- - Updated voice references from "150+ voices" to "50+ neural voices"
275
- - Changed default voice from "Aria" to "en_GB-alan-medium"
276
-
277
- ### 🐛 Bug Fixes
278
-
279
- **macOS Installation (src/installer.js):**
280
- - Fixed Python installation on macOS to handle PEP 668 externally-managed environments
281
- - Added `--break-system-packages` flag for Python dependencies when virtual environments aren't available
282
- - Prevents installation failures on macOS systems with externally-managed Python
283
- - Maintains compatibility with standard Python environments
284
-
285
- ### 🔧 Technical Details
286
-
287
- **Files Changed:**
288
- - `docs/voice-library.md`: Voice name and language accuracy
289
- - `docs/providers.md`: Provider documentation overhaul
290
- - `docs/technical-deep-dive.md`: Complete architecture rewrite
291
- - `src/installer.js`: macOS Python dependency handling
292
-
293
- ### 📊 Impact
294
-
295
- This release ensures that all documentation accurately reflects the current AgentVibes architecture. No functionality was changed, but users will find:
296
- - Accurate voice names and language support
297
- - Correct provider information for making informed choices
298
- - Technical documentation matching the actual codebase
299
- - Better macOS installation reliability
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "agentvibes",
4
- "version": "3.0.0",
5
- "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
4
+ "version": "3.2.0",
5
+ "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
6
6
  "homepage": "https://agentvibes.org",
7
7
  "keywords": [
8
8
  "tts",
@@ -10,6 +10,7 @@
10
10
  "piper-tts",
11
11
  "claude-code",
12
12
  "claude-desktop",
13
+ "clawdbot",
13
14
  "mcp",
14
15
  "model-context-protocol",
15
16
  "voice",
@@ -57,6 +58,7 @@
57
58
  ".claude/verbosity.txt",
58
59
  ".claude/github-star-reminder.txt",
59
60
  ".bmad/",
61
+ ".clawdbot/",
60
62
  ".mcp.json",
61
63
  "README.md",
62
64
  "RELEASE_NOTES.md",