codeply-cli 0.3.1 → 0.4.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 (375) hide show
  1. package/THIRD_PARTY_NOTICES.md +63 -63
  2. package/bin/codeply.js +127 -0
  3. package/lib/agent.mjs +2139 -2139
  4. package/lib/ai.mjs +6 -6
  5. package/lib/apply-patch.js +217 -217
  6. package/lib/arity-table.json +138 -138
  7. package/lib/arity.js +70 -70
  8. package/lib/auth.mjs +6 -6
  9. package/lib/cloud.mjs +708 -0
  10. package/lib/commands.js +103 -103
  11. package/lib/design-library/assemble-artifact.mjs +21 -21
  12. package/lib/design-library/cleanup.mjs +45 -45
  13. package/lib/design-library/index.json +22379 -22379
  14. package/lib/design-library/make-table-data.mjs +39 -39
  15. package/lib/diagnostics.js +192 -192
  16. package/lib/edit-engine.js +364 -364
  17. package/lib/github-agent.mjs +311 -307
  18. package/lib/history.js +75 -75
  19. package/lib/mcp.js +258 -258
  20. package/lib/native-tools.mjs +189 -189
  21. package/lib/oauth-connectors.js +2 -1
  22. package/lib/permissions.js +109 -109
  23. package/lib/plugins.js +353 -353
  24. package/lib/server.mjs +457 -457
  25. package/lib/session-db.js +220 -220
  26. package/lib/share.js +168 -168
  27. package/lib/skills.js +416 -416
  28. package/lib/snapshot.js +146 -146
  29. package/lib/terminal-hints.js +154 -154
  30. package/lib/tools.mjs +2012 -2012
  31. package/lib/typecheck-worker.js +147 -147
  32. package/lib/web-tools.js +158 -158
  33. package/package.json +49 -47
  34. package/skills/SOURCE.md +58 -58
  35. package/skills/accessibility/SKILL.md +147 -147
  36. package/skills/agent-architecture-audit/SKILL.md +257 -257
  37. package/skills/agent-eval/SKILL.md +147 -147
  38. package/skills/agent-harness-construction/SKILL.md +74 -74
  39. package/skills/agent-introspection-debugging/SKILL.md +154 -154
  40. package/skills/agent-payment-x402/SKILL.md +225 -225
  41. package/skills/agent-self-evaluation/SKILL.md +182 -182
  42. package/skills/agent-self-evaluation/references/evaluation-criteria.md +71 -71
  43. package/skills/agent-self-evaluation/references/hook-integration.md +64 -64
  44. package/skills/agent-sort/SKILL.md +216 -216
  45. package/skills/agentic-engineering/SKILL.md +64 -64
  46. package/skills/agentic-os/SKILL.md +388 -388
  47. package/skills/ai-first-engineering/SKILL.md +52 -52
  48. package/skills/ai-regression-testing/SKILL.md +386 -386
  49. package/skills/android-clean-architecture/SKILL.md +340 -340
  50. package/skills/angular-developer/SKILL.md +155 -155
  51. package/skills/angular-developer/references/angular-animations.md +160 -160
  52. package/skills/angular-developer/references/angular-aria.md +410 -410
  53. package/skills/angular-developer/references/cli.md +86 -86
  54. package/skills/angular-developer/references/component-harnesses.md +59 -59
  55. package/skills/angular-developer/references/component-styling.md +91 -91
  56. package/skills/angular-developer/references/components.md +117 -117
  57. package/skills/angular-developer/references/creating-services.md +97 -97
  58. package/skills/angular-developer/references/data-resolvers.md +69 -69
  59. package/skills/angular-developer/references/define-routes.md +67 -67
  60. package/skills/angular-developer/references/defining-providers.md +72 -72
  61. package/skills/angular-developer/references/di-fundamentals.md +120 -120
  62. package/skills/angular-developer/references/e2e-testing.md +56 -56
  63. package/skills/angular-developer/references/effects.md +83 -83
  64. package/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  65. package/skills/angular-developer/references/host-elements.md +80 -80
  66. package/skills/angular-developer/references/injection-context.md +63 -63
  67. package/skills/angular-developer/references/inputs.md +101 -101
  68. package/skills/angular-developer/references/linked-signal.md +59 -59
  69. package/skills/angular-developer/references/loading-strategies.md +61 -61
  70. package/skills/angular-developer/references/mcp.md +108 -108
  71. package/skills/angular-developer/references/navigate-to-routes.md +69 -69
  72. package/skills/angular-developer/references/outputs.md +86 -86
  73. package/skills/angular-developer/references/reactive-forms.md +122 -122
  74. package/skills/angular-developer/references/rendering-strategies.md +44 -44
  75. package/skills/angular-developer/references/resource.md +77 -77
  76. package/skills/angular-developer/references/route-animations.md +56 -56
  77. package/skills/angular-developer/references/route-guards.md +52 -52
  78. package/skills/angular-developer/references/router-lifecycle.md +45 -45
  79. package/skills/angular-developer/references/router-testing.md +87 -87
  80. package/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  81. package/skills/angular-developer/references/signal-forms.md +795 -795
  82. package/skills/angular-developer/references/signals-overview.md +94 -94
  83. package/skills/angular-developer/references/tailwind-css.md +69 -69
  84. package/skills/angular-developer/references/template-driven-forms.md +114 -114
  85. package/skills/angular-developer/references/testing-fundamentals.md +65 -65
  86. package/skills/api-connector-builder/SKILL.md +121 -121
  87. package/skills/api-design/SKILL.md +524 -524
  88. package/skills/architecture-decision-records/SKILL.md +180 -180
  89. package/skills/article-writing/SKILL.md +80 -80
  90. package/skills/automation-audit-ops/SKILL.md +143 -143
  91. package/skills/autonomous-agent-harness/SKILL.md +274 -274
  92. package/skills/autonomous-loops/SKILL.md +611 -611
  93. package/skills/backend-patterns/SKILL.md +562 -562
  94. package/skills/benchmark/SKILL.md +95 -95
  95. package/skills/benchmark-methodology/SKILL.md +191 -191
  96. package/skills/benchmark-optimization-loop/SKILL.md +71 -71
  97. package/skills/blender-motion-state-inspection/SKILL.md +165 -165
  98. package/skills/blueprint/SKILL.md +106 -106
  99. package/skills/brand-discovery/SKILL.md +145 -145
  100. package/skills/brand-discovery/references/10_purpose-why.md +40 -40
  101. package/skills/brand-discovery/references/20_positioning.md +44 -44
  102. package/skills/brand-discovery/references/30_audience-niche.md +52 -52
  103. package/skills/brand-discovery/references/40_personality-archetype.md +57 -57
  104. package/skills/brand-discovery/references/50_voice-tone.md +59 -59
  105. package/skills/brand-discovery/references/60_narrative-story.md +50 -50
  106. package/skills/brand-discovery/references/70_founder-tension.md +49 -49
  107. package/skills/brand-discovery/references/90_SYNTHESIS.md +133 -133
  108. package/skills/brand-voice/SKILL.md +98 -98
  109. package/skills/brand-voice/references/voice-profile-schema.md +55 -55
  110. package/skills/browser-qa/SKILL.md +105 -105
  111. package/skills/bun-runtime/SKILL.md +85 -85
  112. package/skills/canary-watch/SKILL.md +108 -108
  113. package/skills/carrier-relationship-management/SKILL.md +212 -212
  114. package/skills/cisco-ios-patterns/SKILL.md +164 -164
  115. package/skills/ck/SKILL.md +148 -148
  116. package/skills/claude-devfleet/SKILL.md +112 -112
  117. package/skills/click-path-audit/SKILL.md +245 -245
  118. package/skills/clickhouse-io/SKILL.md +445 -445
  119. package/skills/code-tour/SKILL.md +254 -254
  120. package/skills/codebase-onboarding/SKILL.md +234 -234
  121. package/skills/codehealth-mcp/SKILL.md +167 -167
  122. package/skills/coding-standards/SKILL.md +551 -551
  123. package/skills/competitive-platform-analysis/SKILL.md +214 -214
  124. package/skills/competitive-report-structure/SKILL.md +162 -162
  125. package/skills/compose-multiplatform-patterns/SKILL.md +300 -300
  126. package/skills/config-gc/SKILL.md +120 -120
  127. package/skills/configure-ecc/SKILL.md +385 -385
  128. package/skills/connections-optimizer/SKILL.md +190 -190
  129. package/skills/content-engine/SKILL.md +132 -132
  130. package/skills/content-hash-cache-pattern/SKILL.md +162 -162
  131. package/skills/context-budget/SKILL.md +136 -136
  132. package/skills/continuous-agent-loop/SKILL.md +46 -46
  133. package/skills/continuous-learning/SKILL.md +132 -132
  134. package/skills/continuous-learning-v2/SKILL.md +361 -361
  135. package/skills/contract-first/SKILL.md +287 -287
  136. package/skills/cost-aware-llm-pipeline/SKILL.md +184 -184
  137. package/skills/cost-tracking/SKILL.md +97 -97
  138. package/skills/council/SKILL.md +204 -204
  139. package/skills/cpp-coding-standards/SKILL.md +724 -724
  140. package/skills/cpp-testing/SKILL.md +325 -325
  141. package/skills/crosspost/SKILL.md +112 -112
  142. package/skills/csharp-testing/SKILL.md +322 -322
  143. package/skills/customer-billing-ops/SKILL.md +141 -141
  144. package/skills/customs-trade-compliance/SKILL.md +263 -263
  145. package/skills/dart-flutter-patterns/SKILL.md +564 -564
  146. package/skills/dashboard-builder/SKILL.md +109 -109
  147. package/skills/data-scraper-agent/SKILL.md +765 -765
  148. package/skills/data-throughput-accelerator/SKILL.md +74 -74
  149. package/skills/database-migrations/SKILL.md +430 -430
  150. package/skills/deep-research/SKILL.md +160 -160
  151. package/skills/defi-amm-security/SKILL.md +167 -167
  152. package/skills/delivery-gate/SKILL.md +126 -126
  153. package/skills/deployment-patterns/SKILL.md +428 -428
  154. package/skills/design-system/SKILL.md +83 -83
  155. package/skills/django-celery/SKILL.md +458 -458
  156. package/skills/django-patterns/SKILL.md +735 -735
  157. package/skills/django-security/SKILL.md +644 -644
  158. package/skills/django-tdd/SKILL.md +730 -730
  159. package/skills/django-verification/SKILL.md +470 -470
  160. package/skills/dmux-workflows/SKILL.md +192 -192
  161. package/skills/docker-patterns/SKILL.md +365 -365
  162. package/skills/documentation-lookup/SKILL.md +91 -91
  163. package/skills/dotnet-patterns/SKILL.md +322 -322
  164. package/skills/dynamic-workflow-mode/SKILL.md +124 -124
  165. package/skills/e2e-testing/SKILL.md +327 -327
  166. package/skills/ecc-guide/SKILL.md +190 -190
  167. package/skills/ecc-recipes/SKILL.md +149 -149
  168. package/skills/ecc-tools-cost-audit/SKILL.md +161 -161
  169. package/skills/email-ops/SKILL.md +122 -122
  170. package/skills/energy-procurement/SKILL.md +228 -228
  171. package/skills/enterprise-agent-ops/SKILL.md +51 -51
  172. package/skills/error-handling/SKILL.md +377 -377
  173. package/skills/eval-harness/SKILL.md +271 -271
  174. package/skills/evm-token-decimals/SKILL.md +131 -131
  175. package/skills/exa-search/SKILL.md +108 -108
  176. package/skills/fal-ai-media/SKILL.md +289 -289
  177. package/skills/fastapi-patterns/SKILL.md +514 -514
  178. package/skills/finance-billing-ops/SKILL.md +128 -128
  179. package/skills/flox-environments/SKILL.md +497 -497
  180. package/skills/flutter-dart-code-review/SKILL.md +436 -436
  181. package/skills/foundation-models-on-device/SKILL.md +243 -243
  182. package/skills/frontend-a11y/SKILL.md +446 -446
  183. package/skills/frontend-design-direction/SKILL.md +93 -93
  184. package/skills/frontend-patterns/SKILL.md +657 -657
  185. package/skills/frontend-slides/SKILL.md +185 -185
  186. package/skills/fsharp-testing/SKILL.md +281 -281
  187. package/skills/gan-style-harness/SKILL.md +279 -279
  188. package/skills/gateguard/SKILL.md +133 -133
  189. package/skills/generating-python-installer/SKILL.md +820 -820
  190. package/skills/git-workflow/SKILL.md +716 -716
  191. package/skills/github-ops/SKILL.md +145 -145
  192. package/skills/golang-patterns/SKILL.md +676 -676
  193. package/skills/golang-testing/SKILL.md +721 -721
  194. package/skills/google-workspace-ops/SKILL.md +96 -96
  195. package/skills/growth-log/SKILL.md +128 -128
  196. package/skills/healthcare-cdss-patterns/SKILL.md +246 -246
  197. package/skills/healthcare-emr-patterns/SKILL.md +160 -160
  198. package/skills/healthcare-eval-harness/SKILL.md +208 -208
  199. package/skills/healthcare-phi-compliance/SKILL.md +146 -146
  200. package/skills/hermes-imports/SKILL.md +89 -89
  201. package/skills/hexagonal-architecture/SKILL.md +277 -277
  202. package/skills/hipaa-compliance/SKILL.md +79 -79
  203. package/skills/homelab-network-readiness/SKILL.md +170 -170
  204. package/skills/homelab-network-setup/SKILL.md +130 -130
  205. package/skills/homelab-pihole-dns/SKILL.md +275 -275
  206. package/skills/homelab-vlan-segmentation/SKILL.md +312 -312
  207. package/skills/homelab-wireguard-vpn/SKILL.md +306 -306
  208. package/skills/hookify-rules/SKILL.md +128 -128
  209. package/skills/inherit-legacy-style/SKILL.md +157 -157
  210. package/skills/intent-driven-development/SKILL.md +360 -360
  211. package/skills/inventory-demand-planning/SKILL.md +247 -247
  212. package/skills/investor-materials/SKILL.md +97 -97
  213. package/skills/investor-outreach/SKILL.md +92 -92
  214. package/skills/ios-icon-gen/SKILL.md +158 -158
  215. package/skills/iterative-retrieval/SKILL.md +212 -212
  216. package/skills/ito-basket-compare/SKILL.md +64 -64
  217. package/skills/ito-compute/SKILL.md +129 -129
  218. package/skills/ito-data-atlas-agent/SKILL.md +64 -64
  219. package/skills/ito-market-intelligence/SKILL.md +61 -61
  220. package/skills/ito-trade-planner/SKILL.md +68 -68
  221. package/skills/java-coding-standards/SKILL.md +384 -384
  222. package/skills/jira-integration/SKILL.md +303 -303
  223. package/skills/jpa-patterns/SKILL.md +152 -152
  224. package/skills/knowledge-ops/SKILL.md +155 -155
  225. package/skills/kotlin-coroutines-flows/SKILL.md +285 -285
  226. package/skills/kotlin-exposed-patterns/SKILL.md +720 -720
  227. package/skills/kotlin-ktor-patterns/SKILL.md +690 -690
  228. package/skills/kotlin-patterns/SKILL.md +712 -712
  229. package/skills/kotlin-testing/SKILL.md +825 -825
  230. package/skills/kubernetes-patterns/SKILL.md +756 -756
  231. package/skills/laravel-patterns/SKILL.md +416 -416
  232. package/skills/laravel-plugin-discovery/SKILL.md +230 -230
  233. package/skills/laravel-security/SKILL.md +948 -948
  234. package/skills/laravel-tdd/SKILL.md +675 -675
  235. package/skills/laravel-verification/SKILL.md +180 -180
  236. package/skills/latency-critical-systems/SKILL.md +75 -75
  237. package/skills/lead-intelligence/SKILL.md +322 -322
  238. package/skills/liquid-glass-design/SKILL.md +279 -279
  239. package/skills/llm-trading-agent-security/SKILL.md +147 -147
  240. package/skills/logistics-exception-management/SKILL.md +222 -222
  241. package/skills/loop-design-check/SKILL.md +143 -143
  242. package/skills/mailtrap-email-integration/SKILL.md +77 -77
  243. package/skills/make-interfaces-feel-better/SKILL.md +152 -152
  244. package/skills/manim-video/SKILL.md +90 -90
  245. package/skills/market-research/SKILL.md +76 -76
  246. package/skills/marketing-campaign/SKILL.md +114 -114
  247. package/skills/mcp-server-patterns/SKILL.md +70 -70
  248. package/skills/messages-ops/SKILL.md +105 -105
  249. package/skills/ml-adoption-playbook/SKILL.md +57 -57
  250. package/skills/mle-workflow/SKILL.md +348 -348
  251. package/skills/motion-advanced/SKILL.md +596 -596
  252. package/skills/motion-foundations/SKILL.md +299 -299
  253. package/skills/motion-patterns/SKILL.md +434 -434
  254. package/skills/motion-ui/SKILL.md +576 -576
  255. package/skills/mysql-patterns/SKILL.md +413 -413
  256. package/skills/nanoclaw-repl/SKILL.md +34 -34
  257. package/skills/nestjs-patterns/SKILL.md +231 -231
  258. package/skills/netmiko-ssh-automation/SKILL.md +174 -174
  259. package/skills/network-bgp-diagnostics/SKILL.md +168 -168
  260. package/skills/network-config-validation/SKILL.md +211 -211
  261. package/skills/network-interface-health/SKILL.md +153 -153
  262. package/skills/nextjs-turbopack/SKILL.md +58 -58
  263. package/skills/nodejs-keccak256/SKILL.md +103 -103
  264. package/skills/nutrient-document-processing/SKILL.md +168 -168
  265. package/skills/nuxt4-patterns/SKILL.md +101 -101
  266. package/skills/openclaw-persona-forge/SKILL.md +289 -289
  267. package/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  268. package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  269. package/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  270. package/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  271. package/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  272. package/skills/openclaw-persona-forge/references/output-template.md +166 -166
  273. package/skills/opensource-pipeline/SKILL.md +256 -256
  274. package/skills/orch-add-feature/SKILL.md +45 -45
  275. package/skills/orch-build-mvp/SKILL.md +49 -49
  276. package/skills/orch-change-feature/SKILL.md +43 -43
  277. package/skills/orch-fix-defect/SKILL.md +43 -43
  278. package/skills/orch-pipeline/SKILL.md +121 -121
  279. package/skills/orch-refine-code/SKILL.md +44 -44
  280. package/skills/parallel-execution-optimizer/SKILL.md +74 -74
  281. package/skills/perl-patterns/SKILL.md +505 -505
  282. package/skills/perl-security/SKILL.md +504 -504
  283. package/skills/perl-testing/SKILL.md +476 -476
  284. package/skills/plan-canvas/SKILL.md +153 -153
  285. package/skills/plan-orchestrate/SKILL.md +263 -263
  286. package/skills/plankton-code-quality/SKILL.md +237 -237
  287. package/skills/postgres-patterns/SKILL.md +148 -148
  288. package/skills/prediction-market-oracle-research/SKILL.md +64 -64
  289. package/skills/prediction-market-risk-review/SKILL.md +61 -61
  290. package/skills/premium-web-design/SKILL.md +154 -154
  291. package/skills/prisma-patterns/SKILL.md +401 -401
  292. package/skills/product-capability/SKILL.md +142 -142
  293. package/skills/product-lens/SKILL.md +93 -93
  294. package/skills/production-audit/SKILL.md +207 -207
  295. package/skills/production-scheduling/SKILL.md +238 -238
  296. package/skills/project-flow-ops/SKILL.md +112 -112
  297. package/skills/prompt-optimizer/SKILL.md +398 -398
  298. package/skills/python-patterns/SKILL.md +751 -751
  299. package/skills/python-testing/SKILL.md +817 -817
  300. package/skills/pytorch-patterns/SKILL.md +397 -397
  301. package/skills/quality-nonconformance/SKILL.md +260 -260
  302. package/skills/quarkus-patterns/SKILL.md +723 -723
  303. package/skills/quarkus-security/SKILL.md +468 -468
  304. package/skills/quarkus-tdd/SKILL.md +812 -812
  305. package/skills/quarkus-verification/SKILL.md +480 -480
  306. package/skills/ralphinho-rfc-pipeline/SKILL.md +68 -68
  307. package/skills/react-native-patterns/SKILL.md +326 -326
  308. package/skills/react-patterns/SKILL.md +342 -342
  309. package/skills/react-performance/SKILL.md +575 -575
  310. package/skills/react-testing/SKILL.md +424 -424
  311. package/skills/recsys-pipeline-architect/SKILL.md +115 -115
  312. package/skills/recursive-decision-ledger/SKILL.md +81 -81
  313. package/skills/redis-patterns/SKILL.md +404 -404
  314. package/skills/regex-vs-llm-structured-text/SKILL.md +221 -221
  315. package/skills/remotion-video-creation/SKILL.md +43 -43
  316. package/skills/repo-scan/SKILL.md +79 -79
  317. package/skills/research-ops/SKILL.md +113 -113
  318. package/skills/returns-reverse-logistics/SKILL.md +240 -240
  319. package/skills/rules-distill/SKILL.md +265 -265
  320. package/skills/rust-patterns/SKILL.md +500 -500
  321. package/skills/rust-testing/SKILL.md +501 -501
  322. package/skills/safety-guard/SKILL.md +76 -76
  323. package/skills/santa-method/SKILL.md +307 -307
  324. package/skills/scientific-db-pubmed-database/SKILL.md +176 -176
  325. package/skills/scientific-db-uspto-database/SKILL.md +178 -178
  326. package/skills/scientific-pkg-gget/SKILL.md +167 -167
  327. package/skills/scientific-thinking-literature-review/SKILL.md +193 -193
  328. package/skills/scientific-thinking-scholar-evaluation/SKILL.md +161 -161
  329. package/skills/search-first/SKILL.md +183 -183
  330. package/skills/security-bounty-hunter/SKILL.md +100 -100
  331. package/skills/security-review/SKILL.md +504 -504
  332. package/skills/security-scan/SKILL.md +166 -166
  333. package/skills/seo/SKILL.md +155 -155
  334. package/skills/skill-comply/SKILL.md +59 -59
  335. package/skills/skill-scout/SKILL.md +141 -141
  336. package/skills/skill-stocktake/SKILL.md +195 -195
  337. package/skills/social-graph-ranker/SKILL.md +155 -155
  338. package/skills/social-publisher/SKILL.md +130 -130
  339. package/skills/springboot-patterns/SKILL.md +315 -315
  340. package/skills/springboot-security/SKILL.md +273 -273
  341. package/skills/springboot-tdd/SKILL.md +159 -159
  342. package/skills/springboot-verification/SKILL.md +232 -232
  343. package/skills/strategic-compact/SKILL.md +142 -142
  344. package/skills/swift-actor-persistence/SKILL.md +144 -144
  345. package/skills/swift-concurrency-6-2/SKILL.md +216 -216
  346. package/skills/swift-protocol-di-testing/SKILL.md +191 -191
  347. package/skills/swiftui-patterns/SKILL.md +259 -259
  348. package/skills/taste/SKILL.md +264 -264
  349. package/skills/taste/references/genre-taxonomy.md +87 -87
  350. package/skills/tdd-workflow/SKILL.md +583 -583
  351. package/skills/team-agent-orchestration/SKILL.md +111 -111
  352. package/skills/team-builder/SKILL.md +169 -169
  353. package/skills/terminal-ops/SKILL.md +110 -110
  354. package/skills/tinystruct-patterns/SKILL.md +279 -279
  355. package/skills/tinystruct-patterns/references/architecture.md +90 -90
  356. package/skills/tinystruct-patterns/references/data-handling.md +60 -60
  357. package/skills/tinystruct-patterns/references/database.md +99 -99
  358. package/skills/tinystruct-patterns/references/routing.md +64 -64
  359. package/skills/tinystruct-patterns/references/system-usage.md +97 -97
  360. package/skills/tinystruct-patterns/references/testing.md +72 -72
  361. package/skills/token-budget-advisor/SKILL.md +134 -134
  362. package/skills/ui-demo/SKILL.md +466 -466
  363. package/skills/ui-to-vue/SKILL.md +135 -135
  364. package/skills/uncloud/SKILL.md +344 -344
  365. package/skills/unified-memory/SKILL.md +170 -170
  366. package/skills/unified-notifications-ops/SKILL.md +188 -188
  367. package/skills/verification-loop/SKILL.md +129 -129
  368. package/skills/video-editing/SKILL.md +311 -311
  369. package/skills/videodb/SKILL.md +375 -375
  370. package/skills/visa-doc-translate/SKILL.md +117 -117
  371. package/skills/vite-patterns/SKILL.md +450 -450
  372. package/skills/vue-patterns/SKILL.md +471 -471
  373. package/skills/windows-desktop-e2e/SKILL.md +888 -888
  374. package/skills/workspace-surface-audit/SKILL.md +126 -126
  375. 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