heimdall-agent 1.0.0 → 1.2.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 (250) hide show
  1. package/README.md +57 -26
  2. package/README.pt-BR.md +443 -0
  3. package/agents/cloud-engineer.md +77 -0
  4. package/agents/code-sentinel.md +71 -34
  5. package/agents/database-architect.md +31 -25
  6. package/agents/frontend-designer.md +30 -28
  7. package/agents/mobile-designer.md +25 -24
  8. package/agents/modernizer.md +68 -0
  9. package/agents/orchestrator.md +107 -93
  10. package/agents/reviewer.md +102 -71
  11. package/agents/security-auditor.md +27 -27
  12. package/agents/tester.md +97 -90
  13. package/commands/grill-me.md +20 -4
  14. package/commands/orchestrate.md +16 -0
  15. package/commands/orchestrator.md +16 -0
  16. package/commands/plan.md +17 -1
  17. package/config/agents.json +31 -3
  18. package/config/mcp.json +72 -0
  19. package/config/models.json +26 -16
  20. package/config/profiles.json +2 -4
  21. package/config/skills.json +762 -573
  22. package/docs/SKILLS.md +393 -275
  23. package/docs/designs/old/2026-10-31 plan-lifecycle-backlog-and-clean-code-skill.md +87 -0
  24. package/docs/designs/old/2026-11-02 skill-upstream-audit-and-update.md +105 -0
  25. package/docs/designs/old/2026-11-05 communication-doctrine-bluf-ste.md +94 -0
  26. package/docs/designs/old/2026-11-06-cloud-engineer-and-resilience-synthesis.md +67 -0
  27. package/docs/designs/old/2026-11-06-herdr-native-agent-orchestration.md +45 -0
  28. package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
  29. package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
  30. package/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
  31. package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
  32. package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
  33. package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
  34. package/docs/runs/skill-audit/customization-report.json +380 -0
  35. package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
  36. package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
  37. package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
  38. package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
  39. package/docs/runs/skill-audit/inventory.json +308 -0
  40. package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
  41. package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
  42. package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
  43. package/docs/runs/skill-audit/probe.ps1 +16 -0
  44. package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
  45. package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
  46. package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
  47. package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
  48. package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
  49. package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
  50. package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
  51. package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
  52. package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
  53. package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
  54. package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
  55. package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
  56. package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
  57. package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
  58. package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
  59. package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
  60. package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
  61. package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
  62. package/docs/runs/skill-audit/update-manifest.md +88 -0
  63. package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
  64. package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
  65. package/docs/runs/skill-audit/upstream-status.json +563 -0
  66. package/docs/runs/skill-audit/verification-results.json +252 -0
  67. package/doctrine/AGENTS.md +42 -77
  68. package/hooks/git/pre-commit +11 -0
  69. package/hooks/heimdall-hook.cjs +81 -2
  70. package/hooks/herdr-agent-state.ps1 +55 -0
  71. package/hooks/hooks.json +0 -11
  72. package/lib/catalog-sync.cjs +167 -0
  73. package/lib/hermes-context.cjs +57 -0
  74. package/lib/model-context.cjs +123 -0
  75. package/lib/path-discovery.cjs +94 -0
  76. package/package.json +7 -3
  77. package/playbooks/01-interactive-grilling-gate.md +23 -6
  78. package/playbooks/02-fast-code-deep-verification.md +3 -2
  79. package/playbooks/03-adversarial-code-review.md +15 -7
  80. package/playbooks/05-canonical-plan-template.md +35 -19
  81. package/playbooks/06-model-registry-matrix.md +24 -13
  82. package/playbooks/07-legacy-code-modernization.md +74 -0
  83. package/playbooks/08-backlog-and-change-request-flow.md +122 -0
  84. package/setup.mjs +592 -172
  85. package/skills/antislop/SKILL.md +76 -56
  86. package/skills/antislop/VERSION +1 -0
  87. package/skills/antislop-copywriting/SKILL.md +407 -372
  88. package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
  89. package/skills/antislop-human/SKILL.md +204 -147
  90. package/skills/antislop-human/contrast-check.py +168 -165
  91. package/skills/antislop-human/contrast-mcp.py +6 -3
  92. package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
  93. package/skills/antislop-human/references/WCAG.md +127 -0
  94. package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
  95. package/skills/antislop-ui/SKILL.md +344 -304
  96. package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
  97. package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
  98. package/skills/brainstorming/SKILL.md +296 -265
  99. package/skills/brainstorming/builder-check-prompt.md +23 -0
  100. package/skills/brainstorming/scripts/frame-template.html +213 -213
  101. package/skills/brainstorming/scripts/server.cjs +723 -723
  102. package/skills/brandkit/SKILL.md +798 -798
  103. package/skills/brutalist-skill/SKILL.md +93 -92
  104. package/skills/caveman/README.md +68 -0
  105. package/skills/caveman/SKILL.md +73 -38
  106. package/skills/claude-collaborator/SKILL.md +24 -44
  107. package/skills/clean-code/SKILL.md +152 -0
  108. package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
  109. package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
  110. package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
  111. package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
  112. package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
  113. package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
  114. package/skills/cloudflare-security-audit/HUNTING.md +251 -251
  115. package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
  116. package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
  117. package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
  118. package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
  119. package/skills/cloudflare-security-audit/SKILL.md +192 -192
  120. package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
  121. package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
  122. package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
  123. package/skills/cloudflare-security-audit/report-schema.json +461 -461
  124. package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
  125. package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
  126. package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
  127. package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
  128. package/skills/codebase-design/DEEPENING.md +37 -0
  129. package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  130. package/skills/codebase-design/SKILL.md +114 -0
  131. package/skills/codex-collaborator/SKILL.md +24 -45
  132. package/skills/communication-doctrine/SKILL.md +89 -0
  133. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  134. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  135. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  136. package/skills/domain-modeling/ADR-FORMAT.md +47 -0
  137. package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
  138. package/skills/domain-modeling/SKILL.md +74 -0
  139. package/skills/executing-plans/SKILL.md +6 -56
  140. package/skills/executing-plans/scripts/task-done +52 -52
  141. package/skills/executing-plans/scripts/task-start +28 -28
  142. package/skills/gemini-collaborator/SKILL.md +24 -56
  143. package/skills/grill-me/SKILL.md +65 -0
  144. package/skills/handoff/SKILL.md +64 -0
  145. package/skills/herdr/SKILL.md +243 -0
  146. package/skills/image-to-code-skill/SKILL.md +1228 -1228
  147. package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
  148. package/skills/imagegen-frontend-web/SKILL.md +987 -987
  149. package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
  150. package/skills/improve-codebase-architecture/SKILL.md +71 -0
  151. package/skills/karpathy-guidelines/SKILL.md +67 -67
  152. package/skills/mcp-engineering/SKILL.md +74 -0
  153. package/skills/minimalist-skill/SKILL.md +87 -85
  154. package/skills/output-skill/SKILL.md +49 -49
  155. package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
  156. package/skills/owasp-security/reference/languages.md +378 -372
  157. package/skills/owasp-security/reference/owasp-report.md +1144 -1140
  158. package/skills/owasp-security/reference/review-checklist.md +134 -132
  159. package/skills/ponytail/SKILL.md +36 -52
  160. package/skills/postgres-best-practices/SKILL.md +30 -52
  161. package/skills/postgres-best-practices/references/backup-restore.md +372 -0
  162. package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
  163. package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
  164. package/skills/postgres-best-practices/references/hot-standby.md +221 -0
  165. package/skills/postgres-best-practices/references/indexing.md +318 -0
  166. package/skills/postgres-best-practices/references/logical-replication.md +610 -0
  167. package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
  168. package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
  169. package/skills/postgres-best-practices/references/query-optimization.md +294 -0
  170. package/skills/postgres-best-practices/references/query-patterns.md +566 -0
  171. package/skills/postgres-best-practices/references/schema-design.md +362 -0
  172. package/skills/postgres-best-practices/references/security-roles.md +489 -0
  173. package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
  174. package/skills/progressive-disclosure/SKILL.md +68 -0
  175. package/skills/pstack-discipline/SKILL.md +40 -0
  176. package/skills/receiving-code-review/SKILL.md +2 -23
  177. package/skills/requesting-code-review/SKILL.md +7 -36
  178. package/skills/soft-skill/SKILL.md +99 -98
  179. package/skills/stitch-skill/DESIGN.md +121 -121
  180. package/skills/stitch-skill/SKILL.md +185 -184
  181. package/skills/strix-security/SKILL.md +54 -53
  182. package/skills/subagent-driven-development/SKILL.md +35 -264
  183. package/skills/subagent-driven-development/references/batching.md +11 -0
  184. package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  185. package/skills/subagent-driven-development/references/final-review.md +47 -0
  186. package/skills/subagent-driven-development/references/fix-loop.md +77 -0
  187. package/skills/subagent-driven-development/references/handling-reports.md +15 -0
  188. package/skills/subagent-driven-development/references/preflight.md +26 -0
  189. package/skills/subagent-driven-development/references/resuming.md +12 -0
  190. package/skills/subagent-driven-development/scripts/review-package +53 -53
  191. package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
  192. package/skills/subagent-driven-development/scripts/task-brief +43 -43
  193. package/skills/systematic-debugging/SKILL.md +283 -306
  194. package/skills/taste-skill/SKILL.md +542 -1206
  195. package/skills/taste-skill/references/app-screens.md +1199 -0
  196. package/skills/taste-skill/references/colour.md +141 -0
  197. package/skills/taste-skill/references/copy.md +177 -0
  198. package/skills/taste-skill/references/critique.md +182 -0
  199. package/skills/taste-skill/references/imagery.md +791 -0
  200. package/skills/taste-skill/references/layout.md +292 -0
  201. package/skills/taste-skill/references/motion.md +980 -0
  202. package/skills/taste-skill/references/research.md +356 -0
  203. package/skills/taste-skill/references/scenes.md +174 -0
  204. package/skills/taste-skill/references/tells.md +115 -0
  205. package/skills/taste-skill/references/type.md +170 -0
  206. package/skills/test-driven-development/SKILL.md +330 -337
  207. package/skills/thermo/SKILL.md +67 -0
  208. package/skills/threat-modeling/SKILL.md +55 -0
  209. package/skills/to-spec/SKILL.md +75 -0
  210. package/skills/to-tickets/SKILL.md +105 -0
  211. package/skills/trailofbits-audit-context/SKILL.md +72 -72
  212. package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
  213. package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
  214. package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
  215. package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
  216. package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
  217. package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
  218. package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
  219. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
  220. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
  221. package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
  222. package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
  223. package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
  224. package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
  225. package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
  226. package/skills/verification-before-completion/SKILL.md +0 -14
  227. package/skills/wayfinder/SKILL.md +128 -0
  228. package/skills/writing-plans/SKILL.md +11 -15
  229. package/skills/writing-skills/SKILL.md +21 -303
  230. package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  231. package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  232. package/skills/writing-skills/references/bulletproofing.md +80 -0
  233. package/skills/writing-skills/references/discovery.md +201 -0
  234. package/skills/writing-skills/references/flowcharts.md +37 -0
  235. package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  236. package/skills/writing-skills/references/persuasion-principles.md +187 -0
  237. package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  238. package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
  239. package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
  240. package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
  241. package/skills/gpt-tasteskill/SKILL.md +0 -74
  242. package/skills/taste-skill-v1/SKILL.md +0 -226
  243. /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
  244. /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
  245. /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
  246. /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
  247. /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
  248. /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
  249. /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
  250. /package/tools/{gemini-bridge.sh → archive/gemini-bridge.sh} +0 -0
@@ -1,75 +1,75 @@
1
- # Debug and Introspection Defaults
2
-
3
- **Report when:** Internal detail reaches a response, a listening port, or a log a lower-privileged party can read, whether it is gated by a flag that defaults to on, or simply unconditional (a stack trace or driver message written straight into an error response, with no flag at all).
4
-
5
- **Skip when:** Log-verbosity-only flags with no user-facing output. Debug servers bound to loopback and off by default.
6
-
7
- The finding needs both halves: enabled-by-default *and* an exposure path. A verbose logger that writes to a root-only file is neither.
8
-
9
- ## VULNERABLE - Report These
10
-
11
- **Stack traces in API responses**
12
- ```python
13
- # File: app.py
14
- @app.errorhandler(Exception)
15
- def handle_error(error):
16
- return jsonify({
17
- 'error': str(error),
18
- 'traceback': traceback.format_exc() # Leaks internal paths, library versions
19
- }), 500
20
- ```
21
- **Why vulnerable:** Exposes internal implementation details to attackers.
22
-
23
- **GraphQL introspection enabled**
24
- ```javascript
25
- // File: server.js
26
- const server = new ApolloServer({
27
- typeDefs,
28
- resolvers,
29
- introspection: true, // Enabled in production
30
- playground: true
31
- });
32
- ```
33
- **Why vulnerable:** Attackers can discover entire API schema, including admin-only fields.
34
-
35
- **Verbose error messages**
36
- ```java
37
- // File: UserController.java
38
- catch (SQLException e) {
39
- return ResponseEntity.status(500).body(
40
- "Database error: " + e.getMessage() // Leaks table names, constraints
41
- );
42
- }
43
- ```
44
- **Why vulnerable:** SQL error messages reveal database structure.
45
-
46
- ## SECURE - Skip These
47
-
48
- **Debug features in logging only**
49
- ```python
50
- # File: app.py
51
- @app.errorhandler(Exception)
52
- def handle_error(error):
53
- logger.exception('Request failed', exc_info=error) # Logs full trace
54
- return jsonify({'error': 'Internal server error'}), 500 # Generic to user
55
- ```
56
-
57
- **Environment-aware debug settings**
58
- ```javascript
59
- // File: server.js
60
- const server = new ApolloServer({
61
- typeDefs,
62
- resolvers,
63
- introspection: process.env.NODE_ENV !== 'production',
64
- playground: process.env.NODE_ENV !== 'production'
65
- });
66
- ```
67
-
68
- **Generic user-facing errors**
69
- ```java
70
- // File: UserController.java
71
- catch (SQLException e) {
72
- logger.error("Database error", e); // Full details to logs
73
- return ResponseEntity.status(500).body("Unable to process request"); // Generic
74
- }
75
- ```
1
+ # Debug and Introspection Defaults
2
+
3
+ **Report when:** Internal detail reaches a response, a listening port, or a log a lower-privileged party can read, whether it is gated by a flag that defaults to on, or simply unconditional (a stack trace or driver message written straight into an error response, with no flag at all).
4
+
5
+ **Skip when:** Log-verbosity-only flags with no user-facing output. Debug servers bound to loopback and off by default.
6
+
7
+ The finding needs both halves: enabled-by-default *and* an exposure path. A verbose logger that writes to a root-only file is neither.
8
+
9
+ ## VULNERABLE - Report These
10
+
11
+ **Stack traces in API responses**
12
+ ```python
13
+ # File: app.py
14
+ @app.errorhandler(Exception)
15
+ def handle_error(error):
16
+ return jsonify({
17
+ 'error': str(error),
18
+ 'traceback': traceback.format_exc() # Leaks internal paths, library versions
19
+ }), 500
20
+ ```
21
+ **Why vulnerable:** Exposes internal implementation details to attackers.
22
+
23
+ **GraphQL introspection enabled**
24
+ ```javascript
25
+ // File: server.js
26
+ const server = new ApolloServer({
27
+ typeDefs,
28
+ resolvers,
29
+ introspection: true, // Enabled in production
30
+ playground: true
31
+ });
32
+ ```
33
+ **Why vulnerable:** Attackers can discover entire API schema, including admin-only fields.
34
+
35
+ **Verbose error messages**
36
+ ```java
37
+ // File: UserController.java
38
+ catch (SQLException e) {
39
+ return ResponseEntity.status(500).body(
40
+ "Database error: " + e.getMessage() // Leaks table names, constraints
41
+ );
42
+ }
43
+ ```
44
+ **Why vulnerable:** SQL error messages reveal database structure.
45
+
46
+ ## SECURE - Skip These
47
+
48
+ **Debug features in logging only**
49
+ ```python
50
+ # File: app.py
51
+ @app.errorhandler(Exception)
52
+ def handle_error(error):
53
+ logger.exception('Request failed', exc_info=error) # Logs full trace
54
+ return jsonify({'error': 'Internal server error'}), 500 # Generic to user
55
+ ```
56
+
57
+ **Environment-aware debug settings**
58
+ ```javascript
59
+ // File: server.js
60
+ const server = new ApolloServer({
61
+ typeDefs,
62
+ resolvers,
63
+ introspection: process.env.NODE_ENV !== 'production',
64
+ playground: process.env.NODE_ENV !== 'production'
65
+ });
66
+ ```
67
+
68
+ **Generic user-facing errors**
69
+ ```java
70
+ // File: UserController.java
71
+ catch (SQLException e) {
72
+ logger.error("Database error", e); // Full details to logs
73
+ return ResponseEntity.status(500).body("Unable to process request"); // Generic
74
+ }
75
+ ```
@@ -1,12 +1,12 @@
1
- {
2
- "id": "default-credentials",
3
- "title": "Default credentials",
4
- "seeds": [
5
- "(password|passwd|pwd|secret|token)[[:space:]]*[:=][[:space:]]*['\"][^'\"]{4,}['\"]",
6
- "(api[_-]?key|access[_-]?key|client[_-]?secret)[[:space:]]*[:=][[:space:]]*['\"][^'\"]+['\"]",
7
- "(admin|root|guest|test)[[:space:]]*[:=][[:space:]]*['\"](admin|root|password|changeme|guest|test|123)",
8
- "(username|user|login|uid|account)[[:space:]]*[:=][[:space:]]*['\"](admin|administrator|root|sa|guest|test|demo)['\"]",
9
- "(hash_password|make_password|set_password|hashpw|generate_password_hash)\\([^)]*['\"][^'\"]{3,}['\"]",
10
- "(postgres(ql)?|mysql|mariadb|mongodb|redis|amqp|mssql)(\\+[a-z]+)?://[^:@[:space:]]+:[^@[:space:]]+@"
11
- ]
12
- }
1
+ {
2
+ "id": "default-credentials",
3
+ "title": "Default credentials",
4
+ "seeds": [
5
+ "(password|passwd|pwd|secret|token)[[:space:]]*[:=][[:space:]]*['\"][^'\"]{4,}['\"]",
6
+ "(api[_-]?key|access[_-]?key|client[_-]?secret)[[:space:]]*[:=][[:space:]]*['\"][^'\"]+['\"]",
7
+ "(admin|root|guest|test)[[:space:]]*[:=][[:space:]]*['\"](admin|root|password|changeme|guest|test|123)",
8
+ "(username|user|login|uid|account)[[:space:]]*[:=][[:space:]]*['\"](admin|administrator|root|sa|guest|test|demo)['\"]",
9
+ "(hash_password|make_password|set_password|hashpw|generate_password_hash)\\([^)]*['\"][^'\"]{3,}['\"]",
10
+ "(postgres(ql)?|mysql|mariadb|mongodb|redis|amqp|mssql)(\\+[a-z]+)?://[^:@[:space:]]+:[^@[:space:]]+@"
11
+ ]
12
+ }
@@ -1,76 +1,76 @@
1
- # Default Credentials
2
-
3
- **Report when:** A credential literal that a running deployment can actually authenticate with, including seeded accounts created on first boot.
4
-
5
- **Skip when:** Accounts created disabled or with a forced-reset flag. Credentials in docs, READMEs, and fixture files.
6
-
7
- A credential in prose is a credential nobody can use. A credential in `bootstrap_admin()` is a login.
8
-
9
- ## VULNERABLE - Report These
10
-
11
- **Hardcoded admin account**
12
- ```python
13
- # File: src/models/user.py
14
- def bootstrap_admin():
15
- """Create default admin account if none exists"""
16
- if not User.query.filter_by(role='admin').first():
17
- admin = User(
18
- username='admin',
19
- password=hash_password('admin123'),
20
- role='admin'
21
- )
22
- db.session.add(admin)
23
- db.session.commit()
24
- ```
25
- **Why vulnerable:** Default admin account created on first run with known credentials.
26
-
27
- **API key in code**
28
- ```javascript
29
- // File: src/integrations/payment.js
30
- const STRIPE_API_KEY = process.env.STRIPE_KEY || 'sk_tes...';
31
-
32
- const stripe = require('stripe')(STRIPE_API_KEY);
33
- ```
34
- **Why vulnerable:** Uses test API key if env var missing. Might reach production.
35
-
36
- **Database connection string**
37
- ```java
38
- // File: DatabaseConfig.java
39
- private static final String DB_URL = System.getenv().getOrDefault(
40
- "DATABASE_URL",
41
- "postgresql://admin:password@localhost:5432/prod"
42
- );
43
- ```
44
- **Why vulnerable:** Hardcoded database credentials as fallback.
45
-
46
- ## SECURE - Skip These
47
-
48
- **Disabled default account**
49
- ```python
50
- # File: src/models/user.py
51
- def bootstrap_admin():
52
- """Admin account MUST be configured via environment"""
53
- username = os.environ['ADMIN_USERNAME']
54
- password = os.environ['ADMIN_PASSWORD']
55
-
56
- if not User.query.filter_by(username=username).first():
57
- admin = User(username=username, password=hash_password(password), role='admin')
58
- db.session.add(admin)
59
- ```
60
-
61
- **Example/documentation credentials**: a credential appearing inside prose in `README.md`:
62
- ```markdown
63
- ## Setup
64
-
65
- Configure your API key:
66
-
67
- export STRIPE_KEY='sk_tes...' # Example only
68
- ```
69
-
70
- **Test fixture credentials**
71
- ```python
72
- # File: tests/conftest.py
73
- @pytest.fixture
74
- def test_user():
75
- return User(username='test_user', password='test_pass') # OK - test scope
76
- ```
1
+ # Default Credentials
2
+
3
+ **Report when:** A credential literal that a running deployment can actually authenticate with, including seeded accounts created on first boot.
4
+
5
+ **Skip when:** Accounts created disabled or with a forced-reset flag. Credentials in docs, READMEs, and fixture files.
6
+
7
+ A credential in prose is a credential nobody can use. A credential in `bootstrap_admin()` is a login.
8
+
9
+ ## VULNERABLE - Report These
10
+
11
+ **Hardcoded admin account**
12
+ ```python
13
+ # File: src/models/user.py
14
+ def bootstrap_admin():
15
+ """Create default admin account if none exists"""
16
+ if not User.query.filter_by(role='admin').first():
17
+ admin = User(
18
+ username='admin',
19
+ password=hash_password('admin123'),
20
+ role='admin'
21
+ )
22
+ db.session.add(admin)
23
+ db.session.commit()
24
+ ```
25
+ **Why vulnerable:** Default admin account created on first run with known credentials.
26
+
27
+ **API key in code**
28
+ ```javascript
29
+ // File: src/integrations/payment.js
30
+ const STRIPE_API_KEY = process.env.STRIPE_KEY || 'sk_tes...';
31
+
32
+ const stripe = require('stripe')(STRIPE_API_KEY);
33
+ ```
34
+ **Why vulnerable:** Uses test API key if env var missing. Might reach production.
35
+
36
+ **Database connection string**
37
+ ```java
38
+ // File: DatabaseConfig.java
39
+ private static final String DB_URL = System.getenv().getOrDefault(
40
+ "DATABASE_URL",
41
+ "postgresql://admin:password@localhost:5432/prod"
42
+ );
43
+ ```
44
+ **Why vulnerable:** Hardcoded database credentials as fallback.
45
+
46
+ ## SECURE - Skip These
47
+
48
+ **Disabled default account**
49
+ ```python
50
+ # File: src/models/user.py
51
+ def bootstrap_admin():
52
+ """Admin account MUST be configured via environment"""
53
+ username = os.environ['ADMIN_USERNAME']
54
+ password = os.environ['ADMIN_PASSWORD']
55
+
56
+ if not User.query.filter_by(username=username).first():
57
+ admin = User(username=username, password=hash_password(password), role='admin')
58
+ db.session.add(admin)
59
+ ```
60
+
61
+ **Example/documentation credentials**: a credential appearing inside prose in `README.md`:
62
+ ```markdown
63
+ ## Setup
64
+
65
+ Configure your API key:
66
+
67
+ export STRIPE_KEY='sk_tes...' # Example only
68
+ ```
69
+
70
+ **Test fixture credentials**
71
+ ```python
72
+ # File: tests/conftest.py
73
+ @pytest.fixture
74
+ def test_user():
75
+ return User(username='test_user', password='test_pass') # OK - test scope
76
+ ```
@@ -1,11 +1,11 @@
1
- {
2
- "id": "fail-open-security",
3
- "title": "Fail-open security switches",
4
- "seeds": [
5
- "(AUTH|AUTHENTICATION|AUTHZ|REQUIRE_AUTH|LOGIN_REQUIRED|VERIFY|TLS_VERIFY|SSL_VERIFY|CSRF|SIGNATURE_CHECK)[A-Z_]*[[:space:]]*[:=][[:space:]]*(False|false|0|['\"](false|0|no|off)['\"])",
6
- "(verify|check_hostname|validate)[[:space:]]*=[[:space:]]*(False|false)",
7
- "(getenv|environ\\.get|process\\.env)[^)]*\\)[[:space:]]*(or|\\|\\|)[[:space:]]*(False|false|['\"](false|0|off|no)['\"])",
8
- "(getenv|environ\\.get|getOrDefault|get_config|get_setting)\\([^)]*,[[:space:]]*['\"]?(false|0|no|off|none|disabled)['\"]?[[:space:]]*\\)",
9
- "InsecureSkipVerify[[:space:]]*:[[:space:]]*true"
10
- ]
11
- }
1
+ {
2
+ "id": "fail-open-security",
3
+ "title": "Fail-open security switches",
4
+ "seeds": [
5
+ "(AUTH|AUTHENTICATION|AUTHZ|REQUIRE_AUTH|LOGIN_REQUIRED|VERIFY|TLS_VERIFY|SSL_VERIFY|CSRF|SIGNATURE_CHECK)[A-Z_]*[[:space:]]*[:=][[:space:]]*(False|false|0|['\"](false|0|no|off)['\"])",
6
+ "(verify|check_hostname|validate)[[:space:]]*=[[:space:]]*(False|false)",
7
+ "(getenv|environ\\.get|process\\.env)[^)]*\\)[[:space:]]*(or|\\|\\|)[[:space:]]*(False|false|['\"](false|0|off|no)['\"])",
8
+ "(getenv|environ\\.get|getOrDefault|get_config|get_setting)\\([^)]*,[[:space:]]*['\"]?(false|0|no|off|none|disabled)['\"]?[[:space:]]*\\)",
9
+ "InsecureSkipVerify[[:space:]]*:[[:space:]]*true"
10
+ ]
11
+ }
@@ -1,70 +1,70 @@
1
- # Fail-Open Security Switches
2
-
3
- **Report when:** The value taken when configuration is absent disables a security control. The insecure state is the unconfigured state.
4
-
5
- **Skip when:** Switches whose unconfigured value is the secure one. Flags read but never consulted at the enforcement point.
6
-
7
- Read the default, not the flag name. `REQUIRE_AUTH` defaulting to `'false'` requires nothing.
8
-
9
- ## VULNERABLE - Report These
10
-
11
- **Authentication disabled by default**
12
- ```python
13
- # File: config/security.py
14
- REQUIRE_AUTH = os.getenv('REQUIRE_AUTH', 'false').lower() == 'true'
15
-
16
- @app.before_request
17
- def check_auth():
18
- if not REQUIRE_AUTH:
19
- return # Skip auth check
20
- # ... auth logic
21
- ```
22
- **Why vulnerable:** Default is no authentication. App runs insecurely if env var missing.
23
-
24
- **CORS allows all origins**
25
- ```javascript
26
- // File: server.js
27
- const allowedOrigins = process.env.ALLOWED_ORIGINS || '*';
28
-
29
- app.use(cors({ origin: allowedOrigins }));
30
- ```
31
- **Why vulnerable:** Default allows requests from any origin. XSS/CSRF risk.
32
-
33
- **Debug mode enabled by default**
34
- ```python
35
- # File: config.py
36
- DEBUG = os.getenv('DEBUG', 'true').lower() != 'false' # Default: true
37
-
38
- if DEBUG:
39
- app.config['DEBUG'] = True
40
- app.config['PROPAGATE_EXCEPTIONS'] = True
41
- ```
42
- **Why vulnerable:** Debug mode default. Stack traces leak sensitive info in production.
43
-
44
- ## SECURE - Skip These
45
-
46
- **Authentication required by default**
47
- ```python
48
- # File: config/security.py
49
- REQUIRE_AUTH = os.getenv('REQUIRE_AUTH', 'true').lower() == 'true' # Default: true
50
-
51
- # Or better - crash if not explicitly configured
52
- REQUIRE_AUTH = os.environ['REQUIRE_AUTH'].lower() == 'true'
53
- ```
54
-
55
- **CORS requires explicit configuration**
56
- ```javascript
57
- // File: server.js
58
- if (!process.env.ALLOWED_ORIGINS) {
59
- throw new Error('ALLOWED_ORIGINS must be configured');
60
- }
61
- const allowedOrigins = process.env.ALLOWED_ORIGINS.split(',');
62
-
63
- app.use(cors({ origin: allowedOrigins }));
64
- ```
65
-
66
- **Debug mode disabled by default**
67
- ```python
68
- # File: config.py
69
- DEBUG = os.getenv('DEBUG', 'false').lower() == 'true' # Default: false
70
- ```
1
+ # Fail-Open Security Switches
2
+
3
+ **Report when:** The value taken when configuration is absent disables a security control. The insecure state is the unconfigured state.
4
+
5
+ **Skip when:** Switches whose unconfigured value is the secure one. Flags read but never consulted at the enforcement point.
6
+
7
+ Read the default, not the flag name. `REQUIRE_AUTH` defaulting to `'false'` requires nothing.
8
+
9
+ ## VULNERABLE - Report These
10
+
11
+ **Authentication disabled by default**
12
+ ```python
13
+ # File: config/security.py
14
+ REQUIRE_AUTH = os.getenv('REQUIRE_AUTH', 'false').lower() == 'true'
15
+
16
+ @app.before_request
17
+ def check_auth():
18
+ if not REQUIRE_AUTH:
19
+ return # Skip auth check
20
+ # ... auth logic
21
+ ```
22
+ **Why vulnerable:** Default is no authentication. App runs insecurely if env var missing.
23
+
24
+ **CORS allows all origins**
25
+ ```javascript
26
+ // File: server.js
27
+ const allowedOrigins = process.env.ALLOWED_ORIGINS || '*';
28
+
29
+ app.use(cors({ origin: allowedOrigins }));
30
+ ```
31
+ **Why vulnerable:** Default allows requests from any origin. XSS/CSRF risk.
32
+
33
+ **Debug mode enabled by default**
34
+ ```python
35
+ # File: config.py
36
+ DEBUG = os.getenv('DEBUG', 'true').lower() != 'false' # Default: true
37
+
38
+ if DEBUG:
39
+ app.config['DEBUG'] = True
40
+ app.config['PROPAGATE_EXCEPTIONS'] = True
41
+ ```
42
+ **Why vulnerable:** Debug mode default. Stack traces leak sensitive info in production.
43
+
44
+ ## SECURE - Skip These
45
+
46
+ **Authentication required by default**
47
+ ```python
48
+ # File: config/security.py
49
+ REQUIRE_AUTH = os.getenv('REQUIRE_AUTH', 'true').lower() == 'true' # Default: true
50
+
51
+ # Or better - crash if not explicitly configured
52
+ REQUIRE_AUTH = os.environ['REQUIRE_AUTH'].lower() == 'true'
53
+ ```
54
+
55
+ **CORS requires explicit configuration**
56
+ ```javascript
57
+ // File: server.js
58
+ if (!process.env.ALLOWED_ORIGINS) {
59
+ throw new Error('ALLOWED_ORIGINS must be configured');
60
+ }
61
+ const allowedOrigins = process.env.ALLOWED_ORIGINS.split(',');
62
+
63
+ app.use(cors({ origin: allowedOrigins }));
64
+ ```
65
+
66
+ **Debug mode disabled by default**
67
+ ```python
68
+ # File: config.py
69
+ DEBUG = os.getenv('DEBUG', 'false').lower() == 'true' # Default: false
70
+ ```
@@ -1,11 +1,11 @@
1
- {
2
- "id": "fallback-secrets",
3
- "title": "Fallback secrets",
4
- "seeds": [
5
- "(getenv|environ\\.get|get_config|get_setting|getOrDefault|GetString|LookupEnv)\\([^)]*,[[:space:]]*['\"]",
6
- "(getenv|environ\\.get|os\\.environ\\.get)\\([^)]*\\)[[:space:]]*(or|\\|\\|)[[:space:]]*['\"]",
7
- "process\\.env\\.[A-Za-z_][A-Za-z0-9_]*[[:space:]]*(\\|\\||\\?\\?)[[:space:]]*['\"]",
8
- "ENV\\.fetch\\([^)]*,[[:space:]]*['\"]",
9
- "(SECRET|SECRET_KEY|JWT_SECRET|SESSION_KEY|SIGNING_KEY|TOKEN|SALT|PEPPER)[[:space:]]*[:=]"
10
- ]
11
- }
1
+ {
2
+ "id": "fallback-secrets",
3
+ "title": "Fallback secrets",
4
+ "seeds": [
5
+ "(getenv|environ\\.get|get_config|get_setting|getOrDefault|GetString|LookupEnv)\\([^)]*,[[:space:]]*['\"]",
6
+ "(getenv|environ\\.get|os\\.environ\\.get)\\([^)]*\\)[[:space:]]*(or|\\|\\|)[[:space:]]*['\"]",
7
+ "process\\.env\\.[A-Za-z_][A-Za-z0-9_]*[[:space:]]*(\\|\\||\\?\\?)[[:space:]]*['\"]",
8
+ "ENV\\.fetch\\([^)]*,[[:space:]]*['\"]",
9
+ "(SECRET|SECRET_KEY|JWT_SECRET|SESSION_KEY|SIGNING_KEY|TOKEN|SALT|PEPPER)[[:space:]]*[:=]"
10
+ ]
11
+ }
@@ -1,70 +1,70 @@
1
- # Fallback Secrets
2
-
3
- **Report when:** A default value supplied when the env var is absent, where that value feeds signing, encryption, session, or token machinery.
4
-
5
- **Skip when:** Defaults generated per-boot at random. Values only used as cache keys or correlation ids.
6
-
7
- The decisive question is not whether a literal exists. It is whether the app **runs** with it. `env.get(X, Y)` runs; `env[X]` crashes. That difference is the whole finding.
8
-
9
- ## VULNERABLE - Report These
10
-
11
- **Python: Environment variable with fallback**
12
- ```python
13
- # File: src/auth/jwt.py
14
- SECRET_KEY = os.environ.get('SECRET_KEY', 'dev-secret-key-123')
15
-
16
- # Used in security context
17
- def create_token(user_id):
18
- return jwt.encode({'user_id': user_id}, SECRET_KEY, algorithm='HS256')
19
- ```
20
- **Why vulnerable:** App runs with known secret if `SECRET_KEY` is missing. Attacker can forge tokens.
21
-
22
- **JavaScript: Logical OR fallback**
23
- ```javascript
24
- // File: config/database.js
25
- const DB_PASSWORD = process.env.DB_PASSWORD || 'admin123';
26
-
27
- const pool = new Pool({
28
- user: 'admin',
29
- password: DB_PASSWORD,
30
- database: 'production'
31
- });
32
- ```
33
- **Why vulnerable:** Database accepts hardcoded password in production if env var missing.
34
-
35
- **Ruby: fetch with default**
36
- ```ruby
37
- # File: config/secrets.rb
38
- Rails.application.credentials.secret_key_base =
39
- ENV.fetch('SECRET_KEY_BASE', 'fallback-secret-base')
40
- ```
41
- **Why vulnerable:** Rails session encryption uses weak known key as fallback.
42
-
43
- ## SECURE - Skip These
44
-
45
- **Fail-secure: Crashes without config**
46
- ```python
47
- # File: src/auth/jwt.py
48
- SECRET_KEY = os.environ['SECRET_KEY'] # Raises KeyError if missing
49
-
50
- # App won't start without SECRET_KEY - fail-secure
51
- ```
52
-
53
- **Explicit validation**
54
- ```javascript
55
- // File: config/database.js
56
- if (!process.env.DB_PASSWORD) {
57
- throw new Error('DB_PASSWORD environment variable required');
58
- }
59
- const DB_PASSWORD = process.env.DB_PASSWORD;
60
- ```
61
-
62
- **Test fixtures (clearly scoped)**
63
- ```python
64
- # File: tests/fixtures/auth.py
65
- TEST_SECRET = 'test-secret-key-123' # OK - test-only
66
-
67
- # Usage in test
68
- def test_token_creation():
69
- token = create_token('user1', secret=TEST_SECRET)
70
- ```
1
+ # Fallback Secrets
2
+
3
+ **Report when:** A default value supplied when the env var is absent, where that value feeds signing, encryption, session, or token machinery.
4
+
5
+ **Skip when:** Defaults generated per-boot at random. Values only used as cache keys or correlation ids.
6
+
7
+ The decisive question is not whether a literal exists. It is whether the app **runs** with it. `env.get(X, Y)` runs; `env[X]` crashes. That difference is the whole finding.
8
+
9
+ ## VULNERABLE - Report These
10
+
11
+ **Python: Environment variable with fallback**
12
+ ```python
13
+ # File: src/auth/jwt.py
14
+ SECRET_KEY = os.environ.get('SECRET_KEY', 'dev-secret-key-123')
15
+
16
+ # Used in security context
17
+ def create_token(user_id):
18
+ return jwt.encode({'user_id': user_id}, SECRET_KEY, algorithm='HS256')
19
+ ```
20
+ **Why vulnerable:** App runs with known secret if `SECRET_KEY` is missing. Attacker can forge tokens.
21
+
22
+ **JavaScript: Logical OR fallback**
23
+ ```javascript
24
+ // File: config/database.js
25
+ const DB_PASSWORD = process.env.DB_PASSWORD || 'admin123';
26
+
27
+ const pool = new Pool({
28
+ user: 'admin',
29
+ password: DB_PASSWORD,
30
+ database: 'production'
31
+ });
32
+ ```
33
+ **Why vulnerable:** Database accepts hardcoded password in production if env var missing.
34
+
35
+ **Ruby: fetch with default**
36
+ ```ruby
37
+ # File: config/secrets.rb
38
+ Rails.application.credentials.secret_key_base =
39
+ ENV.fetch('SECRET_KEY_BASE', 'fallback-secret-base')
40
+ ```
41
+ **Why vulnerable:** Rails session encryption uses weak known key as fallback.
42
+
43
+ ## SECURE - Skip These
44
+
45
+ **Fail-secure: Crashes without config**
46
+ ```python
47
+ # File: src/auth/jwt.py
48
+ SECRET_KEY = os.environ['SECRET_KEY'] # Raises KeyError if missing
49
+
50
+ # App won't start without SECRET_KEY - fail-secure
51
+ ```
52
+
53
+ **Explicit validation**
54
+ ```javascript
55
+ // File: config/database.js
56
+ if (!process.env.DB_PASSWORD) {
57
+ throw new Error('DB_PASSWORD environment variable required');
58
+ }
59
+ const DB_PASSWORD = process.env.DB_PASSWORD;
60
+ ```
61
+
62
+ **Test fixtures (clearly scoped)**
63
+ ```python
64
+ # File: tests/fixtures/auth.py
65
+ TEST_SECRET = 'test-secret-key-123' # OK - test-only
66
+
67
+ # Usage in test
68
+ def test_token_creation():
69
+ token = create_token('user1', secret=TEST_SECRET)
70
+ ```