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