codeply-cli 0.5.0 → 0.5.2

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 (387) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +65 -63
  3. package/bin/codeply.js +1 -1
  4. package/lib/agent.mjs +133 -24
  5. package/lib/ai.js +268 -9
  6. package/lib/ai.mjs +6 -6
  7. package/lib/apply-patch.js +217 -217
  8. package/lib/arity-table.json +138 -138
  9. package/lib/arity.js +70 -70
  10. package/lib/auth.mjs +6 -6
  11. package/lib/bots.js +493 -16
  12. package/lib/chatgpt.js +282 -0
  13. package/lib/cloud-browser.mjs +143 -143
  14. package/lib/cloud.mjs +1186 -1105
  15. package/lib/commands.js +103 -103
  16. package/lib/config.js +83 -3
  17. package/lib/design-library/assemble-artifact.mjs +21 -21
  18. package/lib/design-library/cleanup.mjs +45 -45
  19. package/lib/design-library/index.json +22379 -22379
  20. package/lib/design-library/make-table-data.mjs +39 -39
  21. package/lib/diagnostics.js +192 -192
  22. package/lib/edit-engine.js +364 -364
  23. package/lib/github-agent.mjs +311 -311
  24. package/lib/history.js +75 -75
  25. package/lib/mail-watch.js +504 -0
  26. package/lib/mcp.js +258 -258
  27. package/lib/model-sync.js +114 -0
  28. package/lib/native-tools.mjs +16 -1
  29. package/lib/oauth-connectors.js +146 -24
  30. package/lib/permissions.js +109 -109
  31. package/lib/plugins.js +353 -353
  32. package/lib/publish.js +916 -0
  33. package/lib/reach.js +67 -0
  34. package/lib/server.mjs +457 -457
  35. package/lib/session-db.js +220 -220
  36. package/lib/share.js +168 -168
  37. package/lib/skills.js +2 -0
  38. package/lib/snapshot.js +146 -146
  39. package/lib/telemetry.js +102 -0
  40. package/lib/terminal-hints.js +154 -154
  41. package/lib/tools.mjs +316 -14
  42. package/lib/typecheck-worker.js +147 -147
  43. package/lib/web-tools.js +209 -158
  44. package/package.json +49 -49
  45. package/skills/SOURCE.md +58 -58
  46. package/skills/accessibility/SKILL.md +147 -147
  47. package/skills/agent-architecture-audit/SKILL.md +257 -257
  48. package/skills/agent-eval/SKILL.md +147 -147
  49. package/skills/agent-harness-construction/SKILL.md +74 -74
  50. package/skills/agent-introspection-debugging/SKILL.md +154 -154
  51. package/skills/agent-payment-x402/SKILL.md +225 -225
  52. package/skills/agent-self-evaluation/SKILL.md +182 -182
  53. package/skills/agent-self-evaluation/references/evaluation-criteria.md +71 -71
  54. package/skills/agent-self-evaluation/references/hook-integration.md +64 -64
  55. package/skills/agent-sort/SKILL.md +216 -216
  56. package/skills/agentic-engineering/SKILL.md +64 -64
  57. package/skills/agentic-os/SKILL.md +388 -388
  58. package/skills/ai-first-engineering/SKILL.md +52 -52
  59. package/skills/ai-regression-testing/SKILL.md +386 -386
  60. package/skills/android-clean-architecture/SKILL.md +340 -340
  61. package/skills/angular-developer/SKILL.md +155 -155
  62. package/skills/angular-developer/references/angular-animations.md +160 -160
  63. package/skills/angular-developer/references/angular-aria.md +410 -410
  64. package/skills/angular-developer/references/cli.md +86 -86
  65. package/skills/angular-developer/references/component-harnesses.md +59 -59
  66. package/skills/angular-developer/references/component-styling.md +91 -91
  67. package/skills/angular-developer/references/components.md +117 -117
  68. package/skills/angular-developer/references/creating-services.md +97 -97
  69. package/skills/angular-developer/references/data-resolvers.md +69 -69
  70. package/skills/angular-developer/references/define-routes.md +67 -67
  71. package/skills/angular-developer/references/defining-providers.md +72 -72
  72. package/skills/angular-developer/references/di-fundamentals.md +120 -120
  73. package/skills/angular-developer/references/e2e-testing.md +56 -56
  74. package/skills/angular-developer/references/effects.md +83 -83
  75. package/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  76. package/skills/angular-developer/references/host-elements.md +80 -80
  77. package/skills/angular-developer/references/injection-context.md +63 -63
  78. package/skills/angular-developer/references/inputs.md +101 -101
  79. package/skills/angular-developer/references/linked-signal.md +59 -59
  80. package/skills/angular-developer/references/loading-strategies.md +61 -61
  81. package/skills/angular-developer/references/mcp.md +108 -108
  82. package/skills/angular-developer/references/navigate-to-routes.md +69 -69
  83. package/skills/angular-developer/references/outputs.md +86 -86
  84. package/skills/angular-developer/references/reactive-forms.md +122 -122
  85. package/skills/angular-developer/references/rendering-strategies.md +44 -44
  86. package/skills/angular-developer/references/resource.md +77 -77
  87. package/skills/angular-developer/references/route-animations.md +56 -56
  88. package/skills/angular-developer/references/route-guards.md +52 -52
  89. package/skills/angular-developer/references/router-lifecycle.md +45 -45
  90. package/skills/angular-developer/references/router-testing.md +87 -87
  91. package/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  92. package/skills/angular-developer/references/signal-forms.md +795 -795
  93. package/skills/angular-developer/references/signals-overview.md +94 -94
  94. package/skills/angular-developer/references/tailwind-css.md +69 -69
  95. package/skills/angular-developer/references/template-driven-forms.md +114 -114
  96. package/skills/angular-developer/references/testing-fundamentals.md +65 -65
  97. package/skills/api-connector-builder/SKILL.md +121 -121
  98. package/skills/api-design/SKILL.md +524 -524
  99. package/skills/architecture-decision-records/SKILL.md +180 -180
  100. package/skills/article-writing/SKILL.md +80 -80
  101. package/skills/automation-audit-ops/SKILL.md +143 -143
  102. package/skills/autonomous-agent-harness/SKILL.md +274 -274
  103. package/skills/autonomous-loops/SKILL.md +611 -611
  104. package/skills/backend-patterns/SKILL.md +562 -562
  105. package/skills/benchmark/SKILL.md +95 -95
  106. package/skills/benchmark-methodology/SKILL.md +191 -191
  107. package/skills/benchmark-optimization-loop/SKILL.md +71 -71
  108. package/skills/blender-motion-state-inspection/SKILL.md +165 -165
  109. package/skills/blueprint/SKILL.md +106 -106
  110. package/skills/brand-discovery/SKILL.md +145 -145
  111. package/skills/brand-discovery/references/10_purpose-why.md +40 -40
  112. package/skills/brand-discovery/references/20_positioning.md +44 -44
  113. package/skills/brand-discovery/references/30_audience-niche.md +52 -52
  114. package/skills/brand-discovery/references/40_personality-archetype.md +57 -57
  115. package/skills/brand-discovery/references/50_voice-tone.md +59 -59
  116. package/skills/brand-discovery/references/60_narrative-story.md +50 -50
  117. package/skills/brand-discovery/references/70_founder-tension.md +49 -49
  118. package/skills/brand-discovery/references/90_SYNTHESIS.md +133 -133
  119. package/skills/brand-voice/SKILL.md +98 -98
  120. package/skills/brand-voice/references/voice-profile-schema.md +55 -55
  121. package/skills/browser-qa/SKILL.md +105 -105
  122. package/skills/bun-runtime/SKILL.md +85 -85
  123. package/skills/canary-watch/SKILL.md +108 -108
  124. package/skills/carrier-relationship-management/SKILL.md +212 -212
  125. package/skills/cisco-ios-patterns/SKILL.md +164 -164
  126. package/skills/ck/SKILL.md +148 -148
  127. package/skills/claude-devfleet/SKILL.md +112 -112
  128. package/skills/click-path-audit/SKILL.md +245 -245
  129. package/skills/clickhouse-io/SKILL.md +445 -445
  130. package/skills/code-tour/SKILL.md +254 -254
  131. package/skills/codebase-onboarding/SKILL.md +234 -234
  132. package/skills/codehealth-mcp/SKILL.md +167 -167
  133. package/skills/coding-standards/SKILL.md +551 -551
  134. package/skills/competitive-platform-analysis/SKILL.md +214 -214
  135. package/skills/competitive-report-structure/SKILL.md +162 -162
  136. package/skills/compose-multiplatform-patterns/SKILL.md +300 -300
  137. package/skills/config-gc/SKILL.md +120 -120
  138. package/skills/configure-ecc/SKILL.md +385 -385
  139. package/skills/connections-optimizer/SKILL.md +190 -190
  140. package/skills/content-engine/SKILL.md +132 -132
  141. package/skills/content-hash-cache-pattern/SKILL.md +162 -162
  142. package/skills/context-budget/SKILL.md +136 -136
  143. package/skills/continuous-agent-loop/SKILL.md +46 -46
  144. package/skills/continuous-learning/SKILL.md +132 -132
  145. package/skills/continuous-learning-v2/SKILL.md +361 -361
  146. package/skills/contract-first/SKILL.md +287 -287
  147. package/skills/cost-aware-llm-pipeline/SKILL.md +184 -184
  148. package/skills/cost-tracking/SKILL.md +97 -97
  149. package/skills/council/SKILL.md +204 -204
  150. package/skills/cpp-coding-standards/SKILL.md +724 -724
  151. package/skills/cpp-testing/SKILL.md +325 -325
  152. package/skills/crosspost/SKILL.md +112 -112
  153. package/skills/csharp-testing/SKILL.md +322 -322
  154. package/skills/customer-billing-ops/SKILL.md +141 -141
  155. package/skills/customs-trade-compliance/SKILL.md +263 -263
  156. package/skills/dart-flutter-patterns/SKILL.md +564 -564
  157. package/skills/dashboard-builder/SKILL.md +109 -109
  158. package/skills/data-scraper-agent/SKILL.md +765 -765
  159. package/skills/data-throughput-accelerator/SKILL.md +74 -74
  160. package/skills/database-migrations/SKILL.md +430 -430
  161. package/skills/deep-research/SKILL.md +160 -160
  162. package/skills/defi-amm-security/SKILL.md +167 -167
  163. package/skills/delivery-gate/SKILL.md +126 -126
  164. package/skills/deployment-patterns/SKILL.md +428 -428
  165. package/skills/design-system/SKILL.md +83 -83
  166. package/skills/django-celery/SKILL.md +458 -458
  167. package/skills/django-patterns/SKILL.md +735 -735
  168. package/skills/django-security/SKILL.md +644 -644
  169. package/skills/django-tdd/SKILL.md +730 -730
  170. package/skills/django-verification/SKILL.md +470 -470
  171. package/skills/dmux-workflows/SKILL.md +192 -192
  172. package/skills/docker-patterns/SKILL.md +365 -365
  173. package/skills/documentation-lookup/SKILL.md +91 -91
  174. package/skills/dotnet-patterns/SKILL.md +322 -322
  175. package/skills/dynamic-workflow-mode/SKILL.md +124 -124
  176. package/skills/e2e-testing/SKILL.md +327 -327
  177. package/skills/ecc-guide/SKILL.md +190 -190
  178. package/skills/ecc-recipes/SKILL.md +149 -149
  179. package/skills/ecc-tools-cost-audit/SKILL.md +161 -161
  180. package/skills/email-ops/SKILL.md +122 -122
  181. package/skills/energy-procurement/SKILL.md +228 -228
  182. package/skills/enterprise-agent-ops/SKILL.md +51 -51
  183. package/skills/error-handling/SKILL.md +377 -377
  184. package/skills/eval-harness/SKILL.md +271 -271
  185. package/skills/evm-token-decimals/SKILL.md +131 -131
  186. package/skills/exa-search/SKILL.md +108 -108
  187. package/skills/fal-ai-media/SKILL.md +289 -289
  188. package/skills/fastapi-patterns/SKILL.md +514 -514
  189. package/skills/finance-billing-ops/SKILL.md +128 -128
  190. package/skills/flox-environments/SKILL.md +497 -497
  191. package/skills/flutter-dart-code-review/SKILL.md +436 -436
  192. package/skills/foundation-models-on-device/SKILL.md +243 -243
  193. package/skills/frontend-a11y/SKILL.md +446 -446
  194. package/skills/frontend-design-direction/SKILL.md +93 -93
  195. package/skills/frontend-patterns/SKILL.md +657 -657
  196. package/skills/frontend-slides/SKILL.md +185 -185
  197. package/skills/fsharp-testing/SKILL.md +281 -281
  198. package/skills/gan-style-harness/SKILL.md +279 -279
  199. package/skills/gateguard/SKILL.md +133 -133
  200. package/skills/generating-python-installer/SKILL.md +820 -820
  201. package/skills/git-workflow/SKILL.md +716 -716
  202. package/skills/github-ops/SKILL.md +145 -145
  203. package/skills/golang-patterns/SKILL.md +676 -676
  204. package/skills/golang-testing/SKILL.md +721 -721
  205. package/skills/google-workspace-ops/SKILL.md +96 -96
  206. package/skills/growth-log/SKILL.md +128 -128
  207. package/skills/healthcare-cdss-patterns/SKILL.md +246 -246
  208. package/skills/healthcare-emr-patterns/SKILL.md +160 -160
  209. package/skills/healthcare-eval-harness/SKILL.md +208 -208
  210. package/skills/healthcare-phi-compliance/SKILL.md +146 -146
  211. package/skills/hermes-imports/SKILL.md +89 -89
  212. package/skills/hexagonal-architecture/SKILL.md +277 -277
  213. package/skills/hipaa-compliance/SKILL.md +79 -79
  214. package/skills/homelab-network-readiness/SKILL.md +170 -170
  215. package/skills/homelab-network-setup/SKILL.md +130 -130
  216. package/skills/homelab-pihole-dns/SKILL.md +275 -275
  217. package/skills/homelab-vlan-segmentation/SKILL.md +312 -312
  218. package/skills/homelab-wireguard-vpn/SKILL.md +306 -306
  219. package/skills/hookify-rules/SKILL.md +128 -128
  220. package/skills/inherit-legacy-style/SKILL.md +157 -157
  221. package/skills/intent-driven-development/SKILL.md +360 -360
  222. package/skills/inventory-demand-planning/SKILL.md +247 -247
  223. package/skills/investor-materials/SKILL.md +97 -97
  224. package/skills/investor-outreach/SKILL.md +92 -92
  225. package/skills/ios-icon-gen/SKILL.md +158 -158
  226. package/skills/iterative-retrieval/SKILL.md +212 -212
  227. package/skills/ito-basket-compare/SKILL.md +64 -64
  228. package/skills/ito-compute/SKILL.md +129 -129
  229. package/skills/ito-data-atlas-agent/SKILL.md +64 -64
  230. package/skills/ito-market-intelligence/SKILL.md +61 -61
  231. package/skills/ito-trade-planner/SKILL.md +68 -68
  232. package/skills/java-coding-standards/SKILL.md +384 -384
  233. package/skills/jira-integration/SKILL.md +303 -303
  234. package/skills/jpa-patterns/SKILL.md +152 -152
  235. package/skills/knowledge-ops/SKILL.md +155 -155
  236. package/skills/kotlin-coroutines-flows/SKILL.md +285 -285
  237. package/skills/kotlin-exposed-patterns/SKILL.md +720 -720
  238. package/skills/kotlin-ktor-patterns/SKILL.md +690 -690
  239. package/skills/kotlin-patterns/SKILL.md +712 -712
  240. package/skills/kotlin-testing/SKILL.md +825 -825
  241. package/skills/kubernetes-patterns/SKILL.md +756 -756
  242. package/skills/laravel-patterns/SKILL.md +416 -416
  243. package/skills/laravel-plugin-discovery/SKILL.md +230 -230
  244. package/skills/laravel-security/SKILL.md +948 -948
  245. package/skills/laravel-tdd/SKILL.md +675 -675
  246. package/skills/laravel-verification/SKILL.md +180 -180
  247. package/skills/latency-critical-systems/SKILL.md +75 -75
  248. package/skills/lead-intelligence/SKILL.md +322 -322
  249. package/skills/liquid-glass-design/SKILL.md +279 -279
  250. package/skills/llm-trading-agent-security/SKILL.md +147 -147
  251. package/skills/logistics-exception-management/SKILL.md +222 -222
  252. package/skills/loop-design-check/SKILL.md +143 -143
  253. package/skills/mailtrap-email-integration/SKILL.md +77 -77
  254. package/skills/make-interfaces-feel-better/SKILL.md +152 -152
  255. package/skills/manim-video/SKILL.md +90 -90
  256. package/skills/market-research/SKILL.md +76 -76
  257. package/skills/marketing-campaign/SKILL.md +114 -114
  258. package/skills/mcp-server-patterns/SKILL.md +70 -70
  259. package/skills/messages-ops/SKILL.md +105 -105
  260. package/skills/ml-adoption-playbook/SKILL.md +57 -57
  261. package/skills/mle-workflow/SKILL.md +348 -348
  262. package/skills/motion-advanced/SKILL.md +596 -596
  263. package/skills/motion-foundations/SKILL.md +299 -299
  264. package/skills/motion-patterns/SKILL.md +434 -434
  265. package/skills/motion-ui/SKILL.md +576 -576
  266. package/skills/mysql-patterns/SKILL.md +413 -413
  267. package/skills/nanoclaw-repl/SKILL.md +34 -34
  268. package/skills/nestjs-patterns/SKILL.md +231 -231
  269. package/skills/netmiko-ssh-automation/SKILL.md +174 -174
  270. package/skills/network-bgp-diagnostics/SKILL.md +168 -168
  271. package/skills/network-config-validation/SKILL.md +211 -211
  272. package/skills/network-interface-health/SKILL.md +153 -153
  273. package/skills/nextjs-turbopack/SKILL.md +58 -58
  274. package/skills/nodejs-keccak256/SKILL.md +103 -103
  275. package/skills/nutrient-document-processing/SKILL.md +168 -168
  276. package/skills/nuxt4-patterns/SKILL.md +101 -101
  277. package/skills/openclaw-persona-forge/SKILL.md +289 -289
  278. package/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  279. package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  280. package/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  281. package/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  282. package/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  283. package/skills/openclaw-persona-forge/references/output-template.md +166 -166
  284. package/skills/opensource-pipeline/SKILL.md +256 -256
  285. package/skills/orch-add-feature/SKILL.md +45 -45
  286. package/skills/orch-build-mvp/SKILL.md +49 -49
  287. package/skills/orch-change-feature/SKILL.md +43 -43
  288. package/skills/orch-fix-defect/SKILL.md +43 -43
  289. package/skills/orch-pipeline/SKILL.md +121 -121
  290. package/skills/orch-refine-code/SKILL.md +44 -44
  291. package/skills/parallel-execution-optimizer/SKILL.md +74 -74
  292. package/skills/perl-patterns/SKILL.md +505 -505
  293. package/skills/perl-security/SKILL.md +504 -504
  294. package/skills/perl-testing/SKILL.md +476 -476
  295. package/skills/plan-canvas/SKILL.md +153 -153
  296. package/skills/plan-orchestrate/SKILL.md +263 -263
  297. package/skills/plankton-code-quality/SKILL.md +237 -237
  298. package/skills/postgres-patterns/SKILL.md +148 -148
  299. package/skills/prediction-market-oracle-research/SKILL.md +64 -64
  300. package/skills/prediction-market-risk-review/SKILL.md +61 -61
  301. package/skills/premium-web-design/SKILL.md +154 -154
  302. package/skills/prisma-patterns/SKILL.md +401 -401
  303. package/skills/product-capability/SKILL.md +142 -142
  304. package/skills/product-lens/SKILL.md +93 -93
  305. package/skills/production-audit/SKILL.md +207 -207
  306. package/skills/production-scheduling/SKILL.md +238 -238
  307. package/skills/project-flow-ops/SKILL.md +112 -112
  308. package/skills/prompt-optimizer/SKILL.md +398 -398
  309. package/skills/publish-website/SKILL.md +76 -0
  310. package/skills/python-patterns/SKILL.md +751 -751
  311. package/skills/python-testing/SKILL.md +817 -817
  312. package/skills/pytorch-patterns/SKILL.md +397 -397
  313. package/skills/quality-nonconformance/SKILL.md +260 -260
  314. package/skills/quarkus-patterns/SKILL.md +723 -723
  315. package/skills/quarkus-security/SKILL.md +468 -468
  316. package/skills/quarkus-tdd/SKILL.md +812 -812
  317. package/skills/quarkus-verification/SKILL.md +480 -480
  318. package/skills/ralphinho-rfc-pipeline/SKILL.md +68 -68
  319. package/skills/react-native-patterns/SKILL.md +326 -326
  320. package/skills/react-patterns/SKILL.md +342 -342
  321. package/skills/react-performance/SKILL.md +575 -575
  322. package/skills/react-testing/SKILL.md +424 -424
  323. package/skills/recsys-pipeline-architect/SKILL.md +115 -115
  324. package/skills/recursive-decision-ledger/SKILL.md +81 -81
  325. package/skills/redis-patterns/SKILL.md +404 -404
  326. package/skills/regex-vs-llm-structured-text/SKILL.md +221 -221
  327. package/skills/remotion-video-creation/SKILL.md +43 -43
  328. package/skills/repo-scan/SKILL.md +79 -79
  329. package/skills/research-ops/SKILL.md +113 -113
  330. package/skills/returns-reverse-logistics/SKILL.md +240 -240
  331. package/skills/rules-distill/SKILL.md +265 -265
  332. package/skills/rust-patterns/SKILL.md +500 -500
  333. package/skills/rust-testing/SKILL.md +501 -501
  334. package/skills/safety-guard/SKILL.md +76 -76
  335. package/skills/santa-method/SKILL.md +307 -307
  336. package/skills/scientific-db-pubmed-database/SKILL.md +176 -176
  337. package/skills/scientific-db-uspto-database/SKILL.md +178 -178
  338. package/skills/scientific-pkg-gget/SKILL.md +167 -167
  339. package/skills/scientific-thinking-literature-review/SKILL.md +193 -193
  340. package/skills/scientific-thinking-scholar-evaluation/SKILL.md +161 -161
  341. package/skills/search-first/SKILL.md +183 -183
  342. package/skills/security-bounty-hunter/SKILL.md +100 -100
  343. package/skills/security-review/SKILL.md +504 -504
  344. package/skills/security-scan/SKILL.md +166 -166
  345. package/skills/seo/SKILL.md +155 -155
  346. package/skills/skill-comply/SKILL.md +59 -59
  347. package/skills/skill-scout/SKILL.md +141 -141
  348. package/skills/skill-stocktake/SKILL.md +195 -195
  349. package/skills/social-graph-ranker/SKILL.md +155 -155
  350. package/skills/social-publisher/SKILL.md +130 -130
  351. package/skills/springboot-patterns/SKILL.md +315 -315
  352. package/skills/springboot-security/SKILL.md +273 -273
  353. package/skills/springboot-tdd/SKILL.md +159 -159
  354. package/skills/springboot-verification/SKILL.md +232 -232
  355. package/skills/strategic-compact/SKILL.md +142 -142
  356. package/skills/swift-actor-persistence/SKILL.md +144 -144
  357. package/skills/swift-concurrency-6-2/SKILL.md +216 -216
  358. package/skills/swift-protocol-di-testing/SKILL.md +191 -191
  359. package/skills/swiftui-patterns/SKILL.md +259 -259
  360. package/skills/taste/SKILL.md +264 -264
  361. package/skills/taste/references/genre-taxonomy.md +87 -87
  362. package/skills/tdd-workflow/SKILL.md +583 -583
  363. package/skills/team-agent-orchestration/SKILL.md +111 -111
  364. package/skills/team-builder/SKILL.md +169 -169
  365. package/skills/terminal-ops/SKILL.md +110 -110
  366. package/skills/tinystruct-patterns/SKILL.md +279 -279
  367. package/skills/tinystruct-patterns/references/architecture.md +90 -90
  368. package/skills/tinystruct-patterns/references/data-handling.md +60 -60
  369. package/skills/tinystruct-patterns/references/database.md +99 -99
  370. package/skills/tinystruct-patterns/references/routing.md +64 -64
  371. package/skills/tinystruct-patterns/references/system-usage.md +97 -97
  372. package/skills/tinystruct-patterns/references/testing.md +72 -72
  373. package/skills/token-budget-advisor/SKILL.md +134 -134
  374. package/skills/ui-demo/SKILL.md +466 -466
  375. package/skills/ui-to-vue/SKILL.md +135 -135
  376. package/skills/uncloud/SKILL.md +344 -344
  377. package/skills/unified-memory/SKILL.md +170 -170
  378. package/skills/unified-notifications-ops/SKILL.md +188 -188
  379. package/skills/verification-loop/SKILL.md +129 -129
  380. package/skills/video-editing/SKILL.md +311 -311
  381. package/skills/videodb/SKILL.md +375 -375
  382. package/skills/visa-doc-translate/SKILL.md +117 -117
  383. package/skills/vite-patterns/SKILL.md +450 -450
  384. package/skills/vue-patterns/SKILL.md +471 -471
  385. package/skills/windows-desktop-e2e/SKILL.md +888 -888
  386. package/skills/workspace-surface-audit/SKILL.md +126 -126
  387. package/skills/x-api/SKILL.md +235 -235
@@ -1,428 +1,428 @@
1
- ---
2
- name: deployment-patterns
3
- description: Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
4
- metadata:
5
- origin: ECC
6
- ---
7
-
8
- # Deployment Patterns
9
-
10
- Production deployment workflows and CI/CD best practices.
11
-
12
- ## When to Activate
13
-
14
- - Setting up CI/CD pipelines
15
- - Dockerizing an application
16
- - Planning deployment strategy (blue-green, canary, rolling)
17
- - Implementing health checks and readiness probes
18
- - Preparing for a production release
19
- - Configuring environment-specific settings
20
-
21
- ## Deployment Strategies
22
-
23
- ### Rolling Deployment (Default)
24
-
25
- Replace instances gradually — old and new versions run simultaneously during rollout.
26
-
27
- ```
28
- Instance 1: v1 → v2 (update first)
29
- Instance 2: v1 (still running v1)
30
- Instance 3: v1 (still running v1)
31
-
32
- Instance 1: v2
33
- Instance 2: v1 → v2 (update second)
34
- Instance 3: v1
35
-
36
- Instance 1: v2
37
- Instance 2: v2
38
- Instance 3: v1 → v2 (update last)
39
- ```
40
-
41
- **Pros:** Zero downtime, gradual rollout
42
- **Cons:** Two versions run simultaneously — requires backward-compatible changes
43
- **Use when:** Standard deployments, backward-compatible changes
44
-
45
- ### Blue-Green Deployment
46
-
47
- Run two identical environments. Switch traffic atomically.
48
-
49
- ```
50
- Blue (v1) ← traffic
51
- Green (v2) idle, running new version
52
-
53
- # After verification:
54
- Blue (v1) idle (becomes standby)
55
- Green (v2) ← traffic
56
- ```
57
-
58
- **Pros:** Instant rollback (switch back to blue), clean cutover
59
- **Cons:** Requires 2x infrastructure during deployment
60
- **Use when:** Critical services, zero-tolerance for issues
61
-
62
- ### Canary Deployment
63
-
64
- Route a small percentage of traffic to the new version first.
65
-
66
- ```
67
- v1: 95% of traffic
68
- v2: 5% of traffic (canary)
69
-
70
- # If metrics look good:
71
- v1: 50% of traffic
72
- v2: 50% of traffic
73
-
74
- # Final:
75
- v2: 100% of traffic
76
- ```
77
-
78
- **Pros:** Catches issues with real traffic before full rollout
79
- **Cons:** Requires traffic splitting infrastructure, monitoring
80
- **Use when:** High-traffic services, risky changes, feature flags
81
-
82
- ## Docker
83
-
84
- ### Multi-Stage Dockerfile (Node.js)
85
-
86
- ```dockerfile
87
- # Stage 1: Install dependencies
88
- FROM node:22-alpine AS deps
89
- WORKDIR /app
90
- COPY package.json package-lock.json ./
91
- RUN npm ci --production=false
92
-
93
- # Stage 2: Build
94
- FROM node:22-alpine AS builder
95
- WORKDIR /app
96
- COPY --from=deps /app/node_modules ./node_modules
97
- COPY . .
98
- RUN npm run build
99
- RUN npm prune --production
100
-
101
- # Stage 3: Production image
102
- FROM node:22-alpine AS runner
103
- WORKDIR /app
104
-
105
- RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
106
- USER appuser
107
-
108
- COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
109
- COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
110
- COPY --from=builder --chown=appuser:appgroup /app/package.json ./
111
-
112
- ENV NODE_ENV=production
113
- EXPOSE 3000
114
-
115
- HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
116
- CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
117
-
118
- CMD ["node", "dist/server.js"]
119
- ```
120
-
121
- ### Multi-Stage Dockerfile (Go)
122
-
123
- ```dockerfile
124
- FROM golang:1.22-alpine AS builder
125
- WORKDIR /app
126
- COPY go.mod go.sum ./
127
- RUN go mod download
128
- COPY . .
129
- RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server ./cmd/server
130
-
131
- FROM alpine:3.19 AS runner
132
- RUN apk --no-cache add ca-certificates
133
- RUN adduser -D -u 1001 appuser
134
- USER appuser
135
-
136
- COPY --from=builder /server /server
137
-
138
- EXPOSE 8080
139
- HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:8080/health || exit 1
140
- CMD ["/server"]
141
- ```
142
-
143
- ### Multi-Stage Dockerfile (Python/Django)
144
-
145
- ```dockerfile
146
- FROM python:3.12-slim AS builder
147
- WORKDIR /app
148
- RUN pip install --no-cache-dir uv
149
- COPY requirements.txt .
150
- RUN uv pip install --system --no-cache -r requirements.txt
151
-
152
- FROM python:3.12-slim AS runner
153
- WORKDIR /app
154
-
155
- RUN useradd -r -u 1001 appuser
156
- USER appuser
157
-
158
- COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
159
- COPY --from=builder /usr/local/bin /usr/local/bin
160
- COPY . .
161
-
162
- ENV PYTHONUNBUFFERED=1
163
- EXPOSE 8000
164
-
165
- HEALTHCHECK --interval=30s --timeout=3s CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health/')" || exit 1
166
- CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
167
- ```
168
-
169
- ### Docker Best Practices
170
-
171
- ```
172
- # GOOD practices
173
- - Use specific version tags (node:22-alpine, not node:latest)
174
- - Multi-stage builds to minimize image size
175
- - Run as non-root user
176
- - Copy dependency files first (layer caching)
177
- - Use .dockerignore to exclude node_modules, .git, tests
178
- - Add HEALTHCHECK instruction
179
- - Set resource limits in docker-compose or k8s
180
-
181
- # BAD practices
182
- - Running as root
183
- - Using :latest tags
184
- - Copying entire repo in one COPY layer
185
- - Installing dev dependencies in production image
186
- - Storing secrets in image (use env vars or secrets manager)
187
- ```
188
-
189
- ## CI/CD Pipeline
190
-
191
- ### GitHub Actions (Standard Pipeline)
192
-
193
- ```yaml
194
- name: CI/CD
195
-
196
- on:
197
- push:
198
- branches: [main]
199
- pull_request:
200
- branches: [main]
201
-
202
- jobs:
203
- test:
204
- runs-on: ubuntu-latest
205
- steps:
206
- - uses: actions/checkout@v4
207
- - uses: actions/setup-node@v4
208
- with:
209
- node-version: 22
210
- cache: npm
211
- - run: npm ci
212
- - run: npm run lint
213
- - run: npm run typecheck
214
- - run: npm test -- --coverage
215
- - uses: actions/upload-artifact@v4
216
- if: always()
217
- with:
218
- name: coverage
219
- path: coverage/
220
-
221
- build:
222
- needs: test
223
- runs-on: ubuntu-latest
224
- if: github.ref == 'refs/heads/main'
225
- steps:
226
- - uses: actions/checkout@v4
227
- - uses: docker/setup-buildx-action@v3
228
- - uses: docker/login-action@v3
229
- with:
230
- registry: ghcr.io
231
- username: ${{ github.actor }}
232
- password: ${{ secrets.GITHUB_TOKEN }}
233
- - uses: docker/build-push-action@v5
234
- with:
235
- push: true
236
- tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
237
- cache-from: type=gha
238
- cache-to: type=gha,mode=max
239
-
240
- deploy:
241
- needs: build
242
- runs-on: ubuntu-latest
243
- if: github.ref == 'refs/heads/main'
244
- environment: production
245
- steps:
246
- - name: Deploy to production
247
- run: |
248
- # Platform-specific deployment command
249
- # Railway: railway up
250
- # Vercel: vercel --prod
251
- # K8s: kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}
252
- echo "Deploying ${{ github.sha }}"
253
- ```
254
-
255
- ### Pipeline Stages
256
-
257
- ```
258
- PR opened:
259
- lint → typecheck → unit tests → integration tests → preview deploy
260
-
261
- Merged to main:
262
- lint → typecheck → unit tests → integration tests → build image → deploy staging → smoke tests → deploy production
263
- ```
264
-
265
- ## Health Checks
266
-
267
- ### Health Check Endpoint
268
-
269
- ```typescript
270
- // Simple health check
271
- app.get("/health", (req, res) => {
272
- res.status(200).json({ status: "ok" });
273
- });
274
-
275
- // Detailed health check (for internal monitoring)
276
- app.get("/health/detailed", async (req, res) => {
277
- const checks = {
278
- database: await checkDatabase(),
279
- redis: await checkRedis(),
280
- externalApi: await checkExternalApi(),
281
- };
282
-
283
- const allHealthy = Object.values(checks).every(c => c.status === "ok");
284
-
285
- res.status(allHealthy ? 200 : 503).json({
286
- status: allHealthy ? "ok" : "degraded",
287
- timestamp: new Date().toISOString(),
288
- version: process.env.APP_VERSION || "unknown",
289
- uptime: process.uptime(),
290
- checks,
291
- });
292
- });
293
-
294
- async function checkDatabase(): Promise<HealthCheck> {
295
- try {
296
- await db.query("SELECT 1");
297
- return { status: "ok", latency_ms: 2 };
298
- } catch (err) {
299
- return { status: "error", message: "Database unreachable" };
300
- }
301
- }
302
- ```
303
-
304
- ### Kubernetes Probes
305
-
306
- ```yaml
307
- livenessProbe:
308
- httpGet:
309
- path: /health
310
- port: 3000
311
- initialDelaySeconds: 10
312
- periodSeconds: 30
313
- failureThreshold: 3
314
-
315
- readinessProbe:
316
- httpGet:
317
- path: /health
318
- port: 3000
319
- initialDelaySeconds: 5
320
- periodSeconds: 10
321
- failureThreshold: 2
322
-
323
- startupProbe:
324
- httpGet:
325
- path: /health
326
- port: 3000
327
- initialDelaySeconds: 0
328
- periodSeconds: 5
329
- failureThreshold: 30 # 30 * 5s = 150s max startup time
330
- ```
331
-
332
- ## Environment Configuration
333
-
334
- ### Twelve-Factor App Pattern
335
-
336
- ```bash
337
- # All config via environment variables — never in code
338
- DATABASE_URL=postgres://user:pass@host:5432/db
339
- REDIS_URL=redis://host:6379/0
340
- API_KEY=${API_KEY} # injected by secrets manager
341
- LOG_LEVEL=info
342
- PORT=3000
343
-
344
- # Environment-specific behavior
345
- NODE_ENV=production # or staging, development
346
- APP_ENV=production # explicit app environment
347
- ```
348
-
349
- ### Configuration Validation
350
-
351
- ```typescript
352
- import { z } from "zod";
353
-
354
- const envSchema = z.object({
355
- NODE_ENV: z.enum(["development", "staging", "production"]),
356
- PORT: z.coerce.number().default(3000),
357
- DATABASE_URL: z.string().url(),
358
- REDIS_URL: z.string().url(),
359
- JWT_SECRET: z.string().min(32),
360
- LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
361
- });
362
-
363
- // Validate at startup — fail fast if config is wrong
364
- export const env = envSchema.parse(process.env);
365
- ```
366
-
367
- ## Rollback Strategy
368
-
369
- ### Instant Rollback
370
-
371
- ```bash
372
- # Docker/Kubernetes: point to previous image
373
- kubectl rollout undo deployment/app
374
-
375
- # Vercel: promote previous deployment
376
- vercel rollback
377
-
378
- # Railway: redeploy previous commit
379
- railway up --commit <previous-sha>
380
-
381
- # Database: rollback migration (if reversible)
382
- npx prisma migrate resolve --rolled-back <migration-name>
383
- ```
384
-
385
- ### Rollback Checklist
386
-
387
- - [ ] Previous image/artifact is available and tagged
388
- - [ ] Database migrations are backward-compatible (no destructive changes)
389
- - [ ] Feature flags can disable new features without deploy
390
- - [ ] Monitoring alerts configured for error rate spikes
391
- - [ ] Rollback tested in staging before production release
392
-
393
- ## Production Readiness Checklist
394
-
395
- Before any production deployment:
396
-
397
- ### Application
398
- - [ ] All tests pass (unit, integration, E2E)
399
- - [ ] No hardcoded secrets in code or config files
400
- - [ ] Error handling covers all edge cases
401
- - [ ] Logging is structured (JSON) and does not contain PII
402
- - [ ] Health check endpoint returns meaningful status
403
-
404
- ### Infrastructure
405
- - [ ] Docker image builds reproducibly (pinned versions)
406
- - [ ] Environment variables documented and validated at startup
407
- - [ ] Resource limits set (CPU, memory)
408
- - [ ] Horizontal scaling configured (min/max instances)
409
- - [ ] SSL/TLS enabled on all endpoints
410
-
411
- ### Monitoring
412
- - [ ] Application metrics exported (request rate, latency, errors)
413
- - [ ] Alerts configured for error rate > threshold
414
- - [ ] Log aggregation set up (structured logs, searchable)
415
- - [ ] Uptime monitoring on health endpoint
416
-
417
- ### Security
418
- - [ ] Dependencies scanned for CVEs
419
- - [ ] CORS configured for allowed origins only
420
- - [ ] Rate limiting enabled on public endpoints
421
- - [ ] Authentication and authorization verified
422
- - [ ] Security headers set (CSP, HSTS, X-Frame-Options)
423
-
424
- ### Operations
425
- - [ ] Rollback plan documented and tested
426
- - [ ] Database migration tested against production-sized data
427
- - [ ] Runbook for common failure scenarios
428
- - [ ] On-call rotation and escalation path defined
1
+ ---
2
+ name: deployment-patterns
3
+ description: Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
4
+ metadata:
5
+ origin: ECC
6
+ ---
7
+
8
+ # Deployment Patterns
9
+
10
+ Production deployment workflows and CI/CD best practices.
11
+
12
+ ## When to Activate
13
+
14
+ - Setting up CI/CD pipelines
15
+ - Dockerizing an application
16
+ - Planning deployment strategy (blue-green, canary, rolling)
17
+ - Implementing health checks and readiness probes
18
+ - Preparing for a production release
19
+ - Configuring environment-specific settings
20
+
21
+ ## Deployment Strategies
22
+
23
+ ### Rolling Deployment (Default)
24
+
25
+ Replace instances gradually — old and new versions run simultaneously during rollout.
26
+
27
+ ```
28
+ Instance 1: v1 → v2 (update first)
29
+ Instance 2: v1 (still running v1)
30
+ Instance 3: v1 (still running v1)
31
+
32
+ Instance 1: v2
33
+ Instance 2: v1 → v2 (update second)
34
+ Instance 3: v1
35
+
36
+ Instance 1: v2
37
+ Instance 2: v2
38
+ Instance 3: v1 → v2 (update last)
39
+ ```
40
+
41
+ **Pros:** Zero downtime, gradual rollout
42
+ **Cons:** Two versions run simultaneously — requires backward-compatible changes
43
+ **Use when:** Standard deployments, backward-compatible changes
44
+
45
+ ### Blue-Green Deployment
46
+
47
+ Run two identical environments. Switch traffic atomically.
48
+
49
+ ```
50
+ Blue (v1) ← traffic
51
+ Green (v2) idle, running new version
52
+
53
+ # After verification:
54
+ Blue (v1) idle (becomes standby)
55
+ Green (v2) ← traffic
56
+ ```
57
+
58
+ **Pros:** Instant rollback (switch back to blue), clean cutover
59
+ **Cons:** Requires 2x infrastructure during deployment
60
+ **Use when:** Critical services, zero-tolerance for issues
61
+
62
+ ### Canary Deployment
63
+
64
+ Route a small percentage of traffic to the new version first.
65
+
66
+ ```
67
+ v1: 95% of traffic
68
+ v2: 5% of traffic (canary)
69
+
70
+ # If metrics look good:
71
+ v1: 50% of traffic
72
+ v2: 50% of traffic
73
+
74
+ # Final:
75
+ v2: 100% of traffic
76
+ ```
77
+
78
+ **Pros:** Catches issues with real traffic before full rollout
79
+ **Cons:** Requires traffic splitting infrastructure, monitoring
80
+ **Use when:** High-traffic services, risky changes, feature flags
81
+
82
+ ## Docker
83
+
84
+ ### Multi-Stage Dockerfile (Node.js)
85
+
86
+ ```dockerfile
87
+ # Stage 1: Install dependencies
88
+ FROM node:22-alpine AS deps
89
+ WORKDIR /app
90
+ COPY package.json package-lock.json ./
91
+ RUN npm ci --production=false
92
+
93
+ # Stage 2: Build
94
+ FROM node:22-alpine AS builder
95
+ WORKDIR /app
96
+ COPY --from=deps /app/node_modules ./node_modules
97
+ COPY . .
98
+ RUN npm run build
99
+ RUN npm prune --production
100
+
101
+ # Stage 3: Production image
102
+ FROM node:22-alpine AS runner
103
+ WORKDIR /app
104
+
105
+ RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
106
+ USER appuser
107
+
108
+ COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
109
+ COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
110
+ COPY --from=builder --chown=appuser:appgroup /app/package.json ./
111
+
112
+ ENV NODE_ENV=production
113
+ EXPOSE 3000
114
+
115
+ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
116
+ CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
117
+
118
+ CMD ["node", "dist/server.js"]
119
+ ```
120
+
121
+ ### Multi-Stage Dockerfile (Go)
122
+
123
+ ```dockerfile
124
+ FROM golang:1.22-alpine AS builder
125
+ WORKDIR /app
126
+ COPY go.mod go.sum ./
127
+ RUN go mod download
128
+ COPY . .
129
+ RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server ./cmd/server
130
+
131
+ FROM alpine:3.19 AS runner
132
+ RUN apk --no-cache add ca-certificates
133
+ RUN adduser -D -u 1001 appuser
134
+ USER appuser
135
+
136
+ COPY --from=builder /server /server
137
+
138
+ EXPOSE 8080
139
+ HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:8080/health || exit 1
140
+ CMD ["/server"]
141
+ ```
142
+
143
+ ### Multi-Stage Dockerfile (Python/Django)
144
+
145
+ ```dockerfile
146
+ FROM python:3.12-slim AS builder
147
+ WORKDIR /app
148
+ RUN pip install --no-cache-dir uv
149
+ COPY requirements.txt .
150
+ RUN uv pip install --system --no-cache -r requirements.txt
151
+
152
+ FROM python:3.12-slim AS runner
153
+ WORKDIR /app
154
+
155
+ RUN useradd -r -u 1001 appuser
156
+ USER appuser
157
+
158
+ COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
159
+ COPY --from=builder /usr/local/bin /usr/local/bin
160
+ COPY . .
161
+
162
+ ENV PYTHONUNBUFFERED=1
163
+ EXPOSE 8000
164
+
165
+ HEALTHCHECK --interval=30s --timeout=3s CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health/')" || exit 1
166
+ CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
167
+ ```
168
+
169
+ ### Docker Best Practices
170
+
171
+ ```
172
+ # GOOD practices
173
+ - Use specific version tags (node:22-alpine, not node:latest)
174
+ - Multi-stage builds to minimize image size
175
+ - Run as non-root user
176
+ - Copy dependency files first (layer caching)
177
+ - Use .dockerignore to exclude node_modules, .git, tests
178
+ - Add HEALTHCHECK instruction
179
+ - Set resource limits in docker-compose or k8s
180
+
181
+ # BAD practices
182
+ - Running as root
183
+ - Using :latest tags
184
+ - Copying entire repo in one COPY layer
185
+ - Installing dev dependencies in production image
186
+ - Storing secrets in image (use env vars or secrets manager)
187
+ ```
188
+
189
+ ## CI/CD Pipeline
190
+
191
+ ### GitHub Actions (Standard Pipeline)
192
+
193
+ ```yaml
194
+ name: CI/CD
195
+
196
+ on:
197
+ push:
198
+ branches: [main]
199
+ pull_request:
200
+ branches: [main]
201
+
202
+ jobs:
203
+ test:
204
+ runs-on: ubuntu-latest
205
+ steps:
206
+ - uses: actions/checkout@v4
207
+ - uses: actions/setup-node@v4
208
+ with:
209
+ node-version: 22
210
+ cache: npm
211
+ - run: npm ci
212
+ - run: npm run lint
213
+ - run: npm run typecheck
214
+ - run: npm test -- --coverage
215
+ - uses: actions/upload-artifact@v4
216
+ if: always()
217
+ with:
218
+ name: coverage
219
+ path: coverage/
220
+
221
+ build:
222
+ needs: test
223
+ runs-on: ubuntu-latest
224
+ if: github.ref == 'refs/heads/main'
225
+ steps:
226
+ - uses: actions/checkout@v4
227
+ - uses: docker/setup-buildx-action@v3
228
+ - uses: docker/login-action@v3
229
+ with:
230
+ registry: ghcr.io
231
+ username: ${{ github.actor }}
232
+ password: ${{ secrets.GITHUB_TOKEN }}
233
+ - uses: docker/build-push-action@v5
234
+ with:
235
+ push: true
236
+ tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
237
+ cache-from: type=gha
238
+ cache-to: type=gha,mode=max
239
+
240
+ deploy:
241
+ needs: build
242
+ runs-on: ubuntu-latest
243
+ if: github.ref == 'refs/heads/main'
244
+ environment: production
245
+ steps:
246
+ - name: Deploy to production
247
+ run: |
248
+ # Platform-specific deployment command
249
+ # Railway: railway up
250
+ # Vercel: vercel --prod
251
+ # K8s: kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}
252
+ echo "Deploying ${{ github.sha }}"
253
+ ```
254
+
255
+ ### Pipeline Stages
256
+
257
+ ```
258
+ PR opened:
259
+ lint → typecheck → unit tests → integration tests → preview deploy
260
+
261
+ Merged to main:
262
+ lint → typecheck → unit tests → integration tests → build image → deploy staging → smoke tests → deploy production
263
+ ```
264
+
265
+ ## Health Checks
266
+
267
+ ### Health Check Endpoint
268
+
269
+ ```typescript
270
+ // Simple health check
271
+ app.get("/health", (req, res) => {
272
+ res.status(200).json({ status: "ok" });
273
+ });
274
+
275
+ // Detailed health check (for internal monitoring)
276
+ app.get("/health/detailed", async (req, res) => {
277
+ const checks = {
278
+ database: await checkDatabase(),
279
+ redis: await checkRedis(),
280
+ externalApi: await checkExternalApi(),
281
+ };
282
+
283
+ const allHealthy = Object.values(checks).every(c => c.status === "ok");
284
+
285
+ res.status(allHealthy ? 200 : 503).json({
286
+ status: allHealthy ? "ok" : "degraded",
287
+ timestamp: new Date().toISOString(),
288
+ version: process.env.APP_VERSION || "unknown",
289
+ uptime: process.uptime(),
290
+ checks,
291
+ });
292
+ });
293
+
294
+ async function checkDatabase(): Promise<HealthCheck> {
295
+ try {
296
+ await db.query("SELECT 1");
297
+ return { status: "ok", latency_ms: 2 };
298
+ } catch (err) {
299
+ return { status: "error", message: "Database unreachable" };
300
+ }
301
+ }
302
+ ```
303
+
304
+ ### Kubernetes Probes
305
+
306
+ ```yaml
307
+ livenessProbe:
308
+ httpGet:
309
+ path: /health
310
+ port: 3000
311
+ initialDelaySeconds: 10
312
+ periodSeconds: 30
313
+ failureThreshold: 3
314
+
315
+ readinessProbe:
316
+ httpGet:
317
+ path: /health
318
+ port: 3000
319
+ initialDelaySeconds: 5
320
+ periodSeconds: 10
321
+ failureThreshold: 2
322
+
323
+ startupProbe:
324
+ httpGet:
325
+ path: /health
326
+ port: 3000
327
+ initialDelaySeconds: 0
328
+ periodSeconds: 5
329
+ failureThreshold: 30 # 30 * 5s = 150s max startup time
330
+ ```
331
+
332
+ ## Environment Configuration
333
+
334
+ ### Twelve-Factor App Pattern
335
+
336
+ ```bash
337
+ # All config via environment variables — never in code
338
+ DATABASE_URL=postgres://user:pass@host:5432/db
339
+ REDIS_URL=redis://host:6379/0
340
+ API_KEY=${API_KEY} # injected by secrets manager
341
+ LOG_LEVEL=info
342
+ PORT=3000
343
+
344
+ # Environment-specific behavior
345
+ NODE_ENV=production # or staging, development
346
+ APP_ENV=production # explicit app environment
347
+ ```
348
+
349
+ ### Configuration Validation
350
+
351
+ ```typescript
352
+ import { z } from "zod";
353
+
354
+ const envSchema = z.object({
355
+ NODE_ENV: z.enum(["development", "staging", "production"]),
356
+ PORT: z.coerce.number().default(3000),
357
+ DATABASE_URL: z.string().url(),
358
+ REDIS_URL: z.string().url(),
359
+ JWT_SECRET: z.string().min(32),
360
+ LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
361
+ });
362
+
363
+ // Validate at startup — fail fast if config is wrong
364
+ export const env = envSchema.parse(process.env);
365
+ ```
366
+
367
+ ## Rollback Strategy
368
+
369
+ ### Instant Rollback
370
+
371
+ ```bash
372
+ # Docker/Kubernetes: point to previous image
373
+ kubectl rollout undo deployment/app
374
+
375
+ # Vercel: promote previous deployment
376
+ vercel rollback
377
+
378
+ # Railway: redeploy previous commit
379
+ railway up --commit <previous-sha>
380
+
381
+ # Database: rollback migration (if reversible)
382
+ npx prisma migrate resolve --rolled-back <migration-name>
383
+ ```
384
+
385
+ ### Rollback Checklist
386
+
387
+ - [ ] Previous image/artifact is available and tagged
388
+ - [ ] Database migrations are backward-compatible (no destructive changes)
389
+ - [ ] Feature flags can disable new features without deploy
390
+ - [ ] Monitoring alerts configured for error rate spikes
391
+ - [ ] Rollback tested in staging before production release
392
+
393
+ ## Production Readiness Checklist
394
+
395
+ Before any production deployment:
396
+
397
+ ### Application
398
+ - [ ] All tests pass (unit, integration, E2E)
399
+ - [ ] No hardcoded secrets in code or config files
400
+ - [ ] Error handling covers all edge cases
401
+ - [ ] Logging is structured (JSON) and does not contain PII
402
+ - [ ] Health check endpoint returns meaningful status
403
+
404
+ ### Infrastructure
405
+ - [ ] Docker image builds reproducibly (pinned versions)
406
+ - [ ] Environment variables documented and validated at startup
407
+ - [ ] Resource limits set (CPU, memory)
408
+ - [ ] Horizontal scaling configured (min/max instances)
409
+ - [ ] SSL/TLS enabled on all endpoints
410
+
411
+ ### Monitoring
412
+ - [ ] Application metrics exported (request rate, latency, errors)
413
+ - [ ] Alerts configured for error rate > threshold
414
+ - [ ] Log aggregation set up (structured logs, searchable)
415
+ - [ ] Uptime monitoring on health endpoint
416
+
417
+ ### Security
418
+ - [ ] Dependencies scanned for CVEs
419
+ - [ ] CORS configured for allowed origins only
420
+ - [ ] Rate limiting enabled on public endpoints
421
+ - [ ] Authentication and authorization verified
422
+ - [ ] Security headers set (CSP, HSTS, X-Frame-Options)
423
+
424
+ ### Operations
425
+ - [ ] Rollback plan documented and tested
426
+ - [ ] Database migration tested against production-sized data
427
+ - [ ] Runbook for common failure scenarios
428
+ - [ ] On-call rotation and escalation path defined