claude-autopm 2.8.2 → 2.8.4

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 (391) hide show
  1. package/README.md +399 -637
  2. package/install/install.js +15 -5
  3. package/package.json +2 -1
  4. package/packages/plugin-ai/LICENSE +21 -0
  5. package/packages/plugin-ai/README.md +316 -0
  6. package/packages/plugin-ai/agents/anthropic-claude-expert.md +579 -0
  7. package/packages/plugin-ai/agents/azure-openai-expert.md +1411 -0
  8. package/packages/plugin-ai/agents/gemini-api-expert.md +880 -0
  9. package/packages/plugin-ai/agents/google-a2a-expert.md +1445 -0
  10. package/packages/plugin-ai/agents/huggingface-expert.md +2131 -0
  11. package/packages/plugin-ai/agents/langchain-expert.md +1427 -0
  12. package/packages/plugin-ai/agents/langgraph-workflow-expert.md +520 -0
  13. package/packages/plugin-ai/agents/openai-python-expert.md +1087 -0
  14. package/packages/plugin-ai/commands/a2a-setup.md +886 -0
  15. package/packages/plugin-ai/commands/ai-model-deployment.md +481 -0
  16. package/packages/plugin-ai/commands/anthropic-optimize.md +793 -0
  17. package/packages/plugin-ai/commands/huggingface-deploy.md +789 -0
  18. package/packages/plugin-ai/commands/langchain-optimize.md +807 -0
  19. package/packages/plugin-ai/commands/llm-optimize.md +348 -0
  20. package/packages/plugin-ai/commands/openai-optimize.md +863 -0
  21. package/packages/plugin-ai/commands/rag-optimize.md +841 -0
  22. package/packages/plugin-ai/commands/rag-setup-scaffold.md +382 -0
  23. package/packages/plugin-ai/package.json +66 -0
  24. package/packages/plugin-ai/plugin.json +519 -0
  25. package/packages/plugin-ai/rules/ai-model-standards.md +449 -0
  26. package/packages/plugin-ai/rules/prompt-engineering-standards.md +509 -0
  27. package/packages/plugin-ai/scripts/examples/huggingface-inference-example.py +145 -0
  28. package/packages/plugin-ai/scripts/examples/langchain-rag-example.py +366 -0
  29. package/packages/plugin-ai/scripts/examples/mlflow-tracking-example.py +224 -0
  30. package/packages/plugin-ai/scripts/examples/openai-chat-example.py +425 -0
  31. package/packages/plugin-cloud/README.md +268 -0
  32. package/packages/plugin-cloud/agents/README.md +55 -0
  33. package/packages/plugin-cloud/agents/aws-cloud-architect.md +521 -0
  34. package/packages/plugin-cloud/agents/azure-cloud-architect.md +436 -0
  35. package/packages/plugin-cloud/agents/gcp-cloud-architect.md +385 -0
  36. package/packages/plugin-cloud/agents/gcp-cloud-functions-engineer.md +306 -0
  37. package/packages/plugin-cloud/agents/gemini-api-expert.md +880 -0
  38. package/packages/plugin-cloud/agents/kubernetes-orchestrator.md +566 -0
  39. package/packages/plugin-cloud/agents/openai-python-expert.md +1087 -0
  40. package/packages/plugin-cloud/agents/terraform-infrastructure-expert.md +454 -0
  41. package/packages/plugin-cloud/commands/cloud-cost-optimize.md +243 -0
  42. package/packages/plugin-cloud/commands/cloud-validate.md +196 -0
  43. package/packages/plugin-cloud/commands/infra-deploy.md +38 -0
  44. package/packages/plugin-cloud/commands/k8s-deploy.md +37 -0
  45. package/packages/plugin-cloud/commands/ssh-security.md +65 -0
  46. package/packages/plugin-cloud/commands/traefik-setup.md +65 -0
  47. package/packages/plugin-cloud/hooks/pre-cloud-deploy.js +456 -0
  48. package/packages/plugin-cloud/package.json +64 -0
  49. package/packages/plugin-cloud/plugin.json +338 -0
  50. package/packages/plugin-cloud/rules/cloud-security-compliance.md +313 -0
  51. package/packages/plugin-cloud/rules/infrastructure-pipeline.md +128 -0
  52. package/packages/plugin-cloud/scripts/examples/aws-validate.sh +30 -0
  53. package/packages/plugin-cloud/scripts/examples/azure-setup.sh +33 -0
  54. package/packages/plugin-cloud/scripts/examples/gcp-setup.sh +39 -0
  55. package/packages/plugin-cloud/scripts/examples/k8s-validate.sh +40 -0
  56. package/packages/plugin-cloud/scripts/examples/terraform-init.sh +26 -0
  57. package/packages/plugin-core/README.md +274 -0
  58. package/packages/plugin-core/agents/core/agent-manager.md +296 -0
  59. package/packages/plugin-core/agents/core/code-analyzer.md +131 -0
  60. package/packages/plugin-core/agents/core/file-analyzer.md +162 -0
  61. package/packages/plugin-core/agents/core/test-runner.md +200 -0
  62. package/packages/plugin-core/commands/code-rabbit.md +128 -0
  63. package/packages/plugin-core/commands/prompt.md +9 -0
  64. package/packages/plugin-core/commands/re-init.md +9 -0
  65. package/packages/plugin-core/hooks/context7-reminder.md +29 -0
  66. package/packages/plugin-core/hooks/enforce-agents.js +125 -0
  67. package/packages/plugin-core/hooks/enforce-agents.sh +35 -0
  68. package/packages/plugin-core/hooks/pre-agent-context7.js +224 -0
  69. package/packages/plugin-core/hooks/pre-command-context7.js +229 -0
  70. package/packages/plugin-core/hooks/strict-enforce-agents.sh +39 -0
  71. package/packages/plugin-core/hooks/test-hook.sh +21 -0
  72. package/packages/plugin-core/hooks/unified-context7-enforcement.sh +38 -0
  73. package/packages/plugin-core/package.json +45 -0
  74. package/packages/plugin-core/plugin.json +387 -0
  75. package/packages/plugin-core/rules/agent-coordination.md +549 -0
  76. package/packages/plugin-core/rules/agent-mandatory.md +170 -0
  77. package/packages/plugin-core/rules/ai-integration-patterns.md +219 -0
  78. package/packages/plugin-core/rules/command-pipelines.md +208 -0
  79. package/packages/plugin-core/rules/context-optimization.md +176 -0
  80. package/packages/plugin-core/rules/context7-enforcement.md +327 -0
  81. package/packages/plugin-core/rules/datetime.md +122 -0
  82. package/packages/plugin-core/rules/definition-of-done.md +272 -0
  83. package/packages/plugin-core/rules/development-environments.md +19 -0
  84. package/packages/plugin-core/rules/development-workflow.md +198 -0
  85. package/packages/plugin-core/rules/framework-path-rules.md +180 -0
  86. package/packages/plugin-core/rules/frontmatter-operations.md +64 -0
  87. package/packages/plugin-core/rules/git-strategy.md +237 -0
  88. package/packages/plugin-core/rules/golden-rules.md +181 -0
  89. package/packages/plugin-core/rules/naming-conventions.md +111 -0
  90. package/packages/plugin-core/rules/no-pr-workflow.md +183 -0
  91. package/packages/plugin-core/rules/performance-guidelines.md +403 -0
  92. package/packages/plugin-core/rules/pipeline-mandatory.md +109 -0
  93. package/packages/plugin-core/rules/security-checklist.md +318 -0
  94. package/packages/plugin-core/rules/standard-patterns.md +197 -0
  95. package/packages/plugin-core/rules/strip-frontmatter.md +85 -0
  96. package/packages/plugin-core/rules/tdd.enforcement.md +103 -0
  97. package/packages/plugin-core/rules/use-ast-grep.md +113 -0
  98. package/packages/plugin-core/scripts/lib/datetime-utils.sh +254 -0
  99. package/packages/plugin-core/scripts/lib/frontmatter-utils.sh +294 -0
  100. package/packages/plugin-core/scripts/lib/github-utils.sh +221 -0
  101. package/packages/plugin-core/scripts/lib/logging-utils.sh +199 -0
  102. package/packages/plugin-core/scripts/lib/validation-utils.sh +339 -0
  103. package/packages/plugin-core/scripts/mcp/add.sh +7 -0
  104. package/packages/plugin-core/scripts/mcp/disable.sh +12 -0
  105. package/packages/plugin-core/scripts/mcp/enable.sh +12 -0
  106. package/packages/plugin-core/scripts/mcp/list.sh +7 -0
  107. package/packages/plugin-core/scripts/mcp/sync.sh +8 -0
  108. package/packages/plugin-data/README.md +315 -0
  109. package/packages/plugin-data/agents/airflow-orchestration-expert.md +158 -0
  110. package/packages/plugin-data/agents/kedro-pipeline-expert.md +304 -0
  111. package/packages/plugin-data/agents/langgraph-workflow-expert.md +530 -0
  112. package/packages/plugin-data/commands/airflow-dag-scaffold.md +413 -0
  113. package/packages/plugin-data/commands/kafka-pipeline-scaffold.md +503 -0
  114. package/packages/plugin-data/package.json +66 -0
  115. package/packages/plugin-data/plugin.json +294 -0
  116. package/packages/plugin-data/rules/data-quality-standards.md +373 -0
  117. package/packages/plugin-data/rules/etl-pipeline-standards.md +255 -0
  118. package/packages/plugin-data/scripts/examples/airflow-dag-example.py +245 -0
  119. package/packages/plugin-data/scripts/examples/dbt-transform-example.sql +238 -0
  120. package/packages/plugin-data/scripts/examples/kafka-streaming-example.py +257 -0
  121. package/packages/plugin-data/scripts/examples/pandas-etl-example.py +332 -0
  122. package/packages/plugin-databases/README.md +330 -0
  123. package/packages/plugin-databases/agents/README.md +50 -0
  124. package/packages/plugin-databases/agents/bigquery-expert.md +401 -0
  125. package/packages/plugin-databases/agents/cosmosdb-expert.md +375 -0
  126. package/packages/plugin-databases/agents/mongodb-expert.md +407 -0
  127. package/packages/plugin-databases/agents/postgresql-expert.md +329 -0
  128. package/packages/plugin-databases/agents/redis-expert.md +74 -0
  129. package/packages/plugin-databases/commands/db-optimize.md +612 -0
  130. package/packages/plugin-databases/package.json +60 -0
  131. package/packages/plugin-databases/plugin.json +237 -0
  132. package/packages/plugin-databases/rules/database-management-strategy.md +146 -0
  133. package/packages/plugin-databases/rules/database-pipeline.md +316 -0
  134. package/packages/plugin-databases/scripts/examples/bigquery-cost-analyze.sh +160 -0
  135. package/packages/plugin-databases/scripts/examples/cosmosdb-ru-optimize.sh +163 -0
  136. package/packages/plugin-databases/scripts/examples/mongodb-shard-check.sh +120 -0
  137. package/packages/plugin-databases/scripts/examples/postgres-index-analyze.sh +95 -0
  138. package/packages/plugin-databases/scripts/examples/redis-cache-stats.sh +121 -0
  139. package/packages/plugin-devops/README.md +367 -0
  140. package/packages/plugin-devops/agents/README.md +52 -0
  141. package/packages/plugin-devops/agents/azure-devops-specialist.md +308 -0
  142. package/packages/plugin-devops/agents/docker-containerization-expert.md +298 -0
  143. package/packages/plugin-devops/agents/github-operations-specialist.md +335 -0
  144. package/packages/plugin-devops/agents/mcp-context-manager.md +319 -0
  145. package/packages/plugin-devops/agents/observability-engineer.md +574 -0
  146. package/packages/plugin-devops/agents/ssh-operations-expert.md +1093 -0
  147. package/packages/plugin-devops/agents/traefik-proxy-expert.md +444 -0
  148. package/packages/plugin-devops/commands/ci-pipeline-create.md +581 -0
  149. package/packages/plugin-devops/commands/docker-optimize.md +493 -0
  150. package/packages/plugin-devops/commands/workflow-create.md +42 -0
  151. package/packages/plugin-devops/hooks/pre-docker-build.js +472 -0
  152. package/packages/plugin-devops/package.json +61 -0
  153. package/packages/plugin-devops/plugin.json +302 -0
  154. package/packages/plugin-devops/rules/ci-cd-kubernetes-strategy.md +25 -0
  155. package/packages/plugin-devops/rules/devops-troubleshooting-playbook.md +450 -0
  156. package/packages/plugin-devops/rules/docker-first-development.md +404 -0
  157. package/packages/plugin-devops/rules/github-operations.md +92 -0
  158. package/packages/plugin-devops/scripts/examples/docker-build-multistage.sh +43 -0
  159. package/packages/plugin-devops/scripts/examples/docker-compose-validate.sh +74 -0
  160. package/packages/plugin-devops/scripts/examples/github-workflow-validate.sh +48 -0
  161. package/packages/plugin-devops/scripts/examples/prometheus-health-check.sh +58 -0
  162. package/packages/plugin-devops/scripts/examples/ssh-key-setup.sh +74 -0
  163. package/packages/plugin-frameworks/README.md +309 -0
  164. package/packages/plugin-frameworks/agents/README.md +64 -0
  165. package/packages/plugin-frameworks/agents/e2e-test-engineer.md +579 -0
  166. package/packages/plugin-frameworks/agents/nats-messaging-expert.md +254 -0
  167. package/packages/plugin-frameworks/agents/react-frontend-engineer.md +393 -0
  168. package/packages/plugin-frameworks/agents/react-ui-expert.md +226 -0
  169. package/packages/plugin-frameworks/agents/tailwindcss-expert.md +1021 -0
  170. package/packages/plugin-frameworks/agents/ux-design-expert.md +244 -0
  171. package/packages/plugin-frameworks/commands/app-scaffold.md +50 -0
  172. package/packages/plugin-frameworks/commands/nextjs-optimize.md +692 -0
  173. package/packages/plugin-frameworks/commands/react-optimize.md +583 -0
  174. package/packages/plugin-frameworks/commands/tailwind-system.md +64 -0
  175. package/packages/plugin-frameworks/package.json +59 -0
  176. package/packages/plugin-frameworks/plugin.json +224 -0
  177. package/packages/plugin-frameworks/rules/performance-guidelines.md +403 -0
  178. package/packages/plugin-frameworks/rules/ui-development-standards.md +281 -0
  179. package/packages/plugin-frameworks/rules/ui-framework-rules.md +151 -0
  180. package/packages/plugin-frameworks/scripts/examples/react-component-perf.sh +34 -0
  181. package/packages/plugin-frameworks/scripts/examples/tailwind-optimize.sh +44 -0
  182. package/packages/plugin-frameworks/scripts/examples/vue-composition-check.sh +41 -0
  183. package/packages/plugin-languages/README.md +333 -0
  184. package/packages/plugin-languages/agents/README.md +50 -0
  185. package/packages/plugin-languages/agents/bash-scripting-expert.md +541 -0
  186. package/packages/plugin-languages/agents/javascript-frontend-engineer.md +197 -0
  187. package/packages/plugin-languages/agents/nodejs-backend-engineer.md +226 -0
  188. package/packages/plugin-languages/agents/python-backend-engineer.md +214 -0
  189. package/packages/plugin-languages/agents/python-backend-expert.md +289 -0
  190. package/packages/plugin-languages/commands/javascript-optimize.md +636 -0
  191. package/packages/plugin-languages/commands/nodejs-api-scaffold.md +341 -0
  192. package/packages/plugin-languages/commands/nodejs-optimize.md +689 -0
  193. package/packages/plugin-languages/commands/python-api-scaffold.md +261 -0
  194. package/packages/plugin-languages/commands/python-optimize.md +593 -0
  195. package/packages/plugin-languages/package.json +65 -0
  196. package/packages/plugin-languages/plugin.json +265 -0
  197. package/packages/plugin-languages/rules/code-quality-standards.md +496 -0
  198. package/packages/plugin-languages/rules/testing-standards.md +768 -0
  199. package/packages/plugin-languages/scripts/examples/bash-production-script.sh +520 -0
  200. package/packages/plugin-languages/scripts/examples/javascript-es6-patterns.js +291 -0
  201. package/packages/plugin-languages/scripts/examples/nodejs-async-iteration.js +360 -0
  202. package/packages/plugin-languages/scripts/examples/python-async-patterns.py +289 -0
  203. package/packages/plugin-languages/scripts/examples/typescript-patterns.ts +432 -0
  204. package/packages/plugin-ml/README.md +430 -0
  205. package/packages/plugin-ml/agents/automl-expert.md +326 -0
  206. package/packages/plugin-ml/agents/computer-vision-expert.md +550 -0
  207. package/packages/plugin-ml/agents/gradient-boosting-expert.md +455 -0
  208. package/packages/plugin-ml/agents/neural-network-architect.md +1228 -0
  209. package/packages/plugin-ml/agents/nlp-transformer-expert.md +584 -0
  210. package/packages/plugin-ml/agents/pytorch-expert.md +412 -0
  211. package/packages/plugin-ml/agents/reinforcement-learning-expert.md +2088 -0
  212. package/packages/plugin-ml/agents/scikit-learn-expert.md +228 -0
  213. package/packages/plugin-ml/agents/tensorflow-keras-expert.md +509 -0
  214. package/packages/plugin-ml/agents/time-series-expert.md +303 -0
  215. package/packages/plugin-ml/commands/ml-automl.md +572 -0
  216. package/packages/plugin-ml/commands/ml-train-optimize.md +657 -0
  217. package/packages/plugin-ml/package.json +52 -0
  218. package/packages/plugin-ml/plugin.json +338 -0
  219. package/packages/plugin-pm/README.md +368 -0
  220. package/packages/plugin-pm/claudeautopm-plugin-pm-2.0.0.tgz +0 -0
  221. package/packages/plugin-pm/commands/azure/COMMANDS.md +107 -0
  222. package/packages/plugin-pm/commands/azure/COMMAND_MAPPING.md +252 -0
  223. package/packages/plugin-pm/commands/azure/INTEGRATION_FIX.md +103 -0
  224. package/packages/plugin-pm/commands/azure/README.md +246 -0
  225. package/packages/plugin-pm/commands/azure/active-work.md +198 -0
  226. package/packages/plugin-pm/commands/azure/aliases.md +143 -0
  227. package/packages/plugin-pm/commands/azure/blocked-items.md +287 -0
  228. package/packages/plugin-pm/commands/azure/clean.md +93 -0
  229. package/packages/plugin-pm/commands/azure/docs-query.md +48 -0
  230. package/packages/plugin-pm/commands/azure/feature-decompose.md +380 -0
  231. package/packages/plugin-pm/commands/azure/feature-list.md +61 -0
  232. package/packages/plugin-pm/commands/azure/feature-new.md +115 -0
  233. package/packages/plugin-pm/commands/azure/feature-show.md +205 -0
  234. package/packages/plugin-pm/commands/azure/feature-start.md +130 -0
  235. package/packages/plugin-pm/commands/azure/fix-integration-example.md +93 -0
  236. package/packages/plugin-pm/commands/azure/help.md +150 -0
  237. package/packages/plugin-pm/commands/azure/import-us.md +269 -0
  238. package/packages/plugin-pm/commands/azure/init.md +211 -0
  239. package/packages/plugin-pm/commands/azure/next-task.md +262 -0
  240. package/packages/plugin-pm/commands/azure/search.md +160 -0
  241. package/packages/plugin-pm/commands/azure/sprint-status.md +235 -0
  242. package/packages/plugin-pm/commands/azure/standup.md +260 -0
  243. package/packages/plugin-pm/commands/azure/sync-all.md +99 -0
  244. package/packages/plugin-pm/commands/azure/task-analyze.md +186 -0
  245. package/packages/plugin-pm/commands/azure/task-close.md +329 -0
  246. package/packages/plugin-pm/commands/azure/task-edit.md +145 -0
  247. package/packages/plugin-pm/commands/azure/task-list.md +263 -0
  248. package/packages/plugin-pm/commands/azure/task-new.md +84 -0
  249. package/packages/plugin-pm/commands/azure/task-reopen.md +79 -0
  250. package/packages/plugin-pm/commands/azure/task-show.md +126 -0
  251. package/packages/plugin-pm/commands/azure/task-start.md +301 -0
  252. package/packages/plugin-pm/commands/azure/task-status.md +65 -0
  253. package/packages/plugin-pm/commands/azure/task-sync.md +67 -0
  254. package/packages/plugin-pm/commands/azure/us-edit.md +164 -0
  255. package/packages/plugin-pm/commands/azure/us-list.md +202 -0
  256. package/packages/plugin-pm/commands/azure/us-new.md +265 -0
  257. package/packages/plugin-pm/commands/azure/us-parse.md +253 -0
  258. package/packages/plugin-pm/commands/azure/us-show.md +188 -0
  259. package/packages/plugin-pm/commands/azure/us-status.md +320 -0
  260. package/packages/plugin-pm/commands/azure/validate.md +86 -0
  261. package/packages/plugin-pm/commands/azure/work-item-sync.md +47 -0
  262. package/packages/plugin-pm/commands/blocked.md +28 -0
  263. package/packages/plugin-pm/commands/clean.md +119 -0
  264. package/packages/plugin-pm/commands/context-create.md +136 -0
  265. package/packages/plugin-pm/commands/context-prime.md +170 -0
  266. package/packages/plugin-pm/commands/context-update.md +292 -0
  267. package/packages/plugin-pm/commands/context.md +28 -0
  268. package/packages/plugin-pm/commands/epic-close.md +86 -0
  269. package/packages/plugin-pm/commands/epic-decompose.md +370 -0
  270. package/packages/plugin-pm/commands/epic-edit.md +83 -0
  271. package/packages/plugin-pm/commands/epic-list.md +30 -0
  272. package/packages/plugin-pm/commands/epic-merge.md +222 -0
  273. package/packages/plugin-pm/commands/epic-oneshot.md +119 -0
  274. package/packages/plugin-pm/commands/epic-refresh.md +119 -0
  275. package/packages/plugin-pm/commands/epic-show.md +28 -0
  276. package/packages/plugin-pm/commands/epic-split.md +120 -0
  277. package/packages/plugin-pm/commands/epic-start.md +195 -0
  278. package/packages/plugin-pm/commands/epic-status.md +28 -0
  279. package/packages/plugin-pm/commands/epic-sync-modular.md +338 -0
  280. package/packages/plugin-pm/commands/epic-sync-original.md +473 -0
  281. package/packages/plugin-pm/commands/epic-sync.md +486 -0
  282. package/packages/plugin-pm/commands/github/workflow-create.md +42 -0
  283. package/packages/plugin-pm/commands/help.md +28 -0
  284. package/packages/plugin-pm/commands/import.md +115 -0
  285. package/packages/plugin-pm/commands/in-progress.md +28 -0
  286. package/packages/plugin-pm/commands/init.md +28 -0
  287. package/packages/plugin-pm/commands/issue-analyze.md +202 -0
  288. package/packages/plugin-pm/commands/issue-close.md +119 -0
  289. package/packages/plugin-pm/commands/issue-edit.md +93 -0
  290. package/packages/plugin-pm/commands/issue-reopen.md +87 -0
  291. package/packages/plugin-pm/commands/issue-show.md +41 -0
  292. package/packages/plugin-pm/commands/issue-start.md +234 -0
  293. package/packages/plugin-pm/commands/issue-status.md +95 -0
  294. package/packages/plugin-pm/commands/issue-sync.md +411 -0
  295. package/packages/plugin-pm/commands/next.md +28 -0
  296. package/packages/plugin-pm/commands/prd-edit.md +82 -0
  297. package/packages/plugin-pm/commands/prd-list.md +28 -0
  298. package/packages/plugin-pm/commands/prd-new.md +55 -0
  299. package/packages/plugin-pm/commands/prd-parse.md +42 -0
  300. package/packages/plugin-pm/commands/prd-status.md +28 -0
  301. package/packages/plugin-pm/commands/search.md +28 -0
  302. package/packages/plugin-pm/commands/standup.md +28 -0
  303. package/packages/plugin-pm/commands/status.md +28 -0
  304. package/packages/plugin-pm/commands/sync.md +99 -0
  305. package/packages/plugin-pm/commands/test-reference-update.md +151 -0
  306. package/packages/plugin-pm/commands/validate.md +28 -0
  307. package/packages/plugin-pm/commands/what-next.md +28 -0
  308. package/packages/plugin-pm/package.json +57 -0
  309. package/packages/plugin-pm/plugin.json +503 -0
  310. package/packages/plugin-pm/scripts/pm/analytics.js +425 -0
  311. package/packages/plugin-pm/scripts/pm/blocked.js +164 -0
  312. package/packages/plugin-pm/scripts/pm/blocked.sh +78 -0
  313. package/packages/plugin-pm/scripts/pm/clean.js +464 -0
  314. package/packages/plugin-pm/scripts/pm/context-create.js +216 -0
  315. package/packages/plugin-pm/scripts/pm/context-prime.js +335 -0
  316. package/packages/plugin-pm/scripts/pm/context-update.js +344 -0
  317. package/packages/plugin-pm/scripts/pm/context.js +338 -0
  318. package/packages/plugin-pm/scripts/pm/epic-close.js +347 -0
  319. package/packages/plugin-pm/scripts/pm/epic-edit.js +382 -0
  320. package/packages/plugin-pm/scripts/pm/epic-list.js +273 -0
  321. package/packages/plugin-pm/scripts/pm/epic-list.sh +109 -0
  322. package/packages/plugin-pm/scripts/pm/epic-show.js +291 -0
  323. package/packages/plugin-pm/scripts/pm/epic-show.sh +105 -0
  324. package/packages/plugin-pm/scripts/pm/epic-split.js +522 -0
  325. package/packages/plugin-pm/scripts/pm/epic-start/epic-start.js +183 -0
  326. package/packages/plugin-pm/scripts/pm/epic-start/epic-start.sh +94 -0
  327. package/packages/plugin-pm/scripts/pm/epic-status.js +291 -0
  328. package/packages/plugin-pm/scripts/pm/epic-status.sh +104 -0
  329. package/packages/plugin-pm/scripts/pm/epic-sync/README.md +208 -0
  330. package/packages/plugin-pm/scripts/pm/epic-sync/create-epic-issue.sh +77 -0
  331. package/packages/plugin-pm/scripts/pm/epic-sync/create-task-issues.sh +86 -0
  332. package/packages/plugin-pm/scripts/pm/epic-sync/update-epic-file.sh +79 -0
  333. package/packages/plugin-pm/scripts/pm/epic-sync/update-references.sh +89 -0
  334. package/packages/plugin-pm/scripts/pm/epic-sync.sh +137 -0
  335. package/packages/plugin-pm/scripts/pm/help.js +92 -0
  336. package/packages/plugin-pm/scripts/pm/help.sh +90 -0
  337. package/packages/plugin-pm/scripts/pm/in-progress.js +178 -0
  338. package/packages/plugin-pm/scripts/pm/in-progress.sh +93 -0
  339. package/packages/plugin-pm/scripts/pm/init.js +321 -0
  340. package/packages/plugin-pm/scripts/pm/init.sh +178 -0
  341. package/packages/plugin-pm/scripts/pm/issue-close.js +232 -0
  342. package/packages/plugin-pm/scripts/pm/issue-edit.js +310 -0
  343. package/packages/plugin-pm/scripts/pm/issue-show.js +272 -0
  344. package/packages/plugin-pm/scripts/pm/issue-start.js +181 -0
  345. package/packages/plugin-pm/scripts/pm/issue-sync/format-comment.sh +468 -0
  346. package/packages/plugin-pm/scripts/pm/issue-sync/gather-updates.sh +460 -0
  347. package/packages/plugin-pm/scripts/pm/issue-sync/post-comment.sh +330 -0
  348. package/packages/plugin-pm/scripts/pm/issue-sync/preflight-validation.sh +348 -0
  349. package/packages/plugin-pm/scripts/pm/issue-sync/update-frontmatter.sh +387 -0
  350. package/packages/plugin-pm/scripts/pm/lib/README.md +85 -0
  351. package/packages/plugin-pm/scripts/pm/lib/epic-discovery.js +119 -0
  352. package/packages/plugin-pm/scripts/pm/lib/logger.js +78 -0
  353. package/packages/plugin-pm/scripts/pm/next.js +189 -0
  354. package/packages/plugin-pm/scripts/pm/next.sh +72 -0
  355. package/packages/plugin-pm/scripts/pm/optimize.js +407 -0
  356. package/packages/plugin-pm/scripts/pm/pr-create.js +337 -0
  357. package/packages/plugin-pm/scripts/pm/pr-list.js +257 -0
  358. package/packages/plugin-pm/scripts/pm/prd-list.js +242 -0
  359. package/packages/plugin-pm/scripts/pm/prd-list.sh +103 -0
  360. package/packages/plugin-pm/scripts/pm/prd-new.js +684 -0
  361. package/packages/plugin-pm/scripts/pm/prd-parse.js +547 -0
  362. package/packages/plugin-pm/scripts/pm/prd-status.js +152 -0
  363. package/packages/plugin-pm/scripts/pm/prd-status.sh +63 -0
  364. package/packages/plugin-pm/scripts/pm/release.js +460 -0
  365. package/packages/plugin-pm/scripts/pm/search.js +192 -0
  366. package/packages/plugin-pm/scripts/pm/search.sh +89 -0
  367. package/packages/plugin-pm/scripts/pm/standup.js +362 -0
  368. package/packages/plugin-pm/scripts/pm/standup.sh +95 -0
  369. package/packages/plugin-pm/scripts/pm/status.js +148 -0
  370. package/packages/plugin-pm/scripts/pm/status.sh +59 -0
  371. package/packages/plugin-pm/scripts/pm/sync-batch.js +337 -0
  372. package/packages/plugin-pm/scripts/pm/sync.js +343 -0
  373. package/packages/plugin-pm/scripts/pm/template-list.js +141 -0
  374. package/packages/plugin-pm/scripts/pm/template-new.js +366 -0
  375. package/packages/plugin-pm/scripts/pm/validate.js +274 -0
  376. package/packages/plugin-pm/scripts/pm/validate.sh +106 -0
  377. package/packages/plugin-pm/scripts/pm/what-next.js +660 -0
  378. package/packages/plugin-testing/README.md +401 -0
  379. package/packages/plugin-testing/agents/frontend-testing-engineer.md +768 -0
  380. package/packages/plugin-testing/commands/jest-optimize.md +800 -0
  381. package/packages/plugin-testing/commands/playwright-optimize.md +887 -0
  382. package/packages/plugin-testing/commands/test-coverage.md +512 -0
  383. package/packages/plugin-testing/commands/test-performance.md +1041 -0
  384. package/packages/plugin-testing/commands/test-setup.md +414 -0
  385. package/packages/plugin-testing/package.json +40 -0
  386. package/packages/plugin-testing/plugin.json +197 -0
  387. package/packages/plugin-testing/rules/test-coverage-requirements.md +581 -0
  388. package/packages/plugin-testing/rules/testing-standards.md +529 -0
  389. package/packages/plugin-testing/scripts/examples/react-testing-example.test.jsx +460 -0
  390. package/packages/plugin-testing/scripts/examples/vitest-config-example.js +352 -0
  391. package/packages/plugin-testing/scripts/examples/vue-testing-example.test.js +586 -0
@@ -0,0 +1,338 @@
1
+ const fs = require('fs');
2
+ const path = require('path');
3
+ const { logError } = require('./lib/logger');
4
+
5
+ /**
6
+ * PM Context Script
7
+ * Displays current project context, configuration, and progress
8
+ */
9
+
10
+ // Constants
11
+ const TASK_FILE_PATTERN = /^\d{3}\.md$/;
12
+
13
+ async function context() {
14
+ console.log('');
15
+ console.log('šŸŽÆ Project Context');
16
+ console.log('='.repeat(60));
17
+ console.log('');
18
+
19
+ // Project Information
20
+ console.log('šŸ“¦ Project Information:');
21
+
22
+ // Get project name from package.json or directory name
23
+ let projectName = path.basename(process.cwd());
24
+ try {
25
+ if (fs.existsSync('package.json')) {
26
+ const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
27
+ if (pkg.name) {
28
+ projectName = pkg.name;
29
+ }
30
+ }
31
+ } catch (err) {
32
+ // Use directory name as fallback
33
+ }
34
+ console.log(` Name: ${projectName}`);
35
+ console.log(` Directory: ${process.cwd()}`);
36
+ console.log('');
37
+
38
+ // Configuration
39
+ console.log('āš™ļø Configuration:');
40
+ let provider = 'Not configured';
41
+ let githubOwner = '-';
42
+ let githubRepo = '-';
43
+ let azureOrg = '-';
44
+ let azureProject = '-';
45
+
46
+ try {
47
+ if (fs.existsSync('.claude/config.json')) {
48
+ const config = JSON.parse(fs.readFileSync('.claude/config.json', 'utf8'));
49
+ if (config.provider) {
50
+ provider = config.provider.charAt(0).toUpperCase() + config.provider.slice(1);
51
+ }
52
+ if (config.github) {
53
+ githubOwner = config.github.owner || '-';
54
+ githubRepo = config.github.repo || '-';
55
+ }
56
+ if (config.azure) {
57
+ azureOrg = config.azure.organization || '-';
58
+ azureProject = config.azure.project || '-';
59
+ }
60
+ }
61
+ } catch (err) {
62
+ // Config not found
63
+ }
64
+
65
+ console.log(` Provider: ${provider}`);
66
+ if (provider.toLowerCase() === 'github') {
67
+ console.log(` GitHub Owner: ${githubOwner}`);
68
+ console.log(` GitHub Repo: ${githubRepo}`);
69
+ } else if (provider.toLowerCase() === 'azure') {
70
+ console.log(` Azure Org: ${azureOrg}`);
71
+ console.log(` Azure Project: ${azureProject}`);
72
+ }
73
+ console.log('');
74
+
75
+ // Active Team
76
+ console.log('šŸ‘„ Active Team:');
77
+ let activeTeam = 'Default';
78
+ try {
79
+ if (fs.existsSync('.claude/active_team.txt')) {
80
+ activeTeam = fs.readFileSync('.claude/active_team.txt', 'utf8').trim();
81
+ }
82
+ } catch (err) {
83
+ // No active team
84
+ }
85
+ console.log(` Team: ${activeTeam}`);
86
+ console.log('');
87
+
88
+ // PRDs
89
+ console.log('šŸ“„ Product Requirements (PRDs):');
90
+ let prdCount = 0;
91
+ let prdNames = [];
92
+ try {
93
+ if (fs.existsSync('.claude/prds')) {
94
+ const files = fs.readdirSync('.claude/prds')
95
+ .filter(f => f.endsWith('.md') && !f.startsWith('.'));
96
+ prdCount = files.length;
97
+ prdNames = files.map(f => f.replace('.md', ''));
98
+ }
99
+ } catch (err) {
100
+ // No PRDs
101
+ }
102
+
103
+ console.log(` Total: ${prdCount}`);
104
+ if (prdCount > 0) {
105
+ prdNames.slice(0, 5).forEach(name => {
106
+ console.log(` • ${name}`);
107
+ });
108
+ if (prdCount > 5) {
109
+ console.log(` ... and ${prdCount - 5} more`);
110
+ }
111
+ }
112
+ console.log('');
113
+
114
+ // Epics with Progress
115
+ console.log('šŸ“š Epics & Progress:');
116
+ let epicCount = 0;
117
+ let totalTasks = 0;
118
+ let completedTasks = 0;
119
+ let inProgressTasks = 0;
120
+ let pendingTasks = 0;
121
+ let epicDetails = [];
122
+
123
+ try {
124
+ if (fs.existsSync('.claude/epics')) {
125
+ const epicDirs = fs.readdirSync('.claude/epics', { withFileTypes: true })
126
+ .filter(d => d.isDirectory())
127
+ .map(d => d.name);
128
+
129
+ epicCount = epicDirs.length;
130
+
131
+ // Helper to count tasks in a directory and update counters
132
+ function countTasksInDir(dir, counters) {
133
+ try {
134
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
135
+ for (const entry of entries) {
136
+ const fullPath = path.join(dir, entry.name);
137
+ if (entry.isDirectory()) {
138
+ countTasksInDir(fullPath, counters);
139
+ } else if (entry.isFile() && TASK_FILE_PATTERN.test(entry.name)) {
140
+ counters.epicTasks++;
141
+ totalTasks++;
142
+ try {
143
+ const content = fs.readFileSync(fullPath, 'utf8');
144
+ const statusMatch = content.match(/^status:\s*(.+)$/m);
145
+ if (statusMatch) {
146
+ const status = statusMatch[1].trim().toLowerCase();
147
+ if (status === 'completed' || status === 'done' || status === 'closed') {
148
+ counters.epicCompleted++;
149
+ completedTasks++;
150
+ } else if (status === 'in-progress' || status === 'in_progress') {
151
+ counters.epicInProgress++;
152
+ inProgressTasks++;
153
+ } else {
154
+ counters.epicPending++;
155
+ pendingTasks++;
156
+ }
157
+ } else {
158
+ counters.epicPending++;
159
+ pendingTasks++;
160
+ }
161
+ } catch (err) {
162
+ counters.epicPending++;
163
+ pendingTasks++;
164
+ }
165
+ }
166
+ }
167
+ } catch (err) {
168
+ // Directory read error
169
+ }
170
+ }
171
+
172
+ for (const epicDir of epicDirs) {
173
+ const epicPath = path.join('.claude/epics', epicDir);
174
+ // Count tasks in this epic (including subdirectories)
175
+ let counters = {
176
+ epicTasks: 0,
177
+ epicCompleted: 0,
178
+ epicInProgress: 0,
179
+ epicPending: 0
180
+ };
181
+ countTasksInDir(epicPath, counters);
182
+ if (counters.epicTasks > 0) {
183
+ const progress = Math.round((counters.epicCompleted / counters.epicTasks) * 100);
184
+ epicDetails.push({
185
+ name: epicDir,
186
+ tasks: counters.epicTasks,
187
+ completed: counters.epicCompleted,
188
+ inProgress: counters.epicInProgress,
189
+ pending: counters.epicPending,
190
+ progress: progress
191
+ });
192
+ }
193
+ }
194
+ }
195
+ } catch (err) {
196
+ // No epics
197
+ }
198
+
199
+ console.log(` Total Epics: ${epicCount}`);
200
+ console.log(` Total Tasks: ${totalTasks}`);
201
+ console.log(` Completed: ${completedTasks}`);
202
+ console.log(` In Progress: ${inProgressTasks}`);
203
+ console.log(` Pending: ${pendingTasks}`);
204
+ console.log('');
205
+
206
+ if (epicDetails.length > 0) {
207
+ console.log(' Epic Breakdown:');
208
+ epicDetails.slice(0, 5).forEach(epic => {
209
+ const progressBar = createProgressBar(epic.progress, 20);
210
+ console.log(` ${epic.name}`);
211
+ console.log(` ${progressBar} ${epic.progress}% (${epic.completed}/${epic.tasks} tasks)`);
212
+ });
213
+ if (epicDetails.length > 5) {
214
+ console.log(` ... and ${epicDetails.length - 5} more epics`);
215
+ }
216
+ console.log('');
217
+ }
218
+
219
+ // Overall Progress
220
+ if (totalTasks > 0) {
221
+ const overallProgress = Math.round((completedTasks / totalTasks) * 100);
222
+ console.log('šŸ“Š Overall Progress:');
223
+ const overallBar = createProgressBar(overallProgress, 40);
224
+ console.log(` ${overallBar} ${overallProgress}%`);
225
+ console.log(` ${completedTasks} / ${totalTasks} tasks completed`);
226
+ console.log('');
227
+ }
228
+
229
+ // Current/Recent Activity
230
+ console.log('šŸ”„ Recent Activity:');
231
+ try {
232
+ // Find most recently modified task file
233
+ let recentTask = null;
234
+ let recentTime = 0;
235
+
236
+ if (fs.existsSync('.claude/epics')) {
237
+ function findRecentTask(dir) {
238
+ let bestTask = null;
239
+ let bestTime = 0;
240
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
241
+
242
+ for (const entry of entries) {
243
+ const fullPath = path.join(dir, entry.name);
244
+
245
+ if (entry.isDirectory()) {
246
+ const subTask = findRecentTask(fullPath);
247
+ if (subTask && subTask.timeMs > bestTime) {
248
+ bestTask = subTask;
249
+ bestTime = subTask.timeMs;
250
+ }
251
+ } else if (entry.isFile() && TASK_FILE_PATTERN.test(entry.name)) {
252
+ const stats = fs.statSync(fullPath);
253
+ if (stats.mtimeMs > bestTime) {
254
+ const content = fs.readFileSync(fullPath, 'utf8');
255
+ const titleMatch = content.match(/^#\s+(.+)$/m);
256
+ const statusMatch = content.match(/^status:\s*(.+)$/m);
257
+ bestTask = {
258
+ path: fullPath,
259
+ title: titleMatch ? titleMatch[1] : entry.name,
260
+ status: statusMatch ? statusMatch[1].trim() : 'pending',
261
+ time: stats.mtime,
262
+ timeMs: stats.mtimeMs
263
+ };
264
+ bestTime = stats.mtimeMs;
265
+ }
266
+ }
267
+ }
268
+ return bestTask;
269
+ }
270
+
271
+ const foundTask = findRecentTask('.claude/epics');
272
+ if (foundTask) {
273
+ recentTask = foundTask;
274
+ recentTime = foundTask.timeMs;
275
+ }
276
+ }
277
+
278
+ if (recentTask) {
279
+ const timeAgo = getTimeAgo(recentTask.time);
280
+ console.log(` Last Modified: ${recentTask.title}`);
281
+ console.log(` Status: ${recentTask.status}`);
282
+ console.log(` Modified: ${timeAgo}`);
283
+ console.log(` File: ${recentTask.path}`);
284
+ } else {
285
+ console.log(' No recent activity');
286
+ }
287
+ } catch (err) {
288
+ console.log(' No recent activity');
289
+ }
290
+
291
+ console.log('');
292
+ console.log('šŸ’” Quick Commands:');
293
+ console.log(' /pm:next # Get next priority task');
294
+ console.log(' /pm:status # Detailed project status');
295
+ console.log(' /pm:standup # Generate standup report');
296
+ console.log(' /pm:search <keyword> # Search PRDs and epics');
297
+ console.log('');
298
+ }
299
+
300
+ // Helper function to create progress bar
301
+ function createProgressBar(percentage, length) {
302
+ const filled = Math.round((percentage / 100) * length);
303
+ const empty = length - filled;
304
+ return '[' + '='.repeat(filled) + '-'.repeat(empty) + ']';
305
+ }
306
+
307
+ // Helper function to get human-readable time ago
308
+ function getTimeAgo(date) {
309
+ const seconds = Math.floor((new Date() - date) / 1000);
310
+
311
+ const intervals = {
312
+ year: 31536000,
313
+ month: 2592000,
314
+ week: 604800,
315
+ day: 86400,
316
+ hour: 3600,
317
+ minute: 60
318
+ };
319
+
320
+ for (const [name, secondsInInterval] of Object.entries(intervals)) {
321
+ const interval = Math.floor(seconds / secondsInInterval);
322
+ if (interval >= 1) {
323
+ return `${interval} ${name}${interval > 1 ? 's' : ''} ago`;
324
+ }
325
+ }
326
+
327
+ return 'just now';
328
+ }
329
+
330
+ // Run if called directly
331
+ if (require.main === module) {
332
+ context().catch(err => {
333
+ logError('Error executing context command', err);
334
+ process.exit(1);
335
+ });
336
+ }
337
+
338
+ module.exports = context;
@@ -0,0 +1,347 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Epic Close - Close/complete an epic
4
+ */
5
+
6
+ const fs = require('fs');
7
+ const path = require('path');
8
+
9
+ class EpicCloser {
10
+ constructor() {
11
+ this.epicsDir = path.join('.claude', 'epics');
12
+ this.prdsDir = path.join('.claude', 'prds');
13
+ this.activeWorkFile = path.join('.claude', 'active-work.json');
14
+ this.completedFile = path.join('.claude', 'completed-work.json');
15
+ }
16
+
17
+ findEpicFile(epicName) {
18
+ // Check epics directory
19
+ let epicPath = path.join(this.epicsDir, `${epicName}.md`);
20
+ if (fs.existsSync(epicPath)) {
21
+ return epicPath;
22
+ }
23
+
24
+ // Check PRDs directory
25
+ epicPath = path.join(this.prdsDir, `${epicName}.md`);
26
+ if (fs.existsSync(epicPath)) {
27
+ return epicPath;
28
+ }
29
+
30
+ return null;
31
+ }
32
+
33
+ loadActiveWork() {
34
+ if (!fs.existsSync(this.activeWorkFile)) {
35
+ return { issues: [], epics: [] };
36
+ }
37
+ try {
38
+ return JSON.parse(fs.readFileSync(this.activeWorkFile, 'utf8'));
39
+ } catch {
40
+ return { issues: [], epics: [] };
41
+ }
42
+ }
43
+
44
+ saveActiveWork(activeWork) {
45
+ const dir = path.dirname(this.activeWorkFile);
46
+ if (!fs.existsSync(dir)) {
47
+ fs.mkdirSync(dir, { recursive: true });
48
+ }
49
+ fs.writeFileSync(this.activeWorkFile, JSON.stringify(activeWork, null, 2));
50
+ }
51
+
52
+ loadCompletedWork() {
53
+ if (!fs.existsSync(this.completedFile)) {
54
+ return { issues: [], epics: [] };
55
+ }
56
+ try {
57
+ return JSON.parse(fs.readFileSync(this.completedFile, 'utf8'));
58
+ } catch {
59
+ return { issues: [], epics: [] };
60
+ }
61
+ }
62
+
63
+ saveCompletedWork(completedWork) {
64
+ const dir = path.dirname(this.completedFile);
65
+ if (!fs.existsSync(dir)) {
66
+ fs.mkdirSync(dir, { recursive: true });
67
+ }
68
+ fs.writeFileSync(this.completedFile, JSON.stringify(completedWork, null, 2));
69
+ }
70
+
71
+ extractTasksFromEpic(epicContent) {
72
+ const lines = epicContent.split('\n');
73
+ const tasks = {
74
+ total: 0,
75
+ completed: 0,
76
+ incomplete: 0,
77
+ completedTasks: [],
78
+ incompleteTasks: []
79
+ };
80
+
81
+ lines.forEach(line => {
82
+ if (line.match(/^- \[x\]/)) {
83
+ tasks.completed++;
84
+ tasks.completedTasks.push(line.replace(/^- \[x\] /, ''));
85
+ } else if (line.match(/^- \[ \]/)) {
86
+ tasks.incomplete++;
87
+ tasks.incompleteTasks.push(line.replace(/^- \[ \] /, ''));
88
+ }
89
+ });
90
+
91
+ tasks.total = tasks.completed + tasks.incomplete;
92
+ return tasks;
93
+ }
94
+
95
+ async closeEpic(epicName, options = {}) {
96
+ console.log(`\nšŸ”’ Closing Epic: ${epicName}`);
97
+ console.log(`${'═'.repeat(50)}\n`);
98
+
99
+ // Find epic file
100
+ const epicFile = this.findEpicFile(epicName);
101
+ if (!epicFile) {
102
+ console.error(`āŒ Epic not found: ${epicName}`);
103
+ this.listAvailableEpics();
104
+ return false;
105
+ }
106
+
107
+ // Read and analyze epic
108
+ let epicContent = fs.readFileSync(epicFile, 'utf8');
109
+ const tasks = this.extractTasksFromEpic(epicContent);
110
+
111
+ // Show current status
112
+ console.log('šŸ“Š Epic Status:');
113
+ console.log(` • Total Tasks: ${tasks.total}`);
114
+ console.log(` • Completed: ${tasks.completed} (${tasks.total > 0 ? Math.round(tasks.completed / tasks.total * 100) : 0}%)`);
115
+ console.log(` • Remaining: ${tasks.incomplete}`);
116
+
117
+ // Check if all tasks are complete
118
+ if (tasks.incomplete > 0 && !options.force) {
119
+ console.log('\nāš ļø Warning: Epic has incomplete tasks!');
120
+ console.log('\nIncomplete tasks:');
121
+ tasks.incompleteTasks.slice(0, 5).forEach(task => {
122
+ console.log(` ⬜ ${task}`);
123
+ });
124
+ if (tasks.incompleteTasks.length > 5) {
125
+ console.log(` ... and ${tasks.incompleteTasks.length - 5} more`);
126
+ }
127
+
128
+ console.log('\nšŸ’” Options:');
129
+ console.log(' • Complete remaining tasks first');
130
+ console.log(' • Use --force to close anyway');
131
+ console.log(' • Use --complete-all to mark all tasks as done');
132
+
133
+ if (!options.completeAll) {
134
+ return false;
135
+ }
136
+ }
137
+
138
+ // Mark all tasks as complete if requested
139
+ if (options.completeAll) {
140
+ console.log('\nāœ… Marking all tasks as complete...');
141
+ epicContent = epicContent.replace(/- \[ \]/g, '- [x]');
142
+ fs.writeFileSync(epicFile, epicContent);
143
+ }
144
+
145
+ // Update epic metadata
146
+ const closedDate = new Date().toISOString();
147
+ const updatedContent = this.updateEpicMetadata(epicContent, {
148
+ status: 'completed',
149
+ closedDate: closedDate
150
+ });
151
+ fs.writeFileSync(epicFile, updatedContent);
152
+
153
+ // Update tracking
154
+ const activeWork = this.loadActiveWork();
155
+ const completedWork = this.loadCompletedWork();
156
+
157
+ // Find and move epic from active to completed
158
+ const activeEpic = activeWork.epics.find(e => e.name === epicName);
159
+ if (activeEpic) {
160
+ // Remove from active
161
+ activeWork.epics = activeWork.epics.filter(e => e.name !== epicName);
162
+ this.saveActiveWork(activeWork);
163
+
164
+ // Add to completed
165
+ const completedEntry = {
166
+ ...activeEpic,
167
+ completedAt: closedDate,
168
+ status: 'completed',
169
+ finalStats: {
170
+ totalTasks: tasks.total,
171
+ completedTasks: options.completeAll ? tasks.total : tasks.completed
172
+ }
173
+ };
174
+
175
+ completedWork.epics.unshift(completedEntry);
176
+
177
+ // Keep only last 50 completed epics
178
+ if (completedWork.epics.length > 50) {
179
+ completedWork.epics = completedWork.epics.slice(0, 50);
180
+ }
181
+
182
+ this.saveCompletedWork(completedWork);
183
+ } else {
184
+ // Add to completed even if not in active
185
+ const completedEntry = {
186
+ name: epicName,
187
+ completedAt: closedDate,
188
+ status: 'completed',
189
+ finalStats: {
190
+ totalTasks: tasks.total,
191
+ completedTasks: options.completeAll ? tasks.total : tasks.completed
192
+ }
193
+ };
194
+
195
+ completedWork.epics.unshift(completedEntry);
196
+ this.saveCompletedWork(completedWork);
197
+ }
198
+
199
+ // Success message
200
+ console.log(`\nāœ… Epic "${epicName}" has been closed!`);
201
+ console.log('\nšŸ“‹ Final Statistics:');
202
+ console.log(` • Total Tasks: ${tasks.total}`);
203
+ console.log(` • Completed: ${options.completeAll ? tasks.total : tasks.completed} (100%)`);
204
+ console.log(` • Closed Date: ${new Date(closedDate).toLocaleString()}`);
205
+
206
+ // Archive epic if requested
207
+ if (options.archive) {
208
+ const archiveDir = path.join(path.dirname(epicFile), 'archive');
209
+ if (!fs.existsSync(archiveDir)) {
210
+ fs.mkdirSync(archiveDir, { recursive: true });
211
+ }
212
+
213
+ const archivePath = path.join(archiveDir, path.basename(epicFile));
214
+ fs.renameSync(epicFile, archivePath);
215
+ console.log(`\nšŸ“¦ Epic archived to: ${archivePath}`);
216
+ }
217
+
218
+ // Show next steps
219
+ console.log('\nšŸ’” Next Steps:');
220
+ console.log(' • View completed epics: /pm:status');
221
+ console.log(' • Start new epic: /pm:init <epic-name>');
222
+ console.log(' • List all epics: /pm:epic-list');
223
+
224
+ return true;
225
+ }
226
+
227
+ updateEpicMetadata(content, metadata) {
228
+ const lines = content.split('\n');
229
+ const updatedLines = [];
230
+ let inMetadata = false;
231
+ let metadataUpdated = false;
232
+
233
+ for (const line of lines) {
234
+ if (line.startsWith('---') && !inMetadata) {
235
+ inMetadata = true;
236
+ updatedLines.push(line);
237
+ } else if (line.startsWith('---') && inMetadata) {
238
+ // Add missing metadata before closing
239
+ if (!metadataUpdated) {
240
+ updatedLines.push(`status: ${metadata.status}`);
241
+ updatedLines.push(`closedDate: ${metadata.closedDate}`);
242
+ }
243
+ updatedLines.push(line);
244
+ inMetadata = false;
245
+ metadataUpdated = true;
246
+ } else if (inMetadata) {
247
+ // Update existing metadata
248
+ if (line.startsWith('status:')) {
249
+ updatedLines.push(`status: ${metadata.status}`);
250
+ metadataUpdated = true;
251
+ } else if (line.startsWith('closedDate:')) {
252
+ updatedLines.push(`closedDate: ${metadata.closedDate}`);
253
+ } else {
254
+ updatedLines.push(line);
255
+ }
256
+ } else {
257
+ updatedLines.push(line);
258
+ }
259
+ }
260
+
261
+ // If no metadata section exists, add it
262
+ if (!metadataUpdated) {
263
+ const titleIndex = updatedLines.findIndex(line => line.startsWith('# '));
264
+ if (titleIndex !== -1) {
265
+ updatedLines.splice(titleIndex + 1, 0,
266
+ '',
267
+ '---',
268
+ `status: ${metadata.status}`,
269
+ `closedDate: ${metadata.closedDate}`,
270
+ '---',
271
+ ''
272
+ );
273
+ }
274
+ }
275
+
276
+ return updatedLines.join('\n');
277
+ }
278
+
279
+ listAvailableEpics() {
280
+ console.log('\nAvailable epics:');
281
+
282
+ const epics = new Set();
283
+
284
+ // List from epics directory
285
+ if (fs.existsSync(this.epicsDir)) {
286
+ fs.readdirSync(this.epicsDir)
287
+ .filter(file => file.endsWith('.md'))
288
+ .forEach(file => epics.add(file.replace('.md', '')));
289
+ }
290
+
291
+ // List from PRDs directory
292
+ if (fs.existsSync(this.prdsDir)) {
293
+ fs.readdirSync(this.prdsDir)
294
+ .filter(file => file.endsWith('.md'))
295
+ .forEach(file => epics.add(file.replace('.md', '')));
296
+ }
297
+
298
+ if (epics.size > 0) {
299
+ Array.from(epics).forEach(epic => {
300
+ console.log(` • ${epic}`);
301
+ });
302
+ } else {
303
+ console.log(' No epics found');
304
+ }
305
+ }
306
+
307
+ async run(args) {
308
+ const epicName = args[0];
309
+
310
+ if (!epicName) {
311
+ console.error('āŒ Error: Epic name required');
312
+ console.error('Usage: /pm:epic-close <epic-name> [--force] [--complete-all] [--archive]');
313
+ console.error('\nOptions:');
314
+ console.error(' --force Close even with incomplete tasks');
315
+ console.error(' --complete-all Mark all tasks as complete');
316
+ console.error(' --archive Move epic to archive folder');
317
+
318
+ this.listAvailableEpics();
319
+ process.exit(1);
320
+ }
321
+
322
+ const options = {};
323
+ args.slice(1).forEach(arg => {
324
+ if (arg === '--force') {
325
+ options.force = true;
326
+ } else if (arg === '--complete-all') {
327
+ options.completeAll = true;
328
+ } else if (arg === '--archive') {
329
+ options.archive = true;
330
+ }
331
+ });
332
+
333
+ const success = await this.closeEpic(epicName, options);
334
+ process.exit(success ? 0 : 1);
335
+ }
336
+ }
337
+
338
+ // Main execution
339
+ if (require.main === module) {
340
+ const closer = new EpicCloser();
341
+ closer.run(process.argv.slice(2)).catch(error => {
342
+ console.error('āŒ Error:', error.message);
343
+ process.exit(1);
344
+ });
345
+ }
346
+
347
+ module.exports = EpicCloser;