@trieungoctam/vibekit 1.0.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 (352) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +85 -0
  3. package/agents/debugger.md +158 -0
  4. package/agents/docs-manager.md +220 -0
  5. package/agents/planner.md +129 -0
  6. package/agents/researcher.md +58 -0
  7. package/agents/reviewer.md +152 -0
  8. package/agents/tester.md +126 -0
  9. package/bin/vibekit.js +18 -0
  10. package/hooks/lib/ck-config-utils.cjs +831 -0
  11. package/hooks/lib/colors.cjs +95 -0
  12. package/hooks/lib/config-counter.cjs +103 -0
  13. package/hooks/lib/context-builder.cjs +616 -0
  14. package/hooks/lib/git-info-cache.cjs +143 -0
  15. package/hooks/lib/hook-logger.cjs +92 -0
  16. package/hooks/lib/privacy-checker.cjs +297 -0
  17. package/hooks/lib/project-detector.cjs +474 -0
  18. package/hooks/lib/scout-checker.cjs +263 -0
  19. package/hooks/lib/transcript-parser.cjs +181 -0
  20. package/hooks/post-edit-simplify-reminder.cjs +156 -0
  21. package/hooks/privacy-block.cjs +166 -0
  22. package/hooks/scout-block.cjs +147 -0
  23. package/hooks/session-init.cjs +360 -0
  24. package/package.json +41 -0
  25. package/rules/development-rules.md +52 -0
  26. package/rules/documentation-management.md +121 -0
  27. package/rules/orchestration-protocol.md +43 -0
  28. package/rules/primary-workflow.md +57 -0
  29. package/rules/team-coordination-rules.md +90 -0
  30. package/skills/ai/agent-browser/SKILL.md +294 -0
  31. package/skills/ai/agent-browser/references/.gitkeep +0 -0
  32. package/skills/ai/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
  33. package/skills/ai/agent-browser/references/browserbase-cloud-setup.md +161 -0
  34. package/skills/ai/ai-artist/SKILL.md +122 -0
  35. package/skills/ai/ai-artist/data/awesome-prompts.csv +3592 -0
  36. package/skills/ai/ai-artist/data/lighting.csv +19 -0
  37. package/skills/ai/ai-artist/data/nano-banana-templates.csv +17 -0
  38. package/skills/ai/ai-artist/data/platforms.csv +11 -0
  39. package/skills/ai/ai-artist/data/styles.csv +26 -0
  40. package/skills/ai/ai-artist/data/techniques.csv +19 -0
  41. package/skills/ai/ai-artist/data/use-cases.csv +16 -0
  42. package/skills/ai/ai-artist/references/advanced-techniques.md +184 -0
  43. package/skills/ai/ai-artist/references/awesome-nano-banana-pro-prompts.md +8575 -0
  44. package/skills/ai/ai-artist/references/domain-code.md +66 -0
  45. package/skills/ai/ai-artist/references/domain-data.md +72 -0
  46. package/skills/ai/ai-artist/references/domain-marketing.md +66 -0
  47. package/skills/ai/ai-artist/references/domain-patterns.md +33 -0
  48. package/skills/ai/ai-artist/references/domain-writing.md +68 -0
  49. package/skills/ai/ai-artist/references/image-prompting.md +141 -0
  50. package/skills/ai/ai-artist/references/llm-prompting.md +165 -0
  51. package/skills/ai/ai-artist/references/nano-banana.md +136 -0
  52. package/skills/ai/ai-artist/references/reasoning-techniques.md +201 -0
  53. package/skills/ai/ai-artist/references/validation-workflow.md +117 -0
  54. package/skills/ai/ai-artist/scripts/core.py +197 -0
  55. package/skills/ai/ai-artist/scripts/extract_prompts.py +102 -0
  56. package/skills/ai/ai-artist/scripts/generate.py +370 -0
  57. package/skills/ai/ai-artist/scripts/search.py +147 -0
  58. package/skills/ai/ai-multimodal/.env.example +204 -0
  59. package/skills/ai/ai-multimodal/SKILL.md +110 -0
  60. package/skills/ai/ai-multimodal/references/audio-processing.md +387 -0
  61. package/skills/ai/ai-multimodal/references/image-generation.md +939 -0
  62. package/skills/ai/ai-multimodal/references/music-generation.md +311 -0
  63. package/skills/ai/ai-multimodal/references/video-analysis.md +515 -0
  64. package/skills/ai/ai-multimodal/references/video-generation.md +457 -0
  65. package/skills/ai/ai-multimodal/references/vision-understanding.md +492 -0
  66. package/skills/ai/ai-multimodal/scripts/.coverage +0 -0
  67. package/skills/ai/ai-multimodal/scripts/check_setup.py +315 -0
  68. package/skills/ai/ai-multimodal/scripts/document_converter.py +395 -0
  69. package/skills/ai/ai-multimodal/scripts/gemini_batch_process.py +1185 -0
  70. package/skills/ai/ai-multimodal/scripts/media_optimizer.py +506 -0
  71. package/skills/ai/ai-multimodal/scripts/requirements.txt +26 -0
  72. package/skills/ai/ai-multimodal/scripts/tests/.coverage +0 -0
  73. package/skills/ai/ai-multimodal/scripts/tests/requirements.txt +20 -0
  74. package/skills/ai/ai-multimodal/scripts/tests/test_document_converter.py +74 -0
  75. package/skills/ai/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
  76. package/skills/ai/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
  77. package/skills/ai/mcp-management/README.md +219 -0
  78. package/skills/ai/mcp-management/SKILL.md +210 -0
  79. package/skills/ai/mcp-management/assets/tools.json +3146 -0
  80. package/skills/ai/mcp-management/references/configuration.md +114 -0
  81. package/skills/ai/mcp-management/references/gemini-cli-integration.md +221 -0
  82. package/skills/ai/mcp-management/references/mcp-protocol.md +116 -0
  83. package/skills/ai/mcp-management/scripts/.env.example +10 -0
  84. package/skills/ai/mcp-management/scripts/cli.ts +195 -0
  85. package/skills/ai/mcp-management/scripts/dist/analyze-tools.js +70 -0
  86. package/skills/ai/mcp-management/scripts/dist/cli.js +160 -0
  87. package/skills/ai/mcp-management/scripts/dist/mcp-client.js +183 -0
  88. package/skills/ai/mcp-management/scripts/mcp-client.ts +230 -0
  89. package/skills/ai/mcp-management/scripts/package.json +20 -0
  90. package/skills/ai/mcp-management/scripts/tsconfig.json +15 -0
  91. package/skills/core/brainstorm/SKILL.md +164 -0
  92. package/skills/core/brainstorm/scripts/frame-template.html +214 -0
  93. package/skills/core/brainstorm/scripts/helper.js +88 -0
  94. package/skills/core/brainstorm/scripts/server.cjs +338 -0
  95. package/skills/core/brainstorm/scripts/start-server.sh +153 -0
  96. package/skills/core/brainstorm/scripts/stop-server.sh +55 -0
  97. package/skills/core/brainstorm/spec-document-reviewer-prompt.md +49 -0
  98. package/skills/core/brainstorm/visual-companion.md +286 -0
  99. package/skills/core/code-review/SKILL.md +147 -0
  100. package/skills/core/code-review/references/code-review-reception.md +113 -0
  101. package/skills/core/code-review/references/codebase-scan-workflow.md +29 -0
  102. package/skills/core/code-review/references/edge-case-scouting.md +119 -0
  103. package/skills/core/code-review/references/parallel-review-workflow.md +69 -0
  104. package/skills/core/code-review/references/requesting-code-review.md +116 -0
  105. package/skills/core/code-review/references/task-management-reviews.md +140 -0
  106. package/skills/core/code-review/references/verification-before-completion.md +139 -0
  107. package/skills/core/cook/README.md +86 -0
  108. package/skills/core/cook/SKILL.md +113 -0
  109. package/skills/core/cook/references/intent-detection.md +101 -0
  110. package/skills/core/cook/references/review-cycle.md +75 -0
  111. package/skills/core/cook/references/subagent-patterns.md +75 -0
  112. package/skills/core/cook/references/workflow-steps.md +172 -0
  113. package/skills/core/debug/SKILL.md +121 -0
  114. package/skills/core/debug/references/defense-in-depth.md +124 -0
  115. package/skills/core/debug/references/frontend-verification.md +103 -0
  116. package/skills/core/debug/references/investigation-methodology.md +101 -0
  117. package/skills/core/debug/references/log-and-ci-analysis.md +97 -0
  118. package/skills/core/debug/references/performance-diagnostics.md +113 -0
  119. package/skills/core/debug/references/reporting-standards.md +122 -0
  120. package/skills/core/debug/references/root-cause-tracing.md +122 -0
  121. package/skills/core/debug/references/systematic-debugging.md +102 -0
  122. package/skills/core/debug/references/task-management-debugging.md +155 -0
  123. package/skills/core/debug/references/verification.md +123 -0
  124. package/skills/core/debug/scripts/find-polluter.sh +63 -0
  125. package/skills/core/debug/scripts/find-polluter.test.md +102 -0
  126. package/skills/core/execute/SKILL.md +70 -0
  127. package/skills/core/fix/SKILL.md +111 -0
  128. package/skills/core/fix/references/complexity-assessment.md +72 -0
  129. package/skills/core/fix/references/mode-selection.md +46 -0
  130. package/skills/core/fix/references/parallel-exploration.md +100 -0
  131. package/skills/core/fix/references/review-cycle.md +77 -0
  132. package/skills/core/fix/references/skill-activation-matrix.md +78 -0
  133. package/skills/core/fix/references/task-orchestration.md +103 -0
  134. package/skills/core/fix/references/workflow-ci.md +28 -0
  135. package/skills/core/fix/references/workflow-deep.md +122 -0
  136. package/skills/core/fix/references/workflow-logs.md +72 -0
  137. package/skills/core/fix/references/workflow-quick.md +59 -0
  138. package/skills/core/fix/references/workflow-standard.md +111 -0
  139. package/skills/core/fix/references/workflow-test.md +75 -0
  140. package/skills/core/fix/references/workflow-types.md +33 -0
  141. package/skills/core/fix/references/workflow-ui.md +75 -0
  142. package/skills/core/plan/SKILL.md +145 -0
  143. package/skills/core/plan/plan-document-reviewer-prompt.md +49 -0
  144. package/skills/core/subagent-dev/SKILL.md +277 -0
  145. package/skills/core/subagent-dev/code-quality-reviewer-prompt.md +26 -0
  146. package/skills/core/subagent-dev/implementer-prompt.md +113 -0
  147. package/skills/core/subagent-dev/spec-reviewer-prompt.md +61 -0
  148. package/skills/core/tdd/SKILL.md +371 -0
  149. package/skills/core/tdd/testing-anti-patterns.md +299 -0
  150. package/skills/core/test/SKILL.md +109 -0
  151. package/skills/core/test/references/report-format.md +58 -0
  152. package/skills/core/test/references/test-execution-workflow.md +103 -0
  153. package/skills/core/test/references/ui-testing-workflow.md +65 -0
  154. package/skills/core/verify/SKILL.md +139 -0
  155. package/skills/dev/backend-dev/SKILL.md +96 -0
  156. package/skills/dev/backend-dev/references/backend-api-design.md +495 -0
  157. package/skills/dev/backend-dev/references/backend-architecture.md +454 -0
  158. package/skills/dev/backend-dev/references/backend-authentication.md +338 -0
  159. package/skills/dev/backend-dev/references/backend-code-quality.md +659 -0
  160. package/skills/dev/backend-dev/references/backend-debugging.md +904 -0
  161. package/skills/dev/backend-dev/references/backend-devops.md +494 -0
  162. package/skills/dev/backend-dev/references/backend-mindset.md +387 -0
  163. package/skills/dev/backend-dev/references/backend-performance.md +397 -0
  164. package/skills/dev/backend-dev/references/backend-security.md +290 -0
  165. package/skills/dev/backend-dev/references/backend-technologies.md +256 -0
  166. package/skills/dev/backend-dev/references/backend-testing.md +429 -0
  167. package/skills/dev/context-engineering/SKILL.md +108 -0
  168. package/skills/dev/context-engineering/references/context-compression.md +84 -0
  169. package/skills/dev/context-engineering/references/context-degradation.md +93 -0
  170. package/skills/dev/context-engineering/references/context-fundamentals.md +75 -0
  171. package/skills/dev/context-engineering/references/context-optimization.md +82 -0
  172. package/skills/dev/context-engineering/references/evaluation.md +89 -0
  173. package/skills/dev/context-engineering/references/memory-systems.md +88 -0
  174. package/skills/dev/context-engineering/references/multi-agent-patterns.md +90 -0
  175. package/skills/dev/context-engineering/references/project-development.md +97 -0
  176. package/skills/dev/context-engineering/references/runtime-awareness.md +202 -0
  177. package/skills/dev/context-engineering/references/tool-design.md +86 -0
  178. package/skills/dev/context-engineering/scripts/compression_evaluator.py +349 -0
  179. package/skills/dev/context-engineering/scripts/context_analyzer.py +317 -0
  180. package/skills/dev/context-engineering/scripts/tests/test_edge_cases.py +246 -0
  181. package/skills/dev/databases/SKILL.md +84 -0
  182. package/skills/dev/databases/analytics.md +198 -0
  183. package/skills/dev/databases/db-design.md +188 -0
  184. package/skills/dev/databases/incremental-etl.md +213 -0
  185. package/skills/dev/databases/references/mongodb-aggregation.md +447 -0
  186. package/skills/dev/databases/references/mongodb-atlas.md +465 -0
  187. package/skills/dev/databases/references/mongodb-crud.md +408 -0
  188. package/skills/dev/databases/references/mongodb-indexing.md +442 -0
  189. package/skills/dev/databases/references/postgresql-administration.md +594 -0
  190. package/skills/dev/databases/references/postgresql-performance.md +527 -0
  191. package/skills/dev/databases/references/postgresql-psql-cli.md +467 -0
  192. package/skills/dev/databases/references/postgresql-queries.md +475 -0
  193. package/skills/dev/databases/scripts/.coverage +0 -0
  194. package/skills/dev/databases/scripts/db_backup.py +502 -0
  195. package/skills/dev/databases/scripts/db_migrate.py +426 -0
  196. package/skills/dev/databases/scripts/db_performance_check.py +457 -0
  197. package/skills/dev/databases/scripts/requirements.txt +20 -0
  198. package/skills/dev/databases/scripts/tests/coverage-db.json +1 -0
  199. package/skills/dev/databases/scripts/tests/requirements.txt +4 -0
  200. package/skills/dev/databases/scripts/tests/test_db_backup.py +340 -0
  201. package/skills/dev/databases/scripts/tests/test_db_migrate.py +277 -0
  202. package/skills/dev/databases/scripts/tests/test_db_performance_check.py +370 -0
  203. package/skills/dev/databases/stacks/bigquery.md +231 -0
  204. package/skills/dev/databases/stacks/d1_cloudflare.md +137 -0
  205. package/skills/dev/databases/stacks/mysql.md +216 -0
  206. package/skills/dev/databases/stacks/postgres.md +235 -0
  207. package/skills/dev/databases/stacks/sqlite.md +244 -0
  208. package/skills/dev/databases/transactional.md +176 -0
  209. package/skills/dev/devops/.env.example +76 -0
  210. package/skills/dev/devops/SKILL.md +97 -0
  211. package/skills/dev/devops/references/browser-rendering.md +305 -0
  212. package/skills/dev/devops/references/cloudflare-d1-kv.md +123 -0
  213. package/skills/dev/devops/references/cloudflare-platform.md +271 -0
  214. package/skills/dev/devops/references/cloudflare-r2-storage.md +280 -0
  215. package/skills/dev/devops/references/cloudflare-workers-advanced.md +312 -0
  216. package/skills/dev/devops/references/cloudflare-workers-apis.md +309 -0
  217. package/skills/dev/devops/references/cloudflare-workers-basics.md +418 -0
  218. package/skills/dev/devops/references/docker-basics.md +297 -0
  219. package/skills/dev/devops/references/docker-compose.md +292 -0
  220. package/skills/dev/devops/references/gcloud-platform.md +297 -0
  221. package/skills/dev/devops/references/gcloud-services.md +304 -0
  222. package/skills/dev/devops/references/kubernetes-basics.md +99 -0
  223. package/skills/dev/devops/references/kubernetes-helm-advanced.md +75 -0
  224. package/skills/dev/devops/references/kubernetes-helm.md +81 -0
  225. package/skills/dev/devops/references/kubernetes-kubectl.md +74 -0
  226. package/skills/dev/devops/references/kubernetes-security-advanced.md +98 -0
  227. package/skills/dev/devops/references/kubernetes-security.md +95 -0
  228. package/skills/dev/devops/references/kubernetes-troubleshooting-advanced.md +74 -0
  229. package/skills/dev/devops/references/kubernetes-troubleshooting.md +49 -0
  230. package/skills/dev/devops/references/kubernetes-workflows-advanced.md +75 -0
  231. package/skills/dev/devops/references/kubernetes-workflows.md +78 -0
  232. package/skills/dev/devops/scripts/cloudflare_deploy.py +269 -0
  233. package/skills/dev/devops/scripts/docker_optimize.py +332 -0
  234. package/skills/dev/devops/scripts/requirements.txt +20 -0
  235. package/skills/dev/devops/scripts/tests/requirements.txt +3 -0
  236. package/skills/dev/devops/scripts/tests/test_cloudflare_deploy.py +285 -0
  237. package/skills/dev/devops/scripts/tests/test_docker_optimize.py +436 -0
  238. package/skills/dev/frontend-design/SKILL.md +78 -0
  239. package/skills/dev/frontend-design/references/ai-multimodal-overview.md +165 -0
  240. package/skills/dev/frontend-design/references/analysis-best-practices.md +80 -0
  241. package/skills/dev/frontend-design/references/analysis-prompts.md +141 -0
  242. package/skills/dev/frontend-design/references/analysis-techniques.md +118 -0
  243. package/skills/dev/frontend-design/references/animejs.md +396 -0
  244. package/skills/dev/frontend-design/references/asset-generation.md +337 -0
  245. package/skills/dev/frontend-design/references/design-extraction-overview.md +71 -0
  246. package/skills/dev/frontend-design/references/extraction-best-practices.md +141 -0
  247. package/skills/dev/frontend-design/references/extraction-output-templates.md +162 -0
  248. package/skills/dev/frontend-design/references/extraction-prompts.md +127 -0
  249. package/skills/dev/frontend-design/references/technical-accessibility.md +119 -0
  250. package/skills/dev/frontend-design/references/technical-best-practices.md +97 -0
  251. package/skills/dev/frontend-design/references/technical-optimization.md +44 -0
  252. package/skills/dev/frontend-design/references/technical-overview.md +90 -0
  253. package/skills/dev/frontend-design/references/technical-workflows.md +150 -0
  254. package/skills/dev/frontend-design/references/visual-analysis-overview.md +95 -0
  255. package/skills/dev/frontend-design/references/workflow-3d.md +102 -0
  256. package/skills/dev/frontend-design/references/workflow-describe.md +87 -0
  257. package/skills/dev/frontend-design/references/workflow-immersive.md +87 -0
  258. package/skills/dev/frontend-design/references/workflow-quick.md +57 -0
  259. package/skills/dev/frontend-design/references/workflow-screenshot.md +63 -0
  260. package/skills/dev/frontend-design/references/workflow-video.md +74 -0
  261. package/skills/dev/frontend-dev/SKILL.md +400 -0
  262. package/skills/dev/frontend-dev/resources/common-patterns.md +331 -0
  263. package/skills/dev/frontend-dev/resources/complete-examples.md +872 -0
  264. package/skills/dev/frontend-dev/resources/component-patterns.md +502 -0
  265. package/skills/dev/frontend-dev/resources/data-fetching.md +767 -0
  266. package/skills/dev/frontend-dev/resources/file-organization.md +502 -0
  267. package/skills/dev/frontend-dev/resources/loading-and-error-states.md +501 -0
  268. package/skills/dev/frontend-dev/resources/performance.md +406 -0
  269. package/skills/dev/frontend-dev/resources/routing-guide.md +364 -0
  270. package/skills/dev/frontend-dev/resources/styling-guide.md +428 -0
  271. package/skills/dev/frontend-dev/resources/typescript-standards.md +418 -0
  272. package/skills/dev/git/SKILL.md +114 -0
  273. package/skills/dev/git/references/branch-management.md +88 -0
  274. package/skills/dev/git/references/commit-standards.md +46 -0
  275. package/skills/dev/git/references/gh-cli-guide.md +109 -0
  276. package/skills/dev/git/references/safety-protocols.md +69 -0
  277. package/skills/dev/git/references/workflow-commit.md +58 -0
  278. package/skills/dev/git/references/workflow-merge.md +48 -0
  279. package/skills/dev/git/references/workflow-pr.md +58 -0
  280. package/skills/dev/git/references/workflow-push.md +52 -0
  281. package/skills/dev/git-worktree/SKILL.md +218 -0
  282. package/skills/utils/ask/SKILL.md +58 -0
  283. package/skills/utils/bootstrap/SKILL.md +101 -0
  284. package/skills/utils/bootstrap/references/shared-phases.md +59 -0
  285. package/skills/utils/bootstrap/references/workflow-auto.md +52 -0
  286. package/skills/utils/bootstrap/references/workflow-fast.md +50 -0
  287. package/skills/utils/bootstrap/references/workflow-full.md +60 -0
  288. package/skills/utils/bootstrap/references/workflow-parallel.md +59 -0
  289. package/skills/utils/ck-help/SKILL.md +102 -0
  290. package/skills/utils/ck-help/scripts/ck-help.py +1321 -0
  291. package/skills/utils/ck-help/scripts/commands_data.yaml +3 -0
  292. package/skills/utils/ck-help/scripts/skills_data.yaml +593 -0
  293. package/skills/utils/copywriting/SKILL.md +94 -0
  294. package/skills/utils/copywriting/references/copy-formulas.md +150 -0
  295. package/skills/utils/copywriting/references/cta-patterns.md +168 -0
  296. package/skills/utils/copywriting/references/email-copy.md +193 -0
  297. package/skills/utils/copywriting/references/headline-templates.md +140 -0
  298. package/skills/utils/copywriting/references/landing-page-copy.md +175 -0
  299. package/skills/utils/copywriting/references/power-words.md +189 -0
  300. package/skills/utils/copywriting/references/social-media-copy.md +222 -0
  301. package/skills/utils/copywriting/references/workflow-cro.md +83 -0
  302. package/skills/utils/copywriting/references/workflow-enhance.md +32 -0
  303. package/skills/utils/copywriting/references/workflow-fast.md +29 -0
  304. package/skills/utils/copywriting/references/workflow-good.md +39 -0
  305. package/skills/utils/copywriting/references/writing-styles.md +247 -0
  306. package/skills/utils/copywriting/scripts/extract-writing-styles.py +308 -0
  307. package/skills/utils/copywriting/templates/copy-brief.md +49 -0
  308. package/skills/utils/docs/SKILL.md +55 -0
  309. package/skills/utils/docs/references/init-workflow.md +32 -0
  310. package/skills/utils/docs/references/summarize-workflow.md +18 -0
  311. package/skills/utils/docs/references/update-workflow.md +59 -0
  312. package/skills/utils/journal/SKILL.md +11 -0
  313. package/skills/utils/kanban/SKILL.md +99 -0
  314. package/skills/utils/preview/SKILL.md +75 -0
  315. package/skills/utils/preview/references/generation-modes.md +95 -0
  316. package/skills/utils/preview/references/view-mode.md +42 -0
  317. package/skills/utils/repomix/SKILL.md +248 -0
  318. package/skills/utils/repomix/references/configuration.md +211 -0
  319. package/skills/utils/repomix/references/usage-patterns.md +232 -0
  320. package/skills/utils/repomix/scripts/.coverage +0 -0
  321. package/skills/utils/repomix/scripts/README.md +179 -0
  322. package/skills/utils/repomix/scripts/repomix_batch.py +455 -0
  323. package/skills/utils/repomix/scripts/repos.example.json +15 -0
  324. package/skills/utils/repomix/scripts/requirements.txt +15 -0
  325. package/skills/utils/repomix/scripts/tests/test_repomix_batch.py +531 -0
  326. package/skills/utils/research/SKILL.md +171 -0
  327. package/skills/utils/scout/SKILL.md +89 -0
  328. package/skills/utils/scout/references/external-scouting.md +140 -0
  329. package/skills/utils/scout/references/internal-scouting.md +119 -0
  330. package/skills/utils/scout/references/task-management-scouting.md +125 -0
  331. package/skills/utils/sequential-thinking/.env.example +8 -0
  332. package/skills/utils/sequential-thinking/README.md +183 -0
  333. package/skills/utils/sequential-thinking/SKILL.md +95 -0
  334. package/skills/utils/sequential-thinking/package.json +31 -0
  335. package/skills/utils/sequential-thinking/references/advanced-strategies.md +79 -0
  336. package/skills/utils/sequential-thinking/references/advanced-techniques.md +76 -0
  337. package/skills/utils/sequential-thinking/references/core-patterns.md +95 -0
  338. package/skills/utils/sequential-thinking/references/examples-api.md +88 -0
  339. package/skills/utils/sequential-thinking/references/examples-architecture.md +94 -0
  340. package/skills/utils/sequential-thinking/references/examples-debug.md +90 -0
  341. package/skills/utils/sequential-thinking/scripts/format-thought.js +159 -0
  342. package/skills/utils/sequential-thinking/scripts/process-thought.js +236 -0
  343. package/skills/utils/sequential-thinking/tests/format-thought.test.js +133 -0
  344. package/skills/utils/sequential-thinking/tests/process-thought.test.js +215 -0
  345. package/skills/utils/write-skill/SKILL.md +655 -0
  346. package/skills/utils/write-skill/anthropic-best-practices.md +1150 -0
  347. package/skills/utils/write-skill/examples/CLAUDE_MD_TESTING.md +189 -0
  348. package/skills/utils/write-skill/graphviz-conventions.dot +172 -0
  349. package/skills/utils/write-skill/persuasion-principles.md +187 -0
  350. package/skills/utils/write-skill/render-graphs.js +168 -0
  351. package/skills/utils/write-skill/testing-skills-with-subagents.md +384 -0
  352. package/src/commands/init.js +238 -0
@@ -0,0 +1,531 @@
1
+ """
2
+ Tests for repomix_batch.py
3
+
4
+ Run with: pytest test_repomix_batch.py -v --cov=repomix_batch --cov-report=term-missing
5
+ """
6
+
7
+ import os
8
+ import sys
9
+ import json
10
+ import subprocess
11
+ from pathlib import Path
12
+ from unittest.mock import Mock, patch, mock_open, MagicMock
13
+ import pytest
14
+
15
+ # Add parent directory to path to import the module
16
+ sys.path.insert(0, str(Path(__file__).parent.parent))
17
+
18
+ from repomix_batch import (
19
+ RepomixConfig,
20
+ EnvLoader,
21
+ RepomixBatchProcessor,
22
+ load_repositories_from_file,
23
+ main
24
+ )
25
+
26
+
27
+ class TestRepomixConfig:
28
+ """Test RepomixConfig dataclass."""
29
+
30
+ def test_default_values(self):
31
+ """Test default configuration values."""
32
+ config = RepomixConfig()
33
+ assert config.style == "xml"
34
+ assert config.output_dir == "repomix-output"
35
+ assert config.remove_comments is False
36
+ assert config.include_pattern is None
37
+ assert config.ignore_pattern is None
38
+ assert config.no_security_check is False
39
+ assert config.verbose is False
40
+
41
+ def test_custom_values(self):
42
+ """Test custom configuration values."""
43
+ config = RepomixConfig(
44
+ style="markdown",
45
+ output_dir="custom-output",
46
+ remove_comments=True,
47
+ include_pattern="src/**",
48
+ ignore_pattern="tests/**",
49
+ no_security_check=True,
50
+ verbose=True
51
+ )
52
+ assert config.style == "markdown"
53
+ assert config.output_dir == "custom-output"
54
+ assert config.remove_comments is True
55
+ assert config.include_pattern == "src/**"
56
+ assert config.ignore_pattern == "tests/**"
57
+ assert config.no_security_check is True
58
+ assert config.verbose is True
59
+
60
+
61
+ class TestEnvLoader:
62
+ """Test EnvLoader class."""
63
+
64
+ def test_parse_env_file_basic(self, tmp_path):
65
+ """Test parsing basic .env file."""
66
+ env_file = tmp_path / ".env"
67
+ env_file.write_text("KEY1=value1\nKEY2=value2\n")
68
+
69
+ result = EnvLoader._parse_env_file(env_file)
70
+ assert result == {"KEY1": "value1", "KEY2": "value2"}
71
+
72
+ def test_parse_env_file_with_quotes(self, tmp_path):
73
+ """Test parsing .env file with quoted values."""
74
+ env_file = tmp_path / ".env"
75
+ env_file.write_text('KEY1="value with spaces"\nKEY2=\'single quotes\'\n')
76
+
77
+ result = EnvLoader._parse_env_file(env_file)
78
+ assert result == {"KEY1": "value with spaces", "KEY2": "single quotes"}
79
+
80
+ def test_parse_env_file_with_comments(self, tmp_path):
81
+ """Test parsing .env file with comments."""
82
+ env_file = tmp_path / ".env"
83
+ env_file.write_text("# Comment\nKEY1=value1\n\n# Another comment\nKEY2=value2\n")
84
+
85
+ result = EnvLoader._parse_env_file(env_file)
86
+ assert result == {"KEY1": "value1", "KEY2": "value2"}
87
+
88
+ def test_parse_env_file_with_empty_lines(self, tmp_path):
89
+ """Test parsing .env file with empty lines."""
90
+ env_file = tmp_path / ".env"
91
+ env_file.write_text("KEY1=value1\n\n\nKEY2=value2\n")
92
+
93
+ result = EnvLoader._parse_env_file(env_file)
94
+ assert result == {"KEY1": "value1", "KEY2": "value2"}
95
+
96
+ def test_parse_env_file_with_equals_in_value(self, tmp_path):
97
+ """Test parsing .env file with equals sign in value."""
98
+ env_file = tmp_path / ".env"
99
+ env_file.write_text("KEY1=value=with=equals\n")
100
+
101
+ result = EnvLoader._parse_env_file(env_file)
102
+ assert result == {"KEY1": "value=with=equals"}
103
+
104
+ def test_parse_env_file_invalid(self, tmp_path):
105
+ """Test parsing invalid .env file."""
106
+ env_file = tmp_path / ".env"
107
+ env_file.write_text("INVALID LINE WITHOUT EQUALS\n")
108
+
109
+ result = EnvLoader._parse_env_file(env_file)
110
+ assert result == {}
111
+
112
+ def test_parse_env_file_not_found(self, tmp_path):
113
+ """Test parsing non-existent .env file."""
114
+ env_file = tmp_path / "nonexistent.env"
115
+ result = EnvLoader._parse_env_file(env_file)
116
+ assert result == {}
117
+
118
+ @patch.dict(os.environ, {"PROCESS_VAR": "from_process"}, clear=True)
119
+ def test_load_env_files_process_env_priority(self):
120
+ """Test that process environment has highest priority."""
121
+ with patch.object(Path, 'exists', return_value=False):
122
+ env_vars = EnvLoader.load_env_files()
123
+ assert env_vars.get("PROCESS_VAR") == "from_process"
124
+
125
+
126
+ class TestRepomixBatchProcessor:
127
+ """Test RepomixBatchProcessor class."""
128
+
129
+ def test_init(self):
130
+ """Test processor initialization."""
131
+ config = RepomixConfig()
132
+ processor = RepomixBatchProcessor(config)
133
+ assert processor.config == config
134
+ assert isinstance(processor.env_vars, dict)
135
+
136
+ @patch("subprocess.run")
137
+ def test_check_repomix_installed_success(self, mock_run):
138
+ """Test checking if repomix is installed (success)."""
139
+ mock_run.return_value = Mock(returncode=0)
140
+
141
+ config = RepomixConfig()
142
+ processor = RepomixBatchProcessor(config)
143
+ assert processor.check_repomix_installed() is True
144
+
145
+ mock_run.assert_called_once()
146
+ args = mock_run.call_args
147
+ assert args[0][0] == ["repomix", "--version"]
148
+
149
+ @patch("subprocess.run")
150
+ def test_check_repomix_installed_failure(self, mock_run):
151
+ """Test checking if repomix is installed (failure)."""
152
+ mock_run.return_value = Mock(returncode=1)
153
+
154
+ config = RepomixConfig()
155
+ processor = RepomixBatchProcessor(config)
156
+ assert processor.check_repomix_installed() is False
157
+
158
+ @patch("subprocess.run")
159
+ def test_check_repomix_installed_not_found(self, mock_run):
160
+ """Test checking if repomix is not found."""
161
+ mock_run.side_effect = FileNotFoundError()
162
+
163
+ config = RepomixConfig()
164
+ processor = RepomixBatchProcessor(config)
165
+ assert processor.check_repomix_installed() is False
166
+
167
+ def test_get_extension(self):
168
+ """Test getting file extension for style."""
169
+ assert RepomixBatchProcessor._get_extension("xml") == "xml"
170
+ assert RepomixBatchProcessor._get_extension("markdown") == "md"
171
+ assert RepomixBatchProcessor._get_extension("json") == "json"
172
+ assert RepomixBatchProcessor._get_extension("plain") == "txt"
173
+ assert RepomixBatchProcessor._get_extension("unknown") == "xml"
174
+
175
+ def test_build_command_local(self):
176
+ """Test building command for local repository."""
177
+ config = RepomixConfig(style="markdown", remove_comments=True)
178
+ processor = RepomixBatchProcessor(config)
179
+
180
+ output_file = Path("output.md")
181
+ cmd = processor._build_command("/path/to/repo", output_file, is_remote=False)
182
+
183
+ assert cmd[0] == "repomix"
184
+ assert "/path/to/repo" in cmd
185
+ assert "--style" in cmd
186
+ assert "markdown" in cmd
187
+ assert "--remove-comments" in cmd
188
+ assert "-o" in cmd
189
+
190
+ def test_build_command_remote(self):
191
+ """Test building command for remote repository."""
192
+ config = RepomixConfig()
193
+ processor = RepomixBatchProcessor(config)
194
+
195
+ output_file = Path("output.xml")
196
+ cmd = processor._build_command("owner/repo", output_file, is_remote=True)
197
+
198
+ assert cmd[0] == "npx"
199
+ assert "repomix" in cmd
200
+ assert "--remote" in cmd
201
+ assert "owner/repo" in cmd
202
+
203
+ def test_build_command_with_patterns(self):
204
+ """Test building command with include/ignore patterns."""
205
+ config = RepomixConfig(
206
+ include_pattern="src/**/*.ts",
207
+ ignore_pattern="tests/**"
208
+ )
209
+ processor = RepomixBatchProcessor(config)
210
+
211
+ output_file = Path("output.xml")
212
+ cmd = processor._build_command("/path/to/repo", output_file, is_remote=False)
213
+
214
+ assert "--include" in cmd
215
+ assert "src/**/*.ts" in cmd
216
+ assert "-i" in cmd
217
+ assert "tests/**" in cmd
218
+
219
+ def test_build_command_verbose(self):
220
+ """Test building command with verbose flag."""
221
+ config = RepomixConfig(verbose=True)
222
+ processor = RepomixBatchProcessor(config)
223
+
224
+ output_file = Path("output.xml")
225
+ cmd = processor._build_command("/path/to/repo", output_file, is_remote=False)
226
+
227
+ assert "--verbose" in cmd
228
+
229
+ def test_build_command_no_security_check(self):
230
+ """Test building command with security check disabled."""
231
+ config = RepomixConfig(no_security_check=True)
232
+ processor = RepomixBatchProcessor(config)
233
+
234
+ output_file = Path("output.xml")
235
+ cmd = processor._build_command("/path/to/repo", output_file, is_remote=False)
236
+
237
+ assert "--no-security-check" in cmd
238
+
239
+ @patch("subprocess.run")
240
+ @patch("pathlib.Path.mkdir")
241
+ def test_process_repository_success(self, mock_mkdir, mock_run):
242
+ """Test processing repository successfully."""
243
+ mock_run.return_value = Mock(returncode=0)
244
+
245
+ config = RepomixConfig()
246
+ processor = RepomixBatchProcessor(config)
247
+
248
+ success, message = processor.process_repository("/path/to/repo")
249
+
250
+ assert success is True
251
+ assert "Successfully processed" in message
252
+ mock_mkdir.assert_called_once()
253
+ mock_run.assert_called_once()
254
+
255
+ @patch("subprocess.run")
256
+ @patch("pathlib.Path.mkdir")
257
+ def test_process_repository_failure(self, mock_mkdir, mock_run):
258
+ """Test processing repository with failure."""
259
+ mock_run.return_value = Mock(
260
+ returncode=1,
261
+ stderr="Error message",
262
+ stdout=""
263
+ )
264
+
265
+ config = RepomixConfig()
266
+ processor = RepomixBatchProcessor(config)
267
+
268
+ success, message = processor.process_repository("/path/to/repo")
269
+
270
+ assert success is False
271
+ assert "Failed to process" in message
272
+ assert "Error message" in message
273
+
274
+ @patch("subprocess.run")
275
+ @patch("pathlib.Path.mkdir")
276
+ def test_process_repository_timeout(self, mock_mkdir, mock_run):
277
+ """Test processing repository with timeout."""
278
+ mock_run.side_effect = subprocess.TimeoutExpired(cmd=[], timeout=300)
279
+
280
+ config = RepomixConfig()
281
+ processor = RepomixBatchProcessor(config)
282
+
283
+ success, message = processor.process_repository("/path/to/repo")
284
+
285
+ assert success is False
286
+ assert "Timeout" in message
287
+
288
+ @patch("subprocess.run")
289
+ @patch("pathlib.Path.mkdir")
290
+ def test_process_repository_exception(self, mock_mkdir, mock_run):
291
+ """Test processing repository with exception."""
292
+ mock_run.side_effect = Exception("Unexpected error")
293
+
294
+ config = RepomixConfig()
295
+ processor = RepomixBatchProcessor(config)
296
+
297
+ success, message = processor.process_repository("/path/to/repo")
298
+
299
+ assert success is False
300
+ assert "Error processing" in message
301
+ assert "Unexpected error" in message
302
+
303
+ @patch("subprocess.run")
304
+ @patch("pathlib.Path.mkdir")
305
+ def test_process_repository_with_custom_output(self, mock_mkdir, mock_run):
306
+ """Test processing repository with custom output name."""
307
+ mock_run.return_value = Mock(returncode=0)
308
+
309
+ config = RepomixConfig()
310
+ processor = RepomixBatchProcessor(config)
311
+
312
+ success, message = processor.process_repository(
313
+ "/path/to/repo",
314
+ output_name="custom-output.xml"
315
+ )
316
+
317
+ assert success is True
318
+ assert "custom-output.xml" in message
319
+
320
+ @patch("subprocess.run")
321
+ @patch("pathlib.Path.mkdir")
322
+ def test_process_repository_remote(self, mock_mkdir, mock_run):
323
+ """Test processing remote repository."""
324
+ mock_run.return_value = Mock(returncode=0)
325
+
326
+ config = RepomixConfig()
327
+ processor = RepomixBatchProcessor(config)
328
+
329
+ success, message = processor.process_repository(
330
+ "owner/repo",
331
+ is_remote=True
332
+ )
333
+
334
+ assert success is True
335
+ cmd = mock_run.call_args[0][0]
336
+ assert "npx" in cmd
337
+ assert "--remote" in cmd
338
+
339
+ @patch.object(RepomixBatchProcessor, "process_repository")
340
+ def test_process_batch_success(self, mock_process):
341
+ """Test processing batch of repositories."""
342
+ mock_process.return_value = (True, "Success")
343
+
344
+ config = RepomixConfig()
345
+ processor = RepomixBatchProcessor(config)
346
+
347
+ repositories = [
348
+ {"path": "/repo1"},
349
+ {"path": "/repo2", "output": "custom.xml"},
350
+ {"path": "owner/repo", "remote": True}
351
+ ]
352
+
353
+ results = processor.process_batch(repositories)
354
+
355
+ assert len(results["success"]) == 3
356
+ assert len(results["failed"]) == 0
357
+ assert mock_process.call_count == 3
358
+
359
+ @patch.object(RepomixBatchProcessor, "process_repository")
360
+ def test_process_batch_with_failures(self, mock_process):
361
+ """Test processing batch with some failures."""
362
+ mock_process.side_effect = [
363
+ (True, "Success 1"),
364
+ (False, "Failed"),
365
+ (True, "Success 2")
366
+ ]
367
+
368
+ config = RepomixConfig()
369
+ processor = RepomixBatchProcessor(config)
370
+
371
+ repositories = [
372
+ {"path": "/repo1"},
373
+ {"path": "/repo2"},
374
+ {"path": "/repo3"}
375
+ ]
376
+
377
+ results = processor.process_batch(repositories)
378
+
379
+ assert len(results["success"]) == 2
380
+ assert len(results["failed"]) == 1
381
+
382
+ def test_process_batch_missing_path(self):
383
+ """Test processing batch with missing path."""
384
+ config = RepomixConfig()
385
+ processor = RepomixBatchProcessor(config)
386
+
387
+ repositories = [
388
+ {"output": "custom.xml"} # Missing 'path'
389
+ ]
390
+
391
+ results = processor.process_batch(repositories)
392
+
393
+ assert len(results["success"]) == 0
394
+ assert len(results["failed"]) == 1
395
+ assert "Missing 'path'" in results["failed"][0]
396
+
397
+
398
+ class TestLoadRepositoriesFromFile:
399
+ """Test load_repositories_from_file function."""
400
+
401
+ def test_load_valid_json(self, tmp_path):
402
+ """Test loading valid JSON file."""
403
+ json_file = tmp_path / "repos.json"
404
+ repos = [
405
+ {"path": "/repo1"},
406
+ {"path": "owner/repo", "remote": True}
407
+ ]
408
+ json_file.write_text(json.dumps(repos))
409
+
410
+ result = load_repositories_from_file(str(json_file))
411
+ assert result == repos
412
+
413
+ def test_load_invalid_json(self, tmp_path):
414
+ """Test loading invalid JSON file."""
415
+ json_file = tmp_path / "invalid.json"
416
+ json_file.write_text("not valid json {")
417
+
418
+ result = load_repositories_from_file(str(json_file))
419
+ assert result == []
420
+
421
+ def test_load_non_array_json(self, tmp_path):
422
+ """Test loading JSON file with non-array content."""
423
+ json_file = tmp_path / "object.json"
424
+ json_file.write_text('{"path": "/repo"}')
425
+
426
+ result = load_repositories_from_file(str(json_file))
427
+ assert result == []
428
+
429
+ def test_load_nonexistent_file(self):
430
+ """Test loading non-existent file."""
431
+ result = load_repositories_from_file("/nonexistent/file.json")
432
+ assert result == []
433
+
434
+
435
+ class TestMain:
436
+ """Test main function."""
437
+
438
+ @patch("sys.argv", ["repomix_batch.py", "/repo1", "/repo2"])
439
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=True)
440
+ @patch.object(RepomixBatchProcessor, "process_batch")
441
+ def test_main_with_repos(self, mock_process_batch, mock_check):
442
+ """Test main function with repository arguments."""
443
+ mock_process_batch.return_value = {"success": ["msg1", "msg2"], "failed": []}
444
+
445
+ result = main()
446
+
447
+ assert result == 0
448
+ mock_check.assert_called_once()
449
+ mock_process_batch.assert_called_once()
450
+
451
+ # Verify repositories passed
452
+ call_args = mock_process_batch.call_args[0][0]
453
+ assert len(call_args) == 2
454
+ assert call_args[0]["path"] == "/repo1"
455
+ assert call_args[1]["path"] == "/repo2"
456
+
457
+ @patch("sys.argv", ["repomix_batch.py", "-f", "repos.json"])
458
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=True)
459
+ @patch.object(RepomixBatchProcessor, "process_batch")
460
+ @patch("repomix_batch.load_repositories_from_file")
461
+ def test_main_with_file(self, mock_load, mock_process_batch, mock_check):
462
+ """Test main function with file argument."""
463
+ mock_load.return_value = [{"path": "/repo1"}]
464
+ mock_process_batch.return_value = {"success": ["msg1"], "failed": []}
465
+
466
+ result = main()
467
+
468
+ assert result == 0
469
+ mock_load.assert_called_once_with("repos.json")
470
+ mock_process_batch.assert_called_once()
471
+
472
+ @patch("sys.argv", ["repomix_batch.py"])
473
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=True)
474
+ def test_main_no_repos(self, mock_check):
475
+ """Test main function with no repositories."""
476
+ result = main()
477
+ assert result == 1
478
+
479
+ @patch("sys.argv", ["repomix_batch.py", "/repo1"])
480
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=False)
481
+ def test_main_repomix_not_installed(self, mock_check):
482
+ """Test main function when repomix is not installed."""
483
+ result = main()
484
+ assert result == 1
485
+
486
+ @patch("sys.argv", ["repomix_batch.py", "/repo1"])
487
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=True)
488
+ @patch.object(RepomixBatchProcessor, "process_batch")
489
+ def test_main_with_failures(self, mock_process_batch, mock_check):
490
+ """Test main function with processing failures."""
491
+ mock_process_batch.return_value = {
492
+ "success": ["msg1"],
493
+ "failed": ["error1"]
494
+ }
495
+
496
+ result = main()
497
+ assert result == 1
498
+
499
+ @patch("sys.argv", [
500
+ "repomix_batch.py",
501
+ "/repo1",
502
+ "--style", "markdown",
503
+ "--remove-comments",
504
+ "--verbose"
505
+ ])
506
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=True)
507
+ @patch.object(RepomixBatchProcessor, "process_batch")
508
+ def test_main_with_options(self, mock_process_batch, mock_check):
509
+ """Test main function with various options."""
510
+ mock_process_batch.return_value = {"success": ["msg1"], "failed": []}
511
+
512
+ result = main()
513
+ assert result == 0
514
+
515
+ # Verify config passed to processor
516
+ # The processor is created inside main, so we check it was called
517
+ mock_process_batch.assert_called_once()
518
+
519
+ @patch("sys.argv", ["repomix_batch.py", "/repo1", "--remote"])
520
+ @patch.object(RepomixBatchProcessor, "check_repomix_installed", return_value=True)
521
+ @patch.object(RepomixBatchProcessor, "process_batch")
522
+ def test_main_with_remote_flag(self, mock_process_batch, mock_check):
523
+ """Test main function with --remote flag."""
524
+ mock_process_batch.return_value = {"success": ["msg1"], "failed": []}
525
+
526
+ result = main()
527
+ assert result == 0
528
+
529
+ # Verify remote flag is set
530
+ call_args = mock_process_batch.call_args[0][0]
531
+ assert call_args[0]["remote"] is True