codeply-cli 0.3.1 → 0.4.1

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 +796 -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,504 +1,504 @@
1
- ---
2
- name: security-review
3
- description: Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.
4
- metadata:
5
- origin: ECC
6
- ---
7
-
8
- # Security Review Skill
9
-
10
- This skill ensures all code follows security best practices and identifies potential vulnerabilities.
11
-
12
- ## When to Activate
13
-
14
- - Implementing authentication or authorization
15
- - Handling user input or file uploads
16
- - Creating new API endpoints
17
- - Working with secrets or credentials
18
- - Implementing payment features
19
- - Storing or transmitting sensitive data
20
- - Integrating third-party APIs
21
-
22
- ## Security Checklist
23
-
24
- ### 1. Secrets Management
25
-
26
- #### FAIL: NEVER Do This
27
- ```typescript
28
- const apiKey = "sk-proj-xxxxx" // Hardcoded secret
29
- const dbPassword = "password123" // In source code
30
- ```
31
-
32
- #### PASS: ALWAYS Do This
33
- ```typescript
34
- const apiKey = process.env.OPENAI_API_KEY
35
- const dbUrl = process.env.DATABASE_URL
36
-
37
- // Verify secrets exist
38
- if (!apiKey) {
39
- throw new Error('OPENAI_API_KEY not configured')
40
- }
41
- ```
42
-
43
- #### Verification Steps
44
- - [ ] No hardcoded API keys, tokens, or passwords
45
- - [ ] All secrets in environment variables
46
- - [ ] `.env.local` in .gitignore
47
- - [ ] No secrets in git history
48
- - [ ] Production secrets in hosting platform (Vercel, Railway)
49
-
50
- ### 2. Input Validation
51
-
52
- #### Always Validate User Input
53
- ```typescript
54
- import { z } from 'zod'
55
-
56
- // Define validation schema
57
- const CreateUserSchema = z.object({
58
- email: z.string().email(),
59
- name: z.string().min(1).max(100),
60
- age: z.number().int().min(0).max(150)
61
- })
62
-
63
- // Validate before processing
64
- export async function createUser(input: unknown) {
65
- try {
66
- const validated = CreateUserSchema.parse(input)
67
- return await db.users.create(validated)
68
- } catch (error) {
69
- if (error instanceof z.ZodError) {
70
- return { success: false, errors: error.issues }
71
- }
72
- throw error
73
- }
74
- }
75
- ```
76
-
77
- #### File Upload Validation
78
- ```typescript
79
- function validateFileUpload(file: File) {
80
- // Size check (5MB max)
81
- const maxSize = 5 * 1024 * 1024
82
- if (file.size > maxSize) {
83
- throw new Error('File too large (max 5MB)')
84
- }
85
-
86
- // Type check
87
- const allowedTypes = ['image/jpeg', 'image/png', 'image/gif']
88
- if (!allowedTypes.includes(file.type)) {
89
- throw new Error('Invalid file type')
90
- }
91
-
92
- // Extension check
93
- const allowedExtensions = ['.jpg', '.jpeg', '.png', '.gif']
94
- const extension = file.name.toLowerCase().match(/\.[^.]+$/)?.[0]
95
- if (!extension || !allowedExtensions.includes(extension)) {
96
- throw new Error('Invalid file extension')
97
- }
98
-
99
- return true
100
- }
101
- ```
102
-
103
- #### Verification Steps
104
- - [ ] All user inputs validated with schemas
105
- - [ ] File uploads restricted (size, type, extension)
106
- - [ ] No direct use of user input in queries
107
- - [ ] Whitelist validation (not blacklist)
108
- - [ ] Error messages don't leak sensitive info
109
-
110
- ### 3. SQL Injection Prevention
111
-
112
- #### FAIL: NEVER Concatenate SQL
113
- ```typescript
114
- // DANGEROUS - SQL Injection vulnerability
115
- const query = `SELECT * FROM users WHERE email = '${userEmail}'`
116
- await db.query(query)
117
- ```
118
-
119
- #### PASS: ALWAYS Use Parameterized Queries
120
- ```typescript
121
- // Safe - parameterized query
122
- const { data } = await supabase
123
- .from('users')
124
- .select('*')
125
- .eq('email', userEmail)
126
-
127
- // Or with raw SQL
128
- await db.query(
129
- 'SELECT * FROM users WHERE email = $1',
130
- [userEmail]
131
- )
132
- ```
133
-
134
- #### Verification Steps
135
- - [ ] All database queries use parameterized queries
136
- - [ ] No string concatenation in SQL
137
- - [ ] ORM/query builder used correctly
138
- - [ ] Supabase queries properly sanitized
139
-
140
- ### 4. Authentication & Authorization
141
-
142
- #### JWT Token Handling
143
- ```typescript
144
- // FAIL: WRONG: localStorage (vulnerable to XSS)
145
- localStorage.setItem('token', token)
146
-
147
- // PASS: CORRECT: httpOnly cookies
148
- res.setHeader('Set-Cookie',
149
- `token=${token}; HttpOnly; Secure; SameSite=Strict; Max-Age=3600`)
150
- ```
151
-
152
- #### Authorization Checks
153
- ```typescript
154
- export async function deleteUser(userId: string, requesterId: string) {
155
- // ALWAYS verify authorization first
156
- const requester = await db.users.findUnique({
157
- where: { id: requesterId }
158
- })
159
-
160
- if (requester.role !== 'admin') {
161
- return NextResponse.json(
162
- { error: 'Unauthorized' },
163
- { status: 403 }
164
- )
165
- }
166
-
167
- // Proceed with deletion
168
- await db.users.delete({ where: { id: userId } })
169
- }
170
- ```
171
-
172
- #### Row Level Security (Supabase)
173
- ```sql
174
- -- Enable RLS on all tables
175
- ALTER TABLE users ENABLE ROW LEVEL SECURITY;
176
-
177
- -- Users can only view their own data
178
- CREATE POLICY "Users view own data"
179
- ON users FOR SELECT
180
- USING (auth.uid() = id);
181
-
182
- -- Users can only update their own data
183
- CREATE POLICY "Users update own data"
184
- ON users FOR UPDATE
185
- USING (auth.uid() = id);
186
- ```
187
-
188
- #### Verification Steps
189
- - [ ] Tokens stored in httpOnly cookies (not localStorage)
190
- - [ ] Authorization checks before sensitive operations
191
- - [ ] Row Level Security enabled in Supabase
192
- - [ ] Role-based access control implemented
193
- - [ ] Session management secure
194
-
195
- ### 5. XSS Prevention
196
-
197
- #### Sanitize HTML
198
- ```typescript
199
- import DOMPurify from 'isomorphic-dompurify'
200
-
201
- // ALWAYS sanitize user-provided HTML
202
- function renderUserContent(html: string) {
203
- const clean = DOMPurify.sanitize(html, {
204
- ALLOWED_TAGS: ['b', 'i', 'em', 'strong', 'p'],
205
- ALLOWED_ATTR: []
206
- })
207
- return <div dangerouslySetInnerHTML={{ __html: clean }} />
208
- }
209
- ```
210
-
211
- #### Content Security Policy
212
-
213
- Start strict and loosen only with a documented removal plan. Do not default to
214
- `'unsafe-inline'` or `'unsafe-eval'`; they neutralize much of CSP's protection
215
- and should be treated as temporary compatibility debt.
216
-
217
- ```typescript
218
- // next.config.js
219
- const securityHeaders = [
220
- {
221
- key: 'Content-Security-Policy',
222
- value: `
223
- default-src 'self';
224
- base-uri 'self';
225
- object-src 'none';
226
- frame-ancestors 'none';
227
- script-src 'self';
228
- style-src 'self';
229
- img-src 'self' data: https:;
230
- font-src 'self';
231
- connect-src 'self' https://api.example.com;
232
- `.replace(/\s{2,}/g, ' ').trim()
233
- }
234
- ]
235
- ```
236
-
237
- #### Verification Steps
238
- - [ ] User-provided HTML sanitized
239
- - [ ] CSP headers configured
240
- - [ ] No unvalidated dynamic content rendering
241
- - [ ] React's built-in XSS protection used
242
-
243
- ### 6. CSRF Protection
244
-
245
- #### CSRF Tokens
246
- ```typescript
247
- import { csrf } from '@/lib/csrf'
248
-
249
- export async function POST(request: Request) {
250
- const token = request.headers.get('X-CSRF-Token')
251
-
252
- if (!csrf.verify(token)) {
253
- return NextResponse.json(
254
- { error: 'Invalid CSRF token' },
255
- { status: 403 }
256
- )
257
- }
258
-
259
- // Process request
260
- }
261
- ```
262
-
263
- #### SameSite Cookies
264
- ```typescript
265
- res.setHeader('Set-Cookie',
266
- `session=${sessionId}; HttpOnly; Secure; SameSite=Strict`)
267
- ```
268
-
269
- #### Verification Steps
270
- - [ ] CSRF tokens on state-changing operations
271
- - [ ] SameSite=Strict on all cookies
272
- - [ ] Double-submit cookie pattern implemented
273
-
274
- ### 7. Rate Limiting
275
-
276
- #### API Rate Limiting
277
- ```typescript
278
- import rateLimit from 'express-rate-limit'
279
-
280
- const limiter = rateLimit({
281
- windowMs: 15 * 60 * 1000, // 15 minutes
282
- max: 100, // 100 requests per window
283
- message: 'Too many requests'
284
- })
285
-
286
- // Apply to routes
287
- app.use('/api/', limiter)
288
- ```
289
-
290
- #### Expensive Operations
291
- ```typescript
292
- // Aggressive rate limiting for searches
293
- const searchLimiter = rateLimit({
294
- windowMs: 60 * 1000, // 1 minute
295
- max: 10, // 10 requests per minute
296
- message: 'Too many search requests'
297
- })
298
-
299
- app.use('/api/search', searchLimiter)
300
- ```
301
-
302
- #### Verification Steps
303
- - [ ] Rate limiting on all API endpoints
304
- - [ ] Stricter limits on expensive operations
305
- - [ ] IP-based rate limiting
306
- - [ ] User-based rate limiting (authenticated)
307
-
308
- ### 8. Sensitive Data Exposure
309
-
310
- #### Logging
311
- ```typescript
312
- // FAIL: WRONG: Logging sensitive data
313
- console.log('User login:', { email, password })
314
- console.log('Payment:', { cardNumber, cvv })
315
-
316
- // PASS: CORRECT: Redact sensitive data
317
- console.log('User login:', { email, userId })
318
- console.log('Payment:', { last4: card.last4, userId })
319
- ```
320
-
321
- #### Error Messages
322
- ```typescript
323
- // FAIL: WRONG: Exposing internal details
324
- catch (error) {
325
- return NextResponse.json(
326
- { error: error.message, stack: error.stack },
327
- { status: 500 }
328
- )
329
- }
330
-
331
- // PASS: CORRECT: Generic error messages
332
- catch (error) {
333
- console.error('Internal error:', error)
334
- return NextResponse.json(
335
- { error: 'An error occurred. Please try again.' },
336
- { status: 500 }
337
- )
338
- }
339
- ```
340
-
341
- #### Verification Steps
342
- - [ ] No passwords, tokens, or secrets in logs
343
- - [ ] Error messages generic for users
344
- - [ ] Detailed errors only in server logs
345
- - [ ] No stack traces exposed to users
346
-
347
- ### 9. Blockchain Security (Solana)
348
-
349
- #### Wallet Verification
350
- ```typescript
351
- import { verify } from '@solana/web3.js'
352
-
353
- async function verifyWalletOwnership(
354
- publicKey: string,
355
- signature: string,
356
- message: string
357
- ) {
358
- try {
359
- const isValid = verify(
360
- Buffer.from(message),
361
- Buffer.from(signature, 'base64'),
362
- Buffer.from(publicKey, 'base64')
363
- )
364
- return isValid
365
- } catch (error) {
366
- return false
367
- }
368
- }
369
- ```
370
-
371
- #### Transaction Verification
372
- ```typescript
373
- async function verifyTransaction(transaction: Transaction) {
374
- // Verify recipient
375
- if (transaction.to !== expectedRecipient) {
376
- throw new Error('Invalid recipient')
377
- }
378
-
379
- // Verify amount
380
- if (transaction.amount > maxAmount) {
381
- throw new Error('Amount exceeds limit')
382
- }
383
-
384
- // Verify user has sufficient balance
385
- const balance = await getBalance(transaction.from)
386
- if (balance < transaction.amount) {
387
- throw new Error('Insufficient balance')
388
- }
389
-
390
- return true
391
- }
392
- ```
393
-
394
- #### Verification Steps
395
- - [ ] Wallet signatures verified
396
- - [ ] Transaction details validated
397
- - [ ] Balance checks before transactions
398
- - [ ] No blind transaction signing
399
-
400
- ### 10. Dependency Security
401
-
402
- #### Regular Updates
403
- ```bash
404
- # Check for vulnerabilities
405
- npm audit
406
-
407
- # Fix automatically fixable issues
408
- npm audit fix
409
-
410
- # Update dependencies
411
- npm update
412
-
413
- # Check for outdated packages
414
- npm outdated
415
- ```
416
-
417
- #### Lock Files
418
- ```bash
419
- # ALWAYS commit lock files
420
- git add package-lock.json
421
-
422
- # Use in CI/CD for reproducible builds
423
- npm ci # Instead of npm install
424
- ```
425
-
426
- #### Verification Steps
427
- - [ ] Dependencies up to date
428
- - [ ] No known vulnerabilities (npm audit clean)
429
- - [ ] Lock files committed
430
- - [ ] Dependabot enabled on GitHub
431
- - [ ] Regular security updates
432
-
433
- ## Security Testing
434
-
435
- ### Automated Security Tests
436
- ```typescript
437
- // Test authentication
438
- test('requires authentication', async () => {
439
- const response = await fetch('/api/protected')
440
- expect(response.status).toBe(401)
441
- })
442
-
443
- // Test authorization
444
- test('requires admin role', async () => {
445
- const response = await fetch('/api/admin', {
446
- headers: { Authorization: `Bearer ${userToken}` }
447
- })
448
- expect(response.status).toBe(403)
449
- })
450
-
451
- // Test input validation
452
- test('rejects invalid input', async () => {
453
- const response = await fetch('/api/users', {
454
- method: 'POST',
455
- body: JSON.stringify({ email: 'not-an-email' })
456
- })
457
- expect(response.status).toBe(400)
458
- })
459
-
460
- // Test rate limiting
461
- test('enforces rate limits', async () => {
462
- const requests = Array(101).fill(null).map(() =>
463
- fetch('/api/endpoint')
464
- )
465
-
466
- const responses = await Promise.all(requests)
467
- const tooManyRequests = responses.filter(r => r.status === 429)
468
-
469
- expect(tooManyRequests.length).toBeGreaterThan(0)
470
- })
471
- ```
472
-
473
- ## Pre-Deployment Security Checklist
474
-
475
- Before ANY production deployment:
476
-
477
- - [ ] **Secrets**: No hardcoded secrets, all in env vars
478
- - [ ] **Input Validation**: All user inputs validated
479
- - [ ] **SQL Injection**: All queries parameterized
480
- - [ ] **XSS**: User content sanitized
481
- - [ ] **CSRF**: Protection enabled
482
- - [ ] **Authentication**: Proper token handling
483
- - [ ] **Authorization**: Role checks in place
484
- - [ ] **Rate Limiting**: Enabled on all endpoints
485
- - [ ] **HTTPS**: Enforced in production
486
- - [ ] **Security Headers**: CSP, X-Frame-Options configured
487
- - [ ] **Error Handling**: No sensitive data in errors
488
- - [ ] **Logging**: No sensitive data logged
489
- - [ ] **Dependencies**: Up to date, no vulnerabilities
490
- - [ ] **Row Level Security**: Enabled in Supabase
491
- - [ ] **CORS**: Properly configured
492
- - [ ] **File Uploads**: Validated (size, type)
493
- - [ ] **Wallet Signatures**: Verified (if blockchain)
494
-
495
- ## Resources
496
-
497
- - [OWASP Top 10](https://owasp.org/www-project-top-ten/)
498
- - [Next.js Security](https://nextjs.org/docs/security)
499
- - [Supabase Security](https://supabase.com/docs/guides/auth)
500
- - [Web Security Academy](https://portswigger.net/web-security)
501
-
502
- ---
503
-
504
- **Remember**: Security is not optional. One vulnerability can compromise the entire platform. When in doubt, err on the side of caution.
1
+ ---
2
+ name: security-review
3
+ description: Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.
4
+ metadata:
5
+ origin: ECC
6
+ ---
7
+
8
+ # Security Review Skill
9
+
10
+ This skill ensures all code follows security best practices and identifies potential vulnerabilities.
11
+
12
+ ## When to Activate
13
+
14
+ - Implementing authentication or authorization
15
+ - Handling user input or file uploads
16
+ - Creating new API endpoints
17
+ - Working with secrets or credentials
18
+ - Implementing payment features
19
+ - Storing or transmitting sensitive data
20
+ - Integrating third-party APIs
21
+
22
+ ## Security Checklist
23
+
24
+ ### 1. Secrets Management
25
+
26
+ #### FAIL: NEVER Do This
27
+ ```typescript
28
+ const apiKey = "sk-proj-xxxxx" // Hardcoded secret
29
+ const dbPassword = "password123" // In source code
30
+ ```
31
+
32
+ #### PASS: ALWAYS Do This
33
+ ```typescript
34
+ const apiKey = process.env.OPENAI_API_KEY
35
+ const dbUrl = process.env.DATABASE_URL
36
+
37
+ // Verify secrets exist
38
+ if (!apiKey) {
39
+ throw new Error('OPENAI_API_KEY not configured')
40
+ }
41
+ ```
42
+
43
+ #### Verification Steps
44
+ - [ ] No hardcoded API keys, tokens, or passwords
45
+ - [ ] All secrets in environment variables
46
+ - [ ] `.env.local` in .gitignore
47
+ - [ ] No secrets in git history
48
+ - [ ] Production secrets in hosting platform (Vercel, Railway)
49
+
50
+ ### 2. Input Validation
51
+
52
+ #### Always Validate User Input
53
+ ```typescript
54
+ import { z } from 'zod'
55
+
56
+ // Define validation schema
57
+ const CreateUserSchema = z.object({
58
+ email: z.string().email(),
59
+ name: z.string().min(1).max(100),
60
+ age: z.number().int().min(0).max(150)
61
+ })
62
+
63
+ // Validate before processing
64
+ export async function createUser(input: unknown) {
65
+ try {
66
+ const validated = CreateUserSchema.parse(input)
67
+ return await db.users.create(validated)
68
+ } catch (error) {
69
+ if (error instanceof z.ZodError) {
70
+ return { success: false, errors: error.issues }
71
+ }
72
+ throw error
73
+ }
74
+ }
75
+ ```
76
+
77
+ #### File Upload Validation
78
+ ```typescript
79
+ function validateFileUpload(file: File) {
80
+ // Size check (5MB max)
81
+ const maxSize = 5 * 1024 * 1024
82
+ if (file.size > maxSize) {
83
+ throw new Error('File too large (max 5MB)')
84
+ }
85
+
86
+ // Type check
87
+ const allowedTypes = ['image/jpeg', 'image/png', 'image/gif']
88
+ if (!allowedTypes.includes(file.type)) {
89
+ throw new Error('Invalid file type')
90
+ }
91
+
92
+ // Extension check
93
+ const allowedExtensions = ['.jpg', '.jpeg', '.png', '.gif']
94
+ const extension = file.name.toLowerCase().match(/\.[^.]+$/)?.[0]
95
+ if (!extension || !allowedExtensions.includes(extension)) {
96
+ throw new Error('Invalid file extension')
97
+ }
98
+
99
+ return true
100
+ }
101
+ ```
102
+
103
+ #### Verification Steps
104
+ - [ ] All user inputs validated with schemas
105
+ - [ ] File uploads restricted (size, type, extension)
106
+ - [ ] No direct use of user input in queries
107
+ - [ ] Whitelist validation (not blacklist)
108
+ - [ ] Error messages don't leak sensitive info
109
+
110
+ ### 3. SQL Injection Prevention
111
+
112
+ #### FAIL: NEVER Concatenate SQL
113
+ ```typescript
114
+ // DANGEROUS - SQL Injection vulnerability
115
+ const query = `SELECT * FROM users WHERE email = '${userEmail}'`
116
+ await db.query(query)
117
+ ```
118
+
119
+ #### PASS: ALWAYS Use Parameterized Queries
120
+ ```typescript
121
+ // Safe - parameterized query
122
+ const { data } = await supabase
123
+ .from('users')
124
+ .select('*')
125
+ .eq('email', userEmail)
126
+
127
+ // Or with raw SQL
128
+ await db.query(
129
+ 'SELECT * FROM users WHERE email = $1',
130
+ [userEmail]
131
+ )
132
+ ```
133
+
134
+ #### Verification Steps
135
+ - [ ] All database queries use parameterized queries
136
+ - [ ] No string concatenation in SQL
137
+ - [ ] ORM/query builder used correctly
138
+ - [ ] Supabase queries properly sanitized
139
+
140
+ ### 4. Authentication & Authorization
141
+
142
+ #### JWT Token Handling
143
+ ```typescript
144
+ // FAIL: WRONG: localStorage (vulnerable to XSS)
145
+ localStorage.setItem('token', token)
146
+
147
+ // PASS: CORRECT: httpOnly cookies
148
+ res.setHeader('Set-Cookie',
149
+ `token=${token}; HttpOnly; Secure; SameSite=Strict; Max-Age=3600`)
150
+ ```
151
+
152
+ #### Authorization Checks
153
+ ```typescript
154
+ export async function deleteUser(userId: string, requesterId: string) {
155
+ // ALWAYS verify authorization first
156
+ const requester = await db.users.findUnique({
157
+ where: { id: requesterId }
158
+ })
159
+
160
+ if (requester.role !== 'admin') {
161
+ return NextResponse.json(
162
+ { error: 'Unauthorized' },
163
+ { status: 403 }
164
+ )
165
+ }
166
+
167
+ // Proceed with deletion
168
+ await db.users.delete({ where: { id: userId } })
169
+ }
170
+ ```
171
+
172
+ #### Row Level Security (Supabase)
173
+ ```sql
174
+ -- Enable RLS on all tables
175
+ ALTER TABLE users ENABLE ROW LEVEL SECURITY;
176
+
177
+ -- Users can only view their own data
178
+ CREATE POLICY "Users view own data"
179
+ ON users FOR SELECT
180
+ USING (auth.uid() = id);
181
+
182
+ -- Users can only update their own data
183
+ CREATE POLICY "Users update own data"
184
+ ON users FOR UPDATE
185
+ USING (auth.uid() = id);
186
+ ```
187
+
188
+ #### Verification Steps
189
+ - [ ] Tokens stored in httpOnly cookies (not localStorage)
190
+ - [ ] Authorization checks before sensitive operations
191
+ - [ ] Row Level Security enabled in Supabase
192
+ - [ ] Role-based access control implemented
193
+ - [ ] Session management secure
194
+
195
+ ### 5. XSS Prevention
196
+
197
+ #### Sanitize HTML
198
+ ```typescript
199
+ import DOMPurify from 'isomorphic-dompurify'
200
+
201
+ // ALWAYS sanitize user-provided HTML
202
+ function renderUserContent(html: string) {
203
+ const clean = DOMPurify.sanitize(html, {
204
+ ALLOWED_TAGS: ['b', 'i', 'em', 'strong', 'p'],
205
+ ALLOWED_ATTR: []
206
+ })
207
+ return <div dangerouslySetInnerHTML={{ __html: clean }} />
208
+ }
209
+ ```
210
+
211
+ #### Content Security Policy
212
+
213
+ Start strict and loosen only with a documented removal plan. Do not default to
214
+ `'unsafe-inline'` or `'unsafe-eval'`; they neutralize much of CSP's protection
215
+ and should be treated as temporary compatibility debt.
216
+
217
+ ```typescript
218
+ // next.config.js
219
+ const securityHeaders = [
220
+ {
221
+ key: 'Content-Security-Policy',
222
+ value: `
223
+ default-src 'self';
224
+ base-uri 'self';
225
+ object-src 'none';
226
+ frame-ancestors 'none';
227
+ script-src 'self';
228
+ style-src 'self';
229
+ img-src 'self' data: https:;
230
+ font-src 'self';
231
+ connect-src 'self' https://api.example.com;
232
+ `.replace(/\s{2,}/g, ' ').trim()
233
+ }
234
+ ]
235
+ ```
236
+
237
+ #### Verification Steps
238
+ - [ ] User-provided HTML sanitized
239
+ - [ ] CSP headers configured
240
+ - [ ] No unvalidated dynamic content rendering
241
+ - [ ] React's built-in XSS protection used
242
+
243
+ ### 6. CSRF Protection
244
+
245
+ #### CSRF Tokens
246
+ ```typescript
247
+ import { csrf } from '@/lib/csrf'
248
+
249
+ export async function POST(request: Request) {
250
+ const token = request.headers.get('X-CSRF-Token')
251
+
252
+ if (!csrf.verify(token)) {
253
+ return NextResponse.json(
254
+ { error: 'Invalid CSRF token' },
255
+ { status: 403 }
256
+ )
257
+ }
258
+
259
+ // Process request
260
+ }
261
+ ```
262
+
263
+ #### SameSite Cookies
264
+ ```typescript
265
+ res.setHeader('Set-Cookie',
266
+ `session=${sessionId}; HttpOnly; Secure; SameSite=Strict`)
267
+ ```
268
+
269
+ #### Verification Steps
270
+ - [ ] CSRF tokens on state-changing operations
271
+ - [ ] SameSite=Strict on all cookies
272
+ - [ ] Double-submit cookie pattern implemented
273
+
274
+ ### 7. Rate Limiting
275
+
276
+ #### API Rate Limiting
277
+ ```typescript
278
+ import rateLimit from 'express-rate-limit'
279
+
280
+ const limiter = rateLimit({
281
+ windowMs: 15 * 60 * 1000, // 15 minutes
282
+ max: 100, // 100 requests per window
283
+ message: 'Too many requests'
284
+ })
285
+
286
+ // Apply to routes
287
+ app.use('/api/', limiter)
288
+ ```
289
+
290
+ #### Expensive Operations
291
+ ```typescript
292
+ // Aggressive rate limiting for searches
293
+ const searchLimiter = rateLimit({
294
+ windowMs: 60 * 1000, // 1 minute
295
+ max: 10, // 10 requests per minute
296
+ message: 'Too many search requests'
297
+ })
298
+
299
+ app.use('/api/search', searchLimiter)
300
+ ```
301
+
302
+ #### Verification Steps
303
+ - [ ] Rate limiting on all API endpoints
304
+ - [ ] Stricter limits on expensive operations
305
+ - [ ] IP-based rate limiting
306
+ - [ ] User-based rate limiting (authenticated)
307
+
308
+ ### 8. Sensitive Data Exposure
309
+
310
+ #### Logging
311
+ ```typescript
312
+ // FAIL: WRONG: Logging sensitive data
313
+ console.log('User login:', { email, password })
314
+ console.log('Payment:', { cardNumber, cvv })
315
+
316
+ // PASS: CORRECT: Redact sensitive data
317
+ console.log('User login:', { email, userId })
318
+ console.log('Payment:', { last4: card.last4, userId })
319
+ ```
320
+
321
+ #### Error Messages
322
+ ```typescript
323
+ // FAIL: WRONG: Exposing internal details
324
+ catch (error) {
325
+ return NextResponse.json(
326
+ { error: error.message, stack: error.stack },
327
+ { status: 500 }
328
+ )
329
+ }
330
+
331
+ // PASS: CORRECT: Generic error messages
332
+ catch (error) {
333
+ console.error('Internal error:', error)
334
+ return NextResponse.json(
335
+ { error: 'An error occurred. Please try again.' },
336
+ { status: 500 }
337
+ )
338
+ }
339
+ ```
340
+
341
+ #### Verification Steps
342
+ - [ ] No passwords, tokens, or secrets in logs
343
+ - [ ] Error messages generic for users
344
+ - [ ] Detailed errors only in server logs
345
+ - [ ] No stack traces exposed to users
346
+
347
+ ### 9. Blockchain Security (Solana)
348
+
349
+ #### Wallet Verification
350
+ ```typescript
351
+ import { verify } from '@solana/web3.js'
352
+
353
+ async function verifyWalletOwnership(
354
+ publicKey: string,
355
+ signature: string,
356
+ message: string
357
+ ) {
358
+ try {
359
+ const isValid = verify(
360
+ Buffer.from(message),
361
+ Buffer.from(signature, 'base64'),
362
+ Buffer.from(publicKey, 'base64')
363
+ )
364
+ return isValid
365
+ } catch (error) {
366
+ return false
367
+ }
368
+ }
369
+ ```
370
+
371
+ #### Transaction Verification
372
+ ```typescript
373
+ async function verifyTransaction(transaction: Transaction) {
374
+ // Verify recipient
375
+ if (transaction.to !== expectedRecipient) {
376
+ throw new Error('Invalid recipient')
377
+ }
378
+
379
+ // Verify amount
380
+ if (transaction.amount > maxAmount) {
381
+ throw new Error('Amount exceeds limit')
382
+ }
383
+
384
+ // Verify user has sufficient balance
385
+ const balance = await getBalance(transaction.from)
386
+ if (balance < transaction.amount) {
387
+ throw new Error('Insufficient balance')
388
+ }
389
+
390
+ return true
391
+ }
392
+ ```
393
+
394
+ #### Verification Steps
395
+ - [ ] Wallet signatures verified
396
+ - [ ] Transaction details validated
397
+ - [ ] Balance checks before transactions
398
+ - [ ] No blind transaction signing
399
+
400
+ ### 10. Dependency Security
401
+
402
+ #### Regular Updates
403
+ ```bash
404
+ # Check for vulnerabilities
405
+ npm audit
406
+
407
+ # Fix automatically fixable issues
408
+ npm audit fix
409
+
410
+ # Update dependencies
411
+ npm update
412
+
413
+ # Check for outdated packages
414
+ npm outdated
415
+ ```
416
+
417
+ #### Lock Files
418
+ ```bash
419
+ # ALWAYS commit lock files
420
+ git add package-lock.json
421
+
422
+ # Use in CI/CD for reproducible builds
423
+ npm ci # Instead of npm install
424
+ ```
425
+
426
+ #### Verification Steps
427
+ - [ ] Dependencies up to date
428
+ - [ ] No known vulnerabilities (npm audit clean)
429
+ - [ ] Lock files committed
430
+ - [ ] Dependabot enabled on GitHub
431
+ - [ ] Regular security updates
432
+
433
+ ## Security Testing
434
+
435
+ ### Automated Security Tests
436
+ ```typescript
437
+ // Test authentication
438
+ test('requires authentication', async () => {
439
+ const response = await fetch('/api/protected')
440
+ expect(response.status).toBe(401)
441
+ })
442
+
443
+ // Test authorization
444
+ test('requires admin role', async () => {
445
+ const response = await fetch('/api/admin', {
446
+ headers: { Authorization: `Bearer ${userToken}` }
447
+ })
448
+ expect(response.status).toBe(403)
449
+ })
450
+
451
+ // Test input validation
452
+ test('rejects invalid input', async () => {
453
+ const response = await fetch('/api/users', {
454
+ method: 'POST',
455
+ body: JSON.stringify({ email: 'not-an-email' })
456
+ })
457
+ expect(response.status).toBe(400)
458
+ })
459
+
460
+ // Test rate limiting
461
+ test('enforces rate limits', async () => {
462
+ const requests = Array(101).fill(null).map(() =>
463
+ fetch('/api/endpoint')
464
+ )
465
+
466
+ const responses = await Promise.all(requests)
467
+ const tooManyRequests = responses.filter(r => r.status === 429)
468
+
469
+ expect(tooManyRequests.length).toBeGreaterThan(0)
470
+ })
471
+ ```
472
+
473
+ ## Pre-Deployment Security Checklist
474
+
475
+ Before ANY production deployment:
476
+
477
+ - [ ] **Secrets**: No hardcoded secrets, all in env vars
478
+ - [ ] **Input Validation**: All user inputs validated
479
+ - [ ] **SQL Injection**: All queries parameterized
480
+ - [ ] **XSS**: User content sanitized
481
+ - [ ] **CSRF**: Protection enabled
482
+ - [ ] **Authentication**: Proper token handling
483
+ - [ ] **Authorization**: Role checks in place
484
+ - [ ] **Rate Limiting**: Enabled on all endpoints
485
+ - [ ] **HTTPS**: Enforced in production
486
+ - [ ] **Security Headers**: CSP, X-Frame-Options configured
487
+ - [ ] **Error Handling**: No sensitive data in errors
488
+ - [ ] **Logging**: No sensitive data logged
489
+ - [ ] **Dependencies**: Up to date, no vulnerabilities
490
+ - [ ] **Row Level Security**: Enabled in Supabase
491
+ - [ ] **CORS**: Properly configured
492
+ - [ ] **File Uploads**: Validated (size, type)
493
+ - [ ] **Wallet Signatures**: Verified (if blockchain)
494
+
495
+ ## Resources
496
+
497
+ - [OWASP Top 10](https://owasp.org/www-project-top-ten/)
498
+ - [Next.js Security](https://nextjs.org/docs/security)
499
+ - [Supabase Security](https://supabase.com/docs/guides/auth)
500
+ - [Web Security Academy](https://portswigger.net/web-security)
501
+
502
+ ---
503
+
504
+ **Remember**: Security is not optional. One vulnerability can compromise the entire platform. When in doubt, err on the side of caution.