skillfullstack 0.0.0-stage → 1.0.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 (775) hide show
  1. package/.skillsRegistry/catalog.json +231 -0
  2. package/AGENTS.md +89 -0
  3. package/README.md +210 -2
  4. package/bin/index.js +508 -0
  5. package/package.json +57 -4
  6. package/skills/backend/apiEngineering/SKILL.md +102 -0
  7. package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
  8. package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
  9. package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
  10. package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
  11. package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
  12. package/skills/backend/apiEngineering/policies/performance.md +39 -0
  13. package/skills/backend/apiEngineering/policies/security.md +36 -0
  14. package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
  15. package/skills/backend/apiEngineering/references/apiReference.md +3 -0
  16. package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
  17. package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
  18. package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
  19. package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
  20. package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
  21. package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
  22. package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
  23. package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
  24. package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
  25. package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
  26. package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
  27. package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
  28. package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
  29. package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
  30. package/skills/backend/databaseArchitecture/SKILL.md +118 -0
  31. package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
  32. package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
  33. package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
  34. package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
  35. package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
  36. package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
  37. package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
  38. package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
  39. package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
  40. package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
  41. package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
  42. package/skills/backend/databaseArchitecture/policies/security.md +26 -0
  43. package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
  44. package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
  45. package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
  46. package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
  47. package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
  48. package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
  49. package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
  50. package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
  51. package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
  52. package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
  53. package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
  54. package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
  55. package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
  56. package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
  57. package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
  58. package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
  59. package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
  60. package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
  61. package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
  62. package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
  63. package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
  64. package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
  65. package/skills/backend/golangStandard/SKILL.md +155 -0
  66. package/skills/backend/golangStandard/evals/goVerification.json +14 -0
  67. package/skills/backend/golangStandard/references/apiReference.md +3 -0
  68. package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
  69. package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
  70. package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
  71. package/skills/backend/pythonStandard/SKILL.md +138 -0
  72. package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
  73. package/skills/backend/pythonStandard/references/apiReference.md +3 -0
  74. package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
  75. package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
  76. package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
  77. package/skills/backend/upstash/SKILL.md +98 -0
  78. package/skills/backend/upstash/evals/upstashVerification.json +14 -0
  79. package/skills/backend/upstash/references/apiReference.md +3 -0
  80. package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
  81. package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
  82. package/skills/backend/upstash/references/workflowPatterns.md +35 -0
  83. package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
  84. package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
  85. package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
  86. package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
  87. package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
  88. package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
  89. package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
  90. package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
  91. package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
  92. package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
  93. package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
  94. package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
  95. package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
  96. package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
  97. package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
  98. package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
  99. package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
  100. package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
  101. package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
  102. package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
  103. package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
  104. package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
  105. package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
  106. package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
  107. package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
  108. package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
  109. package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
  110. package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
  111. package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
  112. package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
  113. package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
  114. package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
  115. package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
  116. package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
  117. package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
  118. package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
  119. package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
  120. package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
  121. package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
  122. package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
  123. package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
  124. package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
  125. package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
  126. package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
  127. package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
  128. package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
  129. package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
  130. package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
  131. package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
  132. package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
  133. package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
  134. package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
  135. package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
  136. package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
  137. package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
  138. package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
  139. package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
  140. package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
  141. package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
  142. package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
  143. package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
  144. package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
  145. package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
  146. package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
  147. package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
  148. package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
  149. package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
  150. package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
  151. package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
  152. package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
  153. package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
  154. package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
  155. package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
  156. package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
  157. package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
  158. package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
  159. package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
  160. package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
  161. package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
  162. package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
  163. package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
  164. package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
  165. package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
  166. package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
  167. package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
  168. package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
  169. package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
  170. package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
  171. package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
  172. package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
  173. package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
  174. package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
  175. package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
  176. package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
  177. package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
  178. package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
  179. package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
  180. package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
  181. package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
  182. package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
  183. package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
  184. package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
  185. package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
  186. package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
  187. package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
  188. package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
  189. package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
  190. package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
  191. package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
  192. package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
  193. package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
  194. package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
  195. package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
  196. package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
  197. package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
  198. package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
  199. package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
  200. package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
  201. package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
  202. package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
  203. package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
  204. package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
  205. package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
  206. package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
  207. package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
  208. package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
  209. package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
  210. package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
  211. package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
  212. package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
  213. package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
  214. package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
  215. package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
  216. package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
  217. package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
  218. package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
  219. package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
  220. package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
  221. package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
  222. package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
  223. package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
  224. package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
  225. package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
  226. package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
  227. package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
  228. package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
  229. package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
  230. package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
  231. package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
  232. package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
  233. package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
  234. package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
  235. package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
  236. package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
  237. package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
  238. package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
  239. package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
  240. package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
  241. package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
  242. package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
  243. package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
  244. package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
  245. package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
  246. package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
  247. package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
  248. package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
  249. package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
  250. package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
  251. package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
  252. package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
  253. package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
  254. package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
  255. package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
  256. package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
  257. package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
  258. package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
  259. package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
  260. package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
  261. package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
  262. package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
  263. package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
  264. package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
  265. package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
  266. package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
  267. package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
  268. package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
  269. package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
  270. package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
  271. package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
  272. package/skills/frontend/astro/SKILL.md +327 -0
  273. package/skills/frontend/astro/assets/README.md +71 -0
  274. package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
  275. package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
  276. package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
  277. package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
  278. package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
  279. package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
  280. package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
  281. package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
  282. package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
  283. package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
  284. package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
  285. package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
  286. package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
  287. package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
  288. package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
  289. package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
  290. package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
  291. package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
  292. package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
  293. package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
  294. package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
  295. package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
  296. package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
  297. package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
  298. package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
  299. package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
  300. package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
  301. package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
  302. package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
  303. package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
  304. package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
  305. package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
  306. package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
  307. package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
  308. package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
  309. package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
  310. package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
  311. package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
  312. package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
  313. package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
  314. package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
  315. package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
  316. package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
  317. package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
  318. package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
  319. package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
  320. package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
  321. package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
  322. package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
  323. package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
  324. package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
  325. package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
  326. package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
  327. package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
  328. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
  329. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
  330. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
  331. package/skills/frontend/astro/assets/welcome/courses.md +46 -0
  332. package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
  333. package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
  334. package/skills/frontend/astro/evals/evals.json +66 -0
  335. package/skills/frontend/astro/references/contentCollections.md +164 -0
  336. package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
  337. package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
  338. package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
  339. package/skills/frontend/generativeUi/SKILL.md +128 -0
  340. package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
  341. package/skills/frontend/generativeUi/references/apiReference.md +3 -0
  342. package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
  343. package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
  344. package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
  345. package/skills/frontend/nextjs/SKILL.md +138 -0
  346. package/skills/frontend/nextjs/assets/README.md +67 -0
  347. package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
  348. package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
  349. package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
  350. package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
  351. package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
  352. package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
  353. package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
  354. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
  355. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
  356. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
  357. package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
  358. package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
  359. package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
  360. package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
  361. package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
  362. package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
  363. package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
  364. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
  365. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
  366. package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
  367. package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
  368. package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
  369. package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
  370. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
  371. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
  372. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
  373. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
  374. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
  375. package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
  376. package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
  377. package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
  378. package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
  379. package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
  380. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
  381. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
  382. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
  383. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
  384. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
  385. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
  386. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
  387. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
  388. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
  389. package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
  390. package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
  391. package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
  392. package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
  393. package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
  394. package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
  395. package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
  396. package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
  397. package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
  398. package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
  399. package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
  400. package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
  401. package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
  402. package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
  403. package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
  404. package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
  405. package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
  406. package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
  407. package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
  408. package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
  409. package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
  410. package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
  411. package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
  412. package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
  413. package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
  414. package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
  415. package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
  416. package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
  417. package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
  418. package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
  419. package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
  420. package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
  421. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
  422. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
  423. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
  424. package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
  425. package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
  426. package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
  427. package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
  428. package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
  429. package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
  430. package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
  431. package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
  432. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
  433. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
  434. package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
  435. package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
  436. package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
  437. package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
  438. package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
  439. package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
  440. package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
  441. package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
  442. package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
  443. package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
  444. package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
  445. package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
  446. package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
  447. package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
  448. package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
  449. package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
  450. package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
  451. package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
  452. package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
  453. package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
  454. package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
  455. package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
  456. package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
  457. package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
  458. package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
  459. package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
  460. package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
  461. package/skills/frontend/nextjs/assets/glossary.md +315 -0
  462. package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
  463. package/skills/frontend/nextjs/references/apiReference.md +3 -0
  464. package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
  465. package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
  466. package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
  467. package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
  468. package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
  469. package/skills/frontend/shadcn-ui/SKILL.md +102 -0
  470. package/skills/frontend/shadcn-ui/assets/README.md +82 -0
  471. package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
  472. package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
  473. package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
  474. package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
  475. package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
  476. package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
  477. package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
  478. package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
  479. package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
  480. package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
  481. package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
  482. package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
  483. package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
  484. package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
  485. package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
  486. package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
  487. package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
  488. package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
  489. package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
  490. package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
  491. package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
  492. package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
  493. package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
  494. package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
  495. package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
  496. package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
  497. package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
  498. package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
  499. package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
  500. package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
  501. package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
  502. package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
  503. package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
  504. package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
  505. package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
  506. package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
  507. package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
  508. package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
  509. package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
  510. package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
  511. package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
  512. package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
  513. package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
  514. package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
  515. package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
  516. package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
  517. package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
  518. package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
  519. package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
  520. package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
  521. package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
  522. package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
  523. package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
  524. package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
  525. package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
  526. package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
  527. package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
  528. package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
  529. package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
  530. package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
  531. package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
  532. package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
  533. package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
  534. package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
  535. package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
  536. package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
  537. package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
  538. package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
  539. package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
  540. package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
  541. package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
  542. package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
  543. package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
  544. package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
  545. package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
  546. package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
  547. package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
  548. package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
  549. package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
  550. package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
  551. package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
  552. package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
  553. package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
  554. package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
  555. package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
  556. package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
  557. package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
  558. package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
  559. package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
  560. package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
  561. package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
  562. package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
  563. package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
  564. package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
  565. package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
  566. package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
  567. package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
  568. package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
  569. package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
  570. package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
  571. package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
  572. package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
  573. package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
  574. package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
  575. package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
  576. package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
  577. package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
  578. package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
  579. package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
  580. package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
  581. package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
  582. package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
  583. package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
  584. package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
  585. package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
  586. package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
  587. package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
  588. package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
  589. package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
  590. package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
  591. package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
  592. package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
  593. package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
  594. package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
  595. package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
  596. package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
  597. package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
  598. package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
  599. package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
  600. package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
  601. package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
  602. package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
  603. package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
  604. package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
  605. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
  606. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
  607. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
  608. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
  609. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
  610. package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
  611. package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
  612. package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
  613. package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
  614. package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
  615. package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
  616. package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
  617. package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
  618. package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
  619. package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
  620. package/skills/github/assets/README.md +39 -0
  621. package/skills/github/assets/cli/gh-environment.md +87 -0
  622. package/skills/github/assets/cli/gh-formatting.md +156 -0
  623. package/skills/github/assets/cli/gh-reference.md +2363 -0
  624. package/skills/github/assets/docs-api/github-docs-api.md +60 -0
  625. package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
  626. package/skills/github/assets/rest-api/actions-variables.md +1247 -0
  627. package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
  628. package/skills/github/assets/rest-api/actions-workflows.md +348 -0
  629. package/skills/github/assets/rest-api/authenticating.md +174 -0
  630. package/skills/github/assets/rest-api/branches.md +727 -0
  631. package/skills/github/assets/rest-api/checks-runs.md +1013 -0
  632. package/skills/github/assets/rest-api/checks-suites.md +1142 -0
  633. package/skills/github/assets/rest-api/code-scanning.md +2957 -0
  634. package/skills/github/assets/rest-api/collaborators.md +547 -0
  635. package/skills/github/assets/rest-api/commits.md +957 -0
  636. package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
  637. package/skills/github/assets/rest-api/orgs.md +1172 -0
  638. package/skills/github/assets/rest-api/overview.md +875 -0
  639. package/skills/github/assets/rest-api/pull-reviews.md +722 -0
  640. package/skills/github/assets/rest-api/pulls.md +1605 -0
  641. package/skills/github/assets/rest-api/quickstart.md +344 -0
  642. package/skills/github/assets/rest-api/releases.md +650 -0
  643. package/skills/github/assets/rest-api/repos.md +2957 -0
  644. package/skills/github/assets/rest-api/rules.md +1507 -0
  645. package/skills/github/assets/rest-api/secret-scanning.md +947 -0
  646. package/skills/github/assets/rest-api/teams.md +1690 -0
  647. package/skills/github/githubAction/SKILL.md +159 -0
  648. package/skills/github/githubAction/assets/README.md +38 -0
  649. package/skills/github/githubAction/assets/reference/contexts.md +918 -0
  650. package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
  651. package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
  652. package/skills/github/githubAction/assets/reference/expressions.md +441 -0
  653. package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
  654. package/skills/github/githubAction/assets/reference/variables.md +149 -0
  655. package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
  656. package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
  657. package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
  658. package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
  659. package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
  660. package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
  661. package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
  662. package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
  663. package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
  664. package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
  665. package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
  666. package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
  667. package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
  668. package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
  669. package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
  670. package/skills/github/githubAction/evals/actionVerification.json +14 -0
  671. package/skills/github/githubAction/references/apiReference.md +3 -0
  672. package/skills/github/githubAction/references/workflowPatterns.md +81 -0
  673. package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
  674. package/skills/github/githubQuality/SKILL.md +136 -0
  675. package/skills/github/githubQuality/assets/README.md +24 -0
  676. package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
  677. package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
  678. package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
  679. package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
  680. package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
  681. package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
  682. package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
  683. package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
  684. package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
  685. package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
  686. package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
  687. package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
  688. package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
  689. package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
  690. package/skills/github/githubQuality/references/apiReference.md +3 -0
  691. package/skills/github/githubQuality/references/codeownersExample.md +26 -0
  692. package/skills/github/githubQuality/references/prTemplate.md +20 -0
  693. package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
  694. package/skills/github/githubSecurity/SKILL.md +170 -0
  695. package/skills/github/githubSecurity/assets/README.md +32 -0
  696. package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
  697. package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
  698. package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
  699. package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
  700. package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
  701. package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
  702. package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
  703. package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
  704. package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
  705. package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
  706. package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
  707. package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
  708. package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
  709. package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
  710. package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
  711. package/skills/github/githubSecurity/references/apiReference.md +3 -0
  712. package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
  713. package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
  714. package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
  715. package/skills/github/githubSetup/SKILL.md +137 -0
  716. package/skills/github/githubSetup/assets/README.md +40 -0
  717. package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
  718. package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
  719. package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
  720. package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
  721. package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
  722. package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
  723. package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
  724. package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
  725. package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
  726. package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
  727. package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
  728. package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
  729. package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
  730. package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
  731. package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
  732. package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
  733. package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
  734. package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
  735. package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
  736. package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
  737. package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
  738. package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
  739. package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
  740. package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
  741. package/skills/github/githubSetup/evals/setupVerification.json +14 -0
  742. package/skills/github/githubSetup/references/apiReference.md +3 -0
  743. package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
  744. package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
  745. package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
  746. package/skills/github/githubTeam/SKILL.md +115 -0
  747. package/skills/github/githubTeam/assets/README.md +21 -0
  748. package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
  749. package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
  750. package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
  751. package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
  752. package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
  753. package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
  754. package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
  755. package/skills/github/githubTeam/evals/teamVerification.json +14 -0
  756. package/skills/github/githubTeam/references/apiReference.md +3 -0
  757. package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
  758. package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
  759. package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
  760. package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
  761. package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
  762. package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
  763. package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
  764. package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
  765. package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
  766. package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
  767. package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
  768. package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
  769. package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
  770. package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
  771. package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
  772. package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
  773. package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
  774. package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
  775. package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
@@ -0,0 +1,30 @@
1
+ # Data Modeling Lifecycle & Identifier Engineering Reference
2
+
3
+ ---
4
+
5
+ ## 1. The Three Levels of Data Modeling
6
+
7
+ 1. **Conceptual Data Model (CDM)**:
8
+ - Identifies business entities, domains, and overarching relationships.
9
+ - Independent of any database software or technical storage format.
10
+ - Artifact: High-level Domain ERD.
11
+ 2. **Logical Data Model (LDM)**:
12
+ - Specifies entities, attributes, primary/foreign keys, cardinality ($1:1, 1:N, N:M$), and normalization rules.
13
+ - Abstracted from engine-specific physical storage parameters.
14
+ 3. **Physical Data Model (PDM)**:
15
+ - Defines concrete database implementation: exact data types (`BIGINT`, `TIMESTAMPTZ`, `VARCHAR(255)`), table spaces, indexes, partitions, and engine-specific constraints.
16
+
17
+ ---
18
+
19
+ ## 2. Identifier Engineering Decision Matrix
20
+
21
+ | Identifier Type | Size | Monotonic Ordering | Distributed Generation | Information Leakage | B-Tree Locality |
22
+ | :--- | :--- | :--- | :--- | :--- | :--- |
23
+ | **BIGINT (`IDENTITY` / `AUTO_INCREMENT`)** | 8 bytes | Yes | Requires DB Coordinator | High (sequential IDs reveal volume) | Excellent ($O(1)$ append) |
24
+ | **UUIDv4** | 16 bytes | No (Random) | Yes (Local client) | None | Terrible (Page thrashing on large tables) |
25
+ | **UUIDv7 (RFC 9562)** | 16 bytes | Yes (Time-ordered ms) | Yes (Local client) | None (Timestamp encoded) | Excellent (Preserves B-tree append locality) |
26
+ | **ULID** | 16 bytes | Yes (Time-ordered ms) | Yes (Crockford base32) | None | Excellent |
27
+ | **Snowflake ID** | 8 bytes | Yes (64-bit integer) | Yes (Machine node ID) | Low | Excellent |
28
+
29
+ ### Recommended Standard
30
+ For distributed, secure, and performant modern architectures, **UUIDv7** is the primary recommended identifier. It eliminates database-roundtrip ID generation, hides commercial transaction volume, and maintains near-zero B-tree index fragmentation.
@@ -0,0 +1,32 @@
1
+ # Database Taxonomy & Workload-Driven Selection Reference
2
+
3
+ Comparative analysis across all primary database paradigms.
4
+
5
+ ---
6
+
7
+ ## 1. The 13 Database Families
8
+
9
+ | Family | Representative Engines | Best-Fit Workload | Trade-offs & Limitations |
10
+ | :--- | :--- | :--- | :--- |
11
+ | **Relational (RDBMS)** | PostgreSQL, MySQL, SQLite | Structured data, complex multi-entity transactions, strict ACID. | Horizontal write scaling requires manual sharding or Vitess/Citus. |
12
+ | **Document** | MongoDB, Firestore, Couchbase | Hierarchical polymorphic entities, rapid schema evolution. | Multi-document transactions carry higher latency; risk of unbounded nested documents. |
13
+ | **Key-Value** | Redis, Valkey, DynamoDB | Session storage, caching, token management, $< 5$ms lookups. | Limited query flexibility; secondary indexing is costly or unsupported. |
14
+ | **Wide-Column** | Apache Cassandra, ScyllaDB | High-volume write ingestion (IoT, telemetry, messaging), multi-datacenter. | Query-driven tables; no ad-hoc joins; eventual consistency model. |
15
+ | **Columnar (OLAP)** | ClickHouse, DuckDB, Snowflake | Analytical aggregations over billions of rows (`SUM`, `AVG`, `GROUP BY`). | Inefficient for point lookups or frequent single-row updates. |
16
+ | **Graph** | Neo4j, Amazon Neptune | Deep relationship traversals, fraud detection, social networks, ACLs. | Difficult to scale horizontally; higher memory overhead per edge. |
17
+ | **Time-Series** | TimescaleDB, InfluxDB | Metrics, sensor readings, financial tick data with automatic downsampling. | Specialized for sequential time-stamped inserts; updates are discouraged. |
18
+ | **Search** | Elasticsearch, OpenSearch | Inverted full-text search, fuzzy matching, faceted filtering. | Higher write amplification; eventual consistency; heavy memory consumption. |
19
+ | **Vector** | Qdrant, Milvus, pgvector | High-dimensional embedding similarity search (HNSW, IVFFlat), RAG. | Compute-intensive cosine/L2 distance calculations; memory-heavy indexes. |
20
+ | **Object Storage** | S3, GCS, MinIO | Unstructured files, images, videos, large analytical Parquet dumps. | High latency per request (50-100ms); immutable object semantics. |
21
+ | **Embedded** | SQLite, DuckDB, RocksDB | Local desktop apps, mobile devices, edge devices, zero-network daemon cache. | Single-writer limitations (concurrency bottleneck under heavy concurrent web writes). |
22
+ | **In-Memory** | Redis, Dragonfly, SAP HANA | Ultra-low latency $(< 1$ms) real-time leaderboards, rate limit counters. | RAM cost is higher than SSDs; persistence depends on periodic snapshots/AOF. |
23
+ | **Ledger** | ImmuDB, Amazon QLDB alternatives | Cryptographically verifiable immutable audit logs and legal transaction history. | Append-only; higher storage growth; specialized query interfaces. |
24
+
25
+ ---
26
+
27
+ ## 2. Polyglot Persistence Architecture Rules
28
+
29
+ Polyglot persistence combines specialized databases (e.g. PostgreSQL + Redis + ClickHouse).
30
+ - **Law 1**: Explicitly designate the single **System of Record (SoR)** (usually PostgreSQL).
31
+ - **Law 2**: Secondary read stores (Redis cache, Elastic search index, ClickHouse analytics) must be populated asynchronously via **Change Data Capture (CDC)** (Debezium, Kafka) or outbox domain events.
32
+ - **Law 3**: Never perform dual-writes synchronously from application code without two-phase commit or transactional outbox patterns.
@@ -0,0 +1,32 @@
1
+ # Indexing Fundamentals & Query Optimization Reference
2
+
3
+ ---
4
+
5
+ ## 1. Physical Index Types
6
+
7
+ | Index Architecture | Engine Examples | Ideal Query Pattern | Limitations |
8
+ | :--- | :--- | :--- | :--- |
9
+ | **B-Tree** | PostgreSQL, MySQL, SQLite | Equality (`=`), Range (`<`, `>`, `BETWEEN`), Sorting (`ORDER BY`). | Inefficient for high-dimensional vectors or full text. |
10
+ | **Hash** | PostgreSQL, MySQL (Memory) | Exact equality (`=`) lookups only. | Does not support range scans or sorting. |
11
+ | **GIN (Generalized Inverted)** | PostgreSQL | JSONB containment (`@>`), full-text search, arrays (`&&`). | Higher write amplification during inserts/updates. |
12
+ | **GiST** | PostgreSQL | Geometric data, spatial coordinates, full-text search. | Slower build times and larger size than B-tree. |
13
+ | **BRIN (Block Range Index)** | PostgreSQL | Huge tables naturally ordered by insertion (`created_at`). | Tiny footprint ($< 1\%$ size of B-tree), but requires physical sorting. |
14
+ | **HNSW / IVFFlat** | pgvector, Qdrant, Milvus | Approximate nearest neighbor vector similarity search. | Memory intensive; trade-off between recall and search latency. |
15
+
16
+ ---
17
+
18
+ ## 2. Composite Index Column Ordering Heuristic
19
+
20
+ When creating composite index `CREATE INDEX idx_orders ON orders (tenant_id, status, created_at)`:
21
+ 1. **Rule 1 (Equality Columns First)**: Place columns tested with strict equality (`WHERE tenant_id = ? AND status = ?`) at the leading edge.
22
+ 2. **Rule 2 (Range Columns Second)**: Place columns tested with range operators (`WHERE created_at >= ?`) after the equality columns.
23
+ 3. **Rule 3 (Covering Columns via INCLUDE)**: Add non-filter payload columns to `INCLUDE (amount, currency)` to enable **Index-Only Scans** without bloating the B-tree navigation key.
24
+
25
+ ---
26
+
27
+ ## 3. Query Plan Diagnostics (`EXPLAIN ANALYZE`)
28
+
29
+ Key indicators to inspect in execution plans:
30
+ - **Index Scan vs Index Only Scan vs Sequential Scan**: Verify that large tables avoid full sequential scans (`Seq Scan`).
31
+ - **Buffers (`BUFFERS` flag)**: Check `shared hit` vs `shared read`. High `read` indicates disk I/O bottlenecks.
32
+ - **Rows Estimation Divergence**: If estimated rows differ from actual rows by orders of magnitude, update database statistics via `ANALYZE <table>`.
@@ -0,0 +1,61 @@
1
+ # Relational Normalization & Dependency Theory Reference
2
+
3
+ Comprehensive mathematical and practical guide to relational normalization (1NF through BCNF and 5NF).
4
+
5
+ ---
6
+
7
+ ## 1. Functional Dependencies & Keys
8
+
9
+ - **Functional Dependency ($X \rightarrow Y$)**:
10
+ Given relation $R$, attribute set $Y$ is functionally dependent on $X$ if each $X$-value in $R$ is associated with precisely one $Y$-value.
11
+ - **Candidate Key**:
12
+ A minimal superkey: a set of attributes that uniquely determines all other attributes in the relation, with no proper subset that does the same.
13
+ - **Prime Attribute**: An attribute that is a member of any candidate key.
14
+ - **Determinant**: Any attribute or set of attributes upon which some other attribute is functionally dependent.
15
+
16
+ ---
17
+
18
+ ## 2. Normal Forms Hierarchy
19
+
20
+ ```
21
+ [ 1NF ] Atomic attributes & unique tuples
22
+ |
23
+ [ 2NF ] No partial dependencies on candidate keys
24
+ |
25
+ [ 3NF ] No transitive dependencies on candidate keys
26
+ |
27
+ [ BCNF ] Every determinant is a candidate key
28
+ |
29
+ [ 4NF ] No multi-valued dependencies (MVD)
30
+ |
31
+ [ 5NF ] No join dependencies (PJNF)
32
+ ```
33
+
34
+ ### First Normal Form (1NF)
35
+ - Each attribute must contain atomic (indivisible) values.
36
+ - No repeating groups or arrays stored as comma-separated text.
37
+ - Must have an identifiable primary key.
38
+
39
+ ### Second Normal Form (2NF)
40
+ - Relation is in 1NF.
41
+ - No non-prime attribute is partially dependent on any candidate key.
42
+ - (Applies when candidate keys are composite. If all candidate keys are single attributes, 1NF implies 2NF).
43
+
44
+ ### Third Normal Form (3NF)
45
+ - Relation is in 2NF.
46
+ - No transitive dependencies: if $X \rightarrow Y$ and $Y \rightarrow Z$, then non-prime attribute $Z$ must not depend on $X$ through non-prime $Y$.
47
+ - Formal rule: For every non-trivial $X \rightarrow Y$, either $X$ is a superkey OR $Y$ is a prime attribute.
48
+
49
+ ### Boyce-Codd Normal Form (BCNF)
50
+ - Stricter than 3NF: For EVERY non-trivial functional dependency $X \rightarrow Y$, $X$ MUST be a superkey.
51
+ - Eliminates anomalies when candidate keys overlap composite attributes.
52
+
53
+ ---
54
+
55
+ ## 3. Lossless Decomposition & Dependency Preservation
56
+
57
+ When decomposing relation $R$ into $R_1$ and $R_2$:
58
+ 1. **Lossless Join**:
59
+ $R_1 \bowtie R_2 = R$ if and only if $R_1 \cap R_2 \rightarrow R_1$ OR $R_1 \cap R_2 \rightarrow R_2$.
60
+ 2. **Dependency Preservation**:
61
+ All original functional dependencies can be enforced using the local constraints of decomposed relations without performing expensive joins.
@@ -0,0 +1,37 @@
1
+ # Database Scalability, Partitioning & Sharding Reference
2
+
3
+ ---
4
+
5
+ ## 1. Partitioning vs. Sharding
6
+
7
+ ```
8
+ PARTITIONING (Single Database Node / Engine Managed)
9
+ [ Logical Table: orders ]
10
+ ├── Partition 2026-Q1 (Physical Table orders_2026_q1)
11
+ ├── Partition 2026-Q2 (Physical Table orders_2026_q2)
12
+ └── Partition 2026-Q3 (Physical Table orders_2026_q3)
13
+ --> Queries with WHERE created_at = ... trigger Partition Pruning.
14
+
15
+ SHARDING (Multiple Independent Database Nodes / Distributed Cluster)
16
+ [ Cluster Coordinator / Router ]
17
+ ├── Shard 01 (Database Server A) -> Tenants 001 - 250
18
+ ├── Shard 02 (Database Server B) -> Tenants 251 - 500
19
+ └── Shard 03 (Database Server C) -> Tenants 501 - 750
20
+ --> Queries without Shard Key trigger expensive scatter-gather cross-node queries.
21
+ ```
22
+
23
+ ---
24
+
25
+ ## 2. Partitioning Strategies
26
+
27
+ - **Range Partitioning**: Partition by continuous values (e.g. `created_at` by month/year). Ideal for time-series and log data where old partitions can be detached or archived.
28
+ - **List Partitioning**: Partition by explicit categorical values (e.g. `region IN ('EU', 'US', 'APAC')`).
29
+ - **Hash Partitioning**: Partition by modulus hash over a key. Guarantees uniform distribution across $N$ physical tables.
30
+
31
+ ---
32
+
33
+ ## 3. Sharding Architecture & Shard-Key Selection
34
+
35
+ - **High Cardinality**: The shard key must have millions of distinct values (e.g., `user_id` or `tenant_id`). Never shard on low-cardinality flags (e.g., `country` or `status`).
36
+ - **Even Distribution**: Avoid sequential timestamps or monotonically increasing counters as shard keys; otherwise, all writes hit a single node (Hot Partition).
37
+ - **Cross-Shard Query Penalty**: Avoid shard keys that require distributed joins across nodes. Design tables so that all related entity reads (`orders`, `order_items`, `invoices`) colocate on the same shard via a shared `tenant_id` or `account_id`.
@@ -0,0 +1,39 @@
1
+ # Transactions, Concurrency & ACID Guarantees Reference
2
+
3
+ ---
4
+
5
+ ## 1. The ACID Model
6
+
7
+ - **Atomicity**: An operation either commits entirely or rolls back cleanly. Enforced via the Write-Ahead Log (WAL) or undo logs.
8
+ - **Consistency**: Invariants (NOT NULL, CHECK, Foreign Keys) must be true before and after transaction execution.
9
+ - **Isolation**: Concurrent transactions must not corrupt or leak uncommitted state to one another.
10
+ - **Durability**: Once a transaction is committed, its changes survive crashes, power outages, and engine restarts.
11
+
12
+ ---
13
+
14
+ ## 2. Standard SQL Isolation Levels vs Anomalies
15
+
16
+ | Isolation Level | Dirty Read | Non-Repeatable Read | Phantom Read | Serialization Anomaly / Write Skew |
17
+ | :--- | :---: | :---: | :---: | :---: |
18
+ | **Read Uncommitted** | Possible | Possible | Possible | Possible |
19
+ | **Read Committed** | **Prevented** | Possible | Possible | Possible |
20
+ | **Repeatable Read** | **Prevented** | **Prevented** | Engine Dependent | Possible (Write Skew) |
21
+ | **Serializable** | **Prevented** | **Prevented** | **Prevented** | **Prevented** |
22
+
23
+ ### Write Skew Example (Prevented only by Serializable or Pessimistic Locks)
24
+ Two doctors simultaneously query hospital on-call schedule. Constraint: $\ge 1$ doctor must remain on call.
25
+ Both see count = 2. Both execute `UPDATE shifts SET on_call = false WHERE doctor_id = ...`.
26
+ Under `Repeatable Read`, both succeed! On-call count becomes 0! Under `Serializable` (SSI), one transaction is aborted with a serialization failure.
27
+
28
+ ---
29
+
30
+ ## 3. Concurrency Control Strategies
31
+
32
+ ### Optimistic Concurrency Control (OCC)
33
+ - Use a `version INT NOT NULL DEFAULT 1` column.
34
+ - Update check: `UPDATE accounts SET balance = balance - 50, version = version + 1 WHERE id = :id AND version = :current_version`.
35
+ - If affected rows = 0, throw a concurrency conflict.
36
+
37
+ ### Pessimistic Concurrency Control
38
+ - Use explicit row locks: `SELECT * FROM accounts WHERE id = :id FOR UPDATE`.
39
+ - Enforce short lock timeouts: `SET lock_timeout = '2s'` to prevent cascading deadlocks.
@@ -0,0 +1,99 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ analyzeMigration.py
4
+ Analyzes DDL migration scripts for dangerous, blocking, or non-backward-compatible operations:
5
+ - Direct DROP COLUMN or DROP TABLE without deprecation
6
+ - Direct RENAME COLUMN
7
+ - Non-concurrent index creation (CREATE INDEX without CONCURRENTLY)
8
+ - Adding NOT NULL columns without DEFAULT values
9
+ """
10
+
11
+ import sys
12
+ import os
13
+ import re
14
+ import json
15
+ import argparse
16
+
17
+ def analyze_migration_sql(sql_content):
18
+ risks = []
19
+
20
+ # 1. Check for DROP COLUMN
21
+ drop_col_matches = re.findall(r"alter\s+table\s+([a-zA-Z0-9_\"\.]+)\s+drop\s+(?:column\s+)?([a-zA-Z0-9_\"\.]+)", sql_content, re.IGNORECASE)
22
+ for table, col in drop_col_matches:
23
+ risks.append({
24
+ "severity": "CRITICAL",
25
+ "operation": "DROP_COLUMN",
26
+ "table": table.strip(),
27
+ "target": col.strip(),
28
+ "message": f"Directly dropping column '{col.strip()}' on table '{table.strip()}' breaks running applications. Use expand-and-contract phase 3."
29
+ })
30
+
31
+ # 2. Check for RENAME COLUMN
32
+ rename_matches = re.findall(r"alter\s+table\s+([a-zA-Z0-9_\"\.]+)\s+rename\s+(?:column\s+)?([a-zA-Z0-9_\"\.]+)\s+to\s+([a-zA-Z0-9_\"\.]+)", sql_content, re.IGNORECASE)
33
+ for table, old_c, new_c in rename_matches:
34
+ risks.append({
35
+ "severity": "CRITICAL",
36
+ "operation": "RENAME_COLUMN",
37
+ "table": table.strip(),
38
+ "target": f"{old_c.strip()} -> {new_c.strip()}",
39
+ "message": "Renaming columns causes immediate downtime for running application code. Use dual-writing with expand-and-contract."
40
+ })
41
+
42
+ # 3. Check for CREATE INDEX without CONCURRENTLY
43
+ create_idx_matches = re.findall(r"create\s+(?:unique\s+)?index\s+(?!concurrently\b)([a-zA-Z0-9_\"\.]+)\s+on\s+([a-zA-Z0-9_\"\.]+)", sql_content, re.IGNORECASE)
44
+ for idx_name, table in create_idx_matches:
45
+ risks.append({
46
+ "severity": "HIGH",
47
+ "operation": "BLOCKING_INDEX_CREATION",
48
+ "table": table.strip(),
49
+ "target": idx_name.strip(),
50
+ "message": f"Index '{idx_name.strip()}' on '{table.strip()}' created without CONCURRENTLY. This takes an exclusive write lock on production tables."
51
+ })
52
+
53
+ # 4. Check for ADD COLUMN NOT NULL without DEFAULT
54
+ add_not_null = re.findall(r"alter\s+table\s+([a-zA-Z0-9_\"\.]+)\s+add\s+(?:column\s+)?([a-zA-Z0-9_\"\.]+)\s+[^;]+?not\s+null(?!\s+default\b)", sql_content, re.IGNORECASE)
55
+ for table, col in add_not_null:
56
+ risks.append({
57
+ "severity": "HIGH",
58
+ "operation": "ADD_NOT_NULL_NO_DEFAULT",
59
+ "table": table.strip(),
60
+ "target": col.strip(),
61
+ "message": f"Adding NOT NULL column '{col.strip()}' without a DEFAULT fails if existing rows exist in table '{table.strip()}'."
62
+ })
63
+
64
+ critical_count = len([r for r in risks if r["severity"] == "CRITICAL"])
65
+ high_count = len([r for r in risks if r["severity"] == "HIGH"])
66
+
67
+ return {
68
+ "isSafeForZeroDowntime": critical_count == 0 and high_count == 0,
69
+ "summary": {
70
+ "criticalRisks": critical_count,
71
+ "highRisks": high_count,
72
+ "totalFindings": len(risks)
73
+ },
74
+ "findings": risks
75
+ }
76
+
77
+ def main():
78
+ parser = argparse.ArgumentParser(description="Analyze DDL migration scripts for zero-downtime safety")
79
+ parser.add_argument("--migration", help="Path to SQL migration file", required=False)
80
+ args = parser.parse_args()
81
+
82
+ if args.migration and os.path.exists(args.migration):
83
+ with open(args.migration) as f:
84
+ content = f.read()
85
+ elif not sys.stdin.isatty():
86
+ content = sys.stdin.read()
87
+ else:
88
+ content = """
89
+ -- Safe expand migration
90
+ ALTER TABLE users ADD COLUMN full_name VARCHAR(255) NULL;
91
+ CREATE INDEX CONCURRENTLY idx_users_full_name ON users (full_name);
92
+ """
93
+
94
+ result = analyze_migration_sql(content)
95
+ print(json.dumps(result, indent=2))
96
+ sys.exit(0 if result["isSafeForZeroDowntime"] else 1)
97
+
98
+ if __name__ == "__main__":
99
+ main()
@@ -0,0 +1,177 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ auditDatabaseSchema.py
4
+ Static SQL DDL linter checking:
5
+ - Presence of PRIMARY KEY on every table
6
+ - Explicit referential actions on FOREIGN KEY constraints
7
+ - Presence of NOT NULL on non-nullable fields
8
+ - Detection of dangerous EAV or unstructured JSON anti-patterns without constraints
9
+ """
10
+
11
+ import sys
12
+ import os
13
+ import re
14
+ import json
15
+ import argparse
16
+
17
+ def audit_sql_schema(sql_content):
18
+ findings = []
19
+
20
+ # Extract CREATE TABLE blocks
21
+ table_pattern = re.compile(r"CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?([a-zA-Z0-9_\"\.]+)\s*\((.*?)\);", re.DOTALL | re.IGNORECASE)
22
+ tables = table_pattern.findall(sql_content)
23
+
24
+ if not tables:
25
+ findings.append({"level": "WARN", "message": "No CREATE TABLE statements found in input."})
26
+
27
+ PROHIBITED_TABLE_NAMES = {"data", "info", "items", "records", "logs", "temp", "test"}
28
+ PROHIBITED_COLUMN_NAMES = {"misc", "extra_data", "temp", "field1", "future_use", "data"}
29
+
30
+ for table_name, body in tables:
31
+ clean_name = table_name.replace('"', '').strip()
32
+ body_lower = body.lower()
33
+
34
+ # 1. Table Naming Checks
35
+ if clean_name.lower().startswith("tbl_") or clean_name.lower().startswith("tbl"):
36
+ findings.append({
37
+ "level": "WARN",
38
+ "table": clean_name,
39
+ "rule": "TABLE_NAMING_HUNGARIAN_PREFIX",
40
+ "message": f"Table '{clean_name}' uses Hungarian notation prefix 'tbl_'. Use clean plural snake_case instead."
41
+ })
42
+ if clean_name.lower() in PROHIBITED_TABLE_NAMES:
43
+ findings.append({
44
+ "level": "ERROR",
45
+ "table": clean_name,
46
+ "rule": "TABLE_NAMING_GENERIC_PROHIBITED",
47
+ "message": f"Table name '{clean_name}' is generic and prohibited. Specify the business domain entity name."
48
+ })
49
+ if any(c.isupper() for c in clean_name):
50
+ findings.append({
51
+ "level": "WARN",
52
+ "table": clean_name,
53
+ "rule": "TABLE_NAMING_SNAKE_CASE",
54
+ "message": f"Table '{clean_name}' uses uppercase or PascalCase letters. Use lowercase snake_case."
55
+ })
56
+
57
+ # 2. Check for Primary Key
58
+ has_pk = "primary key" in body_lower
59
+ if not has_pk:
60
+ findings.append({
61
+ "level": "ERROR",
62
+ "table": clean_name,
63
+ "rule": "PRIMARY_KEY_REQUIRED",
64
+ "message": f"Table '{clean_name}' does not define a PRIMARY KEY."
65
+ })
66
+
67
+ # 3. Check Foreign Keys for ON DELETE clause
68
+ fk_matches = re.findall(r"foreign\s+key\s*\([^\)]+\)\s*references\s+([a-zA-Z0-9_\"\.]+)(?:\s*\([^\)]+\))?([^,\n\)]*)", body, re.IGNORECASE)
69
+ for ref_table, clause in fk_matches:
70
+ if "on delete" not in clause.lower():
71
+ findings.append({
72
+ "level": "WARN",
73
+ "table": clean_name,
74
+ "rule": "EXPLICIT_REFERENTIAL_ACTION",
75
+ "message": f"Foreign key referencing '{ref_table.strip()}' missing explicit ON DELETE action (e.g. RESTRICT or CASCADE)."
76
+ })
77
+
78
+ # 4. Check for speculative/generic columns (YAGNI / Lean Schema)
79
+ col_lines = [line.strip().split()[0].replace('"', '') for line in body.splitlines() if line.strip() and not line.strip().upper().startswith(("PRIMARY", "FOREIGN", "CONSTRAINT", "UNIQUE", "CHECK", ")"))]
80
+ for col in col_lines:
81
+ if col.lower() in PROHIBITED_COLUMN_NAMES:
82
+ findings.append({
83
+ "level": "WARN",
84
+ "table": clean_name,
85
+ "column": col,
86
+ "rule": "SPECULATIVE_CATCHALL_COLUMN",
87
+ "message": f"Column '{col}' appears to be a generic catch-all or speculative field violating the Lean Schema Law (YAGNI)."
88
+ })
89
+
90
+ # 5. Check for multi-tenant tenant_id recommendation
91
+ if any(keyword in clean_name for keyword in ["order", "invoice", "account", "customer", "project"]):
92
+ if "tenant_id" not in body_lower:
93
+ findings.append({
94
+ "level": "INFO",
95
+ "table": clean_name,
96
+ "rule": "TENANT_ISOLATION_RECOMMENDATION",
97
+ "message": f"Tenant-scoped entity table '{clean_name}' does not include a 'tenant_id' column."
98
+ })
99
+
100
+ # 6. Check for Temporal Booking Exclusion Constraint
101
+ if any(w in clean_name for w in ["appointment", "booking", "reservation", "schedule", "stay"]):
102
+ if ("start" in body_lower and "end" in body_lower) or ("assigned_at" in body_lower and "vacated_at" in body_lower):
103
+ if "exclude" not in body_lower or "gist" not in body_lower:
104
+ findings.append({
105
+ "level": "WARN",
106
+ "table": clean_name,
107
+ "rule": "MISSING_EXCLUSION_CONSTRAINT",
108
+ "message": f"Temporal allocation table '{clean_name}' lacks a PostgreSQL Exclusion Constraint (EXCLUDE USING gist) to prevent overlapping double-bookings."
109
+ })
110
+
111
+ # 7. Check for Cross-Tenant Composite Foreign Key
112
+ if "tenant_id" in body_lower:
113
+ # Check foreign keys that reference other tables without tenant_id in the key
114
+ simple_fks = re.findall(r"foreign\s+key\s*\(\s*([a-zA-Z0-9_]+)\s*\)\s*references\s+([a-zA-Z0-9_]+)\s*\(\s*([a-zA-Z0-9_]+)\s*\)", body, re.IGNORECASE)
115
+ for col, ref_t, ref_c in simple_fks:
116
+ if col.lower() != "tenant_id" and ref_t.lower() not in ["hospitals", "tenants", "organizations", "accounts"]:
117
+ findings.append({
118
+ "level": "WARN",
119
+ "table": clean_name,
120
+ "column": col,
121
+ "rule": "CROSS_TENANT_FK_VULNERABILITY",
122
+ "message": f"Foreign key on '{clean_name}({col})' referencing '{ref_t}' is not tenant-aware. Enforce composite FK '(tenant_id, {col}) REFERENCES {ref_t}(tenant_id, id)'."
123
+ })
124
+
125
+ # 8. Check for RLS Policy Completeness across entire script
126
+ rls_tables = set(re.findall(r"alter\s+table\s+([a-zA-Z0-9_\"\.]+)\s+enable\s+row\s+level\s+security", sql_content, re.IGNORECASE))
127
+ policy_tables = set(re.findall(r"create\s+policy\s+[a-zA-Z0-9_\"\.]+\s+on\s+([a-zA-Z0-9_\"\.]+)", sql_content, re.IGNORECASE))
128
+
129
+ rls_clean = {t.replace('"', '').strip() for t in rls_tables}
130
+ policy_clean = {t.replace('"', '').strip() for t in policy_tables}
131
+
132
+ for t in rls_clean:
133
+ if t not in policy_clean:
134
+ findings.append({
135
+ "level": "ERROR",
136
+ "table": t,
137
+ "rule": "INCOMPLETE_RLS_POLICY",
138
+ "message": f"Table '{t}' has ROW LEVEL SECURITY enabled, but lacks any CREATE POLICY definition. Normal roles will be completely denied access."
139
+ })
140
+
141
+ error_count = len([f for f in findings if f["level"] == "ERROR"])
142
+ warn_count = len([f for f in findings if f["level"] == "WARN"])
143
+
144
+ return {
145
+ "isCompliant": error_count == 0,
146
+ "summary": {
147
+ "tablesAudited": len(tables),
148
+ "errors": error_count,
149
+ "warnings": warn_count
150
+ },
151
+ "findings": findings
152
+ }
153
+
154
+ def main():
155
+ parser = argparse.ArgumentParser(description="Audit SQL DDL schema for database architecture rules")
156
+ parser.add_argument("--schema", help="Path to SQL schema file", required=False)
157
+ args = parser.parse_args()
158
+
159
+ if args.schema and os.path.exists(args.schema):
160
+ with open(args.schema) as f:
161
+ content = f.read()
162
+ elif not sys.stdin.isatty():
163
+ content = sys.stdin.read()
164
+ else:
165
+ content = """
166
+ CREATE TABLE users (
167
+ id BIGINT PRIMARY KEY,
168
+ email VARCHAR(255) NOT NULL UNIQUE
169
+ );
170
+ """
171
+
172
+ result = audit_sql_schema(content)
173
+ print(json.dumps(result, indent=2))
174
+ sys.exit(0 if result["isCompliant"] else 1)
175
+
176
+ if __name__ == "__main__":
177
+ main()
@@ -0,0 +1,149 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ inspectDatabaseIndexes.py
4
+ Inspects SQL DDL schemas to identify:
5
+ - Foreign key columns lacking a supporting secondary index (causes Seq Scans & cascade locks)
6
+ - Index definitions on boolean or very low cardinality columns without a filter/partial clause
7
+ """
8
+
9
+ import sys
10
+ import os
11
+ import re
12
+ import json
13
+ import argparse
14
+
15
+ def inspect_indexes(sql_content):
16
+ findings = []
17
+
18
+ # 1. Find all foreign keys and their columns
19
+ # FOREIGN KEY (col) REFERENCES other_table
20
+ fk_pattern = re.compile(r"CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?([a-zA-Z0-9_\"\.]+)\s*\((.*?)\);", re.DOTALL | re.IGNORECASE)
21
+ tables = fk_pattern.findall(sql_content)
22
+
23
+ fks = []
24
+ for table_name, body in tables:
25
+ clean_tbl = table_name.replace('"', '').strip()
26
+ fk_matches = re.findall(r"foreign\s+key\s*\(([^\)]+)\)\s*references\s+([a-zA-Z0-9_\"\.]+)", body, re.IGNORECASE)
27
+ for fk_col, ref_tbl in fk_matches:
28
+ col_list = [c.replace('"', '').strip().lower() for c in fk_col.split(",")]
29
+ fks.append({
30
+ "table": clean_tbl,
31
+ "columns": col_list,
32
+ "column_str": fk_col.replace('"', '').strip(),
33
+ "referencedTable": ref_tbl.replace('"', '').strip()
34
+ })
35
+
36
+ # 2. Find all index definitions
37
+ idx_pattern = re.compile(r"CREATE\s+(?:UNIQUE\s+)?INDEX\s+(?:CONCURRENTLY\s+)?([a-zA-Z0-9_\"\.]+)\s+ON\s+([a-zA-Z0-9_\"\.]+)\s*(?:USING\s+\w+\s*)?\(([^\)]+)\)", re.IGNORECASE)
38
+ indexes = idx_pattern.findall(sql_content)
39
+
40
+ idx_map = {}
41
+ for idx_name, tbl, cols in indexes:
42
+ clean_tbl = tbl.replace('"', '').strip()
43
+ col_list = [c.replace('"', '').strip().lower() for c in cols.split(",")]
44
+ if clean_tbl not in idx_map:
45
+ idx_map[clean_tbl] = []
46
+ idx_map[clean_tbl].append({
47
+ "name": idx_name.replace('"', '').strip(),
48
+ "columns": col_list,
49
+ "leadingColumn": col_list[0]
50
+ })
51
+
52
+ # Also find PRIMARY KEY and UNIQUE constraints in tables that act as indexes
53
+ for table_name, body in tables:
54
+ clean_tbl = table_name.replace('"', '').strip()
55
+
56
+ pk_matches = re.findall(r"primary\s+key\s*\(([^\)]+)\)", body, re.IGNORECASE)
57
+ for pk_cols in pk_matches:
58
+ col_list = [c.replace('"', '').strip().lower() for c in pk_cols.split(",")]
59
+ if clean_tbl not in idx_map:
60
+ idx_map[clean_tbl] = []
61
+ idx_map[clean_tbl].append({
62
+ "name": f"pk_{clean_tbl}_{col_list[0]}",
63
+ "columns": col_list,
64
+ "leadingColumn": col_list[0]
65
+ })
66
+
67
+ uq_matches = re.findall(r"unique\s*\(([^\)]+)\)", body, re.IGNORECASE)
68
+ for uq_cols in uq_matches:
69
+ col_list = [c.replace('"', '').strip().lower() for c in uq_cols.split(",")]
70
+ if clean_tbl not in idx_map:
71
+ idx_map[clean_tbl] = []
72
+ idx_map[clean_tbl].append({
73
+ "name": f"uq_{clean_tbl}_{col_list[0]}",
74
+ "columns": col_list,
75
+ "leadingColumn": col_list[0]
76
+ })
77
+
78
+ # Check for unindexed foreign keys
79
+ # An index supports a foreign key if its leading columns match the foreign key column sequence
80
+ for fk in fks:
81
+ table_indexes = idx_map.get(fk["table"], [])
82
+ fk_cols = fk["columns"]
83
+ has_index = False
84
+ for idx in table_indexes:
85
+ idx_cols = idx["columns"]
86
+ if len(idx_cols) >= len(fk_cols) and idx_cols[:len(fk_cols)] == fk_cols:
87
+ has_index = True
88
+ break
89
+ if not has_index:
90
+ findings.append({
91
+ "level": "WARN",
92
+ "table": fk["table"],
93
+ "column": fk["column_str"],
94
+ "rule": "UNINDEXED_FOREIGN_KEY",
95
+ "message": f"Foreign key column(s) '({fk['column_str']})' in table '{fk['table']}' lack a supporting index at the leading edge. This risks table scans during joins and delete cascades."
96
+ })
97
+
98
+ # Check for redundant single-column prefix indexes
99
+ for tbl, idxs in idx_map.items():
100
+ single_col_idxs = [idx for idx in idxs if len(idx["columns"]) == 1 and not idx["name"].startswith("uq_") and not idx["name"].startswith("pk_")]
101
+ multi_col_idxs = [idx for idx in idxs if len(idx["columns"]) > 1]
102
+ for s_idx in single_col_idxs:
103
+ col = s_idx["columns"][0].lower()
104
+ matching_composite = next((m for m in multi_col_idxs if m["leadingColumn"].lower() == col), None)
105
+ if matching_composite:
106
+ findings.append({
107
+ "level": "WARN",
108
+ "table": tbl,
109
+ "index": s_idx["name"],
110
+ "rule": "REDUNDANT_PREFIX_INDEX",
111
+ "message": f"Index '{s_idx['name']}' on '{tbl}({col})' is redundant because '{matching_composite['name']}' already indexes '{col}' as its leading column."
112
+ })
113
+
114
+ unindexed_fks = [f for f in findings if f["rule"] == "UNINDEXED_FOREIGN_KEY"]
115
+ redundant_idxs = [f for f in findings if f["rule"] == "REDUNDANT_PREFIX_INDEX"]
116
+
117
+ return {
118
+ "foreignKeysAudited": len(fks),
119
+ "indexesAudited": len(indexes),
120
+ "unindexedFkCount": len(unindexed_fks),
121
+ "redundantIndexCount": len(redundant_idxs),
122
+ "findings": findings
123
+ }
124
+
125
+ def main():
126
+ parser = argparse.ArgumentParser(description="Inspect SQL indexes and foreign keys")
127
+ parser.add_argument("--schema", help="Path to SQL schema file", required=False)
128
+ args = parser.parse_args()
129
+
130
+ if args.schema and os.path.exists(args.schema):
131
+ with open(args.schema) as f:
132
+ content = f.read()
133
+ elif not sys.stdin.isatty():
134
+ content = sys.stdin.read()
135
+ else:
136
+ content = """
137
+ CREATE TABLE orders (
138
+ id BIGINT PRIMARY KEY,
139
+ customer_id BIGINT NOT NULL,
140
+ FOREIGN KEY (customer_id) REFERENCES customers(id)
141
+ );
142
+ CREATE INDEX idx_orders_customer_id ON orders (customer_id);
143
+ """
144
+
145
+ result = inspect_indexes(content)
146
+ print(json.dumps(result, indent=2))
147
+
148
+ if __name__ == "__main__":
149
+ main()