codeply-cli 0.5.1 → 0.5.2

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