specweave 0.10.1 → 0.12.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 (656) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/CLAUDE.md +184 -288
  3. package/README.md +48 -21
  4. package/dist/cli/commands/init.d.ts.map +1 -1
  5. package/dist/cli/commands/init.js +75 -113
  6. package/dist/cli/commands/init.js.map +1 -1
  7. package/dist/cli/helpers/issue-tracker/index.d.ts.map +1 -1
  8. package/dist/cli/helpers/issue-tracker/index.js +39 -0
  9. package/dist/cli/helpers/issue-tracker/index.js.map +1 -1
  10. package/dist/cli/helpers/issue-tracker/jira.d.ts.map +1 -1
  11. package/dist/cli/helpers/issue-tracker/jira.js +2 -9
  12. package/dist/cli/helpers/issue-tracker/jira.js.map +1 -1
  13. package/dist/hooks/lib/git-diff-analyzer.d.ts +89 -0
  14. package/dist/hooks/lib/git-diff-analyzer.d.ts.map +1 -0
  15. package/dist/hooks/lib/git-diff-analyzer.js +226 -0
  16. package/dist/hooks/lib/git-diff-analyzer.js.map +1 -0
  17. package/dist/hooks/lib/prepare-reflection-context.d.ts +42 -0
  18. package/dist/hooks/lib/prepare-reflection-context.d.ts.map +1 -0
  19. package/dist/hooks/lib/prepare-reflection-context.js +123 -0
  20. package/dist/hooks/lib/prepare-reflection-context.js.map +1 -0
  21. package/dist/hooks/lib/reflection-config-loader.d.ts +45 -0
  22. package/dist/hooks/lib/reflection-config-loader.d.ts.map +1 -0
  23. package/dist/hooks/lib/reflection-config-loader.js +132 -0
  24. package/dist/hooks/lib/reflection-config-loader.js.map +1 -0
  25. package/dist/hooks/lib/reflection-parser.d.ts +33 -0
  26. package/dist/hooks/lib/reflection-parser.d.ts.map +1 -0
  27. package/dist/hooks/lib/reflection-parser.js +419 -0
  28. package/dist/hooks/lib/reflection-parser.js.map +1 -0
  29. package/dist/hooks/lib/reflection-prompt-builder.d.ts +56 -0
  30. package/dist/hooks/lib/reflection-prompt-builder.d.ts.map +1 -0
  31. package/dist/hooks/lib/reflection-prompt-builder.js +239 -0
  32. package/dist/hooks/lib/reflection-prompt-builder.js.map +1 -0
  33. package/dist/hooks/lib/reflection-storage.d.ts +64 -0
  34. package/dist/hooks/lib/reflection-storage.d.ts.map +1 -0
  35. package/dist/hooks/lib/reflection-storage.js +305 -0
  36. package/dist/hooks/lib/reflection-storage.js.map +1 -0
  37. package/dist/hooks/lib/run-self-reflection.d.ts +43 -0
  38. package/dist/hooks/lib/run-self-reflection.d.ts.map +1 -0
  39. package/dist/hooks/lib/run-self-reflection.js +203 -0
  40. package/dist/hooks/lib/run-self-reflection.js.map +1 -0
  41. package/dist/hooks/lib/types/reflection-types.d.ts +164 -0
  42. package/dist/hooks/lib/types/reflection-types.d.ts.map +1 -0
  43. package/dist/hooks/lib/types/reflection-types.js +73 -0
  44. package/dist/hooks/lib/types/reflection-types.js.map +1 -0
  45. package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts +89 -0
  46. package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.d.ts.map +1 -0
  47. package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.js +226 -0
  48. package/dist/plugins/specweave/lib/hooks/git-diff-analyzer.js.map +1 -0
  49. package/dist/plugins/specweave/lib/hooks/invoke-translator-skill.d.ts +60 -0
  50. package/dist/plugins/specweave/lib/hooks/invoke-translator-skill.d.ts.map +1 -0
  51. package/dist/plugins/specweave/lib/hooks/invoke-translator-skill.js +201 -0
  52. package/dist/plugins/specweave/lib/hooks/invoke-translator-skill.js.map +1 -0
  53. package/dist/plugins/specweave/lib/hooks/prepare-reflection-context.d.ts +42 -0
  54. package/dist/plugins/specweave/lib/hooks/prepare-reflection-context.d.ts.map +1 -0
  55. package/dist/plugins/specweave/lib/hooks/prepare-reflection-context.js +123 -0
  56. package/dist/plugins/specweave/lib/hooks/prepare-reflection-context.js.map +1 -0
  57. package/dist/plugins/specweave/lib/hooks/reflection-config-loader.d.ts +45 -0
  58. package/dist/plugins/specweave/lib/hooks/reflection-config-loader.d.ts.map +1 -0
  59. package/dist/plugins/specweave/lib/hooks/reflection-config-loader.js +132 -0
  60. package/dist/plugins/specweave/lib/hooks/reflection-config-loader.js.map +1 -0
  61. package/dist/plugins/specweave/lib/hooks/reflection-parser.d.ts +33 -0
  62. package/dist/plugins/specweave/lib/hooks/reflection-parser.d.ts.map +1 -0
  63. package/dist/plugins/specweave/lib/hooks/reflection-parser.js +419 -0
  64. package/dist/plugins/specweave/lib/hooks/reflection-parser.js.map +1 -0
  65. package/dist/plugins/specweave/lib/hooks/reflection-prompt-builder.d.ts +56 -0
  66. package/dist/plugins/specweave/lib/hooks/reflection-prompt-builder.d.ts.map +1 -0
  67. package/dist/plugins/specweave/lib/hooks/reflection-prompt-builder.js +239 -0
  68. package/dist/plugins/specweave/lib/hooks/reflection-prompt-builder.js.map +1 -0
  69. package/dist/plugins/specweave/lib/hooks/reflection-storage.d.ts +64 -0
  70. package/dist/plugins/specweave/lib/hooks/reflection-storage.d.ts.map +1 -0
  71. package/dist/plugins/specweave/lib/hooks/reflection-storage.js +305 -0
  72. package/dist/plugins/specweave/lib/hooks/reflection-storage.js.map +1 -0
  73. package/dist/plugins/specweave/lib/hooks/run-self-reflection.d.ts +43 -0
  74. package/dist/plugins/specweave/lib/hooks/run-self-reflection.d.ts.map +1 -0
  75. package/dist/plugins/specweave/lib/hooks/run-self-reflection.js +203 -0
  76. package/dist/plugins/specweave/lib/hooks/run-self-reflection.js.map +1 -0
  77. package/dist/plugins/specweave/lib/hooks/sync-living-docs.d.ts +27 -0
  78. package/dist/plugins/specweave/lib/hooks/sync-living-docs.d.ts.map +1 -0
  79. package/dist/plugins/specweave/lib/hooks/sync-living-docs.js +116 -0
  80. package/dist/plugins/specweave/lib/hooks/sync-living-docs.js.map +1 -0
  81. package/dist/plugins/specweave/lib/hooks/translate-file.d.ts +59 -0
  82. package/dist/plugins/specweave/lib/hooks/translate-file.d.ts.map +1 -0
  83. package/dist/plugins/specweave/lib/hooks/translate-file.js +350 -0
  84. package/dist/plugins/specweave/lib/hooks/translate-file.js.map +1 -0
  85. package/dist/plugins/specweave/lib/hooks/translate-living-docs.d.ts +13 -0
  86. package/dist/plugins/specweave/lib/hooks/translate-living-docs.d.ts.map +1 -0
  87. package/dist/plugins/specweave/lib/hooks/translate-living-docs.js +175 -0
  88. package/dist/plugins/specweave/lib/hooks/translate-living-docs.js.map +1 -0
  89. package/dist/plugins/specweave/lib/hooks/types/reflection-types.d.ts +164 -0
  90. package/dist/plugins/specweave/lib/hooks/types/reflection-types.d.ts.map +1 -0
  91. package/dist/plugins/specweave/lib/hooks/types/reflection-types.js +73 -0
  92. package/dist/plugins/specweave/lib/hooks/types/reflection-types.js.map +1 -0
  93. package/dist/plugins/specweave/lib/hooks/update-tasks-md.d.ts +29 -0
  94. package/dist/plugins/specweave/lib/hooks/update-tasks-md.d.ts.map +1 -0
  95. package/dist/plugins/specweave/lib/hooks/update-tasks-md.js +203 -0
  96. package/dist/plugins/specweave/lib/hooks/update-tasks-md.js.map +1 -0
  97. package/dist/plugins/specweave-ado/lib/ado-board-resolver.d.ts +94 -0
  98. package/dist/plugins/specweave-ado/lib/ado-board-resolver.d.ts.map +1 -0
  99. package/dist/plugins/specweave-ado/lib/ado-board-resolver.js +219 -0
  100. package/dist/plugins/specweave-ado/lib/ado-board-resolver.js.map +1 -0
  101. package/dist/plugins/specweave-ado/lib/ado-client-v2.d.ts +124 -0
  102. package/dist/plugins/specweave-ado/lib/ado-client-v2.d.ts.map +1 -0
  103. package/dist/plugins/specweave-ado/lib/ado-client-v2.js +382 -0
  104. package/dist/plugins/specweave-ado/lib/ado-client-v2.js.map +1 -0
  105. package/dist/plugins/specweave-ado/lib/ado-client.d.ts +112 -0
  106. package/dist/plugins/specweave-ado/lib/ado-client.d.ts.map +1 -0
  107. package/dist/plugins/specweave-ado/lib/ado-client.js +257 -0
  108. package/dist/plugins/specweave-ado/lib/ado-client.js.map +1 -0
  109. package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.d.ts +40 -0
  110. package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.d.ts.map +1 -0
  111. package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.js +370 -0
  112. package/dist/plugins/specweave-ado/lib/ado-hierarchical-sync.js.map +1 -0
  113. package/dist/plugins/specweave-ado/lib/project-selector.d.ts +42 -0
  114. package/dist/plugins/specweave-ado/lib/project-selector.d.ts.map +1 -0
  115. package/dist/plugins/specweave-ado/lib/project-selector.js +211 -0
  116. package/dist/plugins/specweave-ado/lib/project-selector.js.map +1 -0
  117. package/dist/plugins/specweave-github/lib/github-board-resolver.d.ts +54 -0
  118. package/dist/plugins/specweave-github/lib/github-board-resolver.d.ts.map +1 -0
  119. package/dist/plugins/specweave-github/lib/github-board-resolver.js +122 -0
  120. package/dist/plugins/specweave-github/lib/github-board-resolver.js.map +1 -0
  121. package/dist/plugins/specweave-github/lib/github-client-v2.d.ts +104 -0
  122. package/dist/plugins/specweave-github/lib/github-client-v2.d.ts.map +1 -0
  123. package/dist/plugins/specweave-github/lib/github-client-v2.js +408 -0
  124. package/dist/plugins/specweave-github/lib/github-client-v2.js.map +1 -0
  125. package/dist/plugins/specweave-github/lib/github-client.d.ts +10 -0
  126. package/dist/plugins/specweave-github/lib/github-client.d.ts.map +1 -1
  127. package/dist/plugins/specweave-github/lib/github-client.js +24 -0
  128. package/dist/plugins/specweave-github/lib/github-client.js.map +1 -1
  129. package/dist/plugins/specweave-github/lib/github-hierarchical-sync.d.ts +29 -0
  130. package/dist/plugins/specweave-github/lib/github-hierarchical-sync.d.ts.map +1 -0
  131. package/dist/plugins/specweave-github/lib/github-hierarchical-sync.js +268 -0
  132. package/dist/plugins/specweave-github/lib/github-hierarchical-sync.js.map +1 -0
  133. package/dist/plugins/specweave-github/lib/index.d.ts.map +1 -1
  134. package/dist/plugins/specweave-github/lib/index.js.map +1 -1
  135. package/dist/plugins/specweave-github/lib/repo-selector.d.ts +49 -0
  136. package/dist/plugins/specweave-github/lib/repo-selector.d.ts.map +1 -0
  137. package/dist/plugins/specweave-github/lib/repo-selector.js +216 -0
  138. package/dist/plugins/specweave-github/lib/repo-selector.js.map +1 -0
  139. package/dist/plugins/specweave-github/lib/subtask-sync.d.ts.map +1 -1
  140. package/dist/plugins/specweave-github/lib/subtask-sync.js.map +1 -1
  141. package/dist/plugins/specweave-github/lib/task-parser.d.ts.map +1 -1
  142. package/dist/plugins/specweave-github/lib/task-parser.js.map +1 -1
  143. package/dist/plugins/specweave-github/lib/task-sync.d.ts.map +1 -1
  144. package/dist/plugins/specweave-github/lib/task-sync.js.map +1 -1
  145. package/dist/plugins/specweave-github/lib/types.d.ts.map +1 -1
  146. package/dist/plugins/specweave-github/lib/types.js.map +1 -1
  147. package/dist/plugins/specweave-jira/lib/jira-board-resolver.d.ts +50 -0
  148. package/dist/plugins/specweave-jira/lib/jira-board-resolver.d.ts.map +1 -0
  149. package/dist/plugins/specweave-jira/lib/jira-board-resolver.js +84 -0
  150. package/dist/plugins/specweave-jira/lib/jira-board-resolver.js.map +1 -0
  151. package/dist/plugins/specweave-jira/lib/jira-hierarchical-sync.d.ts +33 -0
  152. package/dist/plugins/specweave-jira/lib/jira-hierarchical-sync.d.ts.map +1 -0
  153. package/dist/plugins/specweave-jira/lib/jira-hierarchical-sync.js +206 -0
  154. package/dist/plugins/specweave-jira/lib/jira-hierarchical-sync.js.map +1 -0
  155. package/dist/plugins/specweave-jira/lib/project-selector.d.ts +42 -0
  156. package/dist/plugins/specweave-jira/lib/project-selector.d.ts.map +1 -0
  157. package/dist/plugins/specweave-jira/lib/project-selector.js +216 -0
  158. package/dist/plugins/specweave-jira/lib/project-selector.js.map +1 -0
  159. package/dist/plugins/specweave-jira/lib/reorganization-detector.d.ts +67 -0
  160. package/dist/plugins/specweave-jira/lib/reorganization-detector.d.ts.map +1 -0
  161. package/dist/plugins/specweave-jira/lib/reorganization-detector.js +252 -0
  162. package/dist/plugins/specweave-jira/lib/reorganization-detector.js.map +1 -0
  163. package/dist/plugins/specweave-jira/lib/setup-wizard.d.ts +29 -0
  164. package/dist/plugins/specweave-jira/lib/setup-wizard.d.ts.map +1 -0
  165. package/dist/plugins/specweave-jira/lib/setup-wizard.js +219 -0
  166. package/dist/plugins/specweave-jira/lib/setup-wizard.js.map +1 -0
  167. package/dist/src/adapters/adapter-base.d.ts +71 -0
  168. package/dist/src/adapters/adapter-base.d.ts.map +1 -0
  169. package/dist/src/adapters/adapter-base.js +139 -0
  170. package/dist/src/adapters/adapter-base.js.map +1 -0
  171. package/dist/src/adapters/adapter-interface.d.ts +149 -0
  172. package/dist/src/adapters/adapter-interface.d.ts.map +1 -0
  173. package/dist/src/adapters/adapter-interface.js +8 -0
  174. package/dist/src/adapters/adapter-interface.js.map +1 -0
  175. package/dist/src/adapters/adapter-loader.d.ts +91 -0
  176. package/dist/src/adapters/adapter-loader.d.ts.map +1 -0
  177. package/dist/src/adapters/adapter-loader.js +238 -0
  178. package/dist/src/adapters/adapter-loader.js.map +1 -0
  179. package/dist/src/adapters/agents-md-generator.d.ts +48 -0
  180. package/dist/src/adapters/agents-md-generator.d.ts.map +1 -0
  181. package/dist/src/adapters/agents-md-generator.js +193 -0
  182. package/dist/src/adapters/agents-md-generator.js.map +1 -0
  183. package/dist/src/adapters/claude/adapter.d.ts +128 -0
  184. package/dist/src/adapters/claude/adapter.d.ts.map +1 -0
  185. package/dist/src/adapters/claude/adapter.js +415 -0
  186. package/dist/src/adapters/claude/adapter.js.map +1 -0
  187. package/dist/src/adapters/claude-md-generator.d.ts +78 -0
  188. package/dist/src/adapters/claude-md-generator.d.ts.map +1 -0
  189. package/dist/src/adapters/claude-md-generator.js +307 -0
  190. package/dist/src/adapters/claude-md-generator.js.map +1 -0
  191. package/dist/src/adapters/codex/adapter.d.ts +50 -0
  192. package/dist/src/adapters/codex/adapter.d.ts.map +1 -0
  193. package/dist/src/adapters/codex/adapter.js +316 -0
  194. package/dist/src/adapters/codex/adapter.js.map +1 -0
  195. package/dist/src/adapters/cursor/adapter.d.ts +98 -0
  196. package/dist/src/adapters/cursor/adapter.d.ts.map +1 -0
  197. package/dist/src/adapters/cursor/adapter.js +406 -0
  198. package/dist/src/adapters/cursor/adapter.js.map +1 -0
  199. package/dist/src/adapters/doc-generator.d.ts +69 -0
  200. package/dist/src/adapters/doc-generator.d.ts.map +1 -0
  201. package/dist/src/adapters/doc-generator.js +247 -0
  202. package/dist/src/adapters/doc-generator.js.map +1 -0
  203. package/dist/src/adapters/gemini/adapter.d.ts +50 -0
  204. package/dist/src/adapters/gemini/adapter.d.ts.map +1 -0
  205. package/dist/src/adapters/gemini/adapter.js +281 -0
  206. package/dist/src/adapters/gemini/adapter.js.map +1 -0
  207. package/dist/src/adapters/generic/adapter.d.ts +86 -0
  208. package/dist/src/adapters/generic/adapter.d.ts.map +1 -0
  209. package/dist/src/adapters/generic/adapter.js +338 -0
  210. package/dist/src/adapters/generic/adapter.js.map +1 -0
  211. package/dist/src/cli/commands/abandon.d.ts +13 -0
  212. package/dist/src/cli/commands/abandon.d.ts.map +1 -0
  213. package/dist/src/cli/commands/abandon.js +15 -0
  214. package/dist/src/cli/commands/abandon.js.map +1 -0
  215. package/dist/src/cli/commands/import-docs.d.ts +21 -0
  216. package/dist/src/cli/commands/import-docs.d.ts.map +1 -0
  217. package/dist/src/cli/commands/import-docs.js +146 -0
  218. package/dist/src/cli/commands/import-docs.js.map +1 -0
  219. package/dist/src/cli/commands/init-multiproject.d.ts +11 -0
  220. package/dist/src/cli/commands/init-multiproject.d.ts.map +1 -0
  221. package/dist/src/cli/commands/init-multiproject.js +202 -0
  222. package/dist/src/cli/commands/init-multiproject.js.map +1 -0
  223. package/dist/src/cli/commands/init.d.ts +9 -0
  224. package/dist/src/cli/commands/init.d.ts.map +1 -0
  225. package/dist/src/cli/commands/init.js +1205 -0
  226. package/dist/src/cli/commands/init.js.map +1 -0
  227. package/dist/src/cli/commands/install.d.ts +9 -0
  228. package/dist/src/cli/commands/install.d.ts.map +1 -0
  229. package/dist/src/cli/commands/install.js +127 -0
  230. package/dist/src/cli/commands/install.js.map +1 -0
  231. package/dist/src/cli/commands/list.d.ts +8 -0
  232. package/dist/src/cli/commands/list.d.ts.map +1 -0
  233. package/dist/src/cli/commands/list.js +119 -0
  234. package/dist/src/cli/commands/list.js.map +1 -0
  235. package/dist/src/cli/commands/migrate-to-multiproject.d.ts +37 -0
  236. package/dist/src/cli/commands/migrate-to-multiproject.d.ts.map +1 -0
  237. package/dist/src/cli/commands/migrate-to-multiproject.js +189 -0
  238. package/dist/src/cli/commands/migrate-to-multiproject.js.map +1 -0
  239. package/dist/src/cli/commands/migrate-to-profiles.d.ts +25 -0
  240. package/dist/src/cli/commands/migrate-to-profiles.d.ts.map +1 -0
  241. package/dist/src/cli/commands/migrate-to-profiles.js +350 -0
  242. package/dist/src/cli/commands/migrate-to-profiles.js.map +1 -0
  243. package/dist/src/cli/commands/pause.d.ts +13 -0
  244. package/dist/src/cli/commands/pause.d.ts.map +1 -0
  245. package/dist/src/cli/commands/pause.js +15 -0
  246. package/dist/src/cli/commands/pause.js.map +1 -0
  247. package/dist/src/cli/commands/qa.d.ts +54 -0
  248. package/dist/src/cli/commands/qa.d.ts.map +1 -0
  249. package/dist/src/cli/commands/qa.js +98 -0
  250. package/dist/src/cli/commands/qa.js.map +1 -0
  251. package/dist/src/cli/commands/resume.d.ts +12 -0
  252. package/dist/src/cli/commands/resume.d.ts.map +1 -0
  253. package/dist/src/cli/commands/resume.js +14 -0
  254. package/dist/src/cli/commands/resume.js.map +1 -0
  255. package/dist/src/cli/commands/status.d.ts +12 -0
  256. package/dist/src/cli/commands/status.d.ts.map +1 -0
  257. package/dist/src/cli/commands/status.js +23 -0
  258. package/dist/src/cli/commands/status.js.map +1 -0
  259. package/dist/src/cli/commands/switch-project.d.ts +13 -0
  260. package/dist/src/cli/commands/switch-project.d.ts.map +1 -0
  261. package/dist/src/cli/commands/switch-project.js +91 -0
  262. package/dist/src/cli/commands/switch-project.js.map +1 -0
  263. package/dist/src/cli/commands/validate-jira.d.ts +35 -0
  264. package/dist/src/cli/commands/validate-jira.d.ts.map +1 -0
  265. package/dist/src/cli/commands/validate-jira.js +112 -0
  266. package/dist/src/cli/commands/validate-jira.js.map +1 -0
  267. package/dist/src/cli/commands/validate-plugins.d.ts +41 -0
  268. package/dist/src/cli/commands/validate-plugins.d.ts.map +1 -0
  269. package/dist/src/cli/commands/validate-plugins.js +171 -0
  270. package/dist/src/cli/commands/validate-plugins.js.map +1 -0
  271. package/dist/src/cli/helpers/issue-tracker/ado.d.ts +57 -0
  272. package/dist/src/cli/helpers/issue-tracker/ado.d.ts.map +1 -0
  273. package/dist/src/cli/helpers/issue-tracker/ado.js +243 -0
  274. package/dist/src/cli/helpers/issue-tracker/ado.js.map +1 -0
  275. package/dist/src/cli/helpers/issue-tracker/github.d.ts +65 -0
  276. package/dist/src/cli/helpers/issue-tracker/github.d.ts.map +1 -0
  277. package/dist/src/cli/helpers/issue-tracker/github.js +426 -0
  278. package/dist/src/cli/helpers/issue-tracker/github.js.map +1 -0
  279. package/dist/src/cli/helpers/issue-tracker/index.d.ts +22 -0
  280. package/dist/src/cli/helpers/issue-tracker/index.d.ts.map +1 -0
  281. package/dist/src/cli/helpers/issue-tracker/index.js +314 -0
  282. package/dist/src/cli/helpers/issue-tracker/index.js.map +1 -0
  283. package/dist/src/cli/helpers/issue-tracker/jira.d.ts +61 -0
  284. package/dist/src/cli/helpers/issue-tracker/jira.d.ts.map +1 -0
  285. package/dist/src/cli/helpers/issue-tracker/jira.js +404 -0
  286. package/dist/src/cli/helpers/issue-tracker/jira.js.map +1 -0
  287. package/dist/src/cli/helpers/issue-tracker/types.d.ts +107 -0
  288. package/dist/src/cli/helpers/issue-tracker/types.d.ts.map +1 -0
  289. package/dist/src/cli/helpers/issue-tracker/types.js +16 -0
  290. package/dist/src/cli/helpers/issue-tracker/types.js.map +1 -0
  291. package/dist/src/cli/helpers/issue-tracker/utils.d.ts +112 -0
  292. package/dist/src/cli/helpers/issue-tracker/utils.d.ts.map +1 -0
  293. package/dist/src/cli/helpers/issue-tracker/utils.js +247 -0
  294. package/dist/src/cli/helpers/issue-tracker/utils.js.map +1 -0
  295. package/dist/src/core/agent-model-manager.d.ts +52 -0
  296. package/dist/src/core/agent-model-manager.d.ts.map +1 -0
  297. package/dist/src/core/agent-model-manager.js +120 -0
  298. package/dist/src/core/agent-model-manager.js.map +1 -0
  299. package/dist/src/core/brownfield/analyzer.d.ts +86 -0
  300. package/dist/src/core/brownfield/analyzer.d.ts.map +1 -0
  301. package/dist/src/core/brownfield/analyzer.js +365 -0
  302. package/dist/src/core/brownfield/analyzer.js.map +1 -0
  303. package/dist/src/core/brownfield/importer.d.ts +76 -0
  304. package/dist/src/core/brownfield/importer.d.ts.map +1 -0
  305. package/dist/src/core/brownfield/importer.js +287 -0
  306. package/dist/src/core/brownfield/importer.js.map +1 -0
  307. package/dist/src/core/config-manager.d.ts +47 -0
  308. package/dist/src/core/config-manager.d.ts.map +1 -0
  309. package/dist/src/core/config-manager.js +136 -0
  310. package/dist/src/core/config-manager.js.map +1 -0
  311. package/dist/src/core/cost-tracker.d.ts +108 -0
  312. package/dist/src/core/cost-tracker.d.ts.map +1 -0
  313. package/dist/src/core/cost-tracker.js +281 -0
  314. package/dist/src/core/cost-tracker.js.map +1 -0
  315. package/dist/src/core/credentials-manager.d.ts +107 -0
  316. package/dist/src/core/credentials-manager.d.ts.map +1 -0
  317. package/dist/src/core/credentials-manager.js +457 -0
  318. package/dist/src/core/credentials-manager.js.map +1 -0
  319. package/dist/src/core/i18n/language-detector.d.ts +29 -0
  320. package/dist/src/core/i18n/language-detector.d.ts.map +1 -0
  321. package/dist/src/core/i18n/language-detector.js +143 -0
  322. package/dist/src/core/i18n/language-detector.js.map +1 -0
  323. package/dist/src/core/i18n/language-manager.d.ts +101 -0
  324. package/dist/src/core/i18n/language-manager.d.ts.map +1 -0
  325. package/dist/src/core/i18n/language-manager.js +232 -0
  326. package/dist/src/core/i18n/language-manager.js.map +1 -0
  327. package/dist/src/core/i18n/language-registry.d.ts +44 -0
  328. package/dist/src/core/i18n/language-registry.d.ts.map +1 -0
  329. package/dist/src/core/i18n/language-registry.js +234 -0
  330. package/dist/src/core/i18n/language-registry.js.map +1 -0
  331. package/dist/src/core/i18n/locale-manager.d.ts +62 -0
  332. package/dist/src/core/i18n/locale-manager.d.ts.map +1 -0
  333. package/dist/src/core/i18n/locale-manager.js +137 -0
  334. package/dist/src/core/i18n/locale-manager.js.map +1 -0
  335. package/dist/src/core/i18n/system-prompt-injector.d.ts +33 -0
  336. package/dist/src/core/i18n/system-prompt-injector.d.ts.map +1 -0
  337. package/dist/src/core/i18n/system-prompt-injector.js +131 -0
  338. package/dist/src/core/i18n/system-prompt-injector.js.map +1 -0
  339. package/dist/src/core/i18n/types.d.ts +151 -0
  340. package/dist/src/core/i18n/types.d.ts.map +1 -0
  341. package/dist/src/core/i18n/types.js +11 -0
  342. package/dist/src/core/i18n/types.js.map +1 -0
  343. package/dist/src/core/increment/limits.d.ts +68 -0
  344. package/dist/src/core/increment/limits.d.ts.map +1 -0
  345. package/dist/src/core/increment/limits.js +224 -0
  346. package/dist/src/core/increment/limits.js.map +1 -0
  347. package/dist/src/core/increment/metadata-manager.d.ts +114 -0
  348. package/dist/src/core/increment/metadata-manager.d.ts.map +1 -0
  349. package/dist/src/core/increment/metadata-manager.js +320 -0
  350. package/dist/src/core/increment/metadata-manager.js.map +1 -0
  351. package/dist/src/core/increment/status-commands.d.ts +43 -0
  352. package/dist/src/core/increment/status-commands.d.ts.map +1 -0
  353. package/dist/src/core/increment/status-commands.js +277 -0
  354. package/dist/src/core/increment/status-commands.js.map +1 -0
  355. package/dist/src/core/increment-status.d.ts +72 -0
  356. package/dist/src/core/increment-status.d.ts.map +1 -0
  357. package/dist/src/core/increment-status.js +227 -0
  358. package/dist/src/core/increment-status.js.map +1 -0
  359. package/dist/src/core/model-selector.d.ts +57 -0
  360. package/dist/src/core/model-selector.d.ts.map +1 -0
  361. package/dist/src/core/model-selector.js +115 -0
  362. package/dist/src/core/model-selector.js.map +1 -0
  363. package/dist/src/core/phase-detector.d.ts +62 -0
  364. package/dist/src/core/phase-detector.d.ts.map +1 -0
  365. package/dist/src/core/phase-detector.js +229 -0
  366. package/dist/src/core/phase-detector.js.map +1 -0
  367. package/dist/src/core/plugin-loader.d.ts +131 -0
  368. package/dist/src/core/plugin-loader.d.ts.map +1 -0
  369. package/dist/src/core/plugin-loader.js +421 -0
  370. package/dist/src/core/plugin-loader.js.map +1 -0
  371. package/dist/src/core/project-manager.d.ts +127 -0
  372. package/dist/src/core/project-manager.d.ts.map +1 -0
  373. package/dist/src/core/project-manager.js +524 -0
  374. package/dist/src/core/project-manager.js.map +1 -0
  375. package/dist/src/core/project-structure-detector.d.ts +92 -0
  376. package/dist/src/core/project-structure-detector.d.ts.map +1 -0
  377. package/dist/src/core/project-structure-detector.js +289 -0
  378. package/dist/src/core/project-structure-detector.js.map +1 -0
  379. package/dist/src/core/qa/qa-runner.d.ts +16 -0
  380. package/dist/src/core/qa/qa-runner.d.ts.map +1 -0
  381. package/dist/src/core/qa/qa-runner.js +404 -0
  382. package/dist/src/core/qa/qa-runner.js.map +1 -0
  383. package/dist/src/core/qa/quality-gate-decider.d.ts +53 -0
  384. package/dist/src/core/qa/quality-gate-decider.d.ts.map +1 -0
  385. package/dist/src/core/qa/quality-gate-decider.js +268 -0
  386. package/dist/src/core/qa/quality-gate-decider.js.map +1 -0
  387. package/dist/src/core/qa/risk-calculator.d.ts +126 -0
  388. package/dist/src/core/qa/risk-calculator.d.ts.map +1 -0
  389. package/dist/src/core/qa/risk-calculator.js +247 -0
  390. package/dist/src/core/qa/risk-calculator.js.map +1 -0
  391. package/dist/src/core/qa/types.d.ts +315 -0
  392. package/dist/src/core/qa/types.d.ts.map +1 -0
  393. package/dist/src/core/qa/types.js +8 -0
  394. package/dist/src/core/qa/types.js.map +1 -0
  395. package/dist/src/core/rfc-generator-v2.d.ts +149 -0
  396. package/dist/src/core/rfc-generator-v2.d.ts.map +1 -0
  397. package/dist/src/core/rfc-generator-v2.js +399 -0
  398. package/dist/src/core/rfc-generator-v2.js.map +1 -0
  399. package/dist/src/core/sync/bidirectional-engine.d.ts +110 -0
  400. package/dist/src/core/sync/bidirectional-engine.d.ts.map +1 -0
  401. package/dist/src/core/sync/bidirectional-engine.js +356 -0
  402. package/dist/src/core/sync/bidirectional-engine.js.map +1 -0
  403. package/dist/src/core/sync/folder-mapper.d.ts +71 -0
  404. package/dist/src/core/sync/folder-mapper.d.ts.map +1 -0
  405. package/dist/src/core/sync/folder-mapper.js +168 -0
  406. package/dist/src/core/sync/folder-mapper.js.map +1 -0
  407. package/dist/src/core/sync/profile-manager.d.ts +72 -0
  408. package/dist/src/core/sync/profile-manager.d.ts.map +1 -0
  409. package/dist/src/core/sync/profile-manager.js +338 -0
  410. package/dist/src/core/sync/profile-manager.js.map +1 -0
  411. package/dist/src/core/sync/profile-selector.d.ts +52 -0
  412. package/dist/src/core/sync/profile-selector.d.ts.map +1 -0
  413. package/dist/src/core/sync/profile-selector.js +179 -0
  414. package/dist/src/core/sync/profile-selector.js.map +1 -0
  415. package/dist/src/core/sync/profile-validator.d.ts +52 -0
  416. package/dist/src/core/sync/profile-validator.d.ts.map +1 -0
  417. package/dist/src/core/sync/profile-validator.js +225 -0
  418. package/dist/src/core/sync/profile-validator.js.map +1 -0
  419. package/dist/src/core/sync/project-context.d.ts +81 -0
  420. package/dist/src/core/sync/project-context.d.ts.map +1 -0
  421. package/dist/src/core/sync/project-context.js +354 -0
  422. package/dist/src/core/sync/project-context.js.map +1 -0
  423. package/dist/src/core/sync/rate-limiter.d.ts +116 -0
  424. package/dist/src/core/sync/rate-limiter.d.ts.map +1 -0
  425. package/dist/src/core/sync/rate-limiter.js +308 -0
  426. package/dist/src/core/sync/rate-limiter.js.map +1 -0
  427. package/dist/src/core/sync/time-range-selector.d.ts +48 -0
  428. package/dist/src/core/sync/time-range-selector.d.ts.map +1 -0
  429. package/dist/src/core/sync/time-range-selector.js +224 -0
  430. package/dist/src/core/sync/time-range-selector.js.map +1 -0
  431. package/dist/src/core/types/config.d.ts +90 -0
  432. package/dist/src/core/types/config.d.ts.map +1 -0
  433. package/dist/src/core/types/config.js +37 -0
  434. package/dist/src/core/types/config.js.map +1 -0
  435. package/dist/src/core/types/increment-metadata.d.ts +120 -0
  436. package/dist/src/core/types/increment-metadata.d.ts.map +1 -0
  437. package/dist/src/core/types/increment-metadata.js +138 -0
  438. package/dist/src/core/types/increment-metadata.js.map +1 -0
  439. package/dist/src/core/types/plugin.d.ts +283 -0
  440. package/dist/src/core/types/plugin.d.ts.map +1 -0
  441. package/dist/src/core/types/plugin.js +49 -0
  442. package/dist/src/core/types/plugin.js.map +1 -0
  443. package/dist/src/core/types/sync-profile.d.ts +403 -0
  444. package/dist/src/core/types/sync-profile.d.ts.map +1 -0
  445. package/dist/src/core/types/sync-profile.js +55 -0
  446. package/dist/src/core/types/sync-profile.js.map +1 -0
  447. package/dist/src/hooks/lib/types/reflection-types.d.ts +125 -0
  448. package/dist/src/hooks/lib/types/reflection-types.d.ts.map +1 -0
  449. package/dist/src/hooks/lib/types/reflection-types.js +54 -0
  450. package/dist/src/hooks/lib/types/reflection-types.js.map +1 -0
  451. package/dist/src/integrations/ado/ado-client.d.ts +127 -0
  452. package/dist/src/integrations/ado/ado-client.d.ts.map +1 -0
  453. package/dist/src/integrations/ado/ado-client.js +416 -0
  454. package/dist/src/integrations/ado/ado-client.js.map +1 -0
  455. package/dist/src/integrations/jira/jira-client.d.ts +139 -0
  456. package/dist/src/integrations/jira/jira-client.d.ts.map +1 -0
  457. package/dist/src/integrations/jira/jira-client.js +386 -0
  458. package/dist/src/integrations/jira/jira-client.js.map +1 -0
  459. package/dist/src/integrations/jira/jira-incremental-mapper.d.ts +75 -0
  460. package/dist/src/integrations/jira/jira-incremental-mapper.d.ts.map +1 -0
  461. package/dist/src/integrations/jira/jira-incremental-mapper.js +474 -0
  462. package/dist/src/integrations/jira/jira-incremental-mapper.js.map +1 -0
  463. package/dist/src/integrations/jira/jira-mapper.d.ts +105 -0
  464. package/dist/src/integrations/jira/jira-mapper.d.ts.map +1 -0
  465. package/dist/src/integrations/jira/jira-mapper.js +494 -0
  466. package/dist/src/integrations/jira/jira-mapper.js.map +1 -0
  467. package/dist/src/metrics/calculators/change-failure-rate.d.ts +22 -0
  468. package/dist/src/metrics/calculators/change-failure-rate.d.ts.map +1 -0
  469. package/dist/src/metrics/calculators/change-failure-rate.js +70 -0
  470. package/dist/src/metrics/calculators/change-failure-rate.js.map +1 -0
  471. package/dist/src/metrics/calculators/deployment-frequency.d.ts +20 -0
  472. package/dist/src/metrics/calculators/deployment-frequency.d.ts.map +1 -0
  473. package/dist/src/metrics/calculators/deployment-frequency.js +61 -0
  474. package/dist/src/metrics/calculators/deployment-frequency.js.map +1 -0
  475. package/dist/src/metrics/calculators/lead-time.d.ts +22 -0
  476. package/dist/src/metrics/calculators/lead-time.d.ts.map +1 -0
  477. package/dist/src/metrics/calculators/lead-time.js +82 -0
  478. package/dist/src/metrics/calculators/lead-time.js.map +1 -0
  479. package/dist/src/metrics/calculators/mttr.d.ts +21 -0
  480. package/dist/src/metrics/calculators/mttr.d.ts.map +1 -0
  481. package/dist/src/metrics/calculators/mttr.js +60 -0
  482. package/dist/src/metrics/calculators/mttr.js.map +1 -0
  483. package/dist/src/metrics/dora-calculator.d.ts +28 -0
  484. package/dist/src/metrics/dora-calculator.d.ts.map +1 -0
  485. package/dist/src/metrics/dora-calculator.js +117 -0
  486. package/dist/src/metrics/dora-calculator.js.map +1 -0
  487. package/dist/src/metrics/github-client.d.ts +51 -0
  488. package/dist/src/metrics/github-client.d.ts.map +1 -0
  489. package/dist/src/metrics/github-client.js +133 -0
  490. package/dist/src/metrics/github-client.js.map +1 -0
  491. package/dist/src/metrics/report-generator.d.ts +17 -0
  492. package/dist/src/metrics/report-generator.d.ts.map +1 -0
  493. package/dist/src/metrics/report-generator.js +403 -0
  494. package/dist/src/metrics/report-generator.js.map +1 -0
  495. package/dist/src/metrics/types.d.ts +112 -0
  496. package/dist/src/metrics/types.d.ts.map +1 -0
  497. package/dist/src/metrics/types.js +10 -0
  498. package/dist/src/metrics/types.js.map +1 -0
  499. package/dist/src/metrics/utils/percentile.d.ts +25 -0
  500. package/dist/src/metrics/utils/percentile.d.ts.map +1 -0
  501. package/dist/src/metrics/utils/percentile.js +46 -0
  502. package/dist/src/metrics/utils/percentile.js.map +1 -0
  503. package/dist/src/metrics/utils/tier-classifier.d.ts +61 -0
  504. package/dist/src/metrics/utils/tier-classifier.d.ts.map +1 -0
  505. package/dist/src/metrics/utils/tier-classifier.js +100 -0
  506. package/dist/src/metrics/utils/tier-classifier.js.map +1 -0
  507. package/dist/src/testing/test-generator.d.ts +117 -0
  508. package/dist/src/testing/test-generator.d.ts.map +1 -0
  509. package/dist/src/testing/test-generator.js +370 -0
  510. package/dist/src/testing/test-generator.js.map +1 -0
  511. package/dist/src/types/cost-tracking.d.ts +43 -0
  512. package/dist/src/types/cost-tracking.d.ts.map +1 -0
  513. package/dist/src/types/cost-tracking.js +8 -0
  514. package/dist/src/types/cost-tracking.js.map +1 -0
  515. package/dist/src/types/model-selection.d.ts +53 -0
  516. package/dist/src/types/model-selection.d.ts.map +1 -0
  517. package/dist/src/types/model-selection.js +12 -0
  518. package/dist/src/types/model-selection.js.map +1 -0
  519. package/dist/src/utils/agents-md-compiler.d.ts +68 -0
  520. package/dist/src/utils/agents-md-compiler.d.ts.map +1 -0
  521. package/dist/src/utils/agents-md-compiler.js +420 -0
  522. package/dist/src/utils/agents-md-compiler.js.map +1 -0
  523. package/dist/src/utils/auth-helpers.d.ts +58 -0
  524. package/dist/src/utils/auth-helpers.d.ts.map +1 -0
  525. package/dist/src/utils/auth-helpers.js +108 -0
  526. package/dist/src/utils/auth-helpers.js.map +1 -0
  527. package/dist/src/utils/auto-install.d.ts +47 -0
  528. package/dist/src/utils/auto-install.d.ts.map +1 -0
  529. package/dist/src/utils/auto-install.js +211 -0
  530. package/dist/src/utils/auto-install.js.map +1 -0
  531. package/dist/src/utils/claude-cli-detector.d.ts +75 -0
  532. package/dist/src/utils/claude-cli-detector.d.ts.map +1 -0
  533. package/dist/src/utils/claude-cli-detector.js +285 -0
  534. package/dist/src/utils/claude-cli-detector.js.map +1 -0
  535. package/dist/src/utils/cost-reporter.d.ts +58 -0
  536. package/dist/src/utils/cost-reporter.d.ts.map +1 -0
  537. package/dist/src/utils/cost-reporter.js +224 -0
  538. package/dist/src/utils/cost-reporter.js.map +1 -0
  539. package/dist/src/utils/docs-preview/config-generator.d.ts +46 -0
  540. package/dist/src/utils/docs-preview/config-generator.d.ts.map +1 -0
  541. package/dist/src/utils/docs-preview/config-generator.js +377 -0
  542. package/dist/src/utils/docs-preview/config-generator.js.map +1 -0
  543. package/dist/src/utils/docs-preview/docusaurus-setup.d.ts +38 -0
  544. package/dist/src/utils/docs-preview/docusaurus-setup.d.ts.map +1 -0
  545. package/dist/src/utils/docs-preview/docusaurus-setup.js +177 -0
  546. package/dist/src/utils/docs-preview/docusaurus-setup.js.map +1 -0
  547. package/dist/src/utils/docs-preview/index.d.ts +7 -0
  548. package/dist/src/utils/docs-preview/index.d.ts.map +1 -0
  549. package/dist/src/utils/docs-preview/index.js +7 -0
  550. package/dist/src/utils/docs-preview/index.js.map +1 -0
  551. package/dist/src/utils/docs-preview/package-installer.d.ts +42 -0
  552. package/dist/src/utils/docs-preview/package-installer.d.ts.map +1 -0
  553. package/dist/src/utils/docs-preview/package-installer.js +182 -0
  554. package/dist/src/utils/docs-preview/package-installer.js.map +1 -0
  555. package/dist/src/utils/docs-preview/server-manager.d.ts +30 -0
  556. package/dist/src/utils/docs-preview/server-manager.d.ts.map +1 -0
  557. package/dist/src/utils/docs-preview/server-manager.js +212 -0
  558. package/dist/src/utils/docs-preview/server-manager.js.map +1 -0
  559. package/dist/src/utils/docs-preview/sidebar-builder.d.ts +32 -0
  560. package/dist/src/utils/docs-preview/sidebar-builder.d.ts.map +1 -0
  561. package/dist/src/utils/docs-preview/sidebar-builder.js +202 -0
  562. package/dist/src/utils/docs-preview/sidebar-builder.js.map +1 -0
  563. package/dist/src/utils/docs-preview/types.d.ts +57 -0
  564. package/dist/src/utils/docs-preview/types.d.ts.map +1 -0
  565. package/dist/src/utils/docs-preview/types.js +2 -0
  566. package/dist/src/utils/docs-preview/types.js.map +1 -0
  567. package/dist/src/utils/env-file.d.ts +88 -0
  568. package/dist/src/utils/env-file.d.ts.map +1 -0
  569. package/dist/src/utils/env-file.js +180 -0
  570. package/dist/src/utils/env-file.js.map +1 -0
  571. package/dist/src/utils/env-multi-project-parser.d.ts +220 -0
  572. package/dist/src/utils/env-multi-project-parser.d.ts.map +1 -0
  573. package/dist/src/utils/env-multi-project-parser.js +403 -0
  574. package/dist/src/utils/env-multi-project-parser.js.map +1 -0
  575. package/dist/src/utils/esm-helpers.d.ts +50 -0
  576. package/dist/src/utils/esm-helpers.d.ts.map +1 -0
  577. package/dist/src/utils/esm-helpers.js +57 -0
  578. package/dist/src/utils/esm-helpers.js.map +1 -0
  579. package/dist/src/utils/execFileNoThrow.d.ts +99 -0
  580. package/dist/src/utils/execFileNoThrow.d.ts.map +1 -0
  581. package/dist/src/utils/execFileNoThrow.js +137 -0
  582. package/dist/src/utils/execFileNoThrow.js.map +1 -0
  583. package/dist/src/utils/external-resource-validator.d.ts +102 -0
  584. package/dist/src/utils/external-resource-validator.d.ts.map +1 -0
  585. package/dist/src/utils/external-resource-validator.js +400 -0
  586. package/dist/src/utils/external-resource-validator.js.map +1 -0
  587. package/dist/src/utils/generate-skills-index.d.ts +24 -0
  588. package/dist/src/utils/generate-skills-index.d.ts.map +1 -0
  589. package/dist/src/utils/generate-skills-index.js +410 -0
  590. package/dist/src/utils/generate-skills-index.js.map +1 -0
  591. package/dist/src/utils/model-selection.d.ts +75 -0
  592. package/dist/src/utils/model-selection.d.ts.map +1 -0
  593. package/dist/src/utils/model-selection.js +204 -0
  594. package/dist/src/utils/model-selection.js.map +1 -0
  595. package/dist/src/utils/plugin-validator.d.ts +161 -0
  596. package/dist/src/utils/plugin-validator.d.ts.map +1 -0
  597. package/dist/src/utils/plugin-validator.js +558 -0
  598. package/dist/src/utils/plugin-validator.js.map +1 -0
  599. package/dist/src/utils/pricing-constants.d.ts +70 -0
  600. package/dist/src/utils/pricing-constants.d.ts.map +1 -0
  601. package/dist/src/utils/pricing-constants.js +71 -0
  602. package/dist/src/utils/pricing-constants.js.map +1 -0
  603. package/dist/src/utils/project-detection.d.ts +141 -0
  604. package/dist/src/utils/project-detection.d.ts.map +1 -0
  605. package/dist/src/utils/project-detection.js +321 -0
  606. package/dist/src/utils/project-detection.js.map +1 -0
  607. package/dist/src/utils/string-utils.d.ts +40 -0
  608. package/dist/src/utils/string-utils.d.ts.map +1 -0
  609. package/dist/src/utils/string-utils.js +58 -0
  610. package/dist/src/utils/string-utils.js.map +1 -0
  611. package/dist/src/utils/translation.d.ts +187 -0
  612. package/dist/src/utils/translation.d.ts.map +1 -0
  613. package/dist/src/utils/translation.js +414 -0
  614. package/dist/src/utils/translation.js.map +1 -0
  615. package/dist/utils/plugin-validator.d.ts.map +1 -1
  616. package/dist/utils/plugin-validator.js +0 -7
  617. package/dist/utils/plugin-validator.js.map +1 -1
  618. package/package.json +3 -2
  619. package/plugins/specweave/agents/reflective-reviewer/AGENT.md +535 -0
  620. package/plugins/specweave/hooks/post-first-increment.sh +10 -28
  621. package/plugins/specweave/hooks/post-increment-planning.sh +261 -1
  622. package/plugins/specweave/hooks/post-task-completion.sh +26 -0
  623. package/plugins/specweave/lib/hooks/git-diff-analyzer.ts +269 -0
  624. package/plugins/specweave/lib/hooks/invoke-translator-skill.ts +264 -0
  625. package/plugins/specweave/lib/hooks/prepare-reflection-context.ts +178 -0
  626. package/plugins/specweave/lib/hooks/reflection-config-loader.ts +156 -0
  627. package/plugins/specweave/lib/hooks/reflection-parser.ts +484 -0
  628. package/plugins/specweave/lib/hooks/reflection-prompt-builder.ts +306 -0
  629. package/plugins/specweave/lib/hooks/reflection-storage.ts +369 -0
  630. package/plugins/specweave/lib/hooks/run-self-reflection.ts +258 -0
  631. package/plugins/specweave/lib/hooks/sync-living-docs.ts +147 -0
  632. package/plugins/specweave/lib/hooks/translate-file.ts +428 -0
  633. package/plugins/specweave/lib/hooks/translate-living-docs.ts +224 -0
  634. package/plugins/specweave/lib/hooks/types/reflection-types.ts +193 -0
  635. package/plugins/specweave/lib/hooks/update-tasks-md.ts +256 -0
  636. package/plugins/specweave/skills/SKILLS-INDEX.md +2 -2
  637. package/plugins/specweave/skills/increment-planner/SKILL.md +21 -92
  638. package/plugins/specweave/skills/plugin-expert/SKILL.md +0 -4
  639. package/plugins/specweave/skills/plugin-installer/SKILL.md +41 -28
  640. package/plugins/specweave/skills/plugin-validator/SKILL.md +0 -1
  641. package/plugins/specweave/skills/project-kickstarter/SKILL.md +3 -3
  642. package/plugins/specweave/skills/spec-generator/SKILL.md +3 -3
  643. package/plugins/specweave-ado/agents/ado-manager/AGENT.md +2 -0
  644. package/plugins/specweave-ado/commands/specweave-ado-sync.md +102 -9
  645. package/plugins/specweave-ado/skills/ado-sync/SKILL.md +7 -3
  646. package/plugins/specweave-docs-preview/.claude-plugin/plugin.json +21 -0
  647. package/plugins/specweave-docs-preview/commands/build.md +489 -0
  648. package/plugins/specweave-docs-preview/commands/preview.md +330 -0
  649. package/plugins/specweave-docs-preview/skills/docs-preview/SKILL.md +386 -0
  650. package/plugins/specweave-github/agents/github-manager/AGENT.md +14 -4
  651. package/plugins/specweave-github/commands/specweave-github-sync.md +60 -11
  652. package/plugins/specweave-github/skills/github-sync/SKILL.md +3 -1
  653. package/plugins/specweave-jira/agents/jira-manager/AGENT.md +18 -8
  654. package/plugins/specweave-jira/commands/specweave-jira-sync.md +62 -19
  655. package/plugins/specweave-jira/skills/jira-sync/SKILL.md +5 -3
  656. package/plugins/specweave/skills/translator/SKILL.md.bak +0 -172
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specweave",
3
- "version": "0.6.1",
3
+ "version": "0.11.0",
4
4
  "description": "SpecWeave - Spec-Driven Development Framework. PM-led planning, intelligent model selection, living documentation, multi-tool support.",
5
5
  "owner": {
6
6
  "name": "Anton Abyzov",
@@ -12,7 +12,7 @@
12
12
  "description": "SpecWeave framework - increment lifecycle, living docs, PM-led planning",
13
13
  "source": "./plugins/specweave",
14
14
  "category": "development",
15
- "version": "0.6.1",
15
+ "version": "0.11.0",
16
16
  "author": {
17
17
  "name": "Anton Abyzov",
18
18
  "email": "anton@spec-weave.com"
@@ -152,7 +152,7 @@
152
152
  },
153
153
  {
154
154
  "name": "specweave-docs-preview",
155
- "description": "Documentation preview - Local Docusaurus server with auto-generated sidebar, hot reload, and beautiful UI. Auto-suggests after first increment. Keywords: docs, preview, documentation, browse docs",
155
+ "description": "Interactive documentation preview - Launch Docusaurus dev server with hot reload, auto-generated sidebar, Mermaid diagrams. Build static sites for deployment.",
156
156
  "source": "./plugins/specweave-docs-preview",
157
157
  "category": "productivity",
158
158
  "version": "1.0.0",
package/CLAUDE.md CHANGED
@@ -681,10 +681,10 @@ my-project/
681
681
  - ✅ Strategy docs are project-level, not module-level
682
682
  - ✅ Living docs sync works best with one central location
683
683
 
684
- **Plugin Detection**:
685
- - ✅ Four-phase detection assumes one `.specweave/` folder
686
- - ✅ Auto-detection scans from root only
687
- - ✅ No ambiguity about where plugins are enabled
684
+ **Plugin Installation**:
685
+ - ✅ ALL plugins installed automatically during `specweave init`
686
+ - ✅ No selective loading or detection needed
687
+ - ✅ Full capabilities available immediately
688
688
 
689
689
  **Prevents Chaos**:
690
690
  - ❌ Nested folders cause: Which is the source of truth?
@@ -842,7 +842,7 @@ if (parentSpecweave) {
842
842
  - Domain expertise (ML, payments) = separate plugins
843
843
  - Core plugin = only increment lifecycle + living docs automation
844
844
 
845
- ### Available Plugins (Opt-In)
845
+ ### Available Plugins (All Auto-Installed)
846
846
 
847
847
  **Implemented Plugins**:
848
848
 
@@ -891,20 +891,22 @@ if (parentSpecweave) {
891
891
  | **jira-sync** | 1 | 1 | 2 | JIRA project tracking |
892
892
  | **ado-sync** | 1 | 1 | 2 | Azure DevOps tracking |
893
893
 
894
- ### Context Efficiency Examples
894
+ ### Context Efficiency
895
895
 
896
- **Before** - Monolithic approach:
897
- - Simple React app: Loads ALL 44 skills + 20 agents ≈ **50K tokens**
898
- - Backend API: Loads ALL 44 skills + 20 agents ≈ **50K tokens**
899
- - ML pipeline: Loads ALL 44 skills + 20 agents ≈ **50K tokens**
896
+ **All plugins are installed, but only relevant skills activate based on context**. Claude Code's native skill system ensures:
897
+ - Skills only activate when their description keywords match the conversation
898
+ - Agents only load when explicitly invoked
899
+ - Commands only appear when relevant
900
900
 
901
- **After** - Modular plugin architecture:
902
- - Simple React app: Core + frontend-stack + github **16K tokens** (68% reduction!)
903
- - Backend API: Core + nodejs-backend + github **15K tokens** (70% reduction!)
904
- - ML pipeline: Core + ml-ops + github **18K tokens** (64% reduction!)
905
- - SpecWeave itself: Core + github + diagrams ≈ **15K tokens** (70% reduction!)
901
+ **Example**: Working on a React frontend:
902
+ - `specweave-frontend` skills activate (React, Next.js, design systems)
903
+ - `specweave-github` skills activate (if mentioning GitHub)
904
+ - `specweave-ml` skills stay dormant (ML keywords not detected)
905
+ - `specweave-payments` skills stay dormant (Stripe not mentioned)
906
906
 
907
- ### How Plugins Are Loaded (Intelligent Auto-Loading)
907
+ **Result**: Even with 19+ plugins installed, you only "pay" (in tokens) for what you're actively using in the conversation.
908
+
909
+ ### How Plugins Are Loaded (All Plugins Installed Upfront)
908
910
 
909
911
  **SpecWeave's plugin system is designed to be intelligent and non-intrusive:**
910
912
 
@@ -932,193 +934,62 @@ When you run `specweave init`:
932
934
  - Claude Code automatically discovers plugins from GitHub
933
935
  - No manual `/plugin marketplace add` needed!
934
936
 
935
- 2. ✅ **Core Plugin Auto-Installation**
936
- - Automatically runs: `claude plugin marketplace add` and `claude plugin install specweave`
937
+ 2. ✅ **ALL Plugins Auto-Installation** (Breaking Change: No Selective Loading!)
938
+ - Automatically installs ALL 19+ plugins from marketplace.json
937
939
  - Works via CLI during init (uses user's shell to access `claude` command)
938
- - Slash commands available IMMEDIATELY - no manual install!
939
- - Success message: "✔ SpecWeave core plugin installed automatically!"
940
+ - Installation process:
941
+ 1. Removes existing marketplace (if present)
942
+ 2. Re-adds marketplace from GitHub (always fresh)
943
+ 3. Reads marketplace.json to get list of all plugins
944
+ 4. Installs each plugin via `claude plugin install {name}`
945
+ 5. Reports success/failure for each plugin
946
+ - All slash commands available IMMEDIATELY - no manual install needed!
947
+ - Success message: "✔ Installed: 19/19 plugins"
940
948
  - Graceful fallback: If CLI unavailable, shows manual install instructions
941
-
942
- 3. ✅ **Issue Tracker Plugin Auto-Installation** (NEW! v0.8.18+)
943
- - Detects GitHub/Jira/Azure DevOps from project structure
944
- - Prompts for credentials (API tokens, PATs)
945
- - **Automatically installs** corresponding plugin (specweave-github, specweave-jira, specweave-ado)
946
- - Happens AFTER marketplace registration (ensures plugin installation succeeds)
947
- - Shows detailed error messages if auto-install fails
948
- - Example: Jira detected → credentials saved → `specweave-jira` plugin installed automatically
949
-
950
- 4. ℹ️ **Optional Plugins Available**
951
- - Suggested based on project type (frontend, backend, infrastructure)
952
- - User can install later via `/plugin install specweave-{name}`
949
+ - **No selective loading**: Everything installed upfront for full capabilities
953
950
 
954
951
  **Key Architectural Change**:
955
952
  - ❌ Old: Copied `.claude-plugin/` + `plugins/` to every project (~2MB bloat)
956
953
  - ✅ New: Reference GitHub marketplace (~2KB settings.json, always up-to-date)
957
954
 
958
- #### Phase 2: Increment Planning (Intelligent Plugin Detection)
959
-
960
- When you create increments (e.g., `/specweave:increment "Add Stripe billing"`):
961
-
962
- 1. **Spec Analysis** (v0.6.0+, Enhanced v0.8.18+)
963
- - increment-planner skill scans spec.md content
964
- - Detects keywords: "Stripe", "GitHub", "Kubernetes", "React", etc.
965
- - Maps keywords → required plugins (see Step 6 in increment-planner/SKILL.md)
966
-
967
- 2. **🚨 AUTOMATIC Plugin Recommendation** (Enhanced v0.8.18+)
968
- ```
969
- 🔌 Detected plugin requirements from spec content:
970
-
971
- REQUIRED (will significantly improve implementation):
972
- • specweave-payments - Stripe integration
973
- Detected: "billing", "Stripe", "subscriptions"
974
- Provides: Stripe expert agent, payment flow validation, webhook handling
975
- → Without this: Manual Stripe integration, no validation
976
-
977
- 📦 Install recommended plugins:
978
- /plugin install specweave-payments
979
-
980
- 💡 Benefits:
981
- • Plugins provide specialized AI agents (Stripe expert, etc.)
982
- • Skills auto-activate based on context (zero manual invocation)
983
- • 70%+ context reduction (only load what you need)
984
- • Best practices built-in (from real-world experience)
985
-
986
- Would you like me to wait while you install these plugins? (Recommended)
987
- Or shall I continue without them? (Limited capabilities)
988
- ```
989
-
990
- 3. **User Decision**
991
- - Install now → Plugin activates immediately (skills available during implementation)
992
- - Install later → Skills won't be available until plugin installed (can add mid-work)
993
- - Skip → Increment creation continues (not blocked, but capabilities limited)
994
-
995
- #### Phase 2.5: Just-in-Time Plugin Installation (NEW! v0.10.0+)
996
-
997
- **The Critical Gap**: Users request features that require plugins (e.g., "preview docs locally"), but those plugins aren't installed yet. Instead of failing silently or recommending manual installation, SpecWeave now **automatically installs plugins just-in-time**.
998
-
999
- **How it works** (via `plugin-installer` skill):
955
+ #### Phase 2: Implementation (All Plugins Ready)
1000
956
 
1001
- 1. **Automatic Detection**
1002
- - User requests a feature (e.g., "Show me the internal docs in a browser")
1003
- - `plugin-installer` skill detects keywords: "docs", "browser" → needs `specweave-docs-preview`
1004
- - Checks if plugin is installed: `/plugin list --installed`
1005
-
1006
- 2. **Auto-Installation**
1007
- ```
1008
- 🔌 Detected need for specweave-docs-preview plugin
1009
-
1010
- 📦 Installing specweave-docs-preview...
1011
- This plugin provides: Beautiful Docusaurus UI for browsing .specweave/docs/
1012
-
1013
- ✅ Plugin installed successfully!
1014
- You can now:
1015
- • Browse documentation in beautiful UI
1016
- • Hot reload when editing markdown files
1017
- • Render Mermaid diagrams automatically
1018
-
1019
- Proceeding to launch docs preview server...
1020
- ```
1021
-
1022
- 3. **Seamless Execution**
1023
- - Plugin installed automatically (no manual intervention)
1024
- - Feature executes immediately
1025
- - User sees clear notification of what was installed and why
1026
-
1027
- **Supported Just-in-Time Plugins**:
1028
-
1029
- | User Keywords | Auto-Installed Plugin | Capabilities |
1030
- |--------------|----------------------|--------------|
1031
- | "preview docs", "documentation UI", "Docusaurus" | `specweave-docs-preview` | Beautiful docs UI, hot reload |
1032
- | "React", "Next.js", "frontend", "UI component" | `specweave-frontend` | Frontend expert, design systems |
1033
- | "K8s", "Kubernetes", "Helm", "deploy" | `specweave-kubernetes` | K8s expert, manifest generation |
1034
- | "TensorFlow", "PyTorch", "ML model" | `specweave-ml` | ML pipelines, training, deployment |
1035
- | "Stripe", "billing", "payment" | `specweave-payments` | Payment expert, Stripe integration |
1036
- | "Playwright", "E2E testing", "browser automation" | `specweave-testing` | E2E testing infrastructure |
1037
- | "Figma", "design tokens", "prototype" | `specweave-figma` | Design system integration |
1038
- | "Mermaid", "C4 model", "architecture diagram" | `specweave-diagrams` | Diagram generation |
1039
-
1040
- **Key Benefits**:
1041
- - ✅ **Zero friction**: No manual plugin installation needed
1042
- - ✅ **Proactive**: Detects requirements automatically based on user request
1043
- - ✅ **Clear UX**: Users understand what's being installed and why
1044
- - ✅ **Fail-safe**: Handles installation errors gracefully with troubleshooting steps
1045
-
1046
- **See**: `plugins/specweave/skills/plugin-installer/SKILL.md` for complete keyword map and workflow
1047
-
1048
- #### Phase 3: Implementation (Auto-Activation)
1049
-
1050
- When plugins are installed:
957
+ After `specweave init`, ALL plugins are already installed. No additional steps needed!
1051
958
 
1052
959
  1. **Skills Auto-Activate**
1053
960
  - Based on description keywords (Claude Code native behavior)
1054
961
  - No manual invocation needed
1055
962
  - Example: Mention "GitHub" → github-sync skill activates
1056
963
 
1057
- 2. **Context Efficiency**
1058
- - Only loaded plugins consume tokens
1059
- - 70%+ reduction vs. monolithic approach
1060
- - Real-time: Simple React app = 16K tokens (was 50K in v0.3.7)
1061
-
1062
- #### Phase 4: First Increment Completion (Documentation Preview)
964
+ 2. **All Capabilities Available**
965
+ - GitHub integration: `/specweave-github:sync`
966
+ - JIRA integration: `/specweave-jira:sync`
967
+ - Frontend tools: React, Next.js, design systems
968
+ - Backend tools: Node.js, Python, .NET
969
+ - Infrastructure: Kubernetes, Helm, monitoring
970
+ - ...and 19+ more plugins ready to use!
1063
971
 
1064
- After completing your first increment:
972
+ ### Plugin Management
1065
973
 
1066
- 1. **🎉 Post-First-Increment Hook** (NEW! v0.8.18+)
1067
- - Automatically triggers when first increment is marked complete
1068
- - Suggests docs-preview plugin for beautiful documentation UI
1069
- - Shows clear benefits and install command
1070
-
1071
- 2. **Suggestion Format**:
1072
- ```
1073
- 🎉 Congratulations! You completed your first increment!
1074
-
1075
- 📚 Preview your documentation in a beautiful UI?
1076
-
1077
- The specweave-docs-preview plugin can generate a Docusaurus site from
1078
- your .specweave/docs/ folder with:
1079
-
1080
- ✓ Auto-generated sidebar from folder structure
1081
- ✓ Hot reload (edit markdown, see changes instantly)
1082
- ✓ Mermaid diagram rendering
1083
- ✓ Priority sorting (Strategy → Specs → Architecture → ...)
1084
-
1085
- 📦 Install with:
1086
- /plugin install specweave-docs-preview
1087
-
1088
- 🚀 Then launch:
1089
- /specweave:docs preview
1090
- ```
1091
-
1092
- 3. **Benefits**:
1093
- - Beautiful, searchable documentation site (Docusaurus 3.x)
1094
- - Live preview with hot reload (see changes in real-time)
1095
- - Auto-generated navigation from folder structure
1096
- - Mermaid diagrams rendered automatically
1097
- - Share docs with stakeholders (export static site)
1098
-
1099
- ### Manual Plugin Management
1100
-
1101
- All plugin management happens through Claude Code's native commands:
974
+ **All 19+ plugins are automatically installed during `specweave init`**. You rarely need to manage plugins manually, but Claude Code's native commands are available if needed:
1102
975
 
1103
976
  ```bash
1104
- # List installed plugins
977
+ # List installed plugins (should show all 19+ SpecWeave plugins)
1105
978
  /plugin list --installed
1106
979
 
1107
- # Install a specific plugin
1108
- /plugin install specweave-kubernetes
1109
-
1110
- # Uninstall a plugin
980
+ # Uninstall a plugin (not recommended - breaks functionality)
1111
981
  /plugin uninstall specweave-kubernetes
1112
982
 
1113
- # List all available plugins from marketplace
1114
- /plugin list specweave
983
+ # Reinstall all plugins (if you uninstalled something by mistake)
984
+ specweave init . # Re-runs full installation
1115
985
  ```
1116
986
 
1117
987
  **Key Insight**: SpecWeave uses **ONLY** Claude Code's native plugin system:
988
+ - ALL plugins installed automatically during init (no manual selection)
1118
989
  - Plugins install globally via `/plugin install specweave-{name}`
1119
990
  - Work across ALL projects (like VS Code extensions)
1120
991
  - Auto-activate based on skills' description keywords
1121
- - Managed by Claude Code (updates, uninstall, etc.)
992
+ - Managed by Claude Code (updates handled via `specweave init` re-run)
1122
993
 
1123
994
  ### Development vs Production Setup
1124
995
 
@@ -2117,6 +1988,137 @@ ls -1 .specweave/increments/ | grep -E '^[0-9]{4}' | wc -l
2117
1988
  - ✅ **Compliance & auditing**: Complete audit trail of all product decisions
2118
1989
  - ✅ **Living documentation**: Specs stay up-to-date without manual intervention
2119
1990
 
1991
+ **Post-Increment-Planning Hook** (AUTOMATIC after `/specweave:increment`):
1992
+
1993
+ **GitHub Issue Auto-Creation** (NEW in v0.8.20+):
1994
+
1995
+ **The Critical Problem**: Without automatic GitHub issue creation, increments don't sync to GitHub automatically. This requires manual `/specweave-github:create-issue` calls, which are often forgotten.
1996
+
1997
+ **The Solution**: The `post-increment-planning.sh` hook now auto-creates GitHub issues immediately after increment planning completes.
1998
+
1999
+ **How It Works** (Automatic):
2000
+ 1. **Hook Triggers**: After `/specweave:increment` completes planning (spec.md, plan.md, tasks.md created)
2001
+ 2. **Auto-Create Check**: Checks if `config.sync.settings.autoCreateIssue` is enabled
2002
+ 3. **GitHub CLI Available**: Verifies `gh` CLI is installed and authenticated
2003
+ 4. **Issue Creation**:
2004
+ - Extracts title from spec.md frontmatter (`title: "..."`)
2005
+ - Extracts summary from "Quick Overview" section
2006
+ - Generates task checklist from tasks.md (all tasks as GitHub checkboxes)
2007
+ - Calls `gh issue create` with proper labels (`specweave`, `increment`)
2008
+ - Parses output to get issue number
2009
+ 5. **Metadata Update**: Creates/updates `.metadata.json` with GitHub issue number and URL
2010
+ 6. **Result**: Increment is now linked to GitHub issue for bidirectional sync!
2011
+
2012
+ **Configuration** (`.specweave/config.json`):
2013
+ ```json
2014
+ {
2015
+ "sync": {
2016
+ "settings": {
2017
+ "autoCreateIssue": true, // ✅ Enable auto-creation!
2018
+ "syncDirection": "bidirectional"
2019
+ },
2020
+ "activeProfile": "specweave-dev",
2021
+ "profiles": {
2022
+ "specweave-dev": {
2023
+ "provider": "github",
2024
+ "config": {
2025
+ "owner": "anton-abyzov",
2026
+ "repo": "specweave"
2027
+ }
2028
+ }
2029
+ }
2030
+ }
2031
+ }
2032
+ ```
2033
+
2034
+ **What Gets Created**:
2035
+ ```markdown
2036
+ # [INC-0016] AI Self-Reflection System
2037
+
2038
+ **Status**: Planning → Implementation
2039
+ **Priority**: P1
2040
+ **Increment**: 0016-self-reflection-system
2041
+
2042
+ ## Summary
2043
+
2044
+ Add AI self-reflection capabilities inspired by Kimi model...
2045
+
2046
+ ## Tasks
2047
+
2048
+ Progress: 0/30 tasks (0%)
2049
+
2050
+ - [ ] T-001: Create Reflection Configuration Schema
2051
+ - [ ] T-002: Create Configuration Loader
2052
+ - [ ] T-003: Create Git Diff Analyzer
2053
+ ... (all 30 tasks)
2054
+
2055
+ ## Links
2056
+
2057
+ - **Spec**: `spec.md`
2058
+ - **Plan**: `plan.md`
2059
+ - **Tasks**: `tasks.md`
2060
+
2061
+ ---
2062
+
2063
+ 🤖 Auto-created by SpecWeave | Updates automatically on task completion
2064
+ ```
2065
+
2066
+ **Error Handling** (Robust):
2067
+ - ✅ **Missing files**: Graceful fallback if spec.md or tasks.md missing
2068
+ - ✅ **Title extraction**: Multiple fallbacks (frontmatter → heading → increment ID)
2069
+ - ✅ **Overview extraction**: Tries "Quick Overview", "Summary", or first paragraph
2070
+ - ✅ **Task count**: Extracts from frontmatter or counts tasks
2071
+ - ✅ **GitHub CLI failures**: Non-blocking (logs error, continues)
2072
+ - ✅ **Duplicate prevention**: Checks metadata.json for existing issue number
2073
+ - ✅ **Repository detection**: Auto-detects from git remote or config
2074
+
2075
+ **Manual Override** (When Needed):
2076
+ ```bash
2077
+ # Disable auto-create for one increment
2078
+ # Just don't set autoCreateIssue in config
2079
+
2080
+ # Or create manually if auto-create failed
2081
+ /specweave-github:create-issue 0016
2082
+
2083
+ # Check if issue was created
2084
+ cat .specweave/increments/0016-self-reflection-system/metadata.json
2085
+ # Should show: "github": {"issue": 30, "url": "..."}
2086
+ ```
2087
+
2088
+ **Why This Matters**:
2089
+ - ✅ **Zero manual work**: Issues auto-create on every increment
2090
+ - ✅ **Immediate tracking**: Increment linked to GitHub from start
2091
+ - ✅ **Bidirectional sync**: Task completion updates GitHub automatically
2092
+ - ✅ **Team visibility**: Stakeholders see progress in GitHub without asking
2093
+ - ✅ **Audit trail**: All increments tracked in one place
2094
+ - ✅ **DORA metrics**: Automatic deployment frequency tracking
2095
+
2096
+ **Workflow Example**:
2097
+ ```bash
2098
+ # 1. Create increment
2099
+ /specweave:increment "AI self-reflection system"
2100
+
2101
+ # 2. Hook auto-fires:
2102
+ # 🔗 Checking GitHub issue auto-creation...
2103
+ # 📦 Auto-create enabled, checking for GitHub CLI...
2104
+ # ✓ GitHub CLI found
2105
+ # 🚀 Creating GitHub issue for 0016-self-reflection-system...
2106
+ # 📝 Issue #30 created
2107
+ # 🔗 https://github.com/anton-abyzov/specweave/issues/30
2108
+ # ✅ metadata.json updated
2109
+
2110
+ # 3. Start work
2111
+ /specweave:do
2112
+
2113
+ # 4. Complete tasks → GitHub updates automatically via post-task-completion hook!
2114
+ ```
2115
+
2116
+ **Requirements**:
2117
+ - GitHub CLI (`gh`) installed and authenticated (`gh auth login`)
2118
+ - Repository with GitHub remote configured
2119
+ - `autoCreateIssue: true` in config.json
2120
+ - Write permissions to repository
2121
+
2120
2122
  ---
2121
2123
 
2122
2124
  ## Plugins
@@ -2129,10 +2131,10 @@ ls -1 .specweave/increments/ | grep -E '^[0-9]{4}' | wc -l
2129
2131
 
2130
2132
  ```
2131
2133
  SpecWeave = Collection of Claude Code Plugins
2132
- ├── specweave (auto-loaded) ← The "framework" IS a plugin
2133
- ├── specweave-github (opt-in)
2134
- ├── specweave-figma (opt-in)
2135
- └── ...all other plugins (opt-in)
2134
+ ├── specweave (auto-installed) ← The "framework" IS a plugin
2135
+ ├── specweave-github (auto-installed)
2136
+ ├── specweave-figma (auto-installed)
2137
+ └── ...all 19+ plugins (auto-installed)
2136
2138
  ```
2137
2139
 
2138
2140
  **What this means**:
@@ -2159,7 +2161,7 @@ SpecWeave = Collection of Claude Code Plugins
2159
2161
  **Discovery**:
2160
2162
  - Browse all plugins: `ls plugins/` or check [.claude-plugin/marketplace.json](/.claude-plugin/marketplace.json)
2161
2163
  - Live catalog: See `.claude-plugin/README.md` for current marketplace contents
2162
- - Auto-detection during `specweave init` suggests relevant plugins
2164
+ - **All plugins automatically installed** during `specweave init` (no manual selection needed)
2163
2165
 
2164
2166
  **Plugin Structure** (all follow same pattern):
2165
2167
  ```
@@ -2171,8 +2173,8 @@ plugins/specweave-{name}/
2171
2173
  └── lib/ # TypeScript utilities (optional)
2172
2174
  ```
2173
2175
 
2174
- **Key Plugins** (for reference):
2175
- - `specweave` - Framework essentials (always loaded)
2176
+ **Key Plugins** (for reference - all auto-installed):
2177
+ - `specweave` - Framework essentials
2176
2178
  - `specweave-github` - GitHub Issues integration
2177
2179
  - `specweave-{frontend|backend|infrastructure}` - Tech stack plugins
2178
2180
 
@@ -2687,112 +2689,6 @@ vim docs-site/docs/guides/getting-started.md
2687
2689
  cd docs-site && npm run build
2688
2690
  ```
2689
2691
 
2690
- ### Documentation Preview (specweave-docs-preview plugin)
2691
-
2692
- **Live preview of `.specweave/docs/` with Docusaurus** - Beautiful UI with hot reload, auto-generated sidebar, and Mermaid diagram support.
2693
-
2694
- **When to Use**:
2695
- - ✅ After completing your first increment (auto-suggested)
2696
- - ✅ Reviewing documentation in a beautiful UI instead of raw markdown
2697
- - ✅ Sharing documentation with non-technical stakeholders
2698
- - ✅ Preparing documentation for external publication
2699
-
2700
- **Installation** (auto-prompted after first increment):
2701
-
2702
- The `post-first-increment.sh` hook automatically prompts you after completing your first increment:
2703
-
2704
- ```
2705
- 🎉 Congratulations! You completed your first increment!
2706
-
2707
- 📚 Would you like to preview your documentation in a beautiful UI?
2708
-
2709
- Options:
2710
- 1) Yes, install and launch now (recommended)
2711
- 2) No thanks, I'll browse markdown files manually
2712
- 3) Remind me later
2713
-
2714
- Your choice [1]:
2715
- ```
2716
-
2717
- **Manual Commands**:
2718
-
2719
- ```bash
2720
- # Launch preview (installs Docusaurus if needed)
2721
- /specweave:docs preview
2722
-
2723
- # Specify port
2724
- /specweave:docs preview --port 3001
2725
-
2726
- # Build static site for deployment
2727
- /specweave:docs build
2728
-
2729
- # Output: .specweave/docs-site-internal/build/
2730
- ```
2731
-
2732
- **Features**:
2733
- - ✅ **Auto-generated sidebar** from `.specweave/docs/internal/` folder structure
2734
- - ✅ **Hot reload** - Edit markdown files and see changes instantly
2735
- - ✅ **Mermaid diagrams** - Automatic rendering of diagrams
2736
- - ✅ **Priority sorting** - Strategy → Specs → Architecture → Delivery → Operations → Governance
2737
- - ✅ **Port auto-discovery** - Finds available port (3000-3010)
2738
- - ✅ **Cross-platform** - Windows/macOS/Linux compatible
2739
-
2740
- **What Gets Indexed**:
2741
- - `.specweave/docs/internal/strategy/` - Business rationale, PRDs
2742
- - `.specweave/docs/internal/specs/` - Feature specifications
2743
- - `.specweave/docs/internal/architecture/` - Technical design, ADRs
2744
- - `.specweave/docs/internal/delivery/` - Build & release processes
2745
- - `.specweave/docs/internal/operations/` - Runbooks, SLOs
2746
- - `.specweave/docs/internal/governance/` - Policies, security
2747
-
2748
- **What Gets Excluded**:
2749
- - ❌ `legacy/` folder (brownfield imports, temporary)
2750
- - ❌ `node_modules/`, `.git/`
2751
- - ❌ `.specweave/increments/` (implementation details, not strategic docs)
2752
-
2753
- **Configuration** (`.specweave/config.json`):
2754
-
2755
- ```json
2756
- {
2757
- "documentation": {
2758
- "preview": {
2759
- "enabled": true,
2760
- "autoInstall": true,
2761
- "port": 3000,
2762
- "openBrowser": true,
2763
- "theme": "default",
2764
- "excludeFolders": ["legacy", "node_modules"]
2765
- }
2766
- }
2767
- }
2768
- ```
2769
-
2770
- **Requirements**:
2771
- - Node.js 18+ (Docusaurus 3.0 requirement)
2772
- - ~150 MB disk space for npm packages
2773
- - ~30 seconds first-time install
2774
-
2775
- **Files Created** (gitignored):
2776
- - `.specweave/docs-site-internal/` - Complete Docusaurus installation for internal docs
2777
- - `package.json` - Dependencies
2778
- - `docusaurus.config.js` - Configuration
2779
- - `sidebars.js` - Auto-generated sidebar
2780
- - `src/` - Landing page and custom CSS
2781
- - `node_modules/` - npm packages
2782
- - `build/` - Static site output (after build)
2783
-
2784
- **Note**: This is separate from `docs-site/` (public-facing docs at project root)
2785
-
2786
- **Implementation**:
2787
- - Plugin: `plugins/specweave-docs-preview/`
2788
- - TypeScript utilities: `src/utils/docs-preview/`
2789
- - CLI commands: `src/cli/commands/docs-{preview,build,setup}.ts`
2790
- - Hook: `plugins/specweave/hooks/post-first-increment.sh`
2791
-
2792
- **See Also**:
2793
- - Plugin docs: `plugins/specweave-docs-preview/skills/docs-preview/SKILL.md`
2794
- - Command docs: `plugins/specweave-docs-preview/commands/docs-preview.md`
2795
-
2796
2692
  ### Translation Workflow (Multilingual Support)
2797
2693
 
2798
2694
  **SpecWeave supports multilingual development** via two-phase post-generation translation (Increment 0006).