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.
- package/.skillsRegistry/catalog.json +231 -0
- package/AGENTS.md +89 -0
- package/README.md +210 -2
- package/bin/index.js +508 -0
- package/package.json +57 -4
- package/skills/backend/apiEngineering/SKILL.md +102 -0
- package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
- package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
- package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
- package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
- package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
- package/skills/backend/apiEngineering/policies/performance.md +39 -0
- package/skills/backend/apiEngineering/policies/security.md +36 -0
- package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
- package/skills/backend/apiEngineering/references/apiReference.md +3 -0
- package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
- package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
- package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
- package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
- package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
- package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
- package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
- package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
- package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
- package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
- package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
- package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
- package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
- package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
- package/skills/backend/databaseArchitecture/SKILL.md +118 -0
- package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
- package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
- package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
- package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
- package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
- package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
- package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
- package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
- package/skills/backend/databaseArchitecture/policies/security.md +26 -0
- package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
- package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
- package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
- package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
- package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
- package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
- package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
- package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
- package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
- package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
- package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
- package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
- package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
- package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
- package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
- package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
- package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
- package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
- package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
- package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
- package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
- package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
- package/skills/backend/golangStandard/SKILL.md +155 -0
- package/skills/backend/golangStandard/evals/goVerification.json +14 -0
- package/skills/backend/golangStandard/references/apiReference.md +3 -0
- package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
- package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
- package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
- package/skills/backend/pythonStandard/SKILL.md +138 -0
- package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
- package/skills/backend/pythonStandard/references/apiReference.md +3 -0
- package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
- package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
- package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
- package/skills/backend/upstash/SKILL.md +98 -0
- package/skills/backend/upstash/evals/upstashVerification.json +14 -0
- package/skills/backend/upstash/references/apiReference.md +3 -0
- package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
- package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
- package/skills/backend/upstash/references/workflowPatterns.md +35 -0
- package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
- package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
- package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
- package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
- package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
- package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
- package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
- package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
- package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
- package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
- package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
- package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
- package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
- package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
- package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
- package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
- package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
- package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
- package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
- package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
- package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
- package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
- package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
- package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
- package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
- package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
- package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
- package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
- package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
- package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
- package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
- package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
- package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
- package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
- package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
- package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
- package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
- package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
- package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
- package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
- package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
- package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
- package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
- package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
- package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
- package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
- package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
- package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
- package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
- package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
- package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
- package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
- package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
- package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
- package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
- package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
- package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
- package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
- package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
- package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
- package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
- package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
- package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
- package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
- package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
- package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
- package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
- package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
- package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
- package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
- package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
- package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
- package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
- package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
- package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
- package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
- package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
- package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
- package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
- package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
- package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
- package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
- package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
- package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
- package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
- package/skills/frontend/astro/SKILL.md +327 -0
- package/skills/frontend/astro/assets/README.md +71 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
- package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
- package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
- package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
- package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
- package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
- package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
- package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
- package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
- package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
- package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
- package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
- package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
- package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
- package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
- package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
- package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
- package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
- package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
- package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
- package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
- package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
- package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
- package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
- package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
- package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
- package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
- package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
- package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
- package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
- package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
- package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
- package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
- package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
- package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
- package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
- package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
- package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
- package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
- package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
- package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
- package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
- package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
- package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
- package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
- package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
- package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
- package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
- package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
- package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
- package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
- package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
- package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
- package/skills/frontend/astro/assets/welcome/courses.md +46 -0
- package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
- package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
- package/skills/frontend/astro/evals/evals.json +66 -0
- package/skills/frontend/astro/references/contentCollections.md +164 -0
- package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
- package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
- package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
- package/skills/frontend/generativeUi/SKILL.md +128 -0
- package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
- package/skills/frontend/generativeUi/references/apiReference.md +3 -0
- package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
- package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
- package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
- package/skills/frontend/nextjs/SKILL.md +138 -0
- package/skills/frontend/nextjs/assets/README.md +67 -0
- package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
- package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
- package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
- package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
- package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
- package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
- package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
- package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
- package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
- package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
- package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
- package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
- package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
- package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
- package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
- package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
- package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
- package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
- package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
- package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
- package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
- package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
- package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
- package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
- package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
- package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
- package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
- package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
- package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
- package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
- package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
- package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
- package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
- package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
- package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
- package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
- package/skills/frontend/nextjs/assets/glossary.md +315 -0
- package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
- package/skills/frontend/nextjs/references/apiReference.md +3 -0
- package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
- package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
- package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
- package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
- package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
- package/skills/frontend/shadcn-ui/SKILL.md +102 -0
- package/skills/frontend/shadcn-ui/assets/README.md +82 -0
- package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
- package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
- package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
- package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
- package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
- package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
- package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
- package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
- package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
- package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
- package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
- package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
- package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
- package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
- package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
- package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
- package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
- package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
- package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
- package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
- package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
- package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
- package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
- package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
- package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
- package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
- package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
- package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
- package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
- package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
- package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
- package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
- package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
- package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
- package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
- package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
- package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
- package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
- package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
- package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
- package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
- package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
- package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
- package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
- package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
- package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
- package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
- package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
- package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
- package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
- package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
- package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
- package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
- package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
- package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
- package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
- package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
- package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
- package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
- package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
- package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
- package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
- package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
- package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
- package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
- package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
- package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
- package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
- package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
- package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
- package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
- package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
- package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
- package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
- package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
- package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
- package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
- package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
- package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
- package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
- package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
- package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
- package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
- package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
- package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
- package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
- package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
- package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
- package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
- package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
- package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
- package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
- package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
- package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
- package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
- package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
- package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
- package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
- package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
- package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
- package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
- package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
- package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
- package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
- package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
- package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
- package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
- package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
- package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
- package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
- package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
- package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
- package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
- package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
- package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
- package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
- package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
- package/skills/github/assets/README.md +39 -0
- package/skills/github/assets/cli/gh-environment.md +87 -0
- package/skills/github/assets/cli/gh-formatting.md +156 -0
- package/skills/github/assets/cli/gh-reference.md +2363 -0
- package/skills/github/assets/docs-api/github-docs-api.md +60 -0
- package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
- package/skills/github/assets/rest-api/actions-variables.md +1247 -0
- package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
- package/skills/github/assets/rest-api/actions-workflows.md +348 -0
- package/skills/github/assets/rest-api/authenticating.md +174 -0
- package/skills/github/assets/rest-api/branches.md +727 -0
- package/skills/github/assets/rest-api/checks-runs.md +1013 -0
- package/skills/github/assets/rest-api/checks-suites.md +1142 -0
- package/skills/github/assets/rest-api/code-scanning.md +2957 -0
- package/skills/github/assets/rest-api/collaborators.md +547 -0
- package/skills/github/assets/rest-api/commits.md +957 -0
- package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
- package/skills/github/assets/rest-api/orgs.md +1172 -0
- package/skills/github/assets/rest-api/overview.md +875 -0
- package/skills/github/assets/rest-api/pull-reviews.md +722 -0
- package/skills/github/assets/rest-api/pulls.md +1605 -0
- package/skills/github/assets/rest-api/quickstart.md +344 -0
- package/skills/github/assets/rest-api/releases.md +650 -0
- package/skills/github/assets/rest-api/repos.md +2957 -0
- package/skills/github/assets/rest-api/rules.md +1507 -0
- package/skills/github/assets/rest-api/secret-scanning.md +947 -0
- package/skills/github/assets/rest-api/teams.md +1690 -0
- package/skills/github/githubAction/SKILL.md +159 -0
- package/skills/github/githubAction/assets/README.md +38 -0
- package/skills/github/githubAction/assets/reference/contexts.md +918 -0
- package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
- package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
- package/skills/github/githubAction/assets/reference/expressions.md +441 -0
- package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
- package/skills/github/githubAction/assets/reference/variables.md +149 -0
- package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
- package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
- package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
- package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
- package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
- package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
- package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
- package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
- package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
- package/skills/github/githubAction/evals/actionVerification.json +14 -0
- package/skills/github/githubAction/references/apiReference.md +3 -0
- package/skills/github/githubAction/references/workflowPatterns.md +81 -0
- package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
- package/skills/github/githubQuality/SKILL.md +136 -0
- package/skills/github/githubQuality/assets/README.md +24 -0
- package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
- package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
- package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
- package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
- package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
- package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
- package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
- package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
- package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
- package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
- package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
- package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
- package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
- package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
- package/skills/github/githubQuality/references/apiReference.md +3 -0
- package/skills/github/githubQuality/references/codeownersExample.md +26 -0
- package/skills/github/githubQuality/references/prTemplate.md +20 -0
- package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
- package/skills/github/githubSecurity/SKILL.md +170 -0
- package/skills/github/githubSecurity/assets/README.md +32 -0
- package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
- package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
- package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
- package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
- package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
- package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
- package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
- package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
- package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
- package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
- package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
- package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
- package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
- package/skills/github/githubSecurity/references/apiReference.md +3 -0
- package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
- package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
- package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
- package/skills/github/githubSetup/SKILL.md +137 -0
- package/skills/github/githubSetup/assets/README.md +40 -0
- package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
- package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
- package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
- package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
- package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
- package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
- package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
- package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
- package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
- package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
- package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
- package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
- package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
- package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
- package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
- package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
- package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
- package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
- package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
- package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
- package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
- package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
- package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
- package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
- package/skills/github/githubSetup/evals/setupVerification.json +14 -0
- package/skills/github/githubSetup/references/apiReference.md +3 -0
- package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
- package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
- package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
- package/skills/github/githubTeam/SKILL.md +115 -0
- package/skills/github/githubTeam/assets/README.md +21 -0
- package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
- package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
- package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
- package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
- package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
- package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
- package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
- package/skills/github/githubTeam/evals/teamVerification.json +14 -0
- package/skills/github/githubTeam/references/apiReference.md +3 -0
- package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
- package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
- package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
- package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
- package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
- package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
- package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
- package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
- package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
- package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
- package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
- package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
- package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
- package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
- package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
- package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
- package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
- package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
- 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()
|