skillfullstack 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,32 @@
|
|
|
1
|
+
# ADR-001: Primary Database Architecture Decision Record
|
|
2
|
+
|
|
3
|
+
## Status
|
|
4
|
+
[ Proposed | Accepted | Deprecated | Superseded ]
|
|
5
|
+
|
|
6
|
+
## Context & Workload Requirements
|
|
7
|
+
Describe the business problem, entities, and anticipated operational scale:
|
|
8
|
+
- **Workload Type**: [ OLTP | OLAP | Time-Series | Graph | Vector | Key-Value ]
|
|
9
|
+
- **Data Scale**: Expected rows at launch, rows at 12 months, daily row ingestion rate.
|
|
10
|
+
- **Access Profile**: Read/Write ratio (e.g., 90/10 vs 30/70), peak queries per second (QPS).
|
|
11
|
+
- **Latency SLO**: P95 target (e.g. $< 15$ms for reads, $< 50$ms for writes).
|
|
12
|
+
- **Consistency Needs**: [ Strict Serializability | Read-Your-Writes | Eventual Consistency ].
|
|
13
|
+
|
|
14
|
+
## Candidate Architectures Evaluated
|
|
15
|
+
1. **Candidate A (e.g. PostgreSQL)**: Pros, cons, operational fit.
|
|
16
|
+
2. **Candidate B (e.g. MongoDB)**: Pros, cons, operational fit.
|
|
17
|
+
3. **Candidate C (e.g. ClickHouse)**: Pros, cons, operational fit.
|
|
18
|
+
|
|
19
|
+
## Decision
|
|
20
|
+
We select **[Selected Database Architecture]** because:
|
|
21
|
+
1. Primary architectural rationale.
|
|
22
|
+
2. Fit with team operational capabilities and infrastructure.
|
|
23
|
+
|
|
24
|
+
## Consequences & Trade-offs
|
|
25
|
+
- **Positive**: What becomes easier or faster.
|
|
26
|
+
- **Negative / Operational Complexity**: What requires additional monitoring, indexing, or backup discipline.
|
|
27
|
+
- **Mitigations**: How identified risks will be controlled.
|
|
28
|
+
|
|
29
|
+
## Verification & Acceptance Criteria
|
|
30
|
+
- [ ] Schema validates under automated integrity checks.
|
|
31
|
+
- [ ] P95 latency confirmed under load test with expected data volume.
|
|
32
|
+
- [ ] PITR restore drill verified.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Pre-Flight Production Database Readiness Checklist
|
|
2
|
+
|
|
3
|
+
Verify all items prior to launching any database service into staging or production:
|
|
4
|
+
|
|
5
|
+
## 1. Schema & Data Integrity
|
|
6
|
+
- [ ] Every table has a designated, immutable primary key.
|
|
7
|
+
- [ ] Multi-tenant tables include `tenant_id` and enforce database RLS.
|
|
8
|
+
- [ ] Foreign keys define explicit referential actions (`ON DELETE RESTRICT/CASCADE`).
|
|
9
|
+
- [ ] Essential numeric boundaries and state machines are enforced via `CHECK` constraints.
|
|
10
|
+
- [ ] Columns default to `NOT NULL` unless nullability is explicitly justified.
|
|
11
|
+
|
|
12
|
+
## 2. Performance & Indexing
|
|
13
|
+
- [ ] All foreign key columns have supporting secondary indexes.
|
|
14
|
+
- [ ] Composite indexes order equality columns first, followed by range columns.
|
|
15
|
+
- [ ] No redundant or duplicate indexes exist.
|
|
16
|
+
- [ ] Query plans for high-frequency queries confirm Index Scans, avoiding full table scans.
|
|
17
|
+
- [ ] Connection pool limits are sized to CPU cores with max acquisition timeout $\le 3$s.
|
|
18
|
+
|
|
19
|
+
## 3. Scalability & Maintenance
|
|
20
|
+
- [ ] High-volume historical tables have an explicit partitioning or archival strategy.
|
|
21
|
+
- [ ] Sharding is only used if vertical scaling and read replicas have been empirically exhausted.
|
|
22
|
+
- [ ] All production indexes are created with `CREATE INDEX CONCURRENTLY`.
|
|
23
|
+
|
|
24
|
+
## 4. Disaster Recovery & Security
|
|
25
|
+
- [ ] Automated daily physical snapshots configured with retention policy.
|
|
26
|
+
- [ ] Continuous Write-Ahead Log (WAL) archiving active to off-region object storage.
|
|
27
|
+
- [ ] Scheduled restore drill tested and validated against RTO and RPO targets.
|
|
28
|
+
- [ ] Database credentials isolated in secure vault; application connects as unprivileged user.
|
|
29
|
+
- [ ] TLS 1.3 enforced on all client connections.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Zero-Downtime Database Migration Plan: [Feature/Table Name]
|
|
2
|
+
|
|
3
|
+
## 1. Migration Overview
|
|
4
|
+
- **Target Table**: `table_name`
|
|
5
|
+
- **Objective**: [ Add column | Split table | Introduce index | Migrate data type ]
|
|
6
|
+
- **Downtime Appetite**: 0 seconds (Zero downtime deployment required)
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## 2. Phased Execution Plan (Expand-and-Contract)
|
|
11
|
+
|
|
12
|
+
### Phase 1: Expand (Non-Breaking DDL)
|
|
13
|
+
- Add new nullable column or table:
|
|
14
|
+
```sql
|
|
15
|
+
ALTER TABLE orders ADD COLUMN fulfillment_status VARCHAR(50) NULL;
|
|
16
|
+
```
|
|
17
|
+
- Deploy application release $v1.1$: Writes to both old and new columns. Reads from old column.
|
|
18
|
+
|
|
19
|
+
### Phase 2: Backfill (Async Batch Data Migration)
|
|
20
|
+
- Script migrating historical records in controlled batches:
|
|
21
|
+
```sql
|
|
22
|
+
UPDATE orders
|
|
23
|
+
SET fulfillment_status = CASE WHEN status = 'done' THEN 'delivered' ELSE 'pending' END
|
|
24
|
+
WHERE fulfillment_status IS NULL AND id BETWEEN :start AND :end;
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
### Phase 3: Contract (Switch Reads & Clean Up)
|
|
28
|
+
- Deploy application release $v1.2$: Reads and writes exclusively from new column.
|
|
29
|
+
- Verify zero active queries read the old column.
|
|
30
|
+
- Drop old column in non-blocking off-peak migration:
|
|
31
|
+
```sql
|
|
32
|
+
ALTER TABLE orders DROP COLUMN status;
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 3. Rollback Protocol
|
|
38
|
+
- **Phase 1 Rollback**: Drop new column if application release fails. Old column was never modified.
|
|
39
|
+
- **Phase 2 Rollback**: Stop backfill background worker.
|
|
40
|
+
- **Phase 3 Rollback**: Revert application release back to $v1.1$ reading from old column before dropping it.
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: durableBackgroundJobs
|
|
3
|
+
description: Durable background execution, long-running agent workflows, and zero-timeout event orchestration with Inngest, Trigger.dev v3, and Upstash Workflow. Use when running multi-step AI tasks, retries, and sleep delays in serverless environments.
|
|
4
|
+
version: 3.x
|
|
5
|
+
last-verified: 2026-11-15
|
|
6
|
+
compatibility: Next.js, Node.js 18+, Python 3.10+, Inngest SDK, Trigger.dev v3
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Durable Background Jobs & Workflows Engineering Guide
|
|
10
|
+
|
|
11
|
+
## 1. Core Architecture (Overcoming Serverless Timeouts)
|
|
12
|
+
Serverless functions enforce hard 10–60s timeouts. Durable execution breaks code into **memoized steps**:
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
┌────────────────────────────────┐
|
|
16
|
+
│ Trigger: event received │
|
|
17
|
+
└──────────────┬─────────────────┘
|
|
18
|
+
▼
|
|
19
|
+
┌────────────────────────────────┐
|
|
20
|
+
│ step.run("fetch-source-data") │──► Succeeded & Memoized
|
|
21
|
+
└──────────────┬─────────────────┘
|
|
22
|
+
▼
|
|
23
|
+
┌────────────────────────────────┐
|
|
24
|
+
│ step.run("call-llm-analysis") │──► Fails? Retried in isolation without
|
|
25
|
+
└──────────────┬─────────────────┘ re-executing Step 1!
|
|
26
|
+
▼
|
|
27
|
+
┌────────────────────────────────┐
|
|
28
|
+
│ step.sleep("wait-for-human") │──► Zero compute cost while paused
|
|
29
|
+
└──────────────┬─────────────────┘
|
|
30
|
+
▼
|
|
31
|
+
┌────────────────────────────────┐
|
|
32
|
+
│ step.run("send-final-payload") │
|
|
33
|
+
└────────────────────────────────┘
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 2. Inngest Step Orchestration Pattern
|
|
39
|
+
|
|
40
|
+
```typescript
|
|
41
|
+
import { Inngest } from "inngest";
|
|
42
|
+
|
|
43
|
+
export const inngest = new Inngest({ id: "fullstack-ai-app" });
|
|
44
|
+
|
|
45
|
+
export const autonomousResearchAgent = inngest.createFunction(
|
|
46
|
+
{
|
|
47
|
+
id: "autonomous-research-agent",
|
|
48
|
+
retries: 3,
|
|
49
|
+
concurrency: { limit: 5, key: "event.data.userId" },
|
|
50
|
+
},
|
|
51
|
+
{ event: "agent/research.requested" },
|
|
52
|
+
async ({ event, step }) => {
|
|
53
|
+
// Step 1: Scrape & decompose queries
|
|
54
|
+
const searchResults = await step.run("search-web-sources", async () => {
|
|
55
|
+
return executeWebSearch(event.data.query);
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
// Step 2: Multi-step LLM synthesis
|
|
59
|
+
const synthesizedReport = await step.run("synthesize-findings", async () => {
|
|
60
|
+
return callLlmSynthesis(searchResults);
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
// Step 3: Sleep or wait for user webhook approval
|
|
64
|
+
await step.sleep("wait-for-cooldown", "30m");
|
|
65
|
+
|
|
66
|
+
// Step 4: Dispatch notifications
|
|
67
|
+
await step.run("publish-report", async () => {
|
|
68
|
+
return emailReportToUser(event.data.userId, synthesizedReport);
|
|
69
|
+
});
|
|
70
|
+
|
|
71
|
+
return { status: "completed", reportId: synthesizedReport.id };
|
|
72
|
+
}
|
|
73
|
+
);
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 3. Trigger.dev v3 Managed Container Task Pattern
|
|
79
|
+
|
|
80
|
+
```typescript
|
|
81
|
+
import { task, wait } from "@trigger.dev/sdk/v3";
|
|
82
|
+
|
|
83
|
+
export const heavyAiBatchTask = task({
|
|
84
|
+
id: "heavy-ai-batch-pipeline",
|
|
85
|
+
retry: { maxAttempts: 4 },
|
|
86
|
+
run: async (payload: { items: string[] }) => {
|
|
87
|
+
const results = [];
|
|
88
|
+
for (const item of payload.items) {
|
|
89
|
+
// Automatic container checkpointing across long loops
|
|
90
|
+
const processed = await processItemWithLlm(item);
|
|
91
|
+
results.push(processed);
|
|
92
|
+
await wait.for({ seconds: 2 });
|
|
93
|
+
}
|
|
94
|
+
return { count: results.length, data: results };
|
|
95
|
+
},
|
|
96
|
+
});
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## 4. Anti-Patterns & Critical Pitfalls
|
|
102
|
+
- ❌ **Monolithic Step Traps**: Putting your entire multi-minute script inside a single `step.run()` block defeats durable execution. Break distinct network boundaries into separate steps.
|
|
103
|
+
- ❌ **Non-Serializable Return Values**: Every value returned by `step.run()` is serialized to JSON. Never return Class instances, database sockets, or non-serializable objects.
|
|
104
|
+
- ❌ **Ephemeral Local Disk Reliance**: Steps can run across different container invocations or machines. Never store intermediate data in `/tmp` expecting it to survive between steps; pass data via step return values or S3/Blob storage.
|
|
105
|
+
- ❌ **Unconstrained Parallel Fan-out**: Spawning 10,000 sub-steps simultaneously crashes downstream third-party APIs. Always set concurrency throttle limits.
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## 5. References & Bundled Utilities
|
|
110
|
+
- Step patterns & retry policies: [references/durableStepPatterns.md](references/durableStepPatterns.md)
|
|
111
|
+
- Idempotency key strategies: [references/idempotencyKeys.md](references/idempotencyKeys.md)
|
|
112
|
+
- Event dispatch tester: [scripts/testWorkflowDispatch.py](scripts/testWorkflowDispatch.py)
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"evals": [
|
|
3
|
+
{
|
|
4
|
+
"name": "inngest-step-pattern",
|
|
5
|
+
"prompt": "Write an Inngest function that fetches data in step 1, sleeps 15 minutes, and saves in step 2.",
|
|
6
|
+
"expectedPattern": "step\\.run\\([\"']fetch.*step\\.sleep\\([\"']15m[\"'].*step\\.run\\([\"']save"
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"name": "trigger-dev-task",
|
|
10
|
+
"prompt": "Define a Trigger.dev v3 background task with retry configuration.",
|
|
11
|
+
"expectedPattern": "task\\(\\{[\\s\\S]*retry:\\s*\\{\\s*maxAttempts:"
|
|
12
|
+
}
|
|
13
|
+
]
|
|
14
|
+
}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Durable Step Function Execution Patterns
|
|
2
|
+
|
|
3
|
+
1. **`step.run(name, handler)`**: The atomic unit of durable execution. Caches return value. Retries on exception without re-running prior steps.
|
|
4
|
+
2. **`step.sleep(name, duration)`**: Halts execution for seconds, hours, or days. Costs zero compute resources while sleeping.
|
|
5
|
+
3. **`step.sleepUntil(name, timestamp)`**: Schedules resumption for a specific future ISO date or UNIX epoch.
|
|
6
|
+
4. **`step.waitForEvent(name, { event, timeout, match })`**: Suspends workflow execution until a specific external webhook arrives (e.g. `order.payment_verified` with matching `orderId`).
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
# Idempotency Key Strategies
|
|
2
|
+
|
|
3
|
+
When dispatching background events:
|
|
4
|
+
- Always supply an `idempotencyKey` when publishing events from webhooks (e.g., Stripe charge ID, GitHub commit SHA).
|
|
5
|
+
- Inngest and QStash deduplicate identical keys within their configured window (typically 24 hours), preventing double-charges, duplicate emails, and repeated LLM token spend.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
testWorkflowDispatch.py
|
|
4
|
+
Dispatches a test event to an Inngest or QStash durable workflow endpoint.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import sys
|
|
8
|
+
import json
|
|
9
|
+
import urllib.request
|
|
10
|
+
|
|
11
|
+
def dispatch_event(url: str, event_name: str, payload: dict):
|
|
12
|
+
body = json.dumps({"name": event_name, "data": payload}).encode("utf-8")
|
|
13
|
+
req = urllib.request.Request(url, data=body, headers={"Content-Type": "application/json"})
|
|
14
|
+
try:
|
|
15
|
+
with urllib.request.urlopen(req) as resp:
|
|
16
|
+
print(f" Event '{event_name}' dispatched successfully to {url}! Status: {resp.status}")
|
|
17
|
+
except Exception as e:
|
|
18
|
+
print(f" Dispatch failed: {e}")
|
|
19
|
+
|
|
20
|
+
if __name__ == "__main__":
|
|
21
|
+
if len(sys.argv) < 3:
|
|
22
|
+
print("Usage: python3 testWorkflowDispatch.py <endpoint_url> <event_name>")
|
|
23
|
+
sys.exit(0)
|
|
24
|
+
dispatch_event(sys.argv[1], sys.argv[2], {"test": True, "source": "cli"})
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: golangStandard
|
|
3
|
+
description: Production-grade Go engineering standards. Implements log/slog structured logging, context propagation, explicit error wrapping with %w, errgroup structured concurrency, and clean internal domain layouts.
|
|
4
|
+
version: 1.23+
|
|
5
|
+
last-verified: 2026-11-16
|
|
6
|
+
compatibility: Go 1.22+, Go 1.23+, Go 1.24+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Production Go Engineering Guide
|
|
10
|
+
|
|
11
|
+
## 1. Core Architecture & Project Layout
|
|
12
|
+
Avoid sprawling, deeply nested `/pkg` directory trees. Modern Go services adhere to clean domain separation or flat packages:
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
my-service/
|
|
16
|
+
├── cmd/
|
|
17
|
+
│ └── server/
|
|
18
|
+
│ └── main.go # Dependency wiring, config load, graceful OS shutdown
|
|
19
|
+
├── internal/
|
|
20
|
+
│ ├── platform/ # Cross-cutting concerns (db pool, telemetry, slog setup)
|
|
21
|
+
│ └── order/ # Domain package (handler, domain model, repository)
|
|
22
|
+
│ ├── handler.go # HTTP/gRPC transport adapters
|
|
23
|
+
│ ├── service.go # Pure business logic
|
|
24
|
+
│ └── repo.go # Database queries / SQL persistence
|
|
25
|
+
├── go.mod
|
|
26
|
+
└── go.sum
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
- Code inside `internal/` cannot be imported by external modules, enforcing privacy.
|
|
30
|
+
- Group by business domain (`internal/order`, `internal/user`) rather than technical layers (`internal/controllers`, `internal/models`).
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 2. Structured Logging with `log/slog`
|
|
35
|
+
Never use `log.Println` or `fmt.Println` in production code. Use the standard library `log/slog`:
|
|
36
|
+
|
|
37
|
+
### Initialization & Context Extraction
|
|
38
|
+
```go
|
|
39
|
+
package platform
|
|
40
|
+
|
|
41
|
+
import (
|
|
42
|
+
"context"
|
|
43
|
+
"log/slog"
|
|
44
|
+
"os"
|
|
45
|
+
)
|
|
46
|
+
|
|
47
|
+
type contextKey string
|
|
48
|
+
const loggerKey contextKey = "slog_logger"
|
|
49
|
+
|
|
50
|
+
func InitLogger(isProduction bool) *slog.Logger {
|
|
51
|
+
var handler slog.Handler
|
|
52
|
+
opts := &slog.HandlerOptions{Level: slog.LevelInfo}
|
|
53
|
+
|
|
54
|
+
if isProduction {
|
|
55
|
+
handler = slog.NewJSONHandler(os.Stdout, opts) // CloudWatch / Datadog JSON
|
|
56
|
+
} else {
|
|
57
|
+
handler = slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelDebug})
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
logger := slog.New(handler)
|
|
61
|
+
slog.SetDefault(logger)
|
|
62
|
+
return logger
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// Inject request-scoped trace fields
|
|
66
|
+
func ContextWithLogger(ctx context.Context, logger *slog.Logger) context.Context {
|
|
67
|
+
return context.WithValue(ctx, loggerKey, logger)
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
func LoggerFromContext(ctx context.Context) *slog.Logger {
|
|
71
|
+
if l, ok := ctx.Value(loggerKey).(*slog.Logger); ok {
|
|
72
|
+
return l
|
|
73
|
+
}
|
|
74
|
+
return slog.Default()
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 3. Idiomatic Error Handling
|
|
81
|
+
Wrap errors contextually with `%w` so callers can inspect sentinel errors with `errors.Is` and custom error types with `errors.As`:
|
|
82
|
+
|
|
83
|
+
```go
|
|
84
|
+
package order
|
|
85
|
+
|
|
86
|
+
import (
|
|
87
|
+
"context"
|
|
88
|
+
"errors"
|
|
89
|
+
"fmt"
|
|
90
|
+
)
|
|
91
|
+
|
|
92
|
+
var ErrOrderNotFound = errors.New("order not found")
|
|
93
|
+
|
|
94
|
+
func (s *Service) GetOrder(ctx context.Context, orderID string) (*Order, error) {
|
|
95
|
+
logger := platform.LoggerFromContext(ctx)
|
|
96
|
+
|
|
97
|
+
order, err := s.repo.FindByID(ctx, orderID)
|
|
98
|
+
if err != nil {
|
|
99
|
+
if errors.Is(err, ErrOrderNotFound) {
|
|
100
|
+
logger.WarnContext(ctx, "order lookup missed", "order_id", orderID)
|
|
101
|
+
return nil, fmt.Errorf("get order [%s]: %w", orderID, ErrOrderNotFound)
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// Log structured error attribute "err", err (never fmt.Sprintf)
|
|
105
|
+
logger.ErrorContext(ctx, "database query failed", "order_id", orderID, "err", err)
|
|
106
|
+
return nil, fmt.Errorf("get order [%s]: %w", orderID, err)
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
return order, nil
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 4. Structured Concurrency with `errgroup`
|
|
116
|
+
Avoid raw `go func()` without lifecycle management. Use `golang.org/x/sync/errgroup` with a cancellable context:
|
|
117
|
+
|
|
118
|
+
```go
|
|
119
|
+
import (
|
|
120
|
+
"context"
|
|
121
|
+
"golang.org/x/sync/errgroup"
|
|
122
|
+
)
|
|
123
|
+
|
|
124
|
+
func ProcessBatch(ctx context.Context, items []string) error {
|
|
125
|
+
g, ctx := errgroup.WithContext(ctx)
|
|
126
|
+
g.SetLimit(10) // Bound concurrency to avoid resource exhaustion
|
|
127
|
+
|
|
128
|
+
for _, item := range items {
|
|
129
|
+
item := item // Capture variable
|
|
130
|
+
g.Go(func() error {
|
|
131
|
+
if err := ctx.Err(); err != nil {
|
|
132
|
+
return err // Context cancelled early by another failure
|
|
133
|
+
}
|
|
134
|
+
return processItem(ctx, item)
|
|
135
|
+
})
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
return g.Wait() // Returns first encountered error and cancels sibling tasks
|
|
139
|
+
}
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 5. Anti-Patterns & Critical Pitfalls
|
|
145
|
+
- ❌ **Ignoring Context**: Never execute SQL queries or HTTP calls using `context.Background()` inside handlers; always pass down the request's `r.Context()`.
|
|
146
|
+
- ❌ **Unstructured Log Formatting**: Never format errors into log strings like `logger.Error(fmt.Sprintf("failed: %v", err))`. Always use key-value structured pairs: `"err", err`.
|
|
147
|
+
- ❌ **Panic for Flow Control**: Do not use `panic()` for operational errors; return explicit error values. Reserve panic only for unrecoverable startup assertions.
|
|
148
|
+
- ❌ **Goroutine Leaks**: Never start goroutines that listen to unbuffered channels without a `select` block listening to `ctx.Done()`.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 6. References & Bundled Utilities
|
|
153
|
+
- Structured logging patterns: [references/slogPatterns.md](references/slogPatterns.md)
|
|
154
|
+
- Domain project layout guidelines: [references/layoutGuide.md](references/layoutGuide.md)
|
|
155
|
+
- Go module scaffolding tool: [scripts/scaffoldGoModule.py](scripts/scaffoldGoModule.py)
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"evals": [
|
|
3
|
+
{
|
|
4
|
+
"name": "slog-json-handler",
|
|
5
|
+
"prompt": "Initialize an slog logger in Go with JSONHandler for production environments.",
|
|
6
|
+
"expectedPattern": "slog\\.NewJSONHandler\\(os\\.Stdout"
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"name": "errgroup-bounded-concurrency",
|
|
10
|
+
"prompt": "Show how to use golang.org/x/sync/errgroup with a concurrency limit and context cancellation.",
|
|
11
|
+
"expectedPattern": "errgroup\\.WithContext\\([\\s\\S]*g\\.SetLimit\\([0-9]+\\)"
|
|
12
|
+
}
|
|
13
|
+
]
|
|
14
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Go Production Layout Guide
|
|
2
|
+
|
|
3
|
+
## Domain-Driven vs Layered Architecture
|
|
4
|
+
In Go, code should be packaged by cohesive business domain rather than technical function:
|
|
5
|
+
|
|
6
|
+
### Preferred (Domain Packaging)
|
|
7
|
+
```
|
|
8
|
+
internal/
|
|
9
|
+
billing/
|
|
10
|
+
handler.go
|
|
11
|
+
service.go
|
|
12
|
+
postgres.go
|
|
13
|
+
user/
|
|
14
|
+
handler.go
|
|
15
|
+
service.go
|
|
16
|
+
postgres.go
|
|
17
|
+
```
|
|
18
|
+
*Benefits*: High cohesion, easy to extract into standalone microservices, prevents circular dependencies.
|
|
19
|
+
|
|
20
|
+
### Anti-Pattern (Technical Layering)
|
|
21
|
+
```
|
|
22
|
+
internal/
|
|
23
|
+
controllers/ # Every controller in one huge bucket
|
|
24
|
+
models/ # Every struct in one bucket
|
|
25
|
+
repositories/ # Circular dependency nightmare
|
|
26
|
+
```
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Go `log/slog` Production Patterns
|
|
2
|
+
|
|
3
|
+
## 1. Handlers & Performance
|
|
4
|
+
- **`slog.NewJSONHandler`**: Emits newline-delimited JSON objects. Standard for production containers, Kubernetes, Datadog, AWS CloudWatch.
|
|
5
|
+
- **`slog.NewTextHandler`**: Human-readable colored/plain text output for local development.
|
|
6
|
+
|
|
7
|
+
## 2. Using `slog.Attr` for High-Throughput Paths
|
|
8
|
+
In hot loops, prefer strongly-typed attribute constructors to avoid reflection allocations:
|
|
9
|
+
```go
|
|
10
|
+
slog.String("user_id", u.ID)
|
|
11
|
+
slog.Int("attempts", count)
|
|
12
|
+
slog.Duration("latency", elapsed)
|
|
13
|
+
slog.Any("err", err)
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## 3. Custom ReplaceAttr Hook (Masking Sensitive Keys)
|
|
17
|
+
```go
|
|
18
|
+
opts := &slog.HandlerOptions{
|
|
19
|
+
ReplaceAttr: func(groups []string, a slog.Attr) slog.Attr {
|
|
20
|
+
if a.Key == "password" || a.Key == "token" || a.Key == "authorization" {
|
|
21
|
+
return slog.String(a.Key, "[REDACTED]")
|
|
22
|
+
}
|
|
23
|
+
return a
|
|
24
|
+
},
|
|
25
|
+
}
|
|
26
|
+
```
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
scaffoldGoModule.py
|
|
4
|
+
Scaffolds an idiomatic Go service layout with cmd/server/main.go, internal/platform, and slog.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import os
|
|
8
|
+
import sys
|
|
9
|
+
import argparse
|
|
10
|
+
|
|
11
|
+
def scaffold_go(module_name: str, out_dir: str):
|
|
12
|
+
os.makedirs(os.path.join(out_dir, "cmd", "server"), exist_ok=True)
|
|
13
|
+
os.makedirs(os.path.join(out_dir, "internal", "platform", "logger"), exist_ok=True)
|
|
14
|
+
|
|
15
|
+
# go.mod
|
|
16
|
+
with open(os.path.join(out_dir, "go.mod"), "w") as f:
|
|
17
|
+
f.write(f"module {module_name}\n\ngo 1.23\n")
|
|
18
|
+
|
|
19
|
+
# main.go
|
|
20
|
+
main_go = f"""package main
|
|
21
|
+
|
|
22
|
+
import (
|
|
23
|
+
"context"
|
|
24
|
+
"log/slog"
|
|
25
|
+
"net/http"
|
|
26
|
+
"os"
|
|
27
|
+
"os/signal"
|
|
28
|
+
"syscall"
|
|
29
|
+
"time"
|
|
30
|
+
|
|
31
|
+
"{module_name}/internal/platform/logger"
|
|
32
|
+
)
|
|
33
|
+
|
|
34
|
+
func main() {{
|
|
35
|
+
log := logger.InitLogger(os.Getenv("ENV") == "production")
|
|
36
|
+
log.Info("Starting server", "module", "{module_name}")
|
|
37
|
+
|
|
38
|
+
mux := http.NewServeMux()
|
|
39
|
+
mux.HandleFunc("GET /healthz", func(w http.ResponseWriter, r *http.Request) {{
|
|
40
|
+
w.WriteHeader(http.StatusOK)
|
|
41
|
+
w.Write([]byte("OK"))
|
|
42
|
+
}})
|
|
43
|
+
|
|
44
|
+
srv := &http.Server{{
|
|
45
|
+
Addr: ":8080",
|
|
46
|
+
Handler: mux,
|
|
47
|
+
ReadTimeout: 5 * time.Second,
|
|
48
|
+
WriteTimeout: 10 * time.Second,
|
|
49
|
+
}}
|
|
50
|
+
|
|
51
|
+
go func() {{
|
|
52
|
+
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {{
|
|
53
|
+
log.Error("server error", "err", err)
|
|
54
|
+
os.Exit(1)
|
|
55
|
+
}}
|
|
56
|
+
}}()
|
|
57
|
+
|
|
58
|
+
// Graceful shutdown
|
|
59
|
+
quit := make(chan os.Signal, 1)
|
|
60
|
+
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
|
|
61
|
+
<-quit
|
|
62
|
+
|
|
63
|
+
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
|
|
64
|
+
defer cancel()
|
|
65
|
+
|
|
66
|
+
if err := srv.Shutdown(ctx); err != nil {{
|
|
67
|
+
log.Error("shutdown error", "err", err)
|
|
68
|
+
}}
|
|
69
|
+
log.Info("Server stopped cleanly")
|
|
70
|
+
}}
|
|
71
|
+
"""
|
|
72
|
+
with open(os.path.join(out_dir, "cmd", "server", "main.go"), "w") as f:
|
|
73
|
+
f.write(main_go)
|
|
74
|
+
|
|
75
|
+
# logger.go
|
|
76
|
+
logger_go = """package logger
|
|
77
|
+
|
|
78
|
+
import (
|
|
79
|
+
"log/slog"
|
|
80
|
+
"os"
|
|
81
|
+
)
|
|
82
|
+
|
|
83
|
+
func InitLogger(isProd bool) *slog.Logger {
|
|
84
|
+
var h slog.Handler
|
|
85
|
+
if isProd {
|
|
86
|
+
h = slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelInfo})
|
|
87
|
+
} else {
|
|
88
|
+
h = slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelDebug})
|
|
89
|
+
}
|
|
90
|
+
l := slog.New(h)
|
|
91
|
+
slog.SetDefault(l)
|
|
92
|
+
return l
|
|
93
|
+
}
|
|
94
|
+
"""
|
|
95
|
+
with open(os.path.join(out_dir, "internal", "platform", "logger", "logger.go"), "w") as f:
|
|
96
|
+
f.write(logger_go)
|
|
97
|
+
|
|
98
|
+
print(f" Scaffolded Go service '{module_name}' at {out_dir}")
|
|
99
|
+
|
|
100
|
+
if __name__ == "__main__":
|
|
101
|
+
parser = argparse.ArgumentParser()
|
|
102
|
+
parser.add_argument("--module", required=True, help="Go module name (e.g. github.com/user/service)")
|
|
103
|
+
parser.add_argument("--out", default=".", help="Target directory")
|
|
104
|
+
args = parser.parse_args()
|
|
105
|
+
scaffold_go(args.module, args.out)
|