@shakudo/kaji-setup-external 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 (411) hide show
  1. package/README.md +155 -0
  2. package/assets/skills/ci-cd/.claude-plugin/plugin.json +8 -0
  3. package/assets/skills/ci-cd/SKILL.md +573 -0
  4. package/assets/skills/ci-cd/assets/templates/github-actions/docker-build.yml +164 -0
  5. package/assets/skills/ci-cd/assets/templates/github-actions/go-ci.yml +420 -0
  6. package/assets/skills/ci-cd/assets/templates/github-actions/node-ci.yml +313 -0
  7. package/assets/skills/ci-cd/assets/templates/github-actions/python-ci.yml +388 -0
  8. package/assets/skills/ci-cd/assets/templates/github-actions/security-scan.yml +416 -0
  9. package/assets/skills/ci-cd/assets/templates/gitlab-ci/docker-build.yml +298 -0
  10. package/assets/skills/ci-cd/assets/templates/gitlab-ci/go-ci.yml +548 -0
  11. package/assets/skills/ci-cd/assets/templates/gitlab-ci/node-ci.yml +334 -0
  12. package/assets/skills/ci-cd/assets/templates/gitlab-ci/python-ci.yml +472 -0
  13. package/assets/skills/ci-cd/assets/templates/gitlab-ci/security-scan.yml +479 -0
  14. package/assets/skills/ci-cd/references/best_practices.md +675 -0
  15. package/assets/skills/ci-cd/references/devsecops.md +862 -0
  16. package/assets/skills/ci-cd/references/optimization.md +651 -0
  17. package/assets/skills/ci-cd/references/security.md +611 -0
  18. package/assets/skills/ci-cd/references/troubleshooting.md +656 -0
  19. package/assets/skills/ci-cd/scripts/ci_health.py +301 -0
  20. package/assets/skills/ci-cd/scripts/pipeline_analyzer.py +440 -0
  21. package/assets/skills/context-optimization/CONTRIBUTING.md +78 -0
  22. package/assets/skills/context-optimization/LICENSE +22 -0
  23. package/assets/skills/context-optimization/README.md +228 -0
  24. package/assets/skills/context-optimization/SKILL.md +104 -0
  25. package/assets/skills/context-optimization/docs/agentskills.md +1264 -0
  26. package/assets/skills/context-optimization/docs/blogs.md +1230 -0
  27. package/assets/skills/context-optimization/docs/claude_research.md +85 -0
  28. package/assets/skills/context-optimization/docs/compression.md +298 -0
  29. package/assets/skills/context-optimization/docs/gemini_research.md +22 -0
  30. package/assets/skills/context-optimization/docs/hncapsule.md +92 -0
  31. package/assets/skills/context-optimization/docs/netflix_context.md +10 -0
  32. package/assets/skills/context-optimization/docs/vercel_tool.md +140 -0
  33. package/assets/skills/context-optimization/examples/book-sft-pipeline/README.md +78 -0
  34. package/assets/skills/context-optimization/examples/book-sft-pipeline/SKILL.md +380 -0
  35. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/README.md +168 -0
  36. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/dataset_sample.jsonl +5 -0
  37. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/pangram/Screenshot 2025-12-27 at 3.05.04/342/200/257AM.png +0 -0
  38. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/pangram/Screenshot 2025-12-27 at 3.05.36/342/200/257AM.png +0 -0
  39. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/pangram/Screenshot 2025-12-27 at 3.07.18/342/200/257AM.png +0 -0
  40. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/sample_outputs.md +63 -0
  41. package/assets/skills/context-optimization/examples/book-sft-pipeline/examples/gertrude-stein/training_config.json +80 -0
  42. package/assets/skills/context-optimization/examples/book-sft-pipeline/references/segmentation-strategies.md +324 -0
  43. package/assets/skills/context-optimization/examples/book-sft-pipeline/references/tinker-format.md +211 -0
  44. package/assets/skills/context-optimization/examples/book-sft-pipeline/references/tinker.txt +3176 -0
  45. package/assets/skills/context-optimization/examples/book-sft-pipeline/scripts/pipeline_example.py +187 -0
  46. package/assets/skills/context-optimization/examples/digital-brain-skill/AGENT.md +35 -0
  47. package/assets/skills/context-optimization/examples/digital-brain-skill/HOW-SKILLS-BUILT-THIS.md +407 -0
  48. package/assets/skills/context-optimization/examples/digital-brain-skill/README.md +209 -0
  49. package/assets/skills/context-optimization/examples/digital-brain-skill/SKILL.md +203 -0
  50. package/assets/skills/context-optimization/examples/digital-brain-skill/SKILLS-MAPPING.md +219 -0
  51. package/assets/skills/context-optimization/examples/digital-brain-skill/agents/AGENTS.md +82 -0
  52. package/assets/skills/context-optimization/examples/digital-brain-skill/agents/scripts/content_ideas.py +132 -0
  53. package/assets/skills/context-optimization/examples/digital-brain-skill/agents/scripts/idea_to_draft.py +181 -0
  54. package/assets/skills/context-optimization/examples/digital-brain-skill/agents/scripts/stale_contacts.py +139 -0
  55. package/assets/skills/context-optimization/examples/digital-brain-skill/agents/scripts/weekly_review.py +121 -0
  56. package/assets/skills/context-optimization/examples/digital-brain-skill/content/CONTENT.md +88 -0
  57. package/assets/skills/context-optimization/examples/digital-brain-skill/content/calendar.md +108 -0
  58. package/assets/skills/context-optimization/examples/digital-brain-skill/content/engagement.jsonl +2 -0
  59. package/assets/skills/context-optimization/examples/digital-brain-skill/content/ideas.jsonl +2 -0
  60. package/assets/skills/context-optimization/examples/digital-brain-skill/content/posts.jsonl +2 -0
  61. package/assets/skills/context-optimization/examples/digital-brain-skill/content/templates/linkedin-post.md +102 -0
  62. package/assets/skills/context-optimization/examples/digital-brain-skill/content/templates/newsletter.md +92 -0
  63. package/assets/skills/context-optimization/examples/digital-brain-skill/content/templates/thread.md +73 -0
  64. package/assets/skills/context-optimization/examples/digital-brain-skill/examples/content-workflow.md +204 -0
  65. package/assets/skills/context-optimization/examples/digital-brain-skill/examples/meeting-prep.md +243 -0
  66. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/IDENTITY.md +46 -0
  67. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/bio-variants.md +101 -0
  68. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/brand.md +165 -0
  69. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/prompts/content-generation.xml +46 -0
  70. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/prompts/reply-generator.xml +40 -0
  71. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/values.yaml +60 -0
  72. package/assets/skills/context-optimization/examples/digital-brain-skill/identity/voice.md +165 -0
  73. package/assets/skills/context-optimization/examples/digital-brain-skill/knowledge/KNOWLEDGE.md +85 -0
  74. package/assets/skills/context-optimization/examples/digital-brain-skill/knowledge/bookmarks.jsonl +2 -0
  75. package/assets/skills/context-optimization/examples/digital-brain-skill/knowledge/competitors.md +117 -0
  76. package/assets/skills/context-optimization/examples/digital-brain-skill/knowledge/learning.yaml +74 -0
  77. package/assets/skills/context-optimization/examples/digital-brain-skill/knowledge/research/_template.md +79 -0
  78. package/assets/skills/context-optimization/examples/digital-brain-skill/network/NETWORK.md +110 -0
  79. package/assets/skills/context-optimization/examples/digital-brain-skill/network/circles.yaml +80 -0
  80. package/assets/skills/context-optimization/examples/digital-brain-skill/network/contacts.jsonl +2 -0
  81. package/assets/skills/context-optimization/examples/digital-brain-skill/network/interactions.jsonl +2 -0
  82. package/assets/skills/context-optimization/examples/digital-brain-skill/network/intros.md +92 -0
  83. package/assets/skills/context-optimization/examples/digital-brain-skill/operations/OPERATIONS.md +75 -0
  84. package/assets/skills/context-optimization/examples/digital-brain-skill/operations/goals.yaml +83 -0
  85. package/assets/skills/context-optimization/examples/digital-brain-skill/operations/meetings.jsonl +2 -0
  86. package/assets/skills/context-optimization/examples/digital-brain-skill/operations/metrics.jsonl +2 -0
  87. package/assets/skills/context-optimization/examples/digital-brain-skill/operations/reviews/_weekly_template.md +114 -0
  88. package/assets/skills/context-optimization/examples/digital-brain-skill/operations/todos.md +76 -0
  89. package/assets/skills/context-optimization/examples/digital-brain-skill/package.json +41 -0
  90. package/assets/skills/context-optimization/examples/digital-brain-skill/references/file-formats.md +386 -0
  91. package/assets/skills/context-optimization/examples/digital-brain-skill/scripts/install.sh +79 -0
  92. package/assets/skills/context-optimization/examples/interleaved_thinking/README.md +620 -0
  93. package/assets/skills/context-optimization/examples/interleaved_thinking/SKILL.md +221 -0
  94. package/assets/skills/context-optimization/examples/interleaved_thinking/docs/agentthinking.md +63 -0
  95. package/assets/skills/context-optimization/examples/interleaved_thinking/docs/interleavedthinking.md +610 -0
  96. package/assets/skills/context-optimization/examples/interleaved_thinking/docs/m2-1.md +224 -0
  97. package/assets/skills/context-optimization/examples/interleaved_thinking/examples/01_basic_capture.py +76 -0
  98. package/assets/skills/context-optimization/examples/interleaved_thinking/examples/02_tool_usage.py +187 -0
  99. package/assets/skills/context-optimization/examples/interleaved_thinking/examples/03_full_optimization.py +1222 -0
  100. package/assets/skills/context-optimization/examples/interleaved_thinking/generated_skills/comprehensive-research-agent/SKILL.md +90 -0
  101. package/assets/skills/context-optimization/examples/interleaved_thinking/generated_skills/comprehensive-research-agent/references/optimization_summary.json +9 -0
  102. package/assets/skills/context-optimization/examples/interleaved_thinking/generated_skills/comprehensive-research-agent/references/optimized_prompt.txt +1 -0
  103. package/assets/skills/context-optimization/examples/interleaved_thinking/generated_skills/comprehensive-research-agent/references/patterns_found.json +205 -0
  104. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/final_prompt.txt +67 -0
  105. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_1/analysis.txt +48 -0
  106. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_1/optimization.txt +15 -0
  107. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_1/optimized_prompt.txt +1 -0
  108. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_1/trace.txt +178 -0
  109. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_10/analysis.txt +47 -0
  110. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_10/trace.txt +162 -0
  111. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_2/analysis.txt +48 -0
  112. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_2/optimization.txt +130 -0
  113. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_2/optimized_prompt.txt +72 -0
  114. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_2/trace.txt +156 -0
  115. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_3/analysis.txt +46 -0
  116. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_3/optimization.txt +147 -0
  117. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_3/optimized_prompt.txt +84 -0
  118. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_3/trace.txt +159 -0
  119. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_4/analysis.txt +46 -0
  120. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_4/optimization.txt +134 -0
  121. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_4/optimized_prompt.txt +67 -0
  122. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_4/trace.txt +165 -0
  123. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_5/analysis.txt +50 -0
  124. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_5/optimization.txt +135 -0
  125. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_5/optimized_prompt.txt +71 -0
  126. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_5/trace.txt +146 -0
  127. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_6/analysis.txt +15 -0
  128. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_6/optimization.txt +15 -0
  129. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_6/optimized_prompt.txt +1 -0
  130. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_6/trace.txt +147 -0
  131. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_7/analysis.txt +46 -0
  132. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_7/optimization.txt +103 -0
  133. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_7/optimized_prompt.txt +45 -0
  134. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_7/trace.txt +134 -0
  135. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_8/analysis.txt +47 -0
  136. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_8/optimization.txt +114 -0
  137. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_8/optimized_prompt.txt +60 -0
  138. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_8/trace.txt +135 -0
  139. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_9/analysis.txt +44 -0
  140. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_9/optimization.txt +106 -0
  141. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_9/optimized_prompt.txt +51 -0
  142. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/iteration_9/trace.txt +170 -0
  143. package/assets/skills/context-optimization/examples/interleaved_thinking/optimization_artifacts/summary.json +11 -0
  144. package/assets/skills/context-optimization/examples/interleaved_thinking/pyproject.toml +70 -0
  145. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/__init__.py +53 -0
  146. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/analyzer.py +465 -0
  147. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/capture.py +417 -0
  148. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/cli.py +271 -0
  149. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/loop.py +468 -0
  150. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/models.py +193 -0
  151. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/optimizer.py +449 -0
  152. package/assets/skills/context-optimization/examples/interleaved_thinking/reasoning_trace_optimizer/skill_generator.py +502 -0
  153. package/assets/skills/context-optimization/examples/interleaved_thinking/tests/__init__.py +1 -0
  154. package/assets/skills/context-optimization/examples/interleaved_thinking/tests/test_models.py +144 -0
  155. package/assets/skills/context-optimization/examples/llm-as-judge-skills/.prettierrc +8 -0
  156. package/assets/skills/context-optimization/examples/llm-as-judge-skills/CONTRIBUTING.md +78 -0
  157. package/assets/skills/context-optimization/examples/llm-as-judge-skills/LICENSE +21 -0
  158. package/assets/skills/context-optimization/examples/llm-as-judge-skills/README.md +659 -0
  159. package/assets/skills/context-optimization/examples/llm-as-judge-skills/agents/evaluator-agent/evaluator-agent.md +177 -0
  160. package/assets/skills/context-optimization/examples/llm-as-judge-skills/agents/index.md +114 -0
  161. package/assets/skills/context-optimization/examples/llm-as-judge-skills/agents/orchestrator-agent/orchestrator-agent.md +205 -0
  162. package/assets/skills/context-optimization/examples/llm-as-judge-skills/agents/research-agent/research-agent.md +183 -0
  163. package/assets/skills/context-optimization/examples/llm-as-judge-skills/env.example +6 -0
  164. package/assets/skills/context-optimization/examples/llm-as-judge-skills/eslint.config.js +18 -0
  165. package/assets/skills/context-optimization/examples/llm-as-judge-skills/examples/basic-evaluation.ts +89 -0
  166. package/assets/skills/context-optimization/examples/llm-as-judge-skills/examples/full-evaluation-workflow.ts +136 -0
  167. package/assets/skills/context-optimization/examples/llm-as-judge-skills/examples/generate-rubric.ts +67 -0
  168. package/assets/skills/context-optimization/examples/llm-as-judge-skills/examples/pairwise-comparison.ts +97 -0
  169. package/assets/skills/context-optimization/examples/llm-as-judge-skills/package.json +79 -0
  170. package/assets/skills/context-optimization/examples/llm-as-judge-skills/prompts/agent-system/orchestrator-prompt.md +197 -0
  171. package/assets/skills/context-optimization/examples/llm-as-judge-skills/prompts/evaluation/direct-scoring-prompt.md +153 -0
  172. package/assets/skills/context-optimization/examples/llm-as-judge-skills/prompts/evaluation/pairwise-comparison-prompt.md +200 -0
  173. package/assets/skills/context-optimization/examples/llm-as-judge-skills/prompts/index.md +138 -0
  174. package/assets/skills/context-optimization/examples/llm-as-judge-skills/prompts/research/research-synthesis-prompt.md +171 -0
  175. package/assets/skills/context-optimization/examples/llm-as-judge-skills/skills/context-fundamentals/context-fundamentals.md +114 -0
  176. package/assets/skills/context-optimization/examples/llm-as-judge-skills/skills/index.md +79 -0
  177. package/assets/skills/context-optimization/examples/llm-as-judge-skills/skills/llm-evaluator/llm-evaluator.md +77 -0
  178. package/assets/skills/context-optimization/examples/llm-as-judge-skills/skills/tool-design/tool-design.md +198 -0
  179. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/agents/evaluator.ts +112 -0
  180. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/agents/index.ts +3 -0
  181. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/config/index.ts +18 -0
  182. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/index.ts +19 -0
  183. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/tools/evaluation/direct-score.ts +164 -0
  184. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/tools/evaluation/generate-rubric.ts +161 -0
  185. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/tools/evaluation/index.ts +9 -0
  186. package/assets/skills/context-optimization/examples/llm-as-judge-skills/src/tools/evaluation/pairwise-compare.ts +255 -0
  187. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tests/evaluation.test.ts +233 -0
  188. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tests/setup.ts +27 -0
  189. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tests/skills.test.ts +213 -0
  190. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/evaluation/direct-score.md +159 -0
  191. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/evaluation/generate-rubric.md +189 -0
  192. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/evaluation/pairwise-compare.md +182 -0
  193. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/index.md +141 -0
  194. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/orchestration/delegate-to-agent.md +171 -0
  195. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/research/read-url.md +162 -0
  196. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tools/research/web-search.md +128 -0
  197. package/assets/skills/context-optimization/examples/llm-as-judge-skills/tsconfig.json +26 -0
  198. package/assets/skills/context-optimization/examples/llm-as-judge-skills/vitest.config.ts +20 -0
  199. package/assets/skills/context-optimization/examples/x-to-book-system/PRD.md +644 -0
  200. package/assets/skills/context-optimization/examples/x-to-book-system/README.md +181 -0
  201. package/assets/skills/context-optimization/examples/x-to-book-system/SKILLS-MAPPING.md +187 -0
  202. package/assets/skills/context-optimization/researcher/example_output.md +75 -0
  203. package/assets/skills/context-optimization/researcher/llm-as-a-judge.md +362 -0
  204. package/assets/skills/context-optimization/skills/advanced-evaluation/SKILL.md +454 -0
  205. package/assets/skills/context-optimization/skills/advanced-evaluation/references/bias-mitigation.md +288 -0
  206. package/assets/skills/context-optimization/skills/advanced-evaluation/references/implementation-patterns.md +315 -0
  207. package/assets/skills/context-optimization/skills/advanced-evaluation/references/metrics-guide.md +331 -0
  208. package/assets/skills/context-optimization/skills/advanced-evaluation/scripts/evaluation_example.py +337 -0
  209. package/assets/skills/context-optimization/skills/bdi-mental-states/SKILL.md +295 -0
  210. package/assets/skills/context-optimization/skills/bdi-mental-states/references/bdi-ontology-core.md +207 -0
  211. package/assets/skills/context-optimization/skills/bdi-mental-states/references/framework-integration.md +582 -0
  212. package/assets/skills/context-optimization/skills/bdi-mental-states/references/rdf-examples.md +315 -0
  213. package/assets/skills/context-optimization/skills/bdi-mental-states/references/sparql-competency.md +420 -0
  214. package/assets/skills/context-optimization/skills/context-compression/SKILL.md +265 -0
  215. package/assets/skills/context-optimization/skills/context-compression/references/evaluation-framework.md +213 -0
  216. package/assets/skills/context-optimization/skills/context-compression/scripts/compression_evaluator.py +658 -0
  217. package/assets/skills/context-optimization/skills/context-degradation/SKILL.md +231 -0
  218. package/assets/skills/context-optimization/skills/context-degradation/references/patterns.md +314 -0
  219. package/assets/skills/context-optimization/skills/context-degradation/scripts/degradation_detector.py +419 -0
  220. package/assets/skills/context-optimization/skills/context-fundamentals/SKILL.md +185 -0
  221. package/assets/skills/context-optimization/skills/context-fundamentals/references/context-components.md +283 -0
  222. package/assets/skills/context-optimization/skills/context-fundamentals/scripts/context_manager.py +370 -0
  223. package/assets/skills/context-optimization/skills/context-optimization/SKILL.md +179 -0
  224. package/assets/skills/context-optimization/skills/context-optimization/references/optimization_techniques.md +272 -0
  225. package/assets/skills/context-optimization/skills/context-optimization/scripts/compaction.py +379 -0
  226. package/assets/skills/context-optimization/skills/evaluation/SKILL.md +231 -0
  227. package/assets/skills/context-optimization/skills/evaluation/references/metrics.md +339 -0
  228. package/assets/skills/context-optimization/skills/evaluation/scripts/evaluator.py +474 -0
  229. package/assets/skills/context-optimization/skills/filesystem-context/SKILL.md +321 -0
  230. package/assets/skills/context-optimization/skills/filesystem-context/references/implementation-patterns.md +549 -0
  231. package/assets/skills/context-optimization/skills/filesystem-context/scripts/filesystem_context.py +353 -0
  232. package/assets/skills/context-optimization/skills/hosted-agents/SKILL.md +279 -0
  233. package/assets/skills/context-optimization/skills/hosted-agents/references/infrastructure-patterns.md +700 -0
  234. package/assets/skills/context-optimization/skills/hosted-agents/scripts/sandbox_manager.py +495 -0
  235. package/assets/skills/context-optimization/skills/memory-systems/SKILL.md +221 -0
  236. package/assets/skills/context-optimization/skills/memory-systems/references/implementation.md +458 -0
  237. package/assets/skills/context-optimization/skills/memory-systems/scripts/memory_store.py +396 -0
  238. package/assets/skills/context-optimization/skills/multi-agent-patterns/SKILL.md +255 -0
  239. package/assets/skills/context-optimization/skills/multi-agent-patterns/references/frameworks.md +433 -0
  240. package/assets/skills/context-optimization/skills/multi-agent-patterns/scripts/coordination.py +439 -0
  241. package/assets/skills/context-optimization/skills/project-development/SKILL.md +342 -0
  242. package/assets/skills/context-optimization/skills/project-development/references/case-studies.md +388 -0
  243. package/assets/skills/context-optimization/skills/project-development/references/pipeline-patterns.md +610 -0
  244. package/assets/skills/context-optimization/skills/project-development/scripts/pipeline_template.py +677 -0
  245. package/assets/skills/context-optimization/skills/tool-design/SKILL.md +311 -0
  246. package/assets/skills/context-optimization/skills/tool-design/references/architectural_reduction.md +210 -0
  247. package/assets/skills/context-optimization/skills/tool-design/references/best_practices.md +176 -0
  248. package/assets/skills/context-optimization/skills/tool-design/scripts/description_generator.py +237 -0
  249. package/assets/skills/context-optimization/template/SKILL.md +98 -0
  250. package/assets/skills/dremio-analytics/SKILL.md +287 -0
  251. package/assets/skills/elevenlabs-voice/SKILL.md +269 -0
  252. package/assets/skills/git-workflow/SKILL.md +266 -0
  253. package/assets/skills/gitops-workflows/.claude-plugin/plugin.json +8 -0
  254. package/assets/skills/gitops-workflows/SKILL.md +568 -0
  255. package/assets/skills/gitops-workflows/assets/applicationsets/cluster-generator.yaml +32 -0
  256. package/assets/skills/gitops-workflows/assets/argocd/install-argocd-3.x.yaml +92 -0
  257. package/assets/skills/gitops-workflows/assets/flux/flux-bootstrap-github.sh +49 -0
  258. package/assets/skills/gitops-workflows/assets/flux/oci-helmrelease.yaml +38 -0
  259. package/assets/skills/gitops-workflows/assets/progressive-delivery/argo-rollouts-canary.yaml +62 -0
  260. package/assets/skills/gitops-workflows/assets/secrets/sops-age-config.yaml +33 -0
  261. package/assets/skills/gitops-workflows/references/argocd_vs_flux.md +243 -0
  262. package/assets/skills/gitops-workflows/references/best_practices.md +160 -0
  263. package/assets/skills/gitops-workflows/references/multi_cluster.md +80 -0
  264. package/assets/skills/gitops-workflows/references/oci_artifacts.md +290 -0
  265. package/assets/skills/gitops-workflows/references/progressive_delivery.md +94 -0
  266. package/assets/skills/gitops-workflows/references/repo_patterns.md +184 -0
  267. package/assets/skills/gitops-workflows/references/secret_management.md +213 -0
  268. package/assets/skills/gitops-workflows/references/troubleshooting.md +134 -0
  269. package/assets/skills/gitops-workflows/scripts/applicationset_generator.py +156 -0
  270. package/assets/skills/gitops-workflows/scripts/check_argocd_health.py +275 -0
  271. package/assets/skills/gitops-workflows/scripts/check_flux_health.py +418 -0
  272. package/assets/skills/gitops-workflows/scripts/oci_artifact_checker.py +150 -0
  273. package/assets/skills/gitops-workflows/scripts/promotion_validator.py +88 -0
  274. package/assets/skills/gitops-workflows/scripts/secret_audit.py +178 -0
  275. package/assets/skills/gitops-workflows/scripts/sync_drift_detector.py +144 -0
  276. package/assets/skills/gitops-workflows/scripts/validate_gitops_repo.py +299 -0
  277. package/assets/skills/iac-terraform/.claude-plugin/plugin.json +8 -0
  278. package/assets/skills/iac-terraform/SKILL.md +653 -0
  279. package/assets/skills/iac-terraform/assets/templates/MODULE_TEMPLATE.md +386 -0
  280. package/assets/skills/iac-terraform/assets/workflows/github-actions-terraform.yml +224 -0
  281. package/assets/skills/iac-terraform/assets/workflows/github-actions-terragrunt.yml +236 -0
  282. package/assets/skills/iac-terraform/assets/workflows/gitlab-ci-terraform.yml +184 -0
  283. package/assets/skills/iac-terraform/references/best_practices.md +709 -0
  284. package/assets/skills/iac-terraform/references/cost_optimization.md +665 -0
  285. package/assets/skills/iac-terraform/references/troubleshooting.md +635 -0
  286. package/assets/skills/iac-terraform/scripts/init_module.py +319 -0
  287. package/assets/skills/iac-terraform/scripts/inspect_state.py +232 -0
  288. package/assets/skills/iac-terraform/scripts/validate_module.py +227 -0
  289. package/assets/skills/k8s-troubleshooter/.claude-plugin/plugin.json +8 -0
  290. package/assets/skills/k8s-troubleshooter/SKILL.md +336 -0
  291. package/assets/skills/k8s-troubleshooter/references/common_issues.md +582 -0
  292. package/assets/skills/k8s-troubleshooter/references/helm_troubleshooting.md +708 -0
  293. package/assets/skills/k8s-troubleshooter/references/incident_response.md +466 -0
  294. package/assets/skills/k8s-troubleshooter/references/performance_troubleshooting.md +687 -0
  295. package/assets/skills/k8s-troubleshooter/scripts/check_namespace.py +500 -0
  296. package/assets/skills/k8s-troubleshooter/scripts/cluster_health.py +223 -0
  297. package/assets/skills/k8s-troubleshooter/scripts/diagnose_pod.py +157 -0
  298. package/assets/skills/mattermost-notify/SKILL.md +248 -0
  299. package/assets/skills/monitoring-observability/SKILL.md +869 -0
  300. package/assets/skills/monitoring-observability/assets/templates/otel-config/collector-config.yaml +227 -0
  301. package/assets/skills/monitoring-observability/assets/templates/prometheus-alerts/kubernetes-alerts.yml +293 -0
  302. package/assets/skills/monitoring-observability/assets/templates/prometheus-alerts/webapp-alerts.yml +243 -0
  303. package/assets/skills/monitoring-observability/assets/templates/runbooks/incident-runbook-template.md +409 -0
  304. package/assets/skills/monitoring-observability/monitoring-observability.skill +0 -0
  305. package/assets/skills/monitoring-observability/references/alerting_best_practices.md +609 -0
  306. package/assets/skills/monitoring-observability/references/datadog_migration.md +649 -0
  307. package/assets/skills/monitoring-observability/references/dql_promql_translation.md +756 -0
  308. package/assets/skills/monitoring-observability/references/logging_guide.md +775 -0
  309. package/assets/skills/monitoring-observability/references/metrics_design.md +406 -0
  310. package/assets/skills/monitoring-observability/references/slo_sla_guide.md +652 -0
  311. package/assets/skills/monitoring-observability/references/tool_comparison.md +697 -0
  312. package/assets/skills/monitoring-observability/references/tracing_guide.md +663 -0
  313. package/assets/skills/monitoring-observability/scripts/alert_quality_checker.py +315 -0
  314. package/assets/skills/monitoring-observability/scripts/analyze_metrics.py +279 -0
  315. package/assets/skills/monitoring-observability/scripts/dashboard_generator.py +395 -0
  316. package/assets/skills/monitoring-observability/scripts/datadog_cost_analyzer.py +477 -0
  317. package/assets/skills/monitoring-observability/scripts/health_check_validator.py +297 -0
  318. package/assets/skills/monitoring-observability/scripts/log_analyzer.py +321 -0
  319. package/assets/skills/monitoring-observability/scripts/slo_calculator.py +365 -0
  320. package/assets/skills/neo4j-graph-rag/SKILL.md +258 -0
  321. package/assets/skills/pagerduty-ops/SKILL.md +380 -0
  322. package/assets/skills/playwright/API_REFERENCE.md +653 -0
  323. package/assets/skills/playwright/SKILL.md +453 -0
  324. package/assets/skills/playwright/lib/helpers.js +441 -0
  325. package/assets/skills/playwright/package.json +26 -0
  326. package/assets/skills/playwright/run.js +228 -0
  327. package/assets/skills/project-memory/README.md +687 -0
  328. package/assets/skills/project-memory/SKILL.md +298 -0
  329. package/assets/skills/project-memory/references/bugs_template.md +41 -0
  330. package/assets/skills/project-memory/references/decisions_template.md +92 -0
  331. package/assets/skills/project-memory/references/issues_template.md +76 -0
  332. package/assets/skills/project-memory/references/key_facts_template.md +158 -0
  333. package/assets/skills/recruit-workflow/SKILL.md +276 -0
  334. package/assets/skills/recruit-workflow/references/email-templates.md +347 -0
  335. package/assets/skills/recruit-workflow/references/workflow-stages.md +395 -0
  336. package/assets/skills/recruit-workflow/scripts/clay_client.py +188 -0
  337. package/assets/skills/recruit-workflow/scripts/lever_client.py +197 -0
  338. package/assets/skills/recruit-workflow/scripts/mailgun_client.py +245 -0
  339. package/assets/skills/recruit-workflow/scripts/minio_client.py +426 -0
  340. package/assets/skills/shakudo-microservice/SKILL.md +215 -0
  341. package/assets/skills/tmux/SKILL.md +631 -0
  342. package/assets/skills/tmux/references/direct-socket-control.md +108 -0
  343. package/assets/skills/tmux/references/session-lifecycle.md +503 -0
  344. package/assets/skills/tmux/references/session-registry.md +1484 -0
  345. package/assets/skills/tmux/tools/cleanup-sessions.sh +263 -0
  346. package/assets/skills/tmux/tools/create-session.sh +224 -0
  347. package/assets/skills/tmux/tools/find-sessions.sh +262 -0
  348. package/assets/skills/tmux/tools/kill-session.sh +308 -0
  349. package/assets/skills/tmux/tools/lib/registry.sh +437 -0
  350. package/assets/skills/tmux/tools/lib/time_utils.sh +54 -0
  351. package/assets/skills/tmux/tools/list-sessions.sh +255 -0
  352. package/assets/skills/tmux/tools/pane-health.sh +424 -0
  353. package/assets/skills/tmux/tools/safe-send.sh +503 -0
  354. package/assets/skills/tmux/tools/wait-for-text.sh +260 -0
  355. package/assets/skills/twilio-sms/SKILL.md +508 -0
  356. package/assets/skills/zellij/SKILL.md +274 -0
  357. package/assets/skills/zellij/references/actions.md +558 -0
  358. package/assets/skills/zellij/references/layouts.md +424 -0
  359. package/bin/cli.ts +46 -0
  360. package/package.json +43 -0
  361. package/src/alias.ts +108 -0
  362. package/src/backup.ts +51 -0
  363. package/src/config.ts +115 -0
  364. package/src/dependencies.ts +163 -0
  365. package/src/errors.ts +77 -0
  366. package/src/index.ts +207 -0
  367. package/src/prompts.ts +142 -0
  368. package/src/schemas.ts +21 -0
  369. package/src/skills.ts +45 -0
  370. package/src/speckit.ts +116 -0
  371. package/src/types.ts +106 -0
  372. package/src/utils.ts +110 -0
  373. package/src/vibe-git.ts +50 -0
  374. package/templates/.specify/memory/constitution.md +109 -0
  375. package/templates/.specify/scripts/bash/check-prerequisites.sh +262 -0
  376. package/templates/.specify/scripts/bash/common.sh +670 -0
  377. package/templates/.specify/scripts/bash/create-new-feature.sh +594 -0
  378. package/templates/.specify/scripts/bash/create-worktree-feature.sh +401 -0
  379. package/templates/.specify/scripts/bash/init-workspace.sh +433 -0
  380. package/templates/.specify/scripts/bash/list-spec-worktrees.sh +198 -0
  381. package/templates/.specify/scripts/bash/setup-plan.sh +105 -0
  382. package/templates/.specify/scripts/bash/test-workspace-rollup.sh +175 -0
  383. package/templates/.specify/scripts/bash/update-agent-context.sh +799 -0
  384. package/templates/.specify/templates/agent-file-template.md +28 -0
  385. package/templates/.specify/templates/checklist-template.md +40 -0
  386. package/templates/.specify/templates/commands/analyze.md +197 -0
  387. package/templates/.specify/templates/commands/checklist.md +306 -0
  388. package/templates/.specify/templates/commands/clarify.md +194 -0
  389. package/templates/.specify/templates/commands/constitution.md +97 -0
  390. package/templates/.specify/templates/commands/implement.md +149 -0
  391. package/templates/.specify/templates/commands/plan.md +123 -0
  392. package/templates/.specify/templates/commands/projects.md +48 -0
  393. package/templates/.specify/templates/commands/rollup.md +66 -0
  394. package/templates/.specify/templates/commands/specify.md +275 -0
  395. package/templates/.specify/templates/commands/specs.md +71 -0
  396. package/templates/.specify/templates/commands/tasks.md +151 -0
  397. package/templates/.specify/templates/commands/taskstoissues.md +35 -0
  398. package/templates/.specify/templates/commands/workspace.md +128 -0
  399. package/templates/.specify/templates/plan-template.md +104 -0
  400. package/templates/.specify/templates/spec-template.md +115 -0
  401. package/templates/.specify/templates/tasks-template.md +251 -0
  402. package/templates/.specify/templates/workspace.yaml +110 -0
  403. package/templates/.specify/workspace.yaml +95 -0
  404. package/templates/AGENTS.md +460 -0
  405. package/templates/oh-my-opencode.json +27 -0
  406. package/templates/opencode.json +383 -0
  407. package/templates/package.json +10 -0
  408. package/templates/project-memory/bugs.md +16 -0
  409. package/templates/project-memory/decisions.md +22 -0
  410. package/templates/project-memory/issues.md +15 -0
  411. package/templates/project-memory/key_facts.md +26 -0
@@ -0,0 +1,313 @@
1
+ # Node.js CI/CD Pipeline
2
+ # Optimized workflow with caching, matrix testing, and deployment
3
+
4
+ name: Node.js CI
5
+
6
+ on:
7
+ push:
8
+ branches: [main, develop]
9
+ paths-ignore:
10
+ - '**.md'
11
+ - 'docs/**'
12
+ pull_request:
13
+ branches: [main]
14
+
15
+ # Cancel in-progress runs for same workflow
16
+ concurrency:
17
+ group: ${{ github.workflow }}-${{ github.ref }}
18
+ cancel-in-progress: true
19
+
20
+ jobs:
21
+ # Security: Secret Scanning
22
+ secret-scan:
23
+ name: Secret Scanning
24
+ runs-on: ubuntu-latest
25
+ timeout-minutes: 5
26
+
27
+ steps:
28
+ - uses: actions/checkout@v4
29
+ with:
30
+ fetch-depth: 0
31
+
32
+ - name: TruffleHog Secret Scan
33
+ uses: trufflesecurity/trufflehog@main
34
+ with:
35
+ path: ./
36
+ base: ${{ github.event.repository.default_branch }}
37
+ head: HEAD
38
+
39
+ - name: Gitleaks
40
+ uses: gitleaks/gitleaks-action@v2
41
+ env:
42
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
43
+
44
+ # Security: SAST
45
+ sast:
46
+ name: Static Analysis
47
+ runs-on: ubuntu-latest
48
+ timeout-minutes: 15
49
+
50
+ permissions:
51
+ contents: read
52
+ security-events: write
53
+
54
+ steps:
55
+ - uses: actions/checkout@v4
56
+
57
+ - name: Initialize CodeQL
58
+ uses: github/codeql-action/init@v3
59
+ with:
60
+ languages: javascript
61
+ queries: security-and-quality
62
+
63
+ - name: Perform CodeQL Analysis
64
+ uses: github/codeql-action/analyze@v3
65
+
66
+ - name: Run Semgrep
67
+ uses: returntocorp/semgrep-action@v1
68
+ with:
69
+ config: >-
70
+ p/security-audit
71
+ p/owasp-top-ten
72
+
73
+ # Security: Dependency Scanning
74
+ dependency-scan:
75
+ name: Dependency Security
76
+ runs-on: ubuntu-latest
77
+ timeout-minutes: 10
78
+
79
+ steps:
80
+ - uses: actions/checkout@v4
81
+
82
+ - uses: actions/setup-node@v4
83
+ with:
84
+ node-version: 20
85
+ cache: 'npm'
86
+
87
+ - name: Install dependencies
88
+ run: npm ci
89
+
90
+ - name: npm audit
91
+ run: |
92
+ npm audit --audit-level=moderate --json > npm-audit.json || true
93
+ npm audit --audit-level=high
94
+ continue-on-error: false
95
+
96
+ - name: Upload audit results
97
+ if: always()
98
+ uses: actions/upload-artifact@v4
99
+ with:
100
+ name: npm-audit-report
101
+ path: npm-audit.json
102
+
103
+ lint:
104
+ name: Lint
105
+ runs-on: ubuntu-latest
106
+ needs: [secret-scan]
107
+ timeout-minutes: 10
108
+
109
+ steps:
110
+ - uses: actions/checkout@v4
111
+
112
+ - uses: actions/setup-node@v4
113
+ with:
114
+ node-version: 20
115
+ cache: 'npm'
116
+
117
+ - name: Install dependencies
118
+ run: npm ci
119
+
120
+ - name: Run linter
121
+ run: npm run lint
122
+
123
+ - name: Check formatting
124
+ run: npm run format:check
125
+
126
+ test:
127
+ name: Test (Node ${{ matrix.node }})
128
+ runs-on: ubuntu-latest
129
+ timeout-minutes: 20
130
+
131
+ strategy:
132
+ matrix:
133
+ node: [18, 20, 22]
134
+ fail-fast: false
135
+
136
+ steps:
137
+ - uses: actions/checkout@v4
138
+
139
+ - uses: actions/setup-node@v4
140
+ with:
141
+ node-version: ${{ matrix.node }}
142
+ cache: 'npm'
143
+
144
+ - name: Install dependencies
145
+ run: npm ci
146
+
147
+ - name: Run unit tests
148
+ run: npm run test:unit
149
+
150
+ - name: Run integration tests
151
+ run: npm run test:integration
152
+ if: matrix.node == 20 # Only run on one version
153
+
154
+ - name: Upload coverage
155
+ uses: codecov/codecov-action@v4
156
+ if: matrix.node == 20
157
+ with:
158
+ files: ./coverage/lcov.info
159
+ fail_ci_if_error: false
160
+
161
+ build:
162
+ name: Build
163
+ runs-on: ubuntu-latest
164
+ needs: [lint, test, sast, dependency-scan]
165
+ timeout-minutes: 15
166
+
167
+ steps:
168
+ - uses: actions/checkout@v4
169
+
170
+ - uses: actions/setup-node@v4
171
+ with:
172
+ node-version: 20
173
+ cache: 'npm'
174
+
175
+ - name: Install dependencies
176
+ run: npm ci
177
+
178
+ - name: Build application
179
+ run: npm run build
180
+
181
+ - name: Upload build artifacts
182
+ uses: actions/upload-artifact@v4
183
+ with:
184
+ name: dist-${{ github.sha }}
185
+ path: dist/
186
+ retention-days: 7
187
+
188
+ e2e:
189
+ name: E2E Tests
190
+ runs-on: ubuntu-latest
191
+ needs: build
192
+ if: github.ref == 'refs/heads/main'
193
+ timeout-minutes: 30
194
+
195
+ steps:
196
+ - uses: actions/checkout@v4
197
+
198
+ - uses: actions/setup-node@v4
199
+ with:
200
+ node-version: 20
201
+ cache: 'npm'
202
+
203
+ - name: Install dependencies
204
+ run: npm ci
205
+
206
+ - name: Download build artifacts
207
+ uses: actions/download-artifact@v4
208
+ with:
209
+ name: dist-${{ github.sha }}
210
+ path: dist/
211
+
212
+ - name: Run E2E tests
213
+ run: npm run test:e2e
214
+
215
+ - name: Upload test results
216
+ if: always()
217
+ uses: actions/upload-artifact@v4
218
+ with:
219
+ name: e2e-results
220
+ path: test-results/
221
+
222
+ deploy-staging:
223
+ name: Deploy to Staging
224
+ runs-on: ubuntu-latest
225
+ needs: [build, test]
226
+ if: github.ref == 'refs/heads/develop'
227
+ environment:
228
+ name: staging
229
+ url: https://staging.example.com
230
+
231
+ permissions:
232
+ contents: read
233
+ id-token: write # For OIDC
234
+
235
+ steps:
236
+ - uses: actions/checkout@v4
237
+
238
+ - name: Download build artifacts
239
+ uses: actions/download-artifact@v4
240
+ with:
241
+ name: dist-${{ github.sha }}
242
+ path: dist/
243
+
244
+ - name: Configure AWS credentials
245
+ uses: aws-actions/configure-aws-credentials@v4
246
+ with:
247
+ role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
248
+ aws-region: us-east-1
249
+
250
+ - name: Deploy to S3
251
+ run: |
252
+ aws s3 sync dist/ s3://${{ secrets.STAGING_BUCKET }}
253
+ aws cloudfront create-invalidation --distribution-id ${{ secrets.STAGING_CF_DIST }} --paths "/*"
254
+
255
+ - name: Smoke tests
256
+ run: |
257
+ sleep 10
258
+ curl -f https://staging.example.com/health || exit 1
259
+
260
+ deploy-production:
261
+ name: Deploy to Production
262
+ runs-on: ubuntu-latest
263
+ needs: [e2e]
264
+ if: github.ref == 'refs/heads/main'
265
+ environment:
266
+ name: production
267
+ url: https://example.com
268
+
269
+ permissions:
270
+ contents: read
271
+ id-token: write
272
+
273
+ steps:
274
+ - uses: actions/checkout@v4
275
+
276
+ - name: Download build artifacts
277
+ uses: actions/download-artifact@v4
278
+ with:
279
+ name: dist-${{ github.sha }}
280
+ path: dist/
281
+
282
+ - name: Configure AWS credentials
283
+ uses: aws-actions/configure-aws-credentials@v4
284
+ with:
285
+ role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
286
+ aws-region: us-east-1
287
+
288
+ - name: Deploy to S3
289
+ run: |
290
+ aws s3 sync dist/ s3://${{ secrets.PRODUCTION_BUCKET }}
291
+ aws cloudfront create-invalidation --distribution-id ${{ secrets.PRODUCTION_CF_DIST }} --paths "/*"
292
+
293
+ - name: Health check
294
+ run: |
295
+ for i in {1..10}; do
296
+ if curl -f https://example.com/health; then
297
+ echo "Health check passed"
298
+ exit 0
299
+ fi
300
+ echo "Attempt $i failed, retrying..."
301
+ sleep 10
302
+ done
303
+ echo "Health check failed"
304
+ exit 1
305
+
306
+ - name: Create deployment record
307
+ run: |
308
+ echo "Deployed version: ${{ github.sha }}"
309
+ echo "Deployment time: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
310
+ # Optionally create release with gh CLI:
311
+ # gh release create v${{ github.run_number }} \
312
+ # --title "Release v${{ github.run_number }}" \
313
+ # --notes "Deployed commit ${{ github.sha }}"
@@ -0,0 +1,388 @@
1
+ # Python CI/CD Pipeline
2
+ # Optimized with caching, matrix testing, and deployment
3
+
4
+ name: Python CI
5
+
6
+ on:
7
+ push:
8
+ branches: [main, develop]
9
+ paths-ignore:
10
+ - '**.md'
11
+ - 'docs/**'
12
+ pull_request:
13
+ branches: [main]
14
+
15
+ concurrency:
16
+ group: ${{ github.workflow }}-${{ github.ref }}
17
+ cancel-in-progress: true
18
+
19
+ jobs:
20
+ # Security: Secret Scanning
21
+ secret-scan:
22
+ name: Secret Scanning
23
+ runs-on: ubuntu-latest
24
+ timeout-minutes: 5
25
+
26
+ steps:
27
+ - uses: actions/checkout@v4
28
+ with:
29
+ fetch-depth: 0
30
+
31
+ - name: TruffleHog Secret Scan
32
+ uses: trufflesecurity/trufflehog@main
33
+ with:
34
+ path: ./
35
+ base: ${{ github.event.repository.default_branch }}
36
+ head: HEAD
37
+
38
+ - name: Gitleaks
39
+ uses: gitleaks/gitleaks-action@v2
40
+ env:
41
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
42
+
43
+ # Security: SAST
44
+ sast:
45
+ name: Static Analysis (CodeQL)
46
+ runs-on: ubuntu-latest
47
+ timeout-minutes: 15
48
+
49
+ permissions:
50
+ contents: read
51
+ security-events: write
52
+
53
+ steps:
54
+ - uses: actions/checkout@v4
55
+
56
+ - uses: actions/setup-python@v5
57
+ with:
58
+ python-version: '3.11'
59
+
60
+ - name: Initialize CodeQL
61
+ uses: github/codeql-action/init@v3
62
+ with:
63
+ languages: python
64
+ queries: security-and-quality
65
+
66
+ - name: Perform CodeQL Analysis
67
+ uses: github/codeql-action/analyze@v3
68
+
69
+ lint:
70
+ name: Lint & Format Check
71
+ runs-on: ubuntu-latest
72
+ needs: [secret-scan]
73
+ timeout-minutes: 10
74
+
75
+ steps:
76
+ - uses: actions/checkout@v4
77
+
78
+ - uses: actions/setup-python@v5
79
+ with:
80
+ python-version: '3.11'
81
+ cache: 'pip'
82
+
83
+ - name: Install dependencies
84
+ run: |
85
+ python -m pip install --upgrade pip
86
+ pip install ruff black mypy isort
87
+
88
+ - name: Run ruff
89
+ run: ruff check .
90
+
91
+ - name: Check formatting with black
92
+ run: black --check .
93
+
94
+ - name: Check import sorting
95
+ run: isort --check-only .
96
+
97
+ - name: Type check with mypy
98
+ run: mypy .
99
+ continue-on-error: true # Don't fail on type errors initially
100
+
101
+ test:
102
+ name: Test (Python ${{ matrix.python-version }})
103
+ runs-on: ubuntu-latest
104
+ timeout-minutes: 20
105
+
106
+ strategy:
107
+ matrix:
108
+ python-version: ['3.9', '3.10', '3.11', '3.12']
109
+ fail-fast: false
110
+
111
+ services:
112
+ postgres:
113
+ image: postgres:15
114
+ env:
115
+ POSTGRES_PASSWORD: postgres
116
+ POSTGRES_DB: testdb
117
+ options: >-
118
+ --health-cmd pg_isready
119
+ --health-interval 10s
120
+ --health-timeout 5s
121
+ --health-retries 5
122
+ ports:
123
+ - 5432:5432
124
+
125
+ redis:
126
+ image: redis:7-alpine
127
+ options: >-
128
+ --health-cmd "redis-cli ping"
129
+ --health-interval 10s
130
+ --health-timeout 5s
131
+ --health-retries 5
132
+ ports:
133
+ - 6379:6379
134
+
135
+ steps:
136
+ - uses: actions/checkout@v4
137
+
138
+ - uses: actions/setup-python@v5
139
+ with:
140
+ python-version: ${{ matrix.python-version }}
141
+ cache: 'pip'
142
+
143
+ - name: Install dependencies
144
+ run: |
145
+ python -m pip install --upgrade pip
146
+ pip install -r requirements.txt
147
+ pip install -r requirements-dev.txt
148
+
149
+ - name: Run unit tests
150
+ env:
151
+ DATABASE_URL: postgresql://postgres:postgres@localhost:5432/testdb
152
+ REDIS_URL: redis://localhost:6379
153
+ run: |
154
+ pytest tests/unit \
155
+ --cov=src \
156
+ --cov-report=xml \
157
+ --cov-report=term \
158
+ --junitxml=junit.xml \
159
+ -v
160
+
161
+ - name: Run integration tests
162
+ if: matrix.python-version == '3.11'
163
+ env:
164
+ DATABASE_URL: postgresql://postgres:postgres@localhost:5432/testdb
165
+ REDIS_URL: redis://localhost:6379
166
+ run: |
167
+ pytest tests/integration -v
168
+
169
+ - name: Upload coverage to Codecov
170
+ if: matrix.python-version == '3.11'
171
+ uses: codecov/codecov-action@v4
172
+ with:
173
+ files: ./coverage.xml
174
+ fail_ci_if_error: false
175
+
176
+ - name: Upload test results
177
+ if: always()
178
+ uses: actions/upload-artifact@v4
179
+ with:
180
+ name: test-results-${{ matrix.python-version }}
181
+ path: junit.xml
182
+
183
+ security:
184
+ name: Security Scanning
185
+ runs-on: ubuntu-latest
186
+ timeout-minutes: 10
187
+
188
+ steps:
189
+ - uses: actions/checkout@v4
190
+
191
+ - uses: actions/setup-python@v5
192
+ with:
193
+ python-version: '3.11'
194
+ cache: 'pip'
195
+
196
+ - name: Install dependencies
197
+ run: |
198
+ python -m pip install --upgrade pip
199
+ pip install -r requirements.txt
200
+
201
+ - name: Run bandit security scan
202
+ run: |
203
+ pip install bandit
204
+ bandit -r src/ -f json -o bandit-report.json -ll || true
205
+ bandit -r src/ -ll
206
+ continue-on-error: false
207
+
208
+ - name: Run safety check
209
+ run: |
210
+ pip install safety
211
+ safety check --json --output safety-report.json || true
212
+ safety check
213
+ continue-on-error: true
214
+
215
+ - name: pip-audit dependency scan
216
+ run: |
217
+ pip install pip-audit
218
+ pip-audit --requirement requirements.txt --format json --output pip-audit.json || true
219
+ pip-audit --requirement requirements.txt
220
+ continue-on-error: false
221
+
222
+ - name: Upload security reports
223
+ if: always()
224
+ uses: actions/upload-artifact@v4
225
+ with:
226
+ name: security-reports
227
+ path: |
228
+ bandit-report.json
229
+ safety-report.json
230
+ pip-audit.json
231
+
232
+ build:
233
+ name: Build Package
234
+ runs-on: ubuntu-latest
235
+ needs: [lint, test, sast, security]
236
+ timeout-minutes: 10
237
+
238
+ steps:
239
+ - uses: actions/checkout@v4
240
+
241
+ - uses: actions/setup-python@v5
242
+ with:
243
+ python-version: '3.11'
244
+ cache: 'pip'
245
+
246
+ - name: Install build tools
247
+ run: |
248
+ python -m pip install --upgrade pip
249
+ pip install build wheel setuptools
250
+
251
+ - name: Build package
252
+ run: python -m build
253
+
254
+ - name: Upload distribution
255
+ uses: actions/upload-artifact@v4
256
+ with:
257
+ name: dist-${{ github.sha }}
258
+ path: dist/
259
+ retention-days: 7
260
+
261
+ e2e:
262
+ name: E2E Tests
263
+ runs-on: ubuntu-latest
264
+ needs: build
265
+ if: github.ref == 'refs/heads/main'
266
+ timeout-minutes: 30
267
+
268
+ steps:
269
+ - uses: actions/checkout@v4
270
+
271
+ - uses: actions/setup-python@v5
272
+ with:
273
+ python-version: '3.11'
274
+ cache: 'pip'
275
+
276
+ - name: Download build artifacts
277
+ uses: actions/download-artifact@v4
278
+ with:
279
+ name: dist-${{ github.sha }}
280
+ path: dist/
281
+
282
+ - name: Install package
283
+ run: |
284
+ pip install dist/*.whl
285
+ pip install -r requirements-dev.txt
286
+
287
+ - name: Run E2E tests
288
+ run: pytest tests/e2e -v
289
+
290
+ deploy-pypi:
291
+ name: Deploy to PyPI
292
+ runs-on: ubuntu-latest
293
+ needs: [build, test]
294
+ if: startsWith(github.ref, 'refs/tags/v')
295
+ environment:
296
+ name: pypi
297
+ url: https://pypi.org/project/your-package
298
+
299
+ permissions:
300
+ id-token: write # For trusted publishing
301
+
302
+ steps:
303
+ - uses: actions/download-artifact@v4
304
+ with:
305
+ name: dist-${{ github.sha }}
306
+ path: dist/
307
+
308
+ - name: Publish to PyPI
309
+ uses: pypa/gh-action-pypi-publish@release/v1
310
+ # Uses OIDC trusted publishing - no token needed!
311
+
312
+ deploy-docker:
313
+ name: Build & Push Docker Image
314
+ runs-on: ubuntu-latest
315
+ needs: [build, test]
316
+ if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
317
+
318
+ permissions:
319
+ contents: read
320
+ packages: write
321
+
322
+ steps:
323
+ - uses: actions/checkout@v4
324
+
325
+ - name: Set up Docker Buildx
326
+ uses: docker/setup-buildx-action@v3
327
+
328
+ - name: Log in to GitHub Container Registry
329
+ uses: docker/login-action@v3
330
+ with:
331
+ registry: ghcr.io
332
+ username: ${{ github.actor }}
333
+ password: ${{ secrets.GITHUB_TOKEN }}
334
+
335
+ - name: Extract metadata
336
+ id: meta
337
+ uses: docker/metadata-action@v5
338
+ with:
339
+ images: ghcr.io/${{ github.repository }}
340
+ tags: |
341
+ type=ref,event=branch
342
+ type=semver,pattern={{version}}
343
+ type=semver,pattern={{major}}.{{minor}}
344
+ type=sha
345
+
346
+ - name: Build and push
347
+ uses: docker/build-push-action@v5
348
+ with:
349
+ context: .
350
+ push: true
351
+ tags: ${{ steps.meta.outputs.tags }}
352
+ labels: ${{ steps.meta.outputs.labels }}
353
+ cache-from: type=gha
354
+ cache-to: type=gha,mode=max
355
+
356
+ deploy-cloud:
357
+ name: Deploy to Cloud Run
358
+ runs-on: ubuntu-latest
359
+ needs: deploy-docker
360
+ if: github.ref == 'refs/heads/main'
361
+ environment:
362
+ name: production
363
+ url: https://your-app.run.app
364
+
365
+ permissions:
366
+ contents: read
367
+ id-token: write
368
+
369
+ steps:
370
+ - uses: actions/checkout@v4
371
+
372
+ - uses: google-github-actions/auth@v2
373
+ with:
374
+ workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
375
+ service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
376
+
377
+ - name: Deploy to Cloud Run
378
+ run: |
379
+ gcloud run deploy your-app \
380
+ --image ghcr.io/${{ github.repository }}:${{ github.sha }} \
381
+ --region us-central1 \
382
+ --platform managed \
383
+ --allow-unauthenticated
384
+
385
+ - name: Health check
386
+ run: |
387
+ URL=$(gcloud run services describe your-app --region us-central1 --format 'value(status.url)')
388
+ curl -f $URL/health || exit 1