@sk8metal/michi-cli 0.0.9 → 0.1.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 (371) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +235 -57
  3. package/dist/scripts/__tests__/create-project.test.js +24 -28
  4. package/dist/scripts/__tests__/create-project.test.js.map +1 -1
  5. package/dist/scripts/__tests__/jira-transitions.test.d.ts +5 -0
  6. package/dist/scripts/__tests__/jira-transitions.test.d.ts.map +1 -0
  7. package/dist/scripts/__tests__/jira-transitions.test.js +172 -0
  8. package/dist/scripts/__tests__/jira-transitions.test.js.map +1 -0
  9. package/dist/scripts/__tests__/multi-project-estimate.test.js +14 -15
  10. package/dist/scripts/__tests__/multi-project-estimate.test.js.map +1 -1
  11. package/dist/scripts/__tests__/setup-existing-project.test.js +79 -0
  12. package/dist/scripts/__tests__/setup-existing-project.test.js.map +1 -1
  13. package/dist/scripts/__tests__/setup-interactive.test.js +23 -17
  14. package/dist/scripts/__tests__/setup-interactive.test.js.map +1 -1
  15. package/dist/scripts/__tests__/spec-impl-workflow.test.d.ts +5 -0
  16. package/dist/scripts/__tests__/spec-impl-workflow.test.d.ts.map +1 -0
  17. package/dist/scripts/__tests__/spec-impl-workflow.test.js +321 -0
  18. package/dist/scripts/__tests__/spec-impl-workflow.test.js.map +1 -0
  19. package/dist/scripts/__tests__/spec-loader.test.d.ts +5 -0
  20. package/dist/scripts/__tests__/spec-loader.test.d.ts.map +1 -0
  21. package/dist/scripts/__tests__/spec-loader.test.js +153 -0
  22. package/dist/scripts/__tests__/spec-loader.test.js.map +1 -0
  23. package/dist/scripts/__tests__/validate-phase.test.js +26 -22
  24. package/dist/scripts/__tests__/validate-phase.test.js.map +1 -1
  25. package/dist/scripts/config/config-schema.d.ts +17 -0
  26. package/dist/scripts/config/config-schema.d.ts.map +1 -1
  27. package/dist/scripts/config/config-schema.js +55 -26
  28. package/dist/scripts/config/config-schema.js.map +1 -1
  29. package/dist/scripts/config-interactive.d.ts.map +1 -1
  30. package/dist/scripts/config-interactive.js +53 -38
  31. package/dist/scripts/config-interactive.js.map +1 -1
  32. package/dist/scripts/confluence-sync.d.ts.map +1 -1
  33. package/dist/scripts/confluence-sync.js +0 -11
  34. package/dist/scripts/confluence-sync.js.map +1 -1
  35. package/dist/scripts/constants/__tests__/environments.test.js +39 -5
  36. package/dist/scripts/constants/__tests__/environments.test.js.map +1 -1
  37. package/dist/scripts/constants/environments.d.ts +1 -1
  38. package/dist/scripts/constants/environments.d.ts.map +1 -1
  39. package/dist/scripts/constants/environments.js +22 -7
  40. package/dist/scripts/constants/environments.js.map +1 -1
  41. package/dist/scripts/constants/test-commands.d.ts +36 -0
  42. package/dist/scripts/constants/test-commands.d.ts.map +1 -0
  43. package/dist/scripts/constants/test-commands.js +70 -0
  44. package/dist/scripts/constants/test-commands.js.map +1 -0
  45. package/dist/scripts/jira-sync.d.ts +89 -3
  46. package/dist/scripts/jira-sync.d.ts.map +1 -1
  47. package/dist/scripts/jira-sync.js +366 -96
  48. package/dist/scripts/jira-sync.js.map +1 -1
  49. package/dist/scripts/markdown-to-confluence.js +1 -1
  50. package/dist/scripts/markdown-to-confluence.js.map +1 -1
  51. package/dist/scripts/phase-runner.d.ts +1 -1
  52. package/dist/scripts/phase-runner.d.ts.map +1 -1
  53. package/dist/scripts/phase-runner.js +809 -13
  54. package/dist/scripts/phase-runner.js.map +1 -1
  55. package/dist/scripts/pr-automation.d.ts.map +1 -1
  56. package/dist/scripts/pr-automation.js.map +1 -1
  57. package/dist/scripts/pre-flight-check.js +1 -1
  58. package/dist/scripts/pre-flight-check.js.map +1 -1
  59. package/dist/scripts/setup-existing-project.js +61 -29
  60. package/dist/scripts/setup-existing-project.js.map +1 -1
  61. package/dist/scripts/setup-interactive.js +3 -3
  62. package/dist/scripts/setup-interactive.js.map +1 -1
  63. package/dist/scripts/spec-impl-workflow.d.ts +94 -0
  64. package/dist/scripts/spec-impl-workflow.d.ts.map +1 -0
  65. package/dist/scripts/spec-impl-workflow.js +354 -0
  66. package/dist/scripts/spec-impl-workflow.js.map +1 -0
  67. package/dist/scripts/template/__tests__/renderer.test.js.map +1 -1
  68. package/dist/scripts/test-execution-generator.d.ts +52 -0
  69. package/dist/scripts/test-execution-generator.d.ts.map +1 -0
  70. package/dist/scripts/test-execution-generator.js +576 -0
  71. package/dist/scripts/test-execution-generator.js.map +1 -0
  72. package/dist/scripts/test-interactive.d.ts +10 -0
  73. package/dist/scripts/test-interactive.d.ts.map +1 -0
  74. package/dist/scripts/test-interactive.js +627 -0
  75. package/dist/scripts/test-interactive.js.map +1 -0
  76. package/dist/scripts/test-new-features.d.ts +5 -0
  77. package/dist/scripts/test-new-features.d.ts.map +1 -0
  78. package/dist/scripts/test-new-features.js +145 -0
  79. package/dist/scripts/test-new-features.js.map +1 -0
  80. package/dist/scripts/test-spec-generator.d.ts +29 -0
  81. package/dist/scripts/test-spec-generator.d.ts.map +1 -0
  82. package/dist/scripts/test-spec-generator.js +494 -0
  83. package/dist/scripts/test-spec-generator.js.map +1 -0
  84. package/dist/scripts/test-workflow-stages.d.ts +6 -0
  85. package/dist/scripts/test-workflow-stages.d.ts.map +1 -0
  86. package/dist/scripts/test-workflow-stages.js +43 -0
  87. package/dist/scripts/test-workflow-stages.js.map +1 -0
  88. package/dist/scripts/utils/__tests__/aidlc-parser.test.d.ts +5 -0
  89. package/dist/scripts/utils/__tests__/aidlc-parser.test.d.ts.map +1 -0
  90. package/dist/scripts/utils/__tests__/aidlc-parser.test.js +315 -0
  91. package/dist/scripts/utils/__tests__/aidlc-parser.test.js.map +1 -0
  92. package/dist/scripts/utils/__tests__/business-days.test.d.ts +5 -0
  93. package/dist/scripts/utils/__tests__/business-days.test.d.ts.map +1 -0
  94. package/dist/scripts/utils/__tests__/business-days.test.js +171 -0
  95. package/dist/scripts/utils/__tests__/business-days.test.js.map +1 -0
  96. package/dist/scripts/utils/__tests__/config-loader.test.js +1 -1
  97. package/dist/scripts/utils/__tests__/config-loader.test.js.map +1 -1
  98. package/dist/scripts/utils/__tests__/config-validator.test.js +164 -35
  99. package/dist/scripts/utils/__tests__/config-validator.test.js.map +1 -1
  100. package/dist/scripts/utils/__tests__/env-config.test.d.ts +5 -0
  101. package/dist/scripts/utils/__tests__/env-config.test.d.ts.map +1 -0
  102. package/dist/scripts/utils/__tests__/env-config.test.js +218 -0
  103. package/dist/scripts/utils/__tests__/env-config.test.js.map +1 -0
  104. package/dist/scripts/utils/__tests__/jira-issue-type-fetcher.test.d.ts +5 -0
  105. package/dist/scripts/utils/__tests__/jira-issue-type-fetcher.test.d.ts.map +1 -0
  106. package/dist/scripts/utils/__tests__/jira-issue-type-fetcher.test.js +202 -0
  107. package/dist/scripts/utils/__tests__/jira-issue-type-fetcher.test.js.map +1 -0
  108. package/dist/scripts/utils/__tests__/tasks-converter.test.d.ts +5 -0
  109. package/dist/scripts/utils/__tests__/tasks-converter.test.d.ts.map +1 -0
  110. package/dist/scripts/utils/__tests__/tasks-converter.test.js +500 -0
  111. package/dist/scripts/utils/__tests__/tasks-converter.test.js.map +1 -0
  112. package/dist/scripts/utils/__tests__/tasks-format-validator.test.d.ts +5 -0
  113. package/dist/scripts/utils/__tests__/tasks-format-validator.test.d.ts.map +1 -0
  114. package/dist/scripts/utils/__tests__/tasks-format-validator.test.js +314 -0
  115. package/dist/scripts/utils/__tests__/tasks-format-validator.test.js.map +1 -0
  116. package/dist/scripts/utils/__tests__/test-runner.test.d.ts +5 -0
  117. package/dist/scripts/utils/__tests__/test-runner.test.d.ts.map +1 -0
  118. package/dist/scripts/utils/__tests__/test-runner.test.js +64 -0
  119. package/dist/scripts/utils/__tests__/test-runner.test.js.map +1 -0
  120. package/dist/scripts/utils/aidlc-parser.d.ts +86 -0
  121. package/dist/scripts/utils/aidlc-parser.d.ts.map +1 -0
  122. package/dist/scripts/utils/aidlc-parser.js +208 -0
  123. package/dist/scripts/utils/aidlc-parser.js.map +1 -0
  124. package/dist/scripts/utils/business-days.d.ts +52 -0
  125. package/dist/scripts/utils/business-days.d.ts.map +1 -0
  126. package/dist/scripts/utils/business-days.js +98 -0
  127. package/dist/scripts/utils/business-days.js.map +1 -0
  128. package/dist/scripts/utils/ci-generator.d.ts +14 -0
  129. package/dist/scripts/utils/ci-generator.d.ts.map +1 -0
  130. package/dist/scripts/utils/ci-generator.js +61 -0
  131. package/dist/scripts/utils/ci-generator.js.map +1 -0
  132. package/dist/scripts/utils/config-loader.js +2 -2
  133. package/dist/scripts/utils/config-loader.js.map +1 -1
  134. package/dist/scripts/utils/config-validator.d.ts +7 -1
  135. package/dist/scripts/utils/config-validator.d.ts.map +1 -1
  136. package/dist/scripts/utils/config-validator.js +136 -23
  137. package/dist/scripts/utils/config-validator.js.map +1 -1
  138. package/dist/scripts/utils/confluence-approval.d.ts +46 -0
  139. package/dist/scripts/utils/confluence-approval.d.ts.map +1 -0
  140. package/dist/scripts/utils/confluence-approval.js +118 -0
  141. package/dist/scripts/utils/confluence-approval.js.map +1 -0
  142. package/dist/scripts/utils/confluence-hierarchy.d.ts.map +1 -1
  143. package/dist/scripts/utils/confluence-hierarchy.js +1 -1
  144. package/dist/scripts/utils/confluence-hierarchy.js.map +1 -1
  145. package/dist/scripts/utils/docker-generator.d.ts +9 -0
  146. package/dist/scripts/utils/docker-generator.d.ts.map +1 -0
  147. package/dist/scripts/utils/docker-generator.js +132 -0
  148. package/dist/scripts/utils/docker-generator.js.map +1 -0
  149. package/dist/scripts/utils/docker-requirement-detector.d.ts +15 -0
  150. package/dist/scripts/utils/docker-requirement-detector.d.ts.map +1 -0
  151. package/dist/scripts/utils/docker-requirement-detector.js +124 -0
  152. package/dist/scripts/utils/docker-requirement-detector.js.map +1 -0
  153. package/dist/scripts/utils/env-config.d.ts +54 -0
  154. package/dist/scripts/utils/env-config.d.ts.map +1 -0
  155. package/dist/scripts/utils/env-config.js +414 -0
  156. package/dist/scripts/utils/env-config.js.map +1 -0
  157. package/dist/scripts/utils/jira-issue-type-fetcher.d.ts +70 -0
  158. package/dist/scripts/utils/jira-issue-type-fetcher.d.ts.map +1 -0
  159. package/dist/scripts/utils/jira-issue-type-fetcher.js +147 -0
  160. package/dist/scripts/utils/jira-issue-type-fetcher.js.map +1 -0
  161. package/dist/scripts/utils/language-detector.d.ts +14 -0
  162. package/dist/scripts/utils/language-detector.d.ts.map +1 -0
  163. package/dist/scripts/utils/language-detector.js +119 -0
  164. package/dist/scripts/utils/language-detector.js.map +1 -0
  165. package/dist/scripts/utils/markdown-parser.d.ts +55 -0
  166. package/dist/scripts/utils/markdown-parser.d.ts.map +1 -0
  167. package/dist/scripts/utils/markdown-parser.js +289 -0
  168. package/dist/scripts/utils/markdown-parser.js.map +1 -0
  169. package/dist/scripts/utils/project-detector.d.ts +17 -0
  170. package/dist/scripts/utils/project-detector.d.ts.map +1 -0
  171. package/dist/scripts/utils/project-detector.js +166 -0
  172. package/dist/scripts/utils/project-detector.js.map +1 -0
  173. package/dist/scripts/utils/project-finder.js +2 -2
  174. package/dist/scripts/utils/project-finder.js.map +1 -1
  175. package/dist/scripts/utils/release-notes-generator.d.ts +56 -0
  176. package/dist/scripts/utils/release-notes-generator.d.ts.map +1 -0
  177. package/dist/scripts/utils/release-notes-generator.js +162 -0
  178. package/dist/scripts/utils/release-notes-generator.js.map +1 -0
  179. package/dist/scripts/utils/spec-loader.d.ts +79 -0
  180. package/dist/scripts/utils/spec-loader.d.ts.map +1 -0
  181. package/dist/scripts/utils/spec-loader.js +80 -0
  182. package/dist/scripts/utils/spec-loader.js.map +1 -0
  183. package/dist/scripts/utils/spec-updater.d.ts +7 -0
  184. package/dist/scripts/utils/spec-updater.d.ts.map +1 -1
  185. package/dist/scripts/utils/spec-updater.js.map +1 -1
  186. package/dist/scripts/utils/tasks-converter.d.ts +57 -0
  187. package/dist/scripts/utils/tasks-converter.d.ts.map +1 -0
  188. package/dist/scripts/utils/tasks-converter.js +322 -0
  189. package/dist/scripts/utils/tasks-converter.js.map +1 -0
  190. package/dist/scripts/utils/tasks-format-validator.d.ts +36 -0
  191. package/dist/scripts/utils/tasks-format-validator.d.ts.map +1 -0
  192. package/dist/scripts/utils/tasks-format-validator.js +158 -0
  193. package/dist/scripts/utils/tasks-format-validator.js.map +1 -0
  194. package/dist/scripts/utils/template-applier.d.ts +37 -0
  195. package/dist/scripts/utils/template-applier.d.ts.map +1 -0
  196. package/dist/scripts/utils/template-applier.js +129 -0
  197. package/dist/scripts/utils/template-applier.js.map +1 -0
  198. package/dist/scripts/utils/test-config-generator.d.ts +12 -0
  199. package/dist/scripts/utils/test-config-generator.d.ts.map +1 -0
  200. package/dist/scripts/utils/test-config-generator.js +185 -0
  201. package/dist/scripts/utils/test-config-generator.js.map +1 -0
  202. package/dist/scripts/utils/test-runner.d.ts +31 -0
  203. package/dist/scripts/utils/test-runner.d.ts.map +1 -0
  204. package/dist/scripts/utils/test-runner.js +103 -0
  205. package/dist/scripts/utils/test-runner.js.map +1 -0
  206. package/dist/scripts/validate-phase.d.ts +1 -1
  207. package/dist/scripts/validate-phase.d.ts.map +1 -1
  208. package/dist/scripts/validate-phase.js +153 -5
  209. package/dist/scripts/validate-phase.js.map +1 -1
  210. package/dist/scripts/workflow-orchestrator.d.ts +8 -0
  211. package/dist/scripts/workflow-orchestrator.d.ts.map +1 -1
  212. package/dist/scripts/workflow-orchestrator.js +108 -7
  213. package/dist/scripts/workflow-orchestrator.js.map +1 -1
  214. package/dist/src/__tests__/integration/internationalization.test.d.ts +8 -0
  215. package/dist/src/__tests__/integration/internationalization.test.d.ts.map +1 -0
  216. package/dist/src/__tests__/integration/internationalization.test.js +333 -0
  217. package/dist/src/__tests__/integration/internationalization.test.js.map +1 -0
  218. package/dist/src/__tests__/integration/setup/claude-agent.test.d.ts +1 -1
  219. package/dist/src/__tests__/integration/setup/claude-agent.test.js +17 -20
  220. package/dist/src/__tests__/integration/setup/claude-agent.test.js.map +1 -1
  221. package/dist/src/__tests__/integration/setup/cursor.test.js +23 -19
  222. package/dist/src/__tests__/integration/setup/cursor.test.js.map +1 -1
  223. package/dist/src/__tests__/integration/setup/validation.test.js +41 -58
  224. package/dist/src/__tests__/integration/setup/validation.test.js.map +1 -1
  225. package/dist/src/cli.d.ts.map +1 -1
  226. package/dist/src/cli.js +208 -18
  227. package/dist/src/cli.js.map +1 -1
  228. package/dist/src/commands/setup-existing.d.ts +3 -0
  229. package/dist/src/commands/setup-existing.d.ts.map +1 -1
  230. package/dist/src/commands/setup-existing.js +334 -47
  231. package/dist/src/commands/setup-existing.js.map +1 -1
  232. package/docs/README.md +3 -1
  233. package/docs/context.md +59 -0
  234. package/docs/design-issue-55.md +240 -0
  235. package/docs/design-issue-56.md +181 -0
  236. package/docs/michi-development/testing/manual-verification-flow.md +2242 -0
  237. package/docs/michi-development/testing/pre-publish-checklist.md +560 -0
  238. package/docs/plan.md +275 -0
  239. package/docs/user-guide/getting-started/github-token-setup.md +509 -0
  240. package/docs/{getting-started → user-guide/getting-started}/quick-start.md +16 -0
  241. package/docs/{getting-started → user-guide/getting-started}/setup.md +28 -1
  242. package/docs/user-guide/guides/internationalization.md +540 -0
  243. package/docs/{guides → user-guide/guides}/multi-project.md +1 -1
  244. package/docs/{guides → user-guide/guides}/phase-automation.md +67 -9
  245. package/docs/user-guide/guides/workflow.md +582 -0
  246. package/docs/user-guide/hands-on/README.md +142 -0
  247. package/docs/user-guide/hands-on/claude-agent-setup.md +455 -0
  248. package/docs/user-guide/hands-on/claude-setup.md +398 -0
  249. package/docs/user-guide/hands-on/cursor-setup.md +352 -0
  250. package/docs/user-guide/hands-on/troubleshooting.md +964 -0
  251. package/docs/user-guide/hands-on/verification-checklist.md +438 -0
  252. package/docs/user-guide/hands-on/workflow-walkthrough.md +906 -0
  253. package/docs/user-guide/reference/config.md +564 -0
  254. package/docs/{reference → user-guide/reference}/quick-reference.md +53 -40
  255. package/docs/user-guide/release/ci-setup.md +541 -0
  256. package/docs/user-guide/release/release-flow.md +476 -0
  257. package/docs/user-guide/templates/test-specs/README.md +173 -0
  258. package/docs/user-guide/templates/test-specs/e2e-test-spec-template.md +547 -0
  259. package/docs/user-guide/templates/test-specs/integration-test-spec-template.md +435 -0
  260. package/docs/user-guide/templates/test-specs/performance-test-spec-template.md +454 -0
  261. package/docs/user-guide/templates/test-specs/security-test-spec-template.md +664 -0
  262. package/docs/user-guide/templates/test-specs/unit-test-spec-template.md +328 -0
  263. package/docs/{testing → user-guide/testing}/integration-tests.md +24 -9
  264. package/docs/user-guide/testing/tdd-cycle.md +349 -0
  265. package/docs/user-guide/testing/test-execution-flow.md +396 -0
  266. package/docs/user-guide/testing/test-failure-handling.md +521 -0
  267. package/docs/user-guide/testing/test-planning-flow.md +181 -0
  268. package/docs/user-guide/testing-strategy.md +185 -0
  269. package/docs/verification-guide.md +518 -0
  270. package/package.json +7 -2
  271. package/scripts/__tests__/create-project.test.ts +67 -49
  272. package/scripts/__tests__/jira-transitions.test.ts +225 -0
  273. package/scripts/__tests__/multi-project-estimate.test.ts +36 -30
  274. package/scripts/__tests__/setup-existing-project.test.ts +98 -1
  275. package/scripts/__tests__/setup-interactive.test.ts +52 -46
  276. package/scripts/__tests__/spec-impl-workflow.test.ts +429 -0
  277. package/scripts/__tests__/spec-loader.test.ts +199 -0
  278. package/scripts/__tests__/validate-phase.test.ts +78 -54
  279. package/scripts/config/config-schema.ts +89 -50
  280. package/scripts/config-interactive.ts +191 -136
  281. package/scripts/confluence-sync.ts +0 -12
  282. package/scripts/constants/__tests__/environments.test.ts +42 -6
  283. package/scripts/constants/environments.ts +33 -13
  284. package/scripts/constants/test-commands.ts +96 -0
  285. package/scripts/jira-sync.ts +767 -232
  286. package/scripts/markdown-to-confluence.ts +1 -1
  287. package/scripts/phase-runner.ts +1056 -63
  288. package/scripts/pr-automation.ts +0 -1
  289. package/scripts/pre-flight-check.ts +1 -1
  290. package/scripts/pre-publish-check.sh +311 -0
  291. package/scripts/quick-verify.sh +115 -0
  292. package/scripts/setup-existing-project.ts +201 -117
  293. package/scripts/setup-interactive.ts +4 -4
  294. package/scripts/spec-impl-workflow.ts +505 -0
  295. package/scripts/template/__tests__/renderer.test.ts +1 -2
  296. package/scripts/test-execution-generator.ts +695 -0
  297. package/scripts/test-interactive.ts +779 -0
  298. package/scripts/test-new-features.ts +168 -0
  299. package/scripts/test-npm-package.sh +345 -0
  300. package/scripts/test-spec-generator.ts +574 -0
  301. package/scripts/test-workflow-stages.ts +53 -0
  302. package/scripts/utils/__tests__/aidlc-parser.test.ts +349 -0
  303. package/scripts/utils/__tests__/business-days.test.ts +214 -0
  304. package/scripts/utils/__tests__/config-loader.test.ts +1 -1
  305. package/scripts/utils/__tests__/config-validator.test.ts +309 -88
  306. package/scripts/utils/__tests__/env-config.test.ts +259 -0
  307. package/scripts/utils/__tests__/jira-issue-type-fetcher.test.ts +272 -0
  308. package/scripts/utils/__tests__/tasks-converter.test.ts +582 -0
  309. package/scripts/utils/__tests__/tasks-format-validator.test.ts +338 -0
  310. package/scripts/utils/__tests__/test-runner.test.ts +77 -0
  311. package/scripts/utils/aidlc-parser.ts +289 -0
  312. package/scripts/utils/business-days.ts +115 -0
  313. package/scripts/utils/ci-generator.ts +84 -0
  314. package/scripts/utils/config-loader.ts +2 -2
  315. package/scripts/utils/config-validator.ts +304 -117
  316. package/scripts/utils/confluence-approval.ts +167 -0
  317. package/scripts/utils/confluence-hierarchy.ts +2 -4
  318. package/scripts/utils/docker-generator.ts +151 -0
  319. package/scripts/utils/docker-requirement-detector.ts +153 -0
  320. package/scripts/utils/env-config.ts +526 -0
  321. package/scripts/utils/jira-issue-type-fetcher.ts +199 -0
  322. package/scripts/utils/language-detector.ts +139 -0
  323. package/scripts/utils/markdown-parser.ts +376 -0
  324. package/scripts/utils/project-detector.ts +192 -0
  325. package/scripts/utils/project-finder.ts +2 -2
  326. package/scripts/utils/release-notes-generator.ts +210 -0
  327. package/scripts/utils/spec-loader.ts +125 -0
  328. package/scripts/utils/spec-updater.ts +8 -1
  329. package/scripts/utils/tasks-converter.ts +601 -0
  330. package/scripts/utils/tasks-format-validator.ts +193 -0
  331. package/scripts/utils/template-applier.ts +202 -0
  332. package/scripts/utils/test-config-generator.ts +210 -0
  333. package/scripts/utils/test-runner.ts +133 -0
  334. package/scripts/validate-phase.ts +186 -9
  335. package/scripts/workflow-orchestrator.ts +130 -12
  336. package/templates/ci/github-actions/java.yml +54 -0
  337. package/templates/ci/github-actions/nodejs.yml +46 -0
  338. package/templates/ci/github-actions/php.yml +52 -0
  339. package/templates/ci/screwdriver/java.yaml +17 -0
  340. package/templates/ci/screwdriver/nodejs.yaml +17 -0
  341. package/templates/ci/screwdriver/php.yaml +20 -0
  342. package/templates/claude/commands/kiro/kiro-spec-impl.md +244 -0
  343. package/templates/claude/commands/kiro/kiro-spec-tasks.md +354 -0
  344. package/templates/claude-agent/README.md +7 -1
  345. package/templates/claude-agent/agents/.gitkeep +0 -0
  346. package/templates/claude-agent/agents/designer.md +79 -0
  347. package/templates/claude-agent/agents/developer.md +68 -0
  348. package/templates/claude-agent/agents/manager-agent.md +59 -0
  349. package/templates/claude-agent/agents/tester.md +101 -0
  350. package/templates/claude-agent/commands/kiro/.gitkeep +0 -0
  351. package/templates/claude-agent/commands/kiro/kiro-spec-impl.md +244 -0
  352. package/templates/claude-agent/commands/kiro/kiro-spec-tasks.md +354 -0
  353. package/templates/cline/rules/atlassian-integration.md +36 -0
  354. package/templates/cline/rules/michi-core.md +56 -0
  355. package/templates/codex/AGENTS.override.md +277 -0
  356. package/templates/codex/prompts/confluence-sync.md +177 -0
  357. package/templates/codex/rules/README.md +210 -0
  358. package/templates/common/.kiro/project.json.template +21 -0
  359. package/templates/cursor/commands/kiro/kiro-spec-impl.md +244 -0
  360. package/templates/cursor/commands/kiro/kiro-spec-tasks.md +354 -0
  361. package/templates/gemini/commands/README.md +41 -0
  362. package/templates/gemini/rules/GEMINI.md +80 -0
  363. package/docs/guides/workflow.md +0 -342
  364. package/docs/reference/config.md +0 -545
  365. package/scripts/setup-existing.sh +0 -279
  366. /package/docs/{contributing → michi-development/contributing}/development.md +0 -0
  367. /package/docs/{contributing → michi-development/contributing}/release.md +0 -0
  368. /package/docs/{testing-strategy.md → michi-development/testing-strategy.md} +0 -0
  369. /package/docs/{getting-started → user-guide/getting-started}/new-repository-setup.md +0 -0
  370. /package/docs/{guides → user-guide/guides}/customization.md +0 -0
  371. /package/docs/{reference → user-guide/reference}/tasks-template.md +0 -0
@@ -2,7 +2,7 @@
2
2
  * config-validator.ts のユニットテスト
3
3
  */
4
4
 
5
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
5
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
6
6
  import { existsSync, writeFileSync, unlinkSync, mkdirSync, rmSync } from 'fs';
7
7
  import { resolve, join } from 'path';
8
8
  import { tmpdir } from 'os';
@@ -10,9 +10,10 @@ import {
10
10
  validateProjectConfig,
11
11
  validateForConfluenceSync,
12
12
  validateForJiraSync,
13
- validateAndReport
13
+ validateForJiraSyncAsync,
14
14
  } from '../config-validator.js';
15
15
  import { clearConfigCache } from '../config-loader.js';
16
+ import * as jiraFetcher from '../jira-issue-type-fetcher.js';
16
17
 
17
18
  describe('config-validator', () => {
18
19
  let testProjectRoot: string;
@@ -26,12 +27,15 @@ describe('config-validator', () => {
26
27
 
27
28
  // 環境変数をバックアップ
28
29
  originalEnv = { ...process.env };
29
-
30
+
30
31
  // キャッシュをクリア
31
32
  clearConfigCache();
32
33
  });
33
34
 
34
35
  afterEach(() => {
36
+ // モックをリストア
37
+ vi.restoreAllMocks();
38
+
35
39
  // 環境変数を復元
36
40
  process.env = originalEnv;
37
41
 
@@ -45,7 +49,7 @@ describe('config-validator', () => {
45
49
  // ディレクトリを削除
46
50
  try {
47
51
  rmSync(testProjectRoot, { recursive: true, force: true });
48
- } catch (e) {
52
+ } catch {
49
53
  // 削除失敗は無視
50
54
  }
51
55
  }
@@ -76,14 +80,17 @@ describe('config-validator', () => {
76
80
  }
77
81
 
78
82
  const configPath = join(testProjectRoot, '.michi/config.json');
79
- writeFileSync(configPath, JSON.stringify({
80
- confluence: {
81
- pageCreationGranularity: 'single',
82
- spaces: {
83
- requirements: 'Michi'
84
- }
85
- }
86
- }));
83
+ writeFileSync(
84
+ configPath,
85
+ JSON.stringify({
86
+ confluence: {
87
+ pageCreationGranularity: 'single',
88
+ spaces: {
89
+ requirements: 'Michi',
90
+ },
91
+ },
92
+ }),
93
+ );
87
94
 
88
95
  const result = validateProjectConfig(testProjectRoot);
89
96
 
@@ -104,11 +111,14 @@ describe('config-validator', () => {
104
111
 
105
112
  it('by-hierarchyモードでhierarchy設定がない場合はエラー', () => {
106
113
  const configPath = join(testProjectRoot, '.michi/config.json');
107
- writeFileSync(configPath, JSON.stringify({
108
- confluence: {
109
- pageCreationGranularity: 'by-hierarchy'
110
- }
111
- }));
114
+ writeFileSync(
115
+ configPath,
116
+ JSON.stringify({
117
+ confluence: {
118
+ pageCreationGranularity: 'by-hierarchy',
119
+ },
120
+ }),
121
+ );
112
122
 
113
123
  const result = validateProjectConfig(testProjectRoot);
114
124
 
@@ -119,11 +129,14 @@ describe('config-validator', () => {
119
129
 
120
130
  it('selected-phasesモードでselectedPhases設定がない場合はエラー', () => {
121
131
  const configPath = join(testProjectRoot, '.michi/config.json');
122
- writeFileSync(configPath, JSON.stringify({
123
- jira: {
124
- storyCreationGranularity: 'selected-phases'
125
- }
126
- }));
132
+ writeFileSync(
133
+ configPath,
134
+ JSON.stringify({
135
+ jira: {
136
+ storyCreationGranularity: 'selected-phases',
137
+ },
138
+ }),
139
+ );
127
140
 
128
141
  const result = validateProjectConfig(testProjectRoot);
129
142
 
@@ -137,13 +150,16 @@ describe('config-validator', () => {
137
150
  it('spaces設定がない場合は警告を返す', () => {
138
151
  // 環境変数をクリア
139
152
  delete process.env.CONFLUENCE_PRD_SPACE;
140
-
153
+
141
154
  const configPath = join(testProjectRoot, '.michi/config.json');
142
- writeFileSync(configPath, JSON.stringify({
143
- confluence: {
144
- pageCreationGranularity: 'single'
145
- }
146
- }));
155
+ writeFileSync(
156
+ configPath,
157
+ JSON.stringify({
158
+ confluence: {
159
+ pageCreationGranularity: 'single',
160
+ },
161
+ }),
162
+ );
147
163
 
148
164
  const result = validateForConfluenceSync('requirements', testProjectRoot);
149
165
 
@@ -157,13 +173,16 @@ describe('config-validator', () => {
157
173
 
158
174
  it('spaces設定がある場合は成功', () => {
159
175
  const configPath = join(testProjectRoot, '.michi/config.json');
160
- writeFileSync(configPath, JSON.stringify({
161
- confluence: {
162
- spaces: {
163
- requirements: 'Michi'
164
- }
165
- }
166
- }));
176
+ writeFileSync(
177
+ configPath,
178
+ JSON.stringify({
179
+ confluence: {
180
+ spaces: {
181
+ requirements: 'Michi',
182
+ },
183
+ },
184
+ }),
185
+ );
167
186
 
168
187
  const result = validateForConfluenceSync('requirements', testProjectRoot);
169
188
 
@@ -175,15 +194,18 @@ describe('config-validator', () => {
175
194
  // デフォルト設定を上書きするため、hierarchyキーを削除
176
195
  // デフォルト設定にhierarchyがあるため、実際にはエラーにならない可能性がある
177
196
  const configPath = join(testProjectRoot, '.michi/config.json');
178
- writeFileSync(configPath, JSON.stringify({
179
- confluence: {
180
- pageCreationGranularity: 'by-hierarchy',
181
- spaces: {
182
- requirements: 'Michi'
183
- }
184
- // hierarchyキーを明示的に削除(デフォルト設定がマージされるため、実際にはエラーにならない)
185
- }
186
- }));
197
+ writeFileSync(
198
+ configPath,
199
+ JSON.stringify({
200
+ confluence: {
201
+ pageCreationGranularity: 'by-hierarchy',
202
+ spaces: {
203
+ requirements: 'Michi',
204
+ },
205
+ // hierarchyキーを明示的に削除(デフォルト設定がマージされるため、実際にはエラーにならない)
206
+ },
207
+ }),
208
+ );
187
209
 
188
210
  const result = validateForConfluenceSync('requirements', testProjectRoot);
189
211
 
@@ -194,14 +216,17 @@ describe('config-validator', () => {
194
216
 
195
217
  it('manualモードでstructure設定がない場合はエラー', () => {
196
218
  const configPath = join(testProjectRoot, '.michi/config.json');
197
- writeFileSync(configPath, JSON.stringify({
198
- confluence: {
199
- pageCreationGranularity: 'manual',
200
- hierarchy: {
201
- mode: 'simple'
202
- }
203
- }
204
- }));
219
+ writeFileSync(
220
+ configPath,
221
+ JSON.stringify({
222
+ confluence: {
223
+ pageCreationGranularity: 'manual',
224
+ hierarchy: {
225
+ mode: 'simple',
226
+ },
227
+ },
228
+ }),
229
+ );
205
230
 
206
231
  const result = validateForConfluenceSync('requirements', testProjectRoot);
207
232
 
@@ -213,11 +238,14 @@ describe('config-validator', () => {
213
238
  it('環境変数CONFLUENCE_PRD_SPACEがある場合は情報メッセージ', () => {
214
239
  process.env.CONFLUENCE_PRD_SPACE = 'Michi';
215
240
  const configPath = join(testProjectRoot, '.michi/config.json');
216
- writeFileSync(configPath, JSON.stringify({
217
- confluence: {
218
- pageCreationGranularity: 'single'
219
- }
220
- }));
241
+ writeFileSync(
242
+ configPath,
243
+ JSON.stringify({
244
+ confluence: {
245
+ pageCreationGranularity: 'single',
246
+ },
247
+ }),
248
+ );
221
249
 
222
250
  const result = validateForConfluenceSync('requirements', testProjectRoot);
223
251
 
@@ -239,9 +267,12 @@ describe('config-validator', () => {
239
267
 
240
268
  it('issueTypes.story設定がない場合はエラー', () => {
241
269
  const configPath = join(testProjectRoot, '.michi/config.json');
242
- writeFileSync(configPath, JSON.stringify({
243
- jira: {}
244
- }));
270
+ writeFileSync(
271
+ configPath,
272
+ JSON.stringify({
273
+ jira: {},
274
+ }),
275
+ );
245
276
 
246
277
  const result = validateForJiraSync(testProjectRoot);
247
278
 
@@ -252,13 +283,16 @@ describe('config-validator', () => {
252
283
 
253
284
  it('issueTypes.story設定がある場合は成功', () => {
254
285
  const configPath = join(testProjectRoot, '.michi/config.json');
255
- writeFileSync(configPath, JSON.stringify({
256
- jira: {
257
- issueTypes: {
258
- story: '10036'
259
- }
260
- }
261
- }));
286
+ writeFileSync(
287
+ configPath,
288
+ JSON.stringify({
289
+ jira: {
290
+ issueTypes: {
291
+ story: '10036',
292
+ },
293
+ },
294
+ }),
295
+ );
262
296
 
263
297
  const result = validateForJiraSync(testProjectRoot);
264
298
 
@@ -269,11 +303,14 @@ describe('config-validator', () => {
269
303
  it('環境変数JIRA_ISSUE_TYPE_STORYがある場合は情報メッセージ', () => {
270
304
  process.env.JIRA_ISSUE_TYPE_STORY = '10036';
271
305
  const configPath = join(testProjectRoot, '.michi/config.json');
272
- writeFileSync(configPath, JSON.stringify({
273
- jira: {
274
- createEpic: true
275
- }
276
- }));
306
+ writeFileSync(
307
+ configPath,
308
+ JSON.stringify({
309
+ jira: {
310
+ createEpic: true,
311
+ },
312
+ }),
313
+ );
277
314
 
278
315
  const result = validateForJiraSync(testProjectRoot);
279
316
 
@@ -287,13 +324,16 @@ describe('config-validator', () => {
287
324
 
288
325
  it('issueTypes.subtask設定がない場合は警告', () => {
289
326
  const configPath = join(testProjectRoot, '.michi/config.json');
290
- writeFileSync(configPath, JSON.stringify({
291
- jira: {
292
- issueTypes: {
293
- story: '10036'
294
- }
295
- }
296
- }));
327
+ writeFileSync(
328
+ configPath,
329
+ JSON.stringify({
330
+ jira: {
331
+ issueTypes: {
332
+ story: '10036',
333
+ },
334
+ },
335
+ }),
336
+ );
297
337
 
298
338
  const result = validateForJiraSync(testProjectRoot);
299
339
 
@@ -304,14 +344,17 @@ describe('config-validator', () => {
304
344
 
305
345
  it('selected-phasesモードでselectedPhases設定がない場合はエラー', () => {
306
346
  const configPath = join(testProjectRoot, '.michi/config.json');
307
- writeFileSync(configPath, JSON.stringify({
308
- jira: {
309
- storyCreationGranularity: 'selected-phases',
310
- issueTypes: {
311
- story: '10036'
312
- }
313
- }
314
- }));
347
+ writeFileSync(
348
+ configPath,
349
+ JSON.stringify({
350
+ jira: {
351
+ storyCreationGranularity: 'selected-phases',
352
+ issueTypes: {
353
+ story: '10036',
354
+ },
355
+ },
356
+ }),
357
+ );
315
358
 
316
359
  const result = validateForJiraSync(testProjectRoot);
317
360
 
@@ -320,5 +363,183 @@ describe('config-validator', () => {
320
363
  expect(result.errors[0]).toContain('selectedPhases');
321
364
  });
322
365
  });
323
- });
324
366
 
367
+ describe('validateForJiraSyncAsync', () => {
368
+ beforeEach(() => {
369
+ // 環境変数をクリア
370
+ delete process.env.JIRA_ISSUE_TYPE_STORY;
371
+ delete process.env.JIRA_ISSUE_TYPE_SUBTASK;
372
+ delete process.env.ATLASSIAN_URL;
373
+ delete process.env.ATLASSIAN_EMAIL;
374
+ delete process.env.ATLASSIAN_API_TOKEN;
375
+ });
376
+
377
+ it('認証情報が未設定の場合は同期版と同じ結果を返す', async () => {
378
+ const configPath = join(testProjectRoot, '.michi/config.json');
379
+ writeFileSync(
380
+ configPath,
381
+ JSON.stringify({
382
+ jira: {
383
+ issueTypes: {
384
+ story: '10036',
385
+ },
386
+ },
387
+ }),
388
+ );
389
+
390
+ // project.jsonを作成
391
+ const projectJsonPath = join(testProjectRoot, '.kiro/project.json');
392
+ mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
393
+ writeFileSync(
394
+ projectJsonPath,
395
+ JSON.stringify({
396
+ jiraProjectKey: 'TEST',
397
+ }),
398
+ );
399
+
400
+ const result = await validateForJiraSyncAsync(testProjectRoot);
401
+
402
+ expect(result.valid).toBe(true);
403
+ expect(result.errors).toHaveLength(0);
404
+ });
405
+
406
+ it('認証情報が設定されていて、Issue Type IDが存在する場合は成功', async () => {
407
+ process.env.ATLASSIAN_URL = 'https://test.atlassian.net';
408
+ process.env.ATLASSIAN_EMAIL = 'test@example.com';
409
+ process.env.ATLASSIAN_API_TOKEN = 'test-token';
410
+ process.env.JIRA_ISSUE_TYPE_STORY = '10073';
411
+
412
+ const configPath = join(testProjectRoot, '.michi/config.json');
413
+ writeFileSync(
414
+ configPath,
415
+ JSON.stringify({
416
+ jira: {},
417
+ }),
418
+ );
419
+
420
+ // project.jsonを作成(すべての必須フィールドを含める)
421
+ const projectJsonPath = join(testProjectRoot, '.kiro/project.json');
422
+ mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
423
+ writeFileSync(
424
+ projectJsonPath,
425
+ JSON.stringify({
426
+ projectId: 'test-project',
427
+ projectName: 'Test Project',
428
+ jiraProjectKey: 'TEST',
429
+ confluenceLabels: [],
430
+ status: 'active',
431
+ team: [],
432
+ stakeholders: [],
433
+ repository: '',
434
+ }),
435
+ );
436
+
437
+ // JIRA APIのモック
438
+ vi.spyOn(jiraFetcher, 'hasJiraCredentials').mockReturnValue(true);
439
+ vi.spyOn(jiraFetcher, 'getProjectIssueTypes').mockResolvedValue([
440
+ { id: '10071', name: 'タスク', subtask: false },
441
+ { id: '10073', name: 'ストーリー', subtask: false },
442
+ { id: '10075', name: 'サブタスク', subtask: true },
443
+ ]);
444
+
445
+ const result = await validateForJiraSyncAsync(testProjectRoot);
446
+
447
+ expect(result.valid).toBe(true);
448
+ expect(result.errors).toHaveLength(0);
449
+ });
450
+
451
+ it('認証情報が設定されていて、Issue Type IDが存在しない場合はエラー', async () => {
452
+ process.env.ATLASSIAN_URL = 'https://test.atlassian.net';
453
+ process.env.ATLASSIAN_EMAIL = 'test@example.com';
454
+ process.env.ATLASSIAN_API_TOKEN = 'test-token';
455
+ process.env.JIRA_ISSUE_TYPE_STORY = '99999'; // 存在しないID
456
+
457
+ const configPath = join(testProjectRoot, '.michi/config.json');
458
+ writeFileSync(
459
+ configPath,
460
+ JSON.stringify({
461
+ jira: {},
462
+ }),
463
+ );
464
+
465
+ // project.jsonを作成(すべての必須フィールドを含める)
466
+ const projectJsonPath = join(testProjectRoot, '.kiro/project.json');
467
+ mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
468
+ writeFileSync(
469
+ projectJsonPath,
470
+ JSON.stringify({
471
+ projectId: 'test-project',
472
+ projectName: 'Test Project',
473
+ jiraProjectKey: 'TEST',
474
+ confluenceLabels: [],
475
+ status: 'active',
476
+ team: [],
477
+ stakeholders: [],
478
+ repository: '',
479
+ }),
480
+ );
481
+
482
+ // JIRA APIのモック
483
+ vi.spyOn(jiraFetcher, 'hasJiraCredentials').mockReturnValue(true);
484
+ vi.spyOn(jiraFetcher, 'getProjectIssueTypes').mockResolvedValue([
485
+ { id: '10071', name: 'タスク', subtask: false },
486
+ { id: '10073', name: 'ストーリー', subtask: false },
487
+ { id: '10075', name: 'サブタスク', subtask: true },
488
+ ]);
489
+
490
+ const result = await validateForJiraSyncAsync(testProjectRoot);
491
+
492
+ expect(result.valid).toBe(false);
493
+ expect(result.errors.length).toBeGreaterThan(0);
494
+ expect(
495
+ result.errors.some(
496
+ (e) => e.includes('99999') && e.includes('存在しません'),
497
+ ),
498
+ ).toBe(true);
499
+ });
500
+
501
+ it('JIRA API取得に失敗した場合は警告を追加するがエラーにはしない', async () => {
502
+ process.env.ATLASSIAN_URL = 'https://test.atlassian.net';
503
+ process.env.ATLASSIAN_EMAIL = 'test@example.com';
504
+ process.env.ATLASSIAN_API_TOKEN = 'test-token';
505
+ process.env.JIRA_ISSUE_TYPE_STORY = '10073';
506
+
507
+ const configPath = join(testProjectRoot, '.michi/config.json');
508
+ writeFileSync(
509
+ configPath,
510
+ JSON.stringify({
511
+ jira: {},
512
+ }),
513
+ );
514
+
515
+ // project.jsonを作成(すべての必須フィールドを含める)
516
+ const projectJsonPath = join(testProjectRoot, '.kiro/project.json');
517
+ mkdirSync(join(testProjectRoot, '.kiro'), { recursive: true });
518
+ writeFileSync(
519
+ projectJsonPath,
520
+ JSON.stringify({
521
+ projectId: 'test-project',
522
+ projectName: 'Test Project',
523
+ jiraProjectKey: 'TEST',
524
+ confluenceLabels: [],
525
+ status: 'active',
526
+ team: [],
527
+ stakeholders: [],
528
+ repository: '',
529
+ }),
530
+ );
531
+
532
+ // JIRA APIのモック(取得失敗)
533
+ vi.spyOn(jiraFetcher, 'hasJiraCredentials').mockReturnValue(true);
534
+ vi.spyOn(jiraFetcher, 'getProjectIssueTypes').mockResolvedValue(null);
535
+
536
+ const result = await validateForJiraSyncAsync(testProjectRoot);
537
+
538
+ expect(result.valid).toBe(true); // エラーにはしない
539
+ expect(result.warnings.length).toBeGreaterThan(0);
540
+ expect(
541
+ result.warnings.some((w) => w.includes('取得できませんでした')),
542
+ ).toBe(true);
543
+ });
544
+ });
545
+ });