specweave 0.33.4 → 0.33.6

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 (719) hide show
  1. package/.claude-plugin/README.md +13 -13
  2. package/.claude-plugin/marketplace.json +26 -37
  3. package/CLAUDE.md +445 -80
  4. package/README.md +34 -31
  5. package/bin/fix-marketplace-errors.sh +1 -1
  6. package/bin/install-commands.sh +2 -2
  7. package/bin/specweave.js +58 -1
  8. package/dist/plugins/specweave-github/lib/ThreeLayerSyncManager.d.ts +5 -0
  9. package/dist/plugins/specweave-github/lib/ThreeLayerSyncManager.d.ts.map +1 -1
  10. package/dist/plugins/specweave-github/lib/ThreeLayerSyncManager.js +14 -4
  11. package/dist/plugins/specweave-github/lib/ThreeLayerSyncManager.js.map +1 -1
  12. package/dist/plugins/specweave-github/lib/completion-calculator.d.ts +1 -0
  13. package/dist/plugins/specweave-github/lib/completion-calculator.d.ts.map +1 -1
  14. package/dist/plugins/specweave-github/lib/completion-calculator.js +2 -0
  15. package/dist/plugins/specweave-github/lib/completion-calculator.js.map +1 -1
  16. package/dist/plugins/specweave-github/lib/duplicate-detector.d.ts.map +1 -1
  17. package/dist/plugins/specweave-github/lib/duplicate-detector.js +20 -6
  18. package/dist/plugins/specweave-github/lib/duplicate-detector.js.map +1 -1
  19. package/dist/plugins/specweave-github/lib/github-client-v2.d.ts +9 -0
  20. package/dist/plugins/specweave-github/lib/github-client-v2.d.ts.map +1 -1
  21. package/dist/plugins/specweave-github/lib/github-client-v2.js +31 -18
  22. package/dist/plugins/specweave-github/lib/github-client-v2.js.map +1 -1
  23. package/dist/plugins/specweave-github/lib/github-feature-sync.d.ts +7 -0
  24. package/dist/plugins/specweave-github/lib/github-feature-sync.d.ts.map +1 -1
  25. package/dist/plugins/specweave-github/lib/github-feature-sync.js +47 -11
  26. package/dist/plugins/specweave-github/lib/github-feature-sync.js.map +1 -1
  27. package/dist/plugins/specweave-github/lib/github-increment-sync-cli.js +39 -13
  28. package/dist/plugins/specweave-github/lib/github-increment-sync-cli.js.map +1 -1
  29. package/dist/plugins/specweave-github/lib/github-issue-updater.d.ts.map +1 -1
  30. package/dist/plugins/specweave-github/lib/github-issue-updater.js +15 -3
  31. package/dist/plugins/specweave-github/lib/github-issue-updater.js.map +1 -1
  32. package/dist/plugins/specweave-github/lib/github-spec-sync.d.ts +7 -0
  33. package/dist/plugins/specweave-github/lib/github-spec-sync.d.ts.map +1 -1
  34. package/dist/plugins/specweave-github/lib/github-spec-sync.js +17 -4
  35. package/dist/plugins/specweave-github/lib/github-spec-sync.js.map +1 -1
  36. package/dist/plugins/specweave-github/lib/github-sync-bidirectional.d.ts.map +1 -1
  37. package/dist/plugins/specweave-github/lib/github-sync-bidirectional.js +13 -3
  38. package/dist/plugins/specweave-github/lib/github-sync-bidirectional.js.map +1 -1
  39. package/dist/plugins/specweave-github/lib/github-sync-increment-changes.d.ts.map +1 -1
  40. package/dist/plugins/specweave-github/lib/github-sync-increment-changes.js +14 -4
  41. package/dist/plugins/specweave-github/lib/github-sync-increment-changes.js.map +1 -1
  42. package/dist/plugins/specweave-github/lib/increment-issue-builder.d.ts.map +1 -1
  43. package/dist/plugins/specweave-github/lib/increment-issue-builder.js +24 -8
  44. package/dist/plugins/specweave-github/lib/increment-issue-builder.js.map +1 -1
  45. package/dist/plugins/specweave-github/lib/user-story-content-builder.d.ts.map +1 -1
  46. package/dist/plugins/specweave-github/lib/user-story-content-builder.js +21 -18
  47. package/dist/plugins/specweave-github/lib/user-story-content-builder.js.map +1 -1
  48. package/dist/plugins/specweave-github/lib/user-story-issue-builder.d.ts +3 -0
  49. package/dist/plugins/specweave-github/lib/user-story-issue-builder.d.ts.map +1 -1
  50. package/dist/plugins/specweave-github/lib/user-story-issue-builder.js +20 -19
  51. package/dist/plugins/specweave-github/lib/user-story-issue-builder.js.map +1 -1
  52. package/dist/src/cli/cleanup-zombies.js +34 -18
  53. package/dist/src/cli/cleanup-zombies.js.map +1 -1
  54. package/dist/src/cli/commands/discrepancies.js +6 -6
  55. package/dist/src/cli/commands/discrepancies.js.map +1 -1
  56. package/dist/src/cli/commands/docs.js +1 -1
  57. package/dist/src/cli/commands/docs.js.map +1 -1
  58. package/dist/src/cli/commands/import-docs.d.ts +1 -1
  59. package/dist/src/cli/commands/import-docs.js +2 -2
  60. package/dist/src/cli/commands/import-docs.js.map +1 -1
  61. package/dist/src/cli/commands/import-external.d.ts +1 -1
  62. package/dist/src/cli/commands/import-external.js +1 -1
  63. package/dist/src/cli/commands/init-multiproject.d.ts +1 -1
  64. package/dist/src/cli/commands/init-multiproject.js +3 -3
  65. package/dist/src/cli/commands/init-multiproject.js.map +1 -1
  66. package/dist/src/cli/commands/init.js +2 -2
  67. package/dist/src/cli/commands/init.js.map +1 -1
  68. package/dist/src/cli/commands/jobs.js +19 -2
  69. package/dist/src/cli/commands/jobs.js.map +1 -1
  70. package/dist/src/cli/commands/living-docs.d.ts +1 -0
  71. package/dist/src/cli/commands/living-docs.d.ts.map +1 -1
  72. package/dist/src/cli/commands/living-docs.js +19 -3
  73. package/dist/src/cli/commands/living-docs.js.map +1 -1
  74. package/dist/src/cli/commands/migrate-to-multiproject.js +1 -1
  75. package/dist/src/cli/commands/migrate-to-multiproject.js.map +1 -1
  76. package/dist/src/cli/commands/migrate-to-profiles.js +1 -1
  77. package/dist/src/cli/commands/migrate-to-profiles.js.map +1 -1
  78. package/dist/src/cli/commands/next-command.d.ts +1 -1
  79. package/dist/src/cli/commands/next-command.js +9 -9
  80. package/dist/src/cli/commands/next-command.js.map +1 -1
  81. package/dist/src/cli/commands/notifications.js +3 -3
  82. package/dist/src/cli/commands/notifications.js.map +1 -1
  83. package/dist/src/cli/commands/plan/increment-detector.js +2 -2
  84. package/dist/src/cli/commands/plan/increment-detector.js.map +1 -1
  85. package/dist/src/cli/commands/plan/plan-orchestrator.d.ts +2 -2
  86. package/dist/src/cli/commands/plan/plan-orchestrator.js +2 -2
  87. package/dist/src/cli/commands/plan/plan-validator.js +2 -2
  88. package/dist/src/cli/commands/plan/plan-validator.js.map +1 -1
  89. package/dist/src/cli/commands/plan/types.d.ts +1 -1
  90. package/dist/src/cli/commands/plan/types.js +1 -1
  91. package/dist/src/cli/commands/plan-command.d.ts +3 -3
  92. package/dist/src/cli/commands/plan-command.js +12 -12
  93. package/dist/src/cli/commands/plan-command.js.map +1 -1
  94. package/dist/src/cli/commands/project.d.ts +77 -0
  95. package/dist/src/cli/commands/project.d.ts.map +1 -0
  96. package/dist/src/cli/commands/project.js +526 -0
  97. package/dist/src/cli/commands/project.js.map +1 -0
  98. package/dist/src/cli/commands/save.d.ts +49 -0
  99. package/dist/src/cli/commands/save.d.ts.map +1 -0
  100. package/dist/src/cli/commands/save.js +583 -0
  101. package/dist/src/cli/commands/save.js.map +1 -0
  102. package/dist/src/cli/commands/sync-spec-commits.js +15 -6
  103. package/dist/src/cli/commands/sync-spec-commits.js.map +1 -1
  104. package/dist/src/cli/commands/sync-spec-content.js +15 -6
  105. package/dist/src/cli/commands/sync-spec-content.js.map +1 -1
  106. package/dist/src/cli/helpers/init/ado-repo-cloning.js +2 -2
  107. package/dist/src/cli/helpers/init/ado-repo-cloning.js.map +1 -1
  108. package/dist/src/cli/helpers/init/bitbucket-repo-cloning.d.ts +1 -1
  109. package/dist/src/cli/helpers/init/bitbucket-repo-cloning.js +3 -3
  110. package/dist/src/cli/helpers/init/bitbucket-repo-cloning.js.map +1 -1
  111. package/dist/src/cli/helpers/init/brownfield-analysis.js +18 -18
  112. package/dist/src/cli/helpers/init/brownfield-analysis.js.map +1 -1
  113. package/dist/src/cli/helpers/init/directory-structure.d.ts.map +1 -1
  114. package/dist/src/cli/helpers/init/directory-structure.js +3 -0
  115. package/dist/src/cli/helpers/init/directory-structure.js.map +1 -1
  116. package/dist/src/cli/helpers/init/external-import-grouping.d.ts.map +1 -1
  117. package/dist/src/cli/helpers/init/external-import-grouping.js +11 -7
  118. package/dist/src/cli/helpers/init/external-import-grouping.js.map +1 -1
  119. package/dist/src/cli/helpers/init/external-import.js +18 -18
  120. package/dist/src/cli/helpers/init/external-import.js.map +1 -1
  121. package/dist/src/cli/helpers/init/github-repo-cloning.d.ts +1 -1
  122. package/dist/src/cli/helpers/init/github-repo-cloning.js +3 -3
  123. package/dist/src/cli/helpers/init/github-repo-cloning.js.map +1 -1
  124. package/dist/src/cli/helpers/init/initial-increment-generator.js +12 -12
  125. package/dist/src/cli/helpers/init/living-docs-preflight.js +5 -5
  126. package/dist/src/cli/helpers/init/living-docs-preflight.js.map +1 -1
  127. package/dist/src/cli/helpers/init/next-steps.js +9 -9
  128. package/dist/src/cli/helpers/init/next-steps.js.map +1 -1
  129. package/dist/src/cli/helpers/init/plugin-installer.js +3 -3
  130. package/dist/src/cli/helpers/init/plugin-installer.js.map +1 -1
  131. package/dist/src/cli/helpers/init/translation-config.js +9 -9
  132. package/dist/src/cli/helpers/init/translation-config.js.map +1 -1
  133. package/dist/src/cli/helpers/init/types.d.ts +1 -1
  134. package/dist/src/cli/helpers/init/types.d.ts.map +1 -1
  135. package/dist/src/cli/helpers/issue-tracker/ado.js +1 -1
  136. package/dist/src/cli/helpers/issue-tracker/ado.js.map +1 -1
  137. package/dist/src/cli/helpers/issue-tracker/github.js +1 -1
  138. package/dist/src/cli/helpers/issue-tracker/github.js.map +1 -1
  139. package/dist/src/cli/helpers/issue-tracker/index.js +2 -2
  140. package/dist/src/cli/helpers/issue-tracker/index.js.map +1 -1
  141. package/dist/src/cli/helpers/issue-tracker/jira.js +1 -1
  142. package/dist/src/cli/helpers/issue-tracker/jira.js.map +1 -1
  143. package/dist/src/cli/update-status-line.js +1 -1
  144. package/dist/src/cli/update-status-line.js.map +1 -1
  145. package/dist/src/cli/workers/brownfield-worker.js +1 -1
  146. package/dist/src/cli/workers/brownfield-worker.js.map +1 -1
  147. package/dist/src/cli/workers/clone-worker.js +22 -5
  148. package/dist/src/cli/workers/clone-worker.js.map +1 -1
  149. package/dist/src/cli/workers/import-worker.js +1 -1
  150. package/dist/src/cli/workers/import-worker.js.map +1 -1
  151. package/dist/src/core/background/brownfield-launcher.js +4 -4
  152. package/dist/src/core/background/brownfield-launcher.js.map +1 -1
  153. package/dist/src/core/background/index.d.ts +3 -3
  154. package/dist/src/core/background/index.js +3 -3
  155. package/dist/src/core/background/job-dependency.d.ts.map +1 -1
  156. package/dist/src/core/background/job-dependency.js +1 -0
  157. package/dist/src/core/background/job-dependency.js.map +1 -1
  158. package/dist/src/core/background/job-launcher.d.ts +1 -1
  159. package/dist/src/core/background/job-launcher.js +5 -5
  160. package/dist/src/core/background/job-launcher.js.map +1 -1
  161. package/dist/src/core/background/job-manager.d.ts +8 -0
  162. package/dist/src/core/background/job-manager.d.ts.map +1 -1
  163. package/dist/src/core/background/job-manager.js +19 -1
  164. package/dist/src/core/background/job-manager.js.map +1 -1
  165. package/dist/src/core/background/types.d.ts +9 -1
  166. package/dist/src/core/background/types.d.ts.map +1 -1
  167. package/dist/src/core/background/types.js +8 -1
  168. package/dist/src/core/background/types.js.map +1 -1
  169. package/dist/src/core/brownfield/importer.js +1 -1
  170. package/dist/src/core/brownfield/importer.js.map +1 -1
  171. package/dist/src/core/config/config-manager.d.ts +7 -1
  172. package/dist/src/core/config/config-manager.d.ts.map +1 -1
  173. package/dist/src/core/config/config-manager.js +24 -2
  174. package/dist/src/core/config/config-manager.js.map +1 -1
  175. package/dist/src/core/config/single-project-migrator.d.ts +110 -0
  176. package/dist/src/core/config/single-project-migrator.d.ts.map +1 -0
  177. package/dist/src/core/config/single-project-migrator.js +179 -0
  178. package/dist/src/core/config/single-project-migrator.js.map +1 -0
  179. package/dist/src/core/config/types.d.ts +3 -3
  180. package/dist/src/core/credentials/credentials-manager.d.ts +25 -4
  181. package/dist/src/core/credentials/credentials-manager.d.ts.map +1 -1
  182. package/dist/src/core/credentials/credentials-manager.js +54 -15
  183. package/dist/src/core/credentials/credentials-manager.js.map +1 -1
  184. package/dist/src/core/deduplication/command-deduplicator.d.ts +4 -4
  185. package/dist/src/core/deduplication/command-deduplicator.d.ts.map +1 -1
  186. package/dist/src/core/deduplication/command-deduplicator.js +3 -3
  187. package/dist/src/core/external-tools/external-items-counter.d.ts +4 -4
  188. package/dist/src/core/external-tools/external-items-counter.js +4 -4
  189. package/dist/src/core/external-tools/external-items-display.js +4 -4
  190. package/dist/src/core/external-tools/external-items-display.js.map +1 -1
  191. package/dist/src/core/increment/completion-validator.js +3 -3
  192. package/dist/src/core/increment/completion-validator.js.map +1 -1
  193. package/dist/src/core/increment/conflict-resolver.js +2 -2
  194. package/dist/src/core/increment/conflict-resolver.js.map +1 -1
  195. package/dist/src/core/increment/desync-detector.d.ts +1 -1
  196. package/dist/src/core/increment/desync-detector.js +3 -3
  197. package/dist/src/core/increment/desync-detector.js.map +1 -1
  198. package/dist/src/core/increment/discipline-checker.js +2 -2
  199. package/dist/src/core/increment/discipline-checker.js.map +1 -1
  200. package/dist/src/core/increment/increment-archiver.js +4 -4
  201. package/dist/src/core/increment/increment-archiver.js.map +1 -1
  202. package/dist/src/core/increment/increment-utils.d.ts +53 -2
  203. package/dist/src/core/increment/increment-utils.d.ts.map +1 -1
  204. package/dist/src/core/increment/increment-utils.js +78 -7
  205. package/dist/src/core/increment/increment-utils.js.map +1 -1
  206. package/dist/src/core/increment/metadata-manager.js +6 -6
  207. package/dist/src/core/increment/metadata-manager.js.map +1 -1
  208. package/dist/src/core/increment/metadata-validator.js +1 -1
  209. package/dist/src/core/increment/metadata-validator.js.map +1 -1
  210. package/dist/src/core/increment/recent-work-scanner.js +2 -2
  211. package/dist/src/core/increment/recent-work-scanner.js.map +1 -1
  212. package/dist/src/core/increment/spec-sync-manager.js +1 -1
  213. package/dist/src/core/increment/spec-sync-manager.js.map +1 -1
  214. package/dist/src/core/increment/status-auto-transition.d.ts +68 -1
  215. package/dist/src/core/increment/status-auto-transition.d.ts.map +1 -1
  216. package/dist/src/core/increment/status-auto-transition.js +141 -1
  217. package/dist/src/core/increment/status-auto-transition.js.map +1 -1
  218. package/dist/src/core/increment/status-change-sync-trigger.d.ts +1 -1
  219. package/dist/src/core/increment/status-change-sync-trigger.js +3 -3
  220. package/dist/src/core/increment/status-change-sync-trigger.js.map +1 -1
  221. package/dist/src/core/living-docs/cross-project-sync.d.ts +12 -0
  222. package/dist/src/core/living-docs/cross-project-sync.d.ts.map +1 -1
  223. package/dist/src/core/living-docs/cross-project-sync.js +33 -0
  224. package/dist/src/core/living-docs/cross-project-sync.js.map +1 -1
  225. package/dist/src/core/living-docs/feature-archiver.d.ts +3 -3
  226. package/dist/src/core/living-docs/feature-archiver.js +3 -3
  227. package/dist/src/core/living-docs/feature-consistency-validator.js +1 -1
  228. package/dist/src/core/living-docs/feature-consistency-validator.js.map +1 -1
  229. package/dist/src/core/living-docs/feature-id-manager.d.ts +5 -0
  230. package/dist/src/core/living-docs/feature-id-manager.d.ts.map +1 -1
  231. package/dist/src/core/living-docs/feature-id-manager.js +19 -1
  232. package/dist/src/core/living-docs/feature-id-manager.js.map +1 -1
  233. package/dist/src/core/living-docs/governance/standards-generator.js +1 -1
  234. package/dist/src/core/living-docs/governance/standards-generator.js.map +1 -1
  235. package/dist/src/core/living-docs/hierarchy-mapper.d.ts +5 -0
  236. package/dist/src/core/living-docs/hierarchy-mapper.d.ts.map +1 -1
  237. package/dist/src/core/living-docs/hierarchy-mapper.js +22 -2
  238. package/dist/src/core/living-docs/hierarchy-mapper.js.map +1 -1
  239. package/dist/src/core/living-docs/living-docs-sync.d.ts +1 -0
  240. package/dist/src/core/living-docs/living-docs-sync.d.ts.map +1 -1
  241. package/dist/src/core/living-docs/living-docs-sync.js +77 -8
  242. package/dist/src/core/living-docs/living-docs-sync.js.map +1 -1
  243. package/dist/src/core/living-docs/project-detector.d.ts +9 -0
  244. package/dist/src/core/living-docs/project-detector.d.ts.map +1 -1
  245. package/dist/src/core/living-docs/project-detector.js +38 -3
  246. package/dist/src/core/living-docs/project-detector.js.map +1 -1
  247. package/dist/src/core/living-docs/suggestions-generator.js +1 -1
  248. package/dist/src/core/living-docs/suggestions-generator.js.map +1 -1
  249. package/dist/src/core/notifications/command-integration.js +1 -1
  250. package/dist/src/core/notifications/command-integration.js.map +1 -1
  251. package/dist/src/core/project/adapters/ado-project-adapter.d.ts +73 -0
  252. package/dist/src/core/project/adapters/ado-project-adapter.d.ts.map +1 -0
  253. package/dist/src/core/project/adapters/ado-project-adapter.js +304 -0
  254. package/dist/src/core/project/adapters/ado-project-adapter.js.map +1 -0
  255. package/dist/src/core/project/adapters/github-project-adapter.d.ts +76 -0
  256. package/dist/src/core/project/adapters/github-project-adapter.d.ts.map +1 -0
  257. package/dist/src/core/project/adapters/github-project-adapter.js +315 -0
  258. package/dist/src/core/project/adapters/github-project-adapter.js.map +1 -0
  259. package/dist/src/core/project/adapters/jira-project-adapter.d.ts +69 -0
  260. package/dist/src/core/project/adapters/jira-project-adapter.d.ts.map +1 -0
  261. package/dist/src/core/project/adapters/jira-project-adapter.js +241 -0
  262. package/dist/src/core/project/adapters/jira-project-adapter.js.map +1 -0
  263. package/dist/src/core/project/project-event-bus.d.ts +72 -0
  264. package/dist/src/core/project/project-event-bus.d.ts.map +1 -0
  265. package/dist/src/core/project/project-event-bus.js +150 -0
  266. package/dist/src/core/project/project-event-bus.js.map +1 -0
  267. package/dist/src/core/project/project-manager.d.ts +0 -22
  268. package/dist/src/core/project/project-manager.d.ts.map +1 -1
  269. package/dist/src/core/project/project-manager.js +5 -275
  270. package/dist/src/core/project/project-manager.js.map +1 -1
  271. package/dist/src/core/project/project-registry.d.ts +93 -0
  272. package/dist/src/core/project/project-registry.d.ts.map +1 -0
  273. package/dist/src/core/project/project-registry.js +448 -0
  274. package/dist/src/core/project/project-registry.js.map +1 -0
  275. package/dist/src/core/project/project-resolution.d.ts +229 -0
  276. package/dist/src/core/project/project-resolution.d.ts.map +1 -0
  277. package/dist/src/core/project/project-resolution.js +633 -0
  278. package/dist/src/core/project/project-resolution.js.map +1 -0
  279. package/dist/src/core/project/types/project-types.d.ts +214 -0
  280. package/dist/src/core/project/types/project-types.d.ts.map +1 -0
  281. package/dist/src/core/project/types/project-types.js +9 -0
  282. package/dist/src/core/project/types/project-types.js.map +1 -0
  283. package/dist/src/core/repo-structure/setup-summary.js +2 -2
  284. package/dist/src/core/repo-structure/setup-summary.js.map +1 -1
  285. package/dist/src/core/specs/spec-identifier-detector.d.ts.map +1 -1
  286. package/dist/src/core/specs/spec-identifier-detector.js +8 -5
  287. package/dist/src/core/specs/spec-identifier-detector.js.map +1 -1
  288. package/dist/src/core/status-line/status-line-updater.js +1 -1
  289. package/dist/src/core/status-line/status-line-updater.js.map +1 -1
  290. package/dist/src/core/types/increment-metadata.d.ts +3 -3
  291. package/dist/src/core/types/increment-metadata.js +3 -3
  292. package/dist/src/core/types/increment-metadata.js.map +1 -1
  293. package/dist/src/core/types/sync-profile.d.ts +1 -0
  294. package/dist/src/core/types/sync-profile.d.ts.map +1 -1
  295. package/dist/src/core/types/sync-profile.js.map +1 -1
  296. package/dist/src/core/validators/ac-presence-validator.d.ts +4 -4
  297. package/dist/src/core/validators/ac-presence-validator.js +3 -3
  298. package/dist/src/core/validators/ac-presence-validator.js.map +1 -1
  299. package/dist/src/core/workflow/backlog-scanner.d.ts +5 -0
  300. package/dist/src/core/workflow/backlog-scanner.d.ts.map +1 -1
  301. package/dist/src/core/workflow/backlog-scanner.js +14 -2
  302. package/dist/src/core/workflow/backlog-scanner.js.map +1 -1
  303. package/dist/src/core/workflow/phase-detector.js +17 -17
  304. package/dist/src/core/workflow/phase-detector.js.map +1 -1
  305. package/dist/src/core/workflow/types.d.ts +1 -1
  306. package/dist/src/core/workflow/types.d.ts.map +1 -1
  307. package/dist/src/core/workflow/workflow-orchestrator.d.ts +1 -1
  308. package/dist/src/core/workflow/workflow-orchestrator.js +9 -9
  309. package/dist/src/core/workflow/workflow-orchestrator.js.map +1 -1
  310. package/dist/src/hooks/scheduler-startup.js +1 -1
  311. package/dist/src/hooks/scheduler-startup.js.map +1 -1
  312. package/dist/src/importers/external-importer.d.ts +26 -5
  313. package/dist/src/importers/external-importer.d.ts.map +1 -1
  314. package/dist/src/importers/item-converter.d.ts.map +1 -1
  315. package/dist/src/importers/item-converter.js +19 -2
  316. package/dist/src/importers/item-converter.js.map +1 -1
  317. package/dist/src/importers/jira-importer.d.ts.map +1 -1
  318. package/dist/src/importers/jira-importer.js +15 -1
  319. package/dist/src/importers/jira-importer.js.map +1 -1
  320. package/dist/src/integrations/jira/jira-incremental-mapper.d.ts +17 -1
  321. package/dist/src/integrations/jira/jira-incremental-mapper.d.ts.map +1 -1
  322. package/dist/src/integrations/jira/jira-incremental-mapper.js +20 -12
  323. package/dist/src/integrations/jira/jira-incremental-mapper.js.map +1 -1
  324. package/dist/src/integrations/jira/jira-mapper.d.ts +17 -1
  325. package/dist/src/integrations/jira/jira-mapper.d.ts.map +1 -1
  326. package/dist/src/integrations/jira/jira-mapper.js +13 -5
  327. package/dist/src/integrations/jira/jira-mapper.js.map +1 -1
  328. package/dist/src/living-docs/enterprise-analyzer.js +1 -1
  329. package/dist/src/living-docs/enterprise-analyzer.js.map +1 -1
  330. package/dist/src/living-docs/smart-doc-organizer.js +1 -1
  331. package/dist/src/living-docs/smart-doc-organizer.js.map +1 -1
  332. package/dist/src/sync/ado-reconciler.d.ts +5 -0
  333. package/dist/src/sync/ado-reconciler.d.ts.map +1 -1
  334. package/dist/src/sync/ado-reconciler.js +16 -4
  335. package/dist/src/sync/ado-reconciler.js.map +1 -1
  336. package/dist/src/sync/jira-reconciler.d.ts +3 -0
  337. package/dist/src/sync/jira-reconciler.d.ts.map +1 -1
  338. package/dist/src/sync/jira-reconciler.js +12 -5
  339. package/dist/src/sync/jira-reconciler.js.map +1 -1
  340. package/dist/src/types/dashboard-cache.d.ts +4 -2
  341. package/dist/src/types/dashboard-cache.d.ts.map +1 -1
  342. package/dist/src/types/dashboard-cache.js +1 -1
  343. package/dist/src/types/dashboard-cache.js.map +1 -1
  344. package/dist/src/utils/ac-embedder.d.ts +1 -1
  345. package/dist/src/utils/docs-preview/config-generator.d.ts.map +1 -1
  346. package/dist/src/utils/docs-preview/config-generator.js +4 -0
  347. package/dist/src/utils/docs-preview/config-generator.js.map +1 -1
  348. package/dist/src/utils/docs-preview/docusaurus-setup.js +2 -2
  349. package/dist/src/utils/docs-preview/docusaurus-setup.js.map +1 -1
  350. package/dist/src/utils/docs-preview/sidebar-builder.js +1 -1
  351. package/dist/src/utils/env-multi-project-parser.d.ts +17 -0
  352. package/dist/src/utils/env-multi-project-parser.d.ts.map +1 -1
  353. package/dist/src/utils/env-multi-project-parser.js +26 -1
  354. package/dist/src/utils/env-multi-project-parser.js.map +1 -1
  355. package/dist/src/utils/external-tool-drift-detector.d.ts +2 -2
  356. package/dist/src/utils/external-tool-drift-detector.js +6 -6
  357. package/dist/src/utils/external-tool-drift-detector.js.map +1 -1
  358. package/dist/src/utils/notification-constants.d.ts +8 -6
  359. package/dist/src/utils/notification-constants.d.ts.map +1 -1
  360. package/dist/src/utils/notification-constants.js +10 -8
  361. package/dist/src/utils/notification-constants.js.map +1 -1
  362. package/dist/src/utils/notification-manager.d.ts +36 -3
  363. package/dist/src/utils/notification-manager.d.ts.map +1 -1
  364. package/dist/src/utils/notification-manager.js +80 -49
  365. package/dist/src/utils/notification-manager.js.map +1 -1
  366. package/dist/src/utils/platform-utils.d.ts +12 -3
  367. package/dist/src/utils/platform-utils.d.ts.map +1 -1
  368. package/dist/src/utils/platform-utils.js +35 -16
  369. package/dist/src/utils/platform-utils.js.map +1 -1
  370. package/dist/src/utils/plugin-validator.js +11 -11
  371. package/dist/src/utils/plugin-validator.js.map +1 -1
  372. package/dist/src/validators/ac-coverage-validator.d.ts +1 -1
  373. package/dist/src/validators/ac-coverage-validator.js +1 -1
  374. package/package.json +3 -1
  375. package/plugins/PLUGINS-INDEX.md +1 -2
  376. package/plugins/specweave/.claude-plugin/plugin.json +1 -1
  377. package/plugins/specweave/COMMANDS.md +49 -49
  378. package/plugins/specweave/agents/pm/AGENT.md +18 -18
  379. package/plugins/specweave/agents/test-aware-planner/AGENT.md +7 -7
  380. package/plugins/specweave/agents/translator/AGENT.md +2 -2
  381. package/plugins/specweave/commands/{specweave-abandon.md → abandon.md} +20 -20
  382. package/plugins/specweave/commands/{specweave-analyze-standards.sh → analyze-standards.sh} +4 -4
  383. package/plugins/specweave/commands/{specweave-archive-features.md → archive-features.md} +7 -7
  384. package/plugins/specweave/commands/{specweave-archive.md → archive.md} +36 -36
  385. package/plugins/specweave/commands/{specweave-backlog.md → backlog.md} +24 -24
  386. package/plugins/specweave/commands/{specweave-check-hooks.md → check-hooks.md} +10 -10
  387. package/plugins/specweave/commands/{specweave-check-tests.md → check-tests.md} +14 -14
  388. package/plugins/specweave/commands/{specweave-costs.md → costs.md} +8 -8
  389. package/plugins/specweave/commands/{specweave-discrepancies.md → discrepancies.md} +15 -15
  390. package/plugins/specweave/commands/{specweave-discrepancy-to-increment.md → discrepancy-to-increment.md} +10 -10
  391. package/plugins/specweave/commands/{specweave-do.md → do.md} +37 -39
  392. package/plugins/specweave/commands/{specweave-done.md → done.md} +23 -23
  393. package/plugins/specweave/commands/{specweave-embed-acs.md → embed-acs.md} +21 -21
  394. package/plugins/specweave/commands/{specweave-external.md → external.md} +11 -11
  395. package/plugins/specweave/commands/{specweave-fix-duplicates.md → fix-duplicates.md} +16 -16
  396. package/plugins/specweave/commands/{specweave-import-docs.md → import-docs.md} +7 -7
  397. package/plugins/specweave/commands/{specweave-import-external.md → import-external.md} +9 -9
  398. package/plugins/specweave/commands/{specweave-increment.md → increment.md} +17 -17
  399. package/plugins/specweave/commands/{specweave-jobs.md → jobs.md} +28 -28
  400. package/plugins/specweave/commands/judge-llm.md +296 -0
  401. package/plugins/specweave/commands/{specweave-living-docs.md → living-docs.md} +72 -29
  402. package/plugins/specweave/commands/migrate-config.md +2 -2
  403. package/plugins/specweave/commands/{specweave-next.md → next.md} +20 -20
  404. package/plugins/specweave/commands/{specweave-notifications.md → notifications.md} +11 -11
  405. package/plugins/specweave/commands/{specweave-organize-docs.md → organize-docs.md} +9 -9
  406. package/plugins/specweave/commands/{specweave-pause.md → pause.md} +19 -19
  407. package/plugins/specweave/commands/{specweave-plan.md → plan.md} +19 -19
  408. package/plugins/specweave/commands/{specweave-progress.md → progress.md} +6 -6
  409. package/plugins/specweave/commands/{specweave-qa.md → qa.md} +15 -15
  410. package/plugins/specweave/commands/{specweave-reopen.md → reopen.md} +41 -41
  411. package/plugins/specweave/commands/{specweave-restore-feature.md → restore-feature.md} +6 -6
  412. package/plugins/specweave/commands/{specweave-restore.md → restore.md} +26 -26
  413. package/plugins/specweave/commands/{specweave-resume.md → resume.md} +33 -33
  414. package/plugins/specweave/commands/revert-wip-limit.md +4 -4
  415. package/plugins/specweave/commands/{specweave-save.md → save.md} +34 -34
  416. package/plugins/specweave/commands/{specweave-status.md → status.md} +29 -29
  417. package/plugins/specweave/commands/{specweave.md → sw.md} +28 -28
  418. package/plugins/specweave/commands/{specweave-sync-acs.md → sync-acs.md} +12 -12
  419. package/plugins/specweave/commands/sync-diagnostics.md +5 -5
  420. package/plugins/specweave/commands/{specweave-sync-docs.md → sync-docs.md} +7 -7
  421. package/plugins/specweave/commands/{specweave-sync-logs.md → sync-logs.md} +14 -14
  422. package/plugins/specweave/commands/{specweave-sync-monitor.md → sync-monitor.md} +5 -5
  423. package/plugins/specweave/commands/{specweave-sync-progress.md → sync-progress.md} +38 -38
  424. package/plugins/specweave/commands/{specweave-sync-specs.md → sync-specs.md} +17 -17
  425. package/plugins/specweave/commands/{specweave-sync-status.md → sync-status.md} +16 -16
  426. package/plugins/specweave/commands/{specweave-sync-tasks.md → sync-tasks.md} +13 -13
  427. package/plugins/specweave/commands/{specweave-tdd-cycle.md → tdd-cycle.md} +1 -1
  428. package/plugins/specweave/commands/{specweave-tdd-green.md → tdd-green.md} +1 -1
  429. package/plugins/specweave/commands/{specweave-tdd-red.md → tdd-red.md} +1 -1
  430. package/plugins/specweave/commands/{specweave-tdd-refactor.md → tdd-refactor.md} +1 -1
  431. package/plugins/specweave/commands/{specweave-translate.md → translate.md} +17 -17
  432. package/plugins/specweave/commands/{specweave-update-scope.md → update-scope.md} +8 -8
  433. package/plugins/specweave/commands/{specweave-update-status.md → update-status.md} +6 -6
  434. package/plugins/specweave/commands/{specweave-validate-features.md → validate-features.md} +8 -8
  435. package/plugins/specweave/commands/{specweave-validate.md → validate.md} +20 -20
  436. package/plugins/specweave/commands/{specweave-workflow.md → workflow.md} +40 -40
  437. package/plugins/specweave/hooks/README.md +5 -5
  438. package/plugins/specweave/hooks/config-env-separator.sh +99 -0
  439. package/plugins/specweave/hooks/github-metadata-guard.sh +73 -0
  440. package/plugins/specweave/hooks/hooks.json +41 -1
  441. package/plugins/specweave/hooks/post-first-increment.sh +2 -2
  442. package/plugins/specweave/hooks/post-increment-completion.sh +7 -7
  443. package/plugins/specweave/hooks/post-increment-planning.sh +11 -11
  444. package/plugins/specweave/hooks/post-increment-status-change.sh +1 -1
  445. package/plugins/specweave/hooks/post-metadata-change.sh +1 -1
  446. package/plugins/specweave/hooks/post-spec-update.sh +2 -2
  447. package/plugins/specweave/hooks/post-task-completion.sh +2 -2
  448. package/plugins/specweave/hooks/pre-increment-start.sh +7 -7
  449. package/plugins/specweave/hooks/project-folder-guard.sh +272 -0
  450. package/plugins/specweave/hooks/spec-project-validator.sh +68 -47
  451. package/plugins/specweave/hooks/user-prompt-submit.sh +27 -27
  452. package/plugins/specweave/hooks/v2/guards/completion-guard.sh +2 -2
  453. package/plugins/specweave/hooks/v2/guards/metadata-json-guard.sh +87 -0
  454. package/plugins/specweave/hooks/v2/guards/metadata-json-guard.test.sh +302 -0
  455. package/plugins/specweave/hooks/v2/guards/per-us-project-validator.sh +72 -18
  456. package/plugins/specweave/hooks/v2/guards/per-us-project-validator.test.sh +406 -0
  457. package/plugins/specweave/hooks/v2/handlers/github-sync-handler.sh +1 -1
  458. package/plugins/specweave/lib/hooks/consolidated-sync.js +35 -5
  459. package/plugins/specweave/lib/hooks/invoke-translator-skill.js +2 -2
  460. package/plugins/specweave/lib/hooks/invoke-translator-skill.ts +2 -2
  461. package/plugins/specweave/lib/hooks/prepare-reflection-context.js +1 -1
  462. package/plugins/specweave/lib/hooks/prepare-reflection-context.ts +1 -1
  463. package/plugins/specweave/lib/hooks/sync-living-docs.js +5 -5
  464. package/plugins/specweave/lib/hooks/translate-file.d.ts +1 -1
  465. package/plugins/specweave/lib/hooks/translate-file.js +2 -2
  466. package/plugins/specweave/lib/hooks/translate-file.ts +3 -3
  467. package/plugins/specweave/lib/hooks/us-completion-orchestrator.js +1 -1
  468. package/plugins/specweave/lib/hooks/us-completion-orchestrator.ts +2 -2
  469. package/plugins/specweave/lib/vendor/core/increment/metadata-manager.js +6 -6
  470. package/plugins/specweave/lib/vendor/core/increment/metadata-manager.js.map +1 -1
  471. package/plugins/specweave/lib/vendor/core/increment/status-auto-transition.d.ts +113 -0
  472. package/plugins/specweave/lib/vendor/core/increment/status-auto-transition.js +318 -0
  473. package/plugins/specweave/lib/vendor/core/increment/status-auto-transition.js.map +1 -0
  474. package/plugins/specweave/lib/vendor/core/types/increment-metadata.d.ts +3 -3
  475. package/plugins/specweave/lib/vendor/core/types/increment-metadata.js +3 -3
  476. package/plugins/specweave/lib/vendor/core/types/increment-metadata.js.map +1 -1
  477. package/plugins/specweave/scripts/README.md +9 -9
  478. package/plugins/specweave/scripts/cleanup-state.sh +1 -1
  479. package/plugins/specweave/scripts/jobs.js +2 -2
  480. package/plugins/specweave/scripts/progress.js +6 -6
  481. package/plugins/specweave/scripts/read-costs.sh +3 -3
  482. package/plugins/specweave/scripts/read-jobs.sh +8 -8
  483. package/plugins/specweave/scripts/read-progress.sh +17 -10
  484. package/plugins/specweave/scripts/read-status.sh +7 -7
  485. package/plugins/specweave/scripts/read-workflow.sh +18 -18
  486. package/plugins/specweave/scripts/rebuild-dashboard-cache.sh +6 -5
  487. package/plugins/specweave/scripts/session-watchdog.sh +14 -8
  488. package/plugins/specweave/scripts/status.js +7 -7
  489. package/plugins/specweave/scripts/update-dashboard-cache.sh +28 -10
  490. package/plugins/specweave/skills/SKILLS-INDEX.md +4 -4
  491. package/plugins/specweave/skills/archive-increments/SKILL.md +15 -15
  492. package/plugins/specweave/skills/brownfield-analyzer/SKILL.md +5 -5
  493. package/plugins/specweave/skills/code-standards-analyzer/SKILL.md +4 -4
  494. package/plugins/specweave/skills/context-loader/SKILL.md +1 -1
  495. package/plugins/specweave/skills/{specweave-detector → detector}/SKILL.md +5 -5
  496. package/plugins/specweave/skills/discrepancy-viewer.md +4 -4
  497. package/plugins/specweave/skills/external-sync-wizard/SKILL.md +24 -24
  498. package/plugins/specweave/skills/{specweave-framework → framework}/SKILL.md +33 -33
  499. package/plugins/specweave/skills/increment-planner/SKILL.md +25 -24
  500. package/plugins/specweave/skills/increment-planner/templates/spec-multi-project.md +6 -16
  501. package/plugins/specweave/skills/increment-planner/templates/spec-single-project.md +6 -12
  502. package/plugins/specweave/skills/increment-quality-judge-v2/SKILL.md +6 -6
  503. package/plugins/specweave/skills/increment-work-router/SKILL.md +23 -23
  504. package/plugins/specweave/skills/instant-status/SKILL.md +7 -7
  505. package/plugins/specweave/skills/plugin-validator/SKILL.md +9 -9
  506. package/plugins/specweave/skills/pm-closure-validation/SKILL.md +4 -4
  507. package/plugins/specweave/skills/progress-sync/SKILL.md +51 -51
  508. package/plugins/specweave/skills/project-kickstarter/SKILL.md +11 -11
  509. package/plugins/specweave/skills/role-orchestrator/README.md +1 -1
  510. package/plugins/specweave/skills/role-orchestrator/SKILL.md +4 -4
  511. package/plugins/specweave/skills/smart-reopen-detector/SKILL.md +17 -17
  512. package/plugins/specweave/skills/spec-generator/SKILL.md +6 -6
  513. package/plugins/specweave/skills/tdd-workflow/SKILL.md +21 -21
  514. package/plugins/specweave/skills/translator/SKILL.md +4 -4
  515. package/plugins/specweave/skills/umbrella-repo-detector/SKILL.md +5 -5
  516. package/plugins/specweave-ado/.claude-plugin/plugin.json +1 -1
  517. package/plugins/specweave-ado/agents/ado-manager/AGENT.md +4 -4
  518. package/plugins/specweave-ado/agents/ado-sync-judge/AGENT.md +4 -4
  519. package/plugins/specweave-ado/commands/cleanup-duplicates.md +9 -9
  520. package/plugins/specweave-ado/commands/clone.md +17 -17
  521. package/plugins/specweave-ado/commands/close.md +10 -10
  522. package/plugins/specweave-ado/commands/create.md +8 -8
  523. package/plugins/specweave-ado/commands/import-areas.md +15 -15
  524. package/plugins/specweave-ado/commands/import-projects.md +12 -12
  525. package/plugins/specweave-ado/commands/pull.md +25 -25
  526. package/plugins/specweave-ado/commands/push.md +20 -20
  527. package/plugins/specweave-ado/commands/reconcile.md +7 -7
  528. package/plugins/specweave-ado/commands/status.md +7 -7
  529. package/plugins/specweave-ado/commands/sync.md +17 -17
  530. package/plugins/specweave-ado/hooks/post-living-docs-update.sh +2 -2
  531. package/plugins/specweave-ado/lib/ado-project-detector.js +1 -1
  532. package/plugins/specweave-ado/lib/ado-project-detector.ts +1 -1
  533. package/plugins/specweave-ado/skills/{specweave-ado-mapper → ado-mapper}/SKILL.md +2 -2
  534. package/plugins/specweave-ado/skills/ado-multi-project/SKILL.md +6 -6
  535. package/plugins/specweave-ado/skills/ado-resource-validator/SKILL.md +5 -5
  536. package/plugins/specweave-ado/skills/ado-sync/SKILL.md +19 -19
  537. package/plugins/specweave-alternatives/.claude-plugin/plugin.json +1 -1
  538. package/plugins/specweave-alternatives/commands/alternatives-analyze.md +14 -14
  539. package/plugins/specweave-backend/.claude-plugin/plugin.json +1 -1
  540. package/plugins/specweave-confluent/.claude-plugin/plugin.json +1 -1
  541. package/plugins/specweave-cost-optimizer/.claude-plugin/plugin.json +1 -1
  542. package/plugins/specweave-cost-optimizer/commands/cost-analyze.md +1 -1
  543. package/plugins/specweave-cost-optimizer/commands/cost-optimize.md +1 -1
  544. package/plugins/specweave-diagrams/.claude-plugin/plugin.json +1 -1
  545. package/plugins/specweave-diagrams/commands/diagrams-generate.md +1 -1
  546. package/plugins/specweave-docs/.claude-plugin/plugin.json +1 -1
  547. package/plugins/specweave-docs/commands/build.md +9 -9
  548. package/plugins/specweave-docs/commands/generate.md +22 -22
  549. package/plugins/specweave-docs/commands/health.md +10 -10
  550. package/plugins/specweave-docs/commands/init.md +9 -9
  551. package/plugins/specweave-docs/commands/organize.md +10 -10
  552. package/plugins/specweave-docs/commands/validate.md +9 -9
  553. package/plugins/specweave-docs/commands/view.md +391 -0
  554. package/plugins/specweave-docs/skills/preview/SKILL.md +60 -21
  555. package/plugins/specweave-figma/.claude-plugin/plugin.json +1 -1
  556. package/plugins/specweave-figma/commands/figma-import.md +1 -1
  557. package/plugins/specweave-figma/commands/figma-to-react.md +1 -1
  558. package/plugins/specweave-figma/commands/figma-tokens.md +1 -1
  559. package/plugins/specweave-frontend/.claude-plugin/plugin.json +1 -1
  560. package/plugins/specweave-frontend/agents/frontend-architect/README.md +5 -5
  561. package/plugins/specweave-frontend/commands/component-generate.md +1 -1
  562. package/plugins/specweave-frontend/commands/design-system-init.md +1 -1
  563. package/plugins/specweave-frontend/commands/frontend-scaffold.md +1 -1
  564. package/plugins/specweave-frontend/commands/nextjs-setup.md +1 -1
  565. package/plugins/specweave-github/.claude-plugin/plugin.json +1 -1
  566. package/plugins/specweave-github/MULTI-PROJECT-SYNC-ARCHITECTURE.md +4 -4
  567. package/plugins/specweave-github/SYNC-ARCHITECTURE-FIX-SUMMARY.md +18 -18
  568. package/plugins/specweave-github/agents/github-manager/AGENT.md +8 -8
  569. package/plugins/specweave-github/commands/cleanup-duplicates.md +8 -8
  570. package/plugins/specweave-github/commands/close.md +25 -25
  571. package/plugins/specweave-github/commands/create.md +17 -17
  572. package/plugins/specweave-github/commands/pull.md +12 -12
  573. package/plugins/specweave-github/commands/push.md +12 -12
  574. package/plugins/specweave-github/commands/reconcile.md +7 -7
  575. package/plugins/specweave-github/commands/status.md +24 -24
  576. package/plugins/specweave-github/commands/sync.md +34 -34
  577. package/plugins/specweave-github/commands/update-user-story.md +6 -6
  578. package/plugins/specweave-github/hooks/README.md +8 -8
  579. package/plugins/specweave-github/hooks/post-task-completion.sh +2 -2
  580. package/plugins/specweave-github/lib/ThreeLayerSyncManager.js +12 -4
  581. package/plugins/specweave-github/lib/ThreeLayerSyncManager.ts +16 -4
  582. package/plugins/specweave-github/lib/completion-calculator.js +3 -1
  583. package/plugins/specweave-github/lib/completion-calculator.ts +6 -0
  584. package/plugins/specweave-github/lib/duplicate-detector.js +12 -6
  585. package/plugins/specweave-github/lib/duplicate-detector.ts +22 -6
  586. package/plugins/specweave-github/lib/github-board-resolver.js +7 -2
  587. package/plugins/specweave-github/lib/github-board-resolver.ts +13 -2
  588. package/plugins/specweave-github/lib/github-client-v2.js +29 -18
  589. package/plugins/specweave-github/lib/github-client-v2.ts +33 -18
  590. package/plugins/specweave-github/lib/github-feature-sync.js +41 -11
  591. package/plugins/specweave-github/lib/github-feature-sync.ts +52 -11
  592. package/plugins/specweave-github/lib/github-hierarchical-sync.js +6 -1
  593. package/plugins/specweave-github/lib/github-hierarchical-sync.ts +12 -1
  594. package/plugins/specweave-github/lib/github-increment-sync-cli.js +35 -17
  595. package/plugins/specweave-github/lib/github-increment-sync-cli.ts +44 -16
  596. package/plugins/specweave-github/lib/github-issue-updater.js +8 -3
  597. package/plugins/specweave-github/lib/github-issue-updater.ts +16 -3
  598. package/plugins/specweave-github/lib/github-spec-sync.js +14 -4
  599. package/plugins/specweave-github/lib/github-spec-sync.ts +19 -4
  600. package/plugins/specweave-github/lib/github-sync-bidirectional.js +8 -3
  601. package/plugins/specweave-github/lib/github-sync-bidirectional.ts +14 -3
  602. package/plugins/specweave-github/lib/github-sync-increment-changes.js +9 -4
  603. package/plugins/specweave-github/lib/github-sync-increment-changes.ts +15 -4
  604. package/plugins/specweave-github/lib/increment-issue-builder.js +23 -10
  605. package/plugins/specweave-github/lib/increment-issue-builder.ts +29 -11
  606. package/plugins/specweave-github/lib/user-story-content-builder.js +19 -16
  607. package/plugins/specweave-github/lib/user-story-content-builder.ts +24 -19
  608. package/plugins/specweave-github/lib/user-story-issue-builder.js +10 -13
  609. package/plugins/specweave-github/lib/user-story-issue-builder.ts +20 -19
  610. package/plugins/specweave-github/reference/github-specweave-mapping.md +1 -1
  611. package/plugins/specweave-github/skills/github-issue-standard/SKILL.md +3 -3
  612. package/plugins/specweave-github/skills/github-issue-tracker/SKILL.md +8 -8
  613. package/plugins/specweave-github/skills/github-sync/SKILL.md +14 -14
  614. package/plugins/specweave-infrastructure/.claude-plugin/plugin.json +1 -1
  615. package/plugins/specweave-infrastructure/commands/{specweave-infrastructure-monitor-setup.md → monitor-setup.md} +1 -1
  616. package/plugins/specweave-infrastructure/commands/{specweave-infrastructure-slo-implement.md → slo-implement.md} +1 -1
  617. package/plugins/specweave-jira/.claude-plugin/plugin.json +1 -1
  618. package/plugins/specweave-jira/agents/jira-sync-judge/AGENT.md +3 -3
  619. package/plugins/specweave-jira/commands/cleanup-duplicates.md +9 -9
  620. package/plugins/specweave-jira/commands/close.md +13 -13
  621. package/plugins/specweave-jira/commands/create.md +8 -8
  622. package/plugins/specweave-jira/commands/import-boards.md +15 -15
  623. package/plugins/specweave-jira/commands/import-projects-full.md +15 -15
  624. package/plugins/specweave-jira/commands/import-projects.md +10 -10
  625. package/plugins/specweave-jira/commands/pull.md +10 -10
  626. package/plugins/specweave-jira/commands/push.md +11 -11
  627. package/plugins/specweave-jira/commands/reconcile.md +7 -7
  628. package/plugins/specweave-jira/commands/status.md +16 -16
  629. package/plugins/specweave-jira/commands/sync.md +27 -27
  630. package/plugins/specweave-jira/skills/{specweave-jira-mapper → jira-mapper}/SKILL.md +2 -2
  631. package/plugins/specweave-jira/skills/jira-resource-validator/SKILL.md +4 -4
  632. package/plugins/specweave-jira/skills/jira-sync/SKILL.md +5 -5
  633. package/plugins/specweave-kafka/.claude-plugin/plugin.json +1 -1
  634. package/plugins/specweave-kafka/IMPLEMENTATION-COMPLETE.md +10 -10
  635. package/plugins/specweave-kafka/README.md +12 -12
  636. package/plugins/specweave-kafka/commands/deploy.md +5 -5
  637. package/plugins/specweave-kafka/commands/dev-env.md +2 -2
  638. package/plugins/specweave-kafka/commands/mcp-configure.md +3 -3
  639. package/plugins/specweave-kafka/commands/monitor-setup.md +3 -3
  640. package/plugins/specweave-kafka/skills/kafka-architecture/SKILL.md +4 -4
  641. package/plugins/specweave-kafka/skills/kafka-cli-tools/SKILL.md +5 -5
  642. package/plugins/specweave-kafka/skills/kafka-mcp-integration/SKILL.md +6 -6
  643. package/plugins/specweave-kafka-streams/.claude-plugin/plugin.json +1 -1
  644. package/plugins/specweave-kafka-streams/commands/topology.md +4 -4
  645. package/plugins/specweave-kubernetes/.claude-plugin/plugin.json +1 -1
  646. package/plugins/specweave-ml/.claude-plugin/plugin.json +1 -1
  647. package/plugins/specweave-ml/README.md +9 -9
  648. package/plugins/specweave-ml/commands/{specweave-ml-deploy.md → deploy.md} +1 -1
  649. package/plugins/specweave-ml/commands/{specweave-ml-evaluate.md → evaluate.md} +1 -1
  650. package/plugins/specweave-ml/commands/{specweave-ml-explain.md → explain.md} +1 -1
  651. package/plugins/specweave-ml/commands/{specweave-ml-pipeline.md → pipeline.md} +1 -1
  652. package/plugins/specweave-ml/skills/automl-optimizer/SKILL.md +1 -1
  653. package/plugins/specweave-ml/skills/data-visualizer/SKILL.md +1 -1
  654. package/plugins/specweave-ml/skills/experiment-tracker/SKILL.md +4 -4
  655. package/plugins/specweave-ml/skills/feature-engineer/SKILL.md +1 -1
  656. package/plugins/specweave-ml/skills/ml-deployment-helper/SKILL.md +2 -2
  657. package/plugins/specweave-ml/skills/ml-pipeline-orchestrator/SKILL.md +10 -10
  658. package/plugins/specweave-ml/skills/model-registry/SKILL.md +1 -1
  659. package/plugins/specweave-ml/skills/time-series-forecaster/SKILL.md +1 -1
  660. package/plugins/specweave-mobile/.claude-plugin/plugin.json +1 -1
  661. package/plugins/specweave-mobile/README.md +2 -2
  662. package/plugins/specweave-mobile/agents/mobile-architect/AGENT.md +2 -2
  663. package/plugins/specweave-mobile/skills/react-native-setup/SKILL.md +1 -1
  664. package/plugins/specweave-n8n/.claude-plugin/plugin.json +1 -1
  665. package/plugins/specweave-n8n/commands/workflow-template.md +4 -4
  666. package/plugins/specweave-payments/.claude-plugin/plugin.json +1 -1
  667. package/plugins/specweave-payments/commands/stripe-setup.md +1 -1
  668. package/plugins/specweave-payments/commands/subscription-flow.md +1 -1
  669. package/plugins/specweave-plugin-dev/.claude-plugin/plugin.json +1 -1
  670. package/plugins/specweave-plugin-dev/commands/plugin-create.md +1 -1
  671. package/plugins/specweave-plugin-dev/commands/plugin-publish.md +1 -1
  672. package/plugins/specweave-plugin-dev/commands/plugin-test.md +1 -1
  673. package/plugins/specweave-release/.claude-plugin/plugin.json +1 -1
  674. package/plugins/specweave-release/IMPLEMENTATION.md +14 -14
  675. package/plugins/specweave-release/README.md +33 -33
  676. package/plugins/specweave-release/agents/release-manager/AGENT.md +18 -18
  677. package/plugins/specweave-release/commands/{specweave-release-align.md → align.md} +19 -19
  678. package/plugins/specweave-release/commands/{specweave-release-init.md → init.md} +19 -19
  679. package/plugins/specweave-release/commands/{specweave-release-npm.md → npm.md} +14 -14
  680. package/plugins/specweave-release/commands/{specweave-release-platform.md → platform.md} +17 -17
  681. package/plugins/specweave-release/commands/{specweave-release-rc.md → rc.md} +37 -37
  682. package/plugins/specweave-release/hooks/post-task-completion.sh +1 -1
  683. package/plugins/specweave-release/skills/rc-manager/SKILL.md +12 -12
  684. package/plugins/specweave-release/skills/release-coordinator/SKILL.md +11 -11
  685. package/plugins/specweave-release/skills/release-strategy-advisor/SKILL.md +4 -4
  686. package/plugins/specweave-release/skills/version-aligner/SKILL.md +7 -7
  687. package/plugins/specweave-testing/.claude-plugin/plugin.json +1 -1
  688. package/plugins/specweave-testing/agents/qa-engineer/README.md +5 -5
  689. package/plugins/specweave-testing/commands/e2e-setup.md +1 -1
  690. package/plugins/specweave-testing/commands/test-coverage.md +1 -1
  691. package/plugins/specweave-testing/commands/test-generate.md +1 -1
  692. package/plugins/specweave-testing/commands/test-init.md +1 -1
  693. package/plugins/specweave-tooling/.claude-plugin/plugin.json +1 -1
  694. package/plugins/specweave-tooling/commands/{specweave-tooling-skill-create.md → skill-create.md} +1 -1
  695. package/plugins/specweave-tooling/commands/{specweave-tooling-skill-package.md → skill-package.md} +1 -1
  696. package/plugins/specweave-tooling/commands/{specweave-tooling-skill-validate.md → skill-validate.md} +1 -1
  697. package/plugins/specweave-ui/.claude-plugin/plugin.json +1 -1
  698. package/plugins/specweave-ui/commands/ui-automate.md +9 -9
  699. package/plugins/specweave-ui/commands/ui-inspect.md +6 -6
  700. package/src/templates/AGENTS.md.template +73 -77
  701. package/src/templates/CLAUDE.md.template +23 -19
  702. package/dist/src/cli/commands/switch-project.d.ts +0 -13
  703. package/dist/src/cli/commands/switch-project.d.ts.map +0 -1
  704. package/dist/src/cli/commands/switch-project.js +0 -78
  705. package/dist/src/cli/commands/switch-project.js.map +0 -1
  706. package/plugins/specweave/commands/specweave-init-multiproject.md +0 -146
  707. package/plugins/specweave/commands/specweave-judge.md +0 -276
  708. package/plugins/specweave-core/.claude-plugin/plugin.json +0 -21
  709. package/plugins/specweave-core/commands/architecture-review.md +0 -288
  710. package/plugins/specweave-core/commands/code-review.md +0 -213
  711. package/plugins/specweave-core/commands/refactor-plan.md +0 -249
  712. package/plugins/specweave-core/skills/code-quality/SKILL.md +0 -158
  713. package/plugins/specweave-core/skills/design-patterns/SKILL.md +0 -245
  714. package/plugins/specweave-core/skills/software-architecture/SKILL.md +0 -84
  715. package/plugins/specweave-docs/commands/preview.md +0 -274
  716. /package/plugins/specweave/skills/{specweave-framework → framework}/test-cases/test-1-increment-naming.yaml +0 -0
  717. /package/plugins/specweave/skills/{specweave-framework → framework}/test-cases/test-2-source-of-truth.yaml +0 -0
  718. /package/plugins/specweave/skills/{specweave-framework → framework}/test-cases/test-3-increment-discipline.yaml +0 -0
  719. /package/plugins/specweave/skills/{specweave-framework → framework}/test-cases/test-4-file-placement.yaml +0 -0
@@ -22,7 +22,7 @@
22
22
 
23
23
  **Initial Increment**: `0001-project-setup` (`.specweave/increments/0001-project-setup/`)
24
24
 
25
- 1. **Start Fresh**: Delete it, run `/specweave:increment "your-feature"`
25
+ 1. **Start Fresh**: Delete it, run `/sw:increment "your-feature"`
26
26
  2. **Customize**: Edit spec.md in the increment folder
27
27
 
28
28
  ---
@@ -32,16 +32,17 @@
32
32
  ```
33
33
  1. NEVER pollute project root with .md files
34
34
  2. Increment IDs unique (0001-9999)
35
- 3. ONLY 3 files in increment root: spec.md, plan.md, tasks.md
35
+ 3. ONLY 4 files in increment root: metadata.json, spec.md, plan.md, tasks.md
36
36
  4. All reports/scripts/logs → increment subfolders
37
- 5. Read context-manifest.yaml first (70%+ token savings)
37
+ 5. metadata.json MUST exist BEFORE spec.md can be created
38
38
  6. tasks.md + spec.md = SOURCE OF TRUTH (update after every task!)
39
39
  ```
40
40
 
41
41
  **File Organization**:
42
42
  ```
43
43
  .specweave/increments/0001-feature/
44
- ├── spec.md, plan.md, tasks.md # ONLY these in root
44
+ ├── metadata.json # REQUIRED - create FIRST
45
+ ├── spec.md, plan.md, tasks.md # Core increment docs
45
46
  ├── reports/ # SESSION-*.md, analysis, etc.
46
47
  ├── scripts/ # Helper scripts
47
48
  └── logs/ # Execution logs
@@ -55,21 +56,21 @@
55
56
 
56
57
  | Command | Purpose |
57
58
  |---------|---------|
58
- | `/specweave:increment "name"` | Plan new feature (PM-led) |
59
- | `/specweave:do` | Execute tasks from active increment |
60
- | `/specweave:done 0001` | Close increment (validates gates) |
61
- | `/specweave:progress` | Show task completion status |
62
- | `/specweave:validate 0001` | Quality check before closing |
63
- | `/specweave:sync-tasks` | Sync tasks.md with reality |
64
- | `/specweave:sync-docs update` | Sync to living docs |
59
+ | `/sw:increment "name"` | Plan new feature (PM-led) |
60
+ | `/sw:do` | Execute tasks from active increment |
61
+ | `/sw:done 0001` | Close increment (validates gates) |
62
+ | `/sw:progress` | Show task completion status |
63
+ | `/sw:validate 0001` | Quality check before closing |
64
+ | `/sw:sync-tasks` | Sync tasks.md with reality |
65
+ | `/sw:sync-docs update` | Sync to living docs |
65
66
 
66
67
  ### Plugin Commands (when installed)
67
68
 
68
69
  | Command | Purpose |
69
70
  |---------|---------|
70
- | `/specweave-github:sync 0001` | Sync increment to GitHub issue |
71
- | `/specweave-jira:sync 0001` | Sync to Jira |
72
- | `/specweave-ado:sync 0001` | Sync to Azure DevOps |
71
+ | `/sw-github:sync 0001` | Sync increment to GitHub issue |
72
+ | `/sw-jira:sync 0001` | Sync to Jira |
73
+ | `/sw-ado:sync 0001` | Sync to Azure DevOps |
73
74
 
74
75
  ---
75
76
 
@@ -84,7 +85,7 @@ SpecWeave v0.28+ introduces powerful automation that **works differently** in no
84
85
  | Feature | Claude Code | Non-Claude Tools |
85
86
  |---------|-------------|------------------|
86
87
  | **Living Docs Builder** | Auto-runs after init | Use `specweave jobs --follow` to monitor |
87
- | **Bidirectional Sync** | Pull sync on session start | Run `/specweave:sync-pull` manually |
88
+ | **Bidirectional Sync** | Pull sync on session start | Run `/sw:sync-pull` manually |
88
89
  | **Background Jobs** | Automatic with hooks | Monitor with `specweave jobs` CLI |
89
90
  | **EDA Hooks** | Auto-detect task completion | Manually update tasks.md + spec.md |
90
91
 
@@ -183,9 +184,9 @@ This gives you the SAME experience as Claude Code with MCP, but deterministic an
183
184
  # Change: - [ ] AC-US1-01 → - [x] AC-US1-01
184
185
 
185
186
  # Step 3: Sync to external tools (if configured)
186
- /specweave:sync-tasks
187
- /specweave-github:sync <increment-id> # If GitHub enabled
188
- /specweave-jira:sync <increment-id> # If Jira enabled
187
+ /sw:sync-tasks
188
+ /sw-github:sync <increment-id> # If GitHub enabled
189
+ /sw-jira:sync <increment-id> # If Jira enabled
189
190
  ```
190
191
 
191
192
  #### 2. After User Story Completion (all ACs satisfied)
@@ -194,25 +195,25 @@ This gives you the SAME experience as Claude Code with MCP, but deterministic an
194
195
  # When ALL acceptance criteria for a user story are [x] checked:
195
196
 
196
197
  # Step 1: Sync to living docs
197
- /specweave:sync-docs update
198
+ /sw:sync-docs update
198
199
 
199
200
  # Step 2: Update GitHub/Jira issue status
200
- /specweave-github:sync <increment-id>
201
+ /sw-github:sync <increment-id>
201
202
  ```
202
203
 
203
204
  #### 3. After Increment Completion
204
205
  ```bash
205
206
  # Claude hook: PostIncrementDone
206
- # When running /specweave:done:
207
+ # When running /sw:done:
207
208
 
208
209
  # Step 1: Validate all tasks complete
209
- /specweave:validate <increment-id>
210
+ /sw:validate <increment-id>
210
211
 
211
212
  # Step 2: Sync living docs
212
- /specweave:sync-docs update
213
+ /sw:sync-docs update
213
214
 
214
215
  # Step 3: Close external issues
215
- /specweave-github:close-issue <increment-id>
216
+ /sw-github:close-issue <increment-id>
216
217
  ```
217
218
 
218
219
  #### 4. After Writing to spec.md or tasks.md
@@ -221,10 +222,10 @@ This gives you the SAME experience as Claude Code with MCP, but deterministic an
221
222
  # After any edit to spec.md or tasks.md:
222
223
 
223
224
  # Sync status line cache
224
- /specweave:sync-tasks
225
+ /sw:sync-tasks
225
226
 
226
227
  # If external tools configured, sync progress
227
- /specweave-github:sync <increment-id>
228
+ /sw-github:sync <increment-id>
228
229
  ```
229
230
 
230
231
  #### 5. Bidirectional Sync - PULL from External Tools (NEW in v0.28)
@@ -233,7 +234,7 @@ This gives you the SAME experience as Claude Code with MCP, but deterministic an
233
234
  # For non-Claude tools, run manually to catch external changes:
234
235
 
235
236
  # Pull changes from external tools (status, priority, assignee)
236
- /specweave:sync-pull
237
+ /sw:sync-pull
237
238
 
238
239
  # This does:
239
240
  # 1. Query ADO/JIRA/GitHub for items changed since last sync
@@ -291,7 +292,7 @@ In non-Claude tools, commands are markdown workflows:
291
292
 
292
293
  ```bash
293
294
  # Find and read command file
294
- cat plugins/specweave/commands/specweave-increment.md
295
+ cat plugins/specweave/commands/increment.md
295
296
  # Follow the workflow steps manually
296
297
  ```
297
298
 
@@ -303,9 +304,9 @@ cat plugins/specweave/commands/specweave-increment.md
303
304
  ├─────────────────────────────────────────────────────────────┤
304
305
  │ 1. Update tasks.md: [ ] → [x] │
305
306
  │ 2. Update spec.md ACs if satisfied: [ ] → [x] │
306
- │ 3. Run: /specweave:sync-tasks │
307
- │ 4. Run: /specweave-github:sync <id> (if GitHub configured) │
308
- │ 5. If all ACs for US done: /specweave:sync-docs update │
307
+ │ 3. Run: /sw:sync-tasks │
308
+ │ 4. Run: /sw-github:sync <id> (if GitHub configured) │
309
+ │ 5. If all ACs for US done: /sw:sync-docs update │
309
310
  └─────────────────────────────────────────────────────────────┘
310
311
  ```
311
312
 
@@ -315,10 +316,10 @@ cat plugins/specweave/commands/specweave-increment.md
315
316
  ┌─────────────────────────────────────────────────────────────┐
316
317
  │ START OF EVERY SESSION (FOR NON-CLAUDE TOOLS) │
317
318
  ├─────────────────────────────────────────────────────────────┤
318
- │ 1. Pull external changes: /specweave:sync-pull │
319
+ │ 1. Pull external changes: /sw:sync-pull │
319
320
  │ 2. Check job status: specweave jobs │
320
- │ 3. Check progress: /specweave:progress │
321
- │ 4. Continue work: /specweave:do │
321
+ │ 3. Check progress: /sw:progress │
322
+ │ 4. Continue work: /sw:do │
322
323
  └─────────────────────────────────────────────────────────────┘
323
324
  ```
324
325
 
@@ -352,12 +353,12 @@ cat plugins/specweave/commands/specweave-increment.md
352
353
 
353
354
  | Command | What It Does | When to Run |
354
355
  |---------|--------------|-------------|
355
- | `/specweave:sync-tasks` | Recalculates progress from tasks.md | After editing tasks.md |
356
- | `/specweave:sync-docs update` | Updates living docs from increment | After US complete |
357
- | `/specweave-github:sync <id>` | Syncs progress to GitHub issue | After each task |
358
- | `/specweave-github:close-issue <id>` | Closes GitHub issue | On increment done |
359
- | `/specweave-jira:sync <id>` | Syncs progress to Jira story | After each task |
360
- | `/specweave-ado:sync <id>` | Syncs to Azure DevOps work item | After each task |
356
+ | `/sw:sync-tasks` | Recalculates progress from tasks.md | After editing tasks.md |
357
+ | `/sw:sync-docs update` | Updates living docs from increment | After US complete |
358
+ | `/sw-github:sync <id>` | Syncs progress to GitHub issue | After each task |
359
+ | `/sw-github:close-issue <id>` | Closes GitHub issue | On increment done |
360
+ | `/sw-jira:sync <id>` | Syncs progress to Jira story | After each task |
361
+ | `/sw-ado:sync <id>` | Syncs to Azure DevOps work item | After each task |
361
362
 
362
363
  ### Complete Sync Flow (Non-Claude Tools)
363
364
 
@@ -378,19 +379,19 @@ TASK COMPLETED
378
379
 
379
380
 
380
381
  ┌─────────────────────────────┐
381
- │ 3. /specweave:sync-tasks │
382
+ │ 3. /sw:sync-tasks │
382
383
  │ Updates progress cache │
383
384
  └─────────────────────────────┘
384
385
 
385
386
 
386
387
  ┌─────────────────────────────┐
387
- │ 4. /specweave-github:sync │
388
+ │ 4. /sw-github:sync │
388
389
  │ Updates GitHub issue │
389
390
  └─────────────────────────────┘
390
391
 
391
392
  ▼ (if all ACs for US done)
392
393
  ┌─────────────────────────────┐
393
- │ 5. /specweave:sync-docs │
394
+ │ 5. /sw:sync-docs │
394
395
  │ Updates living docs │
395
396
  └─────────────────────────────┘
396
397
  ```
@@ -410,26 +411,21 @@ TASK COMPLETED
410
411
 
411
412
  ## Context Loading {#context-loading}
412
413
 
413
- ### Why Context Manifests Matter
414
+ ### Efficient Context Management
414
415
 
415
416
  ```
416
- Without manifest: Load all docs (50k tokens) → Crash risk
417
- With manifest: Load relevant files (5k tokens) → 90% savings
417
+ Read only what's needed for the current task:
418
+ - Active increment: spec.md, tasks.md (always)
419
+ - Supporting docs: only when referenced in tasks
420
+ - Living docs: load per-US when implementing
418
421
  ```
419
422
 
420
- ### Using context-manifest.yaml
423
+ ### Token-Efficient Approach
421
424
 
422
- ```yaml
423
- # .specweave/increments/0001-feature/context-manifest.yaml
424
- spec_sections:
425
- - .specweave/docs/internal/strategy/prd.md
426
- - .specweave/docs/internal/architecture/hld.md
427
- documentation:
428
- - .specweave/docs/internal/specs/default/relevant-spec.md
429
- max_context_tokens: 10000
430
- ```
431
-
432
- **Rule**: Read context-manifest.yaml FIRST. Only load files listed there.
425
+ 1. Start with increment's `tasks.md` - contains current task list
426
+ 2. Reference `spec.md` for acceptance criteria
427
+ 3. Load living docs only when needed for context
428
+ 4. Avoid loading entire documentation trees
433
429
 
434
430
  ---
435
431
 
@@ -439,10 +435,10 @@ max_context_tokens: 10000
439
435
  .specweave/
440
436
  ├── increments/ # Feature increments (0001-9999)
441
437
  │ └── 0001-feature/
438
+ │ ├── metadata.json # Increment metadata - REQUIRED
442
439
  │ ├── spec.md # WHAT & WHY (user stories, ACs)
443
- │ ├── plan.md # HOW (architecture, APIs)
444
- ├── tasks.md # Task checklist with test plans
445
- │ └── context-manifest.yaml # Files to load
440
+ │ ├── plan.md # HOW (architecture, APIs) - optional
441
+ └── tasks.md # Task checklist with test plans
446
442
  ├── docs/internal/
447
443
  │ ├── strategy/ # PRD, business requirements
448
444
  │ ├── specs/ # Living docs (extracted user stories)
@@ -521,10 +517,10 @@ AI: [Creates .specweave/increments/0001-auth/spec.md, plan.md, tasks.md]
521
517
 
522
518
  ### Creating Increment
523
519
  1. `mkdir -p .specweave/increments/0001-feature`
524
- 2. Create `spec.md` (WHAT/WHY, user stories, ACs)
525
- 3. Create `plan.md` (HOW, architecture, APIs)
520
+ 2. Create `metadata.json` (increment metadata) - **MUST be FIRST**
521
+ 3. Create `spec.md` (WHAT/WHY, user stories, ACs)
526
522
  4. Create `tasks.md` (task checklist with tests)
527
- 5. Create `context-manifest.yaml` (selective loading)
523
+ 5. Optional: Create `plan.md` (HOW, architecture) for complex features
528
524
 
529
525
  ### Completing Tasks
530
526
  1. Implement the task
@@ -533,7 +529,7 @@ AI: [Creates .specweave/increments/0001-auth/spec.md, plan.md, tasks.md]
533
529
  4. Sync to external trackers if enabled
534
530
 
535
531
  ### Closing Increment
536
- 1. Run `/specweave:done 0001`
532
+ 1. Run `/sw:done 0001`
537
533
  2. PM validates 3 gates (tasks, tests, docs)
538
534
  3. Living docs synced automatically
539
535
  4. GitHub issue closed (if enabled)
@@ -544,9 +540,9 @@ AI: [Creates .specweave/increments/0001-auth/spec.md, plan.md, tasks.md]
544
540
 
545
541
  | Command | Plugin |
546
542
  |---------|--------|
547
- | `/specweave-github:sync` | GitHub sync |
548
- | `/specweave-jira:sync` | Jira sync |
549
- | `/specweave-ado:sync` | Azure DevOps |
543
+ | `/sw-github:sync` | GitHub sync |
544
+ | `/sw-jira:sync` | Jira sync |
545
+ | `/sw-ado:sync` | Azure DevOps |
550
546
 
551
547
  ---
552
548
 
@@ -559,7 +555,7 @@ AI: [Creates .specweave/increments/0001-auth/spec.md, plan.md, tasks.md]
559
555
  ```bash
560
556
  # Find and read the command file
561
557
  ls plugins/specweave/commands/
562
- cat plugins/specweave/commands/specweave-increment.md
558
+ cat plugins/specweave/commands/increment.md
563
559
  # Follow the workflow steps manually
564
560
  ```
565
561
 
@@ -569,9 +565,9 @@ cat plugins/specweave/commands/specweave-increment.md
569
565
 
570
566
  **Solution** (run after EVERY task in non-Claude tools):
571
567
  ```bash
572
- /specweave:sync-tasks # Update tasks.md
573
- /specweave:sync-docs update # Sync living docs
574
- /specweave-github:sync <increment-id> # Sync to GitHub
568
+ /sw:sync-tasks # Update tasks.md
569
+ /sw:sync-docs update # Sync living docs
570
+ /sw-github:sync <increment-id> # Sync to GitHub
575
571
  ```
576
572
 
577
573
  ### Root Folder Polluted
@@ -593,18 +589,18 @@ mv *.md .specweave/increments/$CURRENT/reports/
593
589
  **Status**: [ ] pending → **Status**: [x] completed
594
590
  ```
595
591
 
596
- Or run: `/specweave:sync-tasks`
592
+ Or run: `/sw:sync-tasks`
597
593
 
598
594
  ### Context Explosion / Crashes
599
595
 
600
596
  **Symptoms**: Tool crashes 10-50s after start
601
597
 
602
- **Causes**: Loading too many files, no context manifest
598
+ **Causes**: Loading too many files at once
603
599
 
604
600
  **Fix**:
605
- 1. Create `context-manifest.yaml` in increment folder
606
- 2. List only files needed for current task
607
- 3. Never load entire `.specweave/docs/` folder
601
+ 1. Load only the active increment's spec.md and tasks.md
602
+ 2. Reference living docs only when needed for specific tasks
603
+ 3. Never load entire `.specweave/docs/` folder at once
608
604
 
609
605
  ### Skills/Agents Not Activating
610
606
 
@@ -43,21 +43,21 @@ Edit("spec.md", "- [ ] **AC-US1-01**", "- [x] **AC-US1-01**");
43
43
  ## Core Workflow
44
44
 
45
45
  ```
46
- /specweave:increment "feature" → /specweave:do → /specweave:progress → /specweave:done 0001
46
+ /sw:increment "feature" → /sw:do → /sw:progress → /sw:done 0001
47
47
  ```
48
48
 
49
49
  | Command | Purpose |
50
50
  |---------|---------|
51
- | `/specweave:increment "X"` | Plan new feature |
52
- | `/specweave:do` | Execute implementation |
53
- | `/specweave:progress` | Check status |
54
- | `/specweave:validate 0001` | Quality check |
55
- | `/specweave:done 0001` | Close increment |
51
+ | `/sw:increment "X"` | Plan new feature |
52
+ | `/sw:do` | Execute implementation |
53
+ | `/sw:progress` | Check status |
54
+ | `/sw:validate 0001` | Quality check |
55
+ | `/sw:done 0001` | Close increment |
56
56
 
57
57
  **Sync Commands** (if plugins installed):
58
- - `/specweave-github:sync` - Sync to GitHub Issues
59
- - `/specweave-jira:sync` - Sync to Jira
60
- - `/specweave-ado:sync` - Sync to Azure DevOps
58
+ - `/sw-github:sync` - Sync to GitHub Issues
59
+ - `/sw-jira:sync` - Sync to Jira
60
+ - `/sw-ado:sync` - Sync to Azure DevOps
61
61
 
62
62
  ---
63
63
 
@@ -67,10 +67,10 @@ Edit("spec.md", "- [ ] **AC-US1-01**", "- [x] **AC-US1-01**");
67
67
  .specweave/
68
68
  ├── increments/ # Feature increments (####-name/)
69
69
  │ └── 0001-feature/
70
+ │ ├── metadata.json # Increment metadata - REQUIRED
70
71
  │ ├── spec.md # WHAT & WHY
71
- │ ├── plan.md # HOW
72
- ├── tasks.md # Checklist with embedded tests
73
- │ └── context-manifest.yaml # Selective loading
72
+ │ ├── plan.md # HOW (optional)
73
+ └── tasks.md # Checklist with embedded tests
74
74
  ├── docs/internal/
75
75
  │ ├── strategy/ # Business specs
76
76
  │ ├── specs/ # Living docs (post-completion)
@@ -96,12 +96,16 @@ Edit("spec.md", "- [ ] **AC-US1-01**", "- [x] **AC-US1-01**");
96
96
 
97
97
  ---
98
98
 
99
- ## Context Loading (Token Savings)
99
+ ## Increment Files
100
100
 
101
- **ALWAYS read `context-manifest.yaml` first!** Load only files listed there.
102
- - Full specs: 50k tokens
103
- - Manifest files: 5k tokens
104
- - **Savings: 90%**
101
+ **Required files** for every increment:
102
+ 1. `metadata.json` - Increment metadata (status, type, dates) - MUST create FIRST
103
+ 2. `spec.md` - User stories, acceptance criteria
104
+ 3. `tasks.md` - Implementation tasks with embedded tests
105
+
106
+ **Optional**:
107
+ - `plan.md` - Technical design (for complex features only)
108
+ - `reports/` - Completion reports, analyses
105
109
 
106
110
  ---
107
111
 
@@ -180,8 +184,8 @@ After **EVERY task completion**, hooks automatically:
180
184
  | Skills not activating | Restart Claude Code |
181
185
  | Commands not found | Check plugin: `/plugin list --installed` |
182
186
  | Root polluted | Move files to increment folders |
183
- | Tasks out of sync | `/specweave:sync-tasks` |
184
- | Can't find increment | `/specweave:status` |
187
+ | Tasks out of sync | `/sw:sync-tasks` |
188
+ | Can't find increment | `/sw:status` |
185
189
 
186
190
  ---
187
191
 
@@ -1,13 +0,0 @@
1
- /**
2
- * CLI Command: /specweave:switch-project
3
- *
4
- * Switch active project for increment planning
5
- */
6
- export declare function switchProject(projectRoot: string, projectId?: string): Promise<void>;
7
- /**
8
- * Get current active project
9
- *
10
- * @param projectRoot - Project root directory
11
- */
12
- export declare function getCurrentProject(projectRoot: string): Promise<void>;
13
- //# sourceMappingURL=switch-project.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"switch-project.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/switch-project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB1E"}
@@ -1,78 +0,0 @@
1
- /**
2
- * CLI Command: /specweave:switch-project
3
- *
4
- * Switch active project for increment planning
5
- */
6
- import { ProjectManager } from '../../core/project/project-manager.js';
7
- import { ConfigManager } from '../../core/config-manager.js';
8
- import { listProjects } from './init-multiproject.js';
9
- // NOTE: This CLI switch-project command is primarily user-facing output (console.log/console.error).
10
- // All console.* calls in this file are legitimate user-facing exceptions
11
- // as defined in CONTRIBUTING.md (project switching status, confirmations, errors).
12
- // Logger infrastructure available for future internal debug logs if needed.
13
- export async function switchProject(projectRoot, projectId) {
14
- const projectManager = new ProjectManager(projectRoot);
15
- const configManager = new ConfigManager(projectRoot);
16
- const config = configManager.load();
17
- // Check if multi-project mode is enabled
18
- if (!config.multiProject?.enabled) {
19
- console.error('\n❌ Multi-project mode not enabled');
20
- console.error(' Run /specweave:init-multiproject first\n');
21
- return;
22
- }
23
- // If no project ID provided, list projects and prompt
24
- if (!projectId) {
25
- await listProjects(projectRoot);
26
- console.log('Usage: /specweave:switch-project <project-id>\n');
27
- return;
28
- }
29
- try {
30
- // Validate project exists
31
- const project = projectManager.getProjectById(projectId);
32
- if (!project) {
33
- const allProjects = projectManager.getAllProjects();
34
- const availableIds = allProjects.map(p => p.projectId).join(', ');
35
- console.error(`\n❌ Project '${projectId}' not found`);
36
- console.error(` Available projects: ${availableIds}\n`);
37
- return;
38
- }
39
- // Check if already active
40
- const currentActive = projectManager.getActiveProject();
41
- if (currentActive.projectId === projectId) {
42
- console.log(`\nℹ️ Project '${project.projectName}' is already active\n`);
43
- return;
44
- }
45
- // Switch project
46
- await projectManager.switchProject(projectId);
47
- console.log(`\n✅ Switched to project: ${project.projectName} (${projectId})`);
48
- console.log('\nℹ️ Future increments will use:');
49
- console.log(` - ${projectManager.getSpecsPath(projectId).replace(projectRoot, '')}`);
50
- console.log(` - ${projectManager.getModulesPath(projectId).replace(projectRoot, '')}`);
51
- console.log(` - ${projectManager.getTeamPath(projectId).replace(projectRoot, '')}\n`);
52
- }
53
- catch (error) {
54
- console.error(`\n❌ Failed to switch project: ${error instanceof Error ? error.message : String(error)}\n`);
55
- throw error;
56
- }
57
- }
58
- /**
59
- * Get current active project
60
- *
61
- * @param projectRoot - Project root directory
62
- */
63
- export async function getCurrentProject(projectRoot) {
64
- const projectManager = new ProjectManager(projectRoot);
65
- const project = projectManager.getActiveProject();
66
- console.log('\n📋 Current Active Project:\n');
67
- console.log(` ID: ${project.projectId}`);
68
- console.log(` Name: ${project.projectName}`);
69
- console.log(` Path: ${project.projectPath}`);
70
- if (project.techStack.length > 0) {
71
- console.log(` Tech Stack: ${project.techStack.join(', ')}`);
72
- }
73
- if (project.keywords.length > 0) {
74
- console.log(` Keywords: ${project.keywords.join(', ')}`);
75
- }
76
- console.log('');
77
- }
78
- //# sourceMappingURL=switch-project.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"switch-project.js","sourceRoot":"","sources":["../../../../src/cli/commands/switch-project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,qGAAqG;AACrG,yEAAyE;AACzE,mFAAmF;AACnF,4EAA4E;AAE5E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,SAAkB;IAElB,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IAEpC,yCAAyC;IACzC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,WAAW,GAAG,cAAc,CAAC,cAAc,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAElE,OAAO,CAAC,KAAK,CAAC,gBAAgB,SAAS,aAAa,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,0BAA0B,YAAY,IAAI,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,0BAA0B;QAC1B,MAAM,aAAa,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC;QACxD,IAAI,aAAa,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,CAAC,WAAW,uBAAuB,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,iBAAiB;QACjB,MAAM,cAAc,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAE9C,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,CAAC,WAAW,KAAK,SAAS,GAAG,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,QAAQ,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,QAAQ,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,GAAG,CAAC,QAAQ,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3G,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE9C,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}
@@ -1,146 +0,0 @@
1
- ---
2
- name: specweave:init-multiproject
3
- description: Initialize multi-project mode for SpecWeave. Enables organizing specs, modules, and team docs by project/team. Auto-migrates existing specs/ to projects/default/.
4
- ---
5
-
6
- # Initialize Multi-Project Mode
7
-
8
- Enable multi-project mode to organize documentation by project or team.
9
-
10
- ## What This Does
11
-
12
- 1. **Auto-migrates** existing `specs/` to `projects/default/specs/` (transparent, no behavior change)
13
- 2. **Enables multi-project mode** in config (optional)
14
- 3. **Creates additional projects** (optional, interactive prompts)
15
- 4. **Sets up folder structure** for each project (specs/, modules/, team/, architecture/, legacy/)
16
-
17
- ## Usage
18
-
19
- ```bash
20
- /specweave:init-multiproject
21
- ```
22
-
23
- ## Interactive Prompts
24
-
25
- 1. **Enable multi-project mode?** (yes/no)
26
- - No: Stay in single-project mode (uses `projects/default/` but `multiProject.enabled = false`)
27
- - Yes: Enable multi-project mode (allows multiple projects)
28
-
29
- 2. **Create additional projects?** (yes/no, only if multi-project enabled)
30
- - If yes, enter project details:
31
- - Project ID (kebab-case, e.g., `web-app`)
32
- - Project name (e.g., "Web Application")
33
- - Description
34
- - Tech stack (comma-separated)
35
- - Team name
36
-
37
- ## Examples
38
-
39
- ### Example 1: Single Project (Default)
40
-
41
- ```bash
42
- /specweave:init-multiproject
43
-
44
- # Prompts:
45
- # - Enable multi-project mode? → No
46
-
47
- # Result:
48
- # ✅ Auto-migrated to projects/default/
49
- # ℹ️ Still in single-project mode
50
- # ℹ️ All operations use projects/default/ automatically
51
- ```
52
-
53
- ### Example 2: Multi-Project (Enterprise)
54
-
55
- ```bash
56
- /specweave:init-multiproject
57
-
58
- # Prompts:
59
- # - Enable multi-project mode? → Yes
60
- # - Create additional projects? → Yes
61
- # - Project ID: web-app
62
- # - Name: Web Application
63
- # - Description: Customer-facing web app
64
- # - Tech stack: React, TypeScript, Node.js
65
- # - Team: Frontend Team
66
- #
67
- # Create another project? → Yes
68
- # - Project ID: platform-infra
69
- # - Name: Platform Infrastructure
70
- # - ...
71
-
72
- # Result:
73
- # ✅ Created projects/web-app/
74
- # ✅ Created projects/platform-infra/
75
- # ✅ Multi-project mode enabled
76
- # ℹ️ Use /specweave:switch-project to change active project
77
- ```
78
-
79
- ## Folder Structure Created
80
-
81
- For each project:
82
-
83
- ```
84
- .specweave/docs/internal/projects/{project-id}/
85
- ├── README.md # Project overview
86
- ├── specs/ # Living docs specs (spec-001, spec-002, ...)
87
- ├── modules/ # Module-level docs (auth, payments, etc.)
88
- ├── team/ # Team playbooks (onboarding, conventions)
89
- ├── architecture/ # Project-specific architecture (optional)
90
- │ └── adr/ # Architecture Decision Records
91
- └── legacy/ # Brownfield imported docs
92
- ```
93
-
94
- ## When to Use
95
-
96
- ### Single Project Mode
97
- - Small projects or startups
98
- - One team, one codebase
99
- - Simple organizational structure
100
-
101
- ### Multi-Project Mode
102
- - Multiple teams or repos
103
- - Microservices architecture
104
- - Platform engineering managing multiple projects
105
- - Different tech stacks per team
106
-
107
- ## Integration with External Sync
108
-
109
- Multi-project mode integrates with external sync (GitHub, JIRA, ADO):
110
-
111
- ```json
112
- {
113
- "multiProject": {
114
- "projects": [{
115
- "id": "web-app",
116
- "syncProfiles": ["web-app-github", "web-app-jira"]
117
- }]
118
- }
119
- }
120
- ```
121
-
122
- Each project can link to specific sync profiles for external tracking.
123
-
124
- ## What Happens to Existing Specs?
125
-
126
- **Automatic Migration**:
127
- 1. Existing `specs/` copied to `projects/default/specs/`
128
- 2. Old `specs/` renamed to `specs.old/` (backup)
129
- 3. Config updated with `multiProject` section
130
- 4. **No behavior change** - all operations still work
131
-
132
- **Rollback** (if needed):
133
- ```bash
134
- # Restore from backup
135
- npm run specweave:rollback-migration
136
- ```
137
-
138
- ## See Also
139
-
140
- - `/specweave:switch-project` - Change active project
141
- - `/specweave:import-docs` - Import brownfield docs
142
- - [Multi-Project Guide](https://docs.spec-weave.com/guides/multi-project-setup)
143
-
144
- ---
145
-
146
- **Implementation**: `src/cli/commands/init-multiproject.ts`