npm - @girardmedia/bootspring - Versions diffs - 3.3.2 → 3.4.0 - Mend

@girardmedia/bootspring 3.3.2 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (171) hide show

package/assets/agents/accessibility-auditor.md +39 -0
package/assets/agents/api-designer.md +40 -0
package/assets/agents/auth-implementer.md +64 -0
package/assets/agents/bug-hunter.md +42 -0
package/assets/agents/bundle-analyzer.md +40 -0
package/assets/agents/cache-optimizer.md +55 -0
package/assets/agents/changelog-writer.md +55 -0
package/assets/agents/ci-cd-builder.md +40 -0
package/assets/agents/code-explainer.md +39 -0
package/assets/agents/code-reviewer.md +39 -0
package/assets/agents/cost-optimizer.md +57 -0
package/assets/agents/cron-scheduler.md +51 -0
package/assets/agents/data-seeder.md +56 -0
package/assets/agents/database-architect.md +40 -0
package/assets/agents/dependency-updater.md +40 -0
package/assets/agents/deploy-checker.md +40 -0
package/assets/agents/docker-optimizer.md +40 -0
package/assets/agents/documentation-writer.md +40 -0
package/assets/agents/email-builder.md +55 -0
package/assets/agents/env-setup.md +40 -0
package/assets/agents/error-handler.md +40 -0
package/assets/agents/eslint-fixer.md +46 -0
package/assets/agents/feature-flagger.md +69 -0
package/assets/agents/git-detective.md +39 -0
package/assets/agents/graphql-builder.md +60 -0
package/assets/agents/incident-responder.md +59 -0
package/assets/agents/log-analyzer.md +39 -0
package/assets/agents/migration-planner.md +41 -0
package/assets/agents/monorepo-navigator.md +39 -0
package/assets/agents/nextjs-expert.md +57 -0
package/assets/agents/notification-builder.md +56 -0
package/assets/agents/onboarding-guide.md +39 -0
package/assets/agents/performance-profiler.md +40 -0
package/assets/agents/prisma-expert.md +57 -0
package/assets/agents/rate-limiter.md +58 -0
package/assets/agents/react-expert.md +58 -0
package/assets/agents/refactorer.md +42 -0
package/assets/agents/regex-builder.md +46 -0
package/assets/agents/release-manager.md +40 -0
package/assets/agents/s3-manager.md +58 -0
package/assets/agents/schema-validator.md +40 -0
package/assets/agents/search-builder.md +62 -0
package/assets/agents/security-auditor.md +39 -0
package/assets/agents/sitemap-generator.md +53 -0
package/assets/agents/stripe-integrator.md +59 -0
package/assets/agents/tailwind-expert.md +55 -0
package/assets/agents/tech-debt-tracker.md +39 -0
package/assets/agents/test-writer.md +42 -0
package/assets/agents/type-fixer.md +45 -0
package/assets/agents/webhook-builder.md +54 -0
package/assets/rules/cpp.md +53 -0
package/assets/rules/css.md +52 -0
package/assets/rules/go.md +50 -0
package/assets/rules/html.md +52 -0
package/assets/rules/java.md +51 -0
package/assets/rules/kotlin.md +50 -0
package/assets/rules/php.md +51 -0
package/assets/rules/python.md +51 -0
package/assets/rules/ruby.md +51 -0
package/assets/rules/rust.md +49 -0
package/assets/rules/shell.md +52 -0
package/assets/rules/sql.md +49 -0
package/assets/rules/swift.md +50 -0
package/assets/rules/typescript.md +52 -0
package/assets/rules/yaml-json.md +51 -0
package/assets/skills/accessibility.md +210 -0
package/assets/skills/agent-patterns.md +387 -0
package/assets/skills/ai-integration.md +263 -0
package/assets/skills/animation-patterns.md +224 -0
package/assets/skills/api-design.md +218 -0
package/assets/skills/api-gateway.md +341 -0
package/assets/skills/api-versioning.md +226 -0
package/assets/skills/astro-patterns.md +233 -0
package/assets/skills/auth-patterns.md +248 -0
package/assets/skills/aws-patterns.md +171 -0
package/assets/skills/background-jobs.md +162 -0
package/assets/skills/browser-extensions.md +309 -0
package/assets/skills/caching-patterns.md +253 -0
package/assets/skills/ci-cd.md +251 -0
package/assets/skills/cli-development.md +296 -0
package/assets/skills/code-review.md +185 -0
package/assets/skills/cron-patterns.md +327 -0
package/assets/skills/data-fetching.md +231 -0
package/assets/skills/database-migrations.md +346 -0
package/assets/skills/database-patterns.md +219 -0
package/assets/skills/debugging.md +281 -0
package/assets/skills/design-system.md +289 -0
package/assets/skills/django-patterns.md +182 -0
package/assets/skills/docker-patterns.md +235 -0
package/assets/skills/e2e-testing.md +287 -0
package/assets/skills/edge-computing.md +268 -0
package/assets/skills/electron-patterns.md +266 -0
package/assets/skills/email-templates.md +206 -0
package/assets/skills/error-handling.md +265 -0
package/assets/skills/event-driven.md +232 -0
package/assets/skills/express-patterns.md +239 -0
package/assets/skills/fastapi-patterns.md +198 -0
package/assets/skills/feature-flags.md +212 -0
package/assets/skills/figma-to-code.md +298 -0
package/assets/skills/file-upload.md +228 -0
package/assets/skills/forms-patterns.md +264 -0
package/assets/skills/gcp-patterns.md +189 -0
package/assets/skills/git-workflow.md +187 -0
package/assets/skills/golang-patterns.md +185 -0
package/assets/skills/graphql-patterns.md +244 -0
package/assets/skills/i18n-patterns.md +172 -0
package/assets/skills/image-processing.md +350 -0
package/assets/skills/java-springboot.md +226 -0
package/assets/skills/kotlin-patterns.md +207 -0
package/assets/skills/kubernetes-patterns.md +326 -0
package/assets/skills/laravel-patterns.md +261 -0
package/assets/skills/llm-fine-tuning.md +335 -0
package/assets/skills/load-testing.md +303 -0
package/assets/skills/logging-observability.md +228 -0
package/assets/skills/markdown-processing.md +318 -0
package/assets/skills/mcp-server-patterns.md +292 -0
package/assets/skills/microservices.md +272 -0
package/assets/skills/migration-patterns.md +239 -0
package/assets/skills/mongodb-patterns.md +189 -0
package/assets/skills/monorepo-patterns.md +287 -0
package/assets/skills/nextjs-app-router.md +237 -0
package/assets/skills/notification-patterns.md +348 -0
package/assets/skills/oauth-patterns.md +246 -0
package/assets/skills/payment-integration.md +222 -0
package/assets/skills/pdf-generation.md +307 -0
package/assets/skills/performance-optimization.md +277 -0
package/assets/skills/php-patterns.md +210 -0
package/assets/skills/prisma-patterns.md +241 -0
package/assets/skills/prompt-engineering.md +193 -0
package/assets/skills/pwa-patterns.md +247 -0
package/assets/skills/python-patterns.md +158 -0
package/assets/skills/python-testing.md +172 -0
package/assets/skills/queue-patterns.md +295 -0
package/assets/skills/rag-patterns.md +159 -0
package/assets/skills/rate-limiting.md +319 -0
package/assets/skills/react-components.md +201 -0
package/assets/skills/react-native-patterns.md +299 -0
package/assets/skills/real-time-patterns.md +181 -0
package/assets/skills/redis-patterns.md +188 -0
package/assets/skills/refactoring.md +218 -0
package/assets/skills/regex-patterns.md +191 -0
package/assets/skills/remix-patterns.md +262 -0
package/assets/skills/responsive-design.md +199 -0
package/assets/skills/ruby-rails-patterns.md +178 -0
package/assets/skills/rust-patterns.md +211 -0
package/assets/skills/search-patterns.md +227 -0
package/assets/skills/security-hardening.md +237 -0
package/assets/skills/seo-patterns.md +179 -0
package/assets/skills/serverless-patterns.md +223 -0
package/assets/skills/sql-optimization.md +154 -0
package/assets/skills/state-management.md +254 -0
package/assets/skills/storybook-patterns.md +330 -0
package/assets/skills/svelte-patterns.md +258 -0
package/assets/skills/swift-patterns.md +227 -0
package/assets/skills/tailwind-patterns.md +272 -0
package/assets/skills/tdd-workflow.md +199 -0
package/assets/skills/terraform-patterns.md +270 -0
package/assets/skills/testing-react.md +240 -0
package/assets/skills/testing-vitest.md +232 -0
package/assets/skills/typescript-strict.md +159 -0
package/assets/skills/video-processing.md +340 -0
package/assets/skills/vue-patterns.md +247 -0
package/assets/skills/web-workers.md +327 -0
package/assets/skills/webhooks-patterns.md +283 -0
package/assets/skills/websocket-patterns.md +306 -0
package/dist/cli/index.js +941 -958
package/dist/core/index.d.ts +341 -11
package/dist/core.js +58 -95
package/dist/mcp/index.d.ts +33 -1
package/dist/mcp-server.js +177 -255
package/package.json +4 -1

package/assets/skills/kotlin-patterns.md ADDED Viewed

@@ -0,0 +1,207 @@
+---
+name: kotlin-patterns
+description: Kotlin patterns for coroutines, sealed classes, extension functions, DSL builders, and null safety.
+---
+# Kotlin Patterns
+## When to Use
+Apply these patterns when writing Kotlin code for Android, backend (Ktor, Spring),
+or multiplatform projects. Use this skill for structured concurrency with coroutines,
+modeling state with sealed classes, writing expressive DSLs, and leveraging Kotlin's
+null safety system.
+## How It Works
+### Coroutines and Structured Concurrency
+Use `coroutineScope` or `supervisorScope` for structured concurrency. Never use
+`GlobalScope`. Launch coroutines within a scope that ties their lifecycle to a
+parent component.
+```kotlin
+class UserRepository(private val api: UserApi, private val db: UserDao) {
+    suspend fun sync(ids: List<String>): List<User> = coroutineScope {
+        val deferred = ids.map { id ->
+            async { api.fetchUser(id) }
+        }
+        val users = deferred.awaitAll()
+        db.insertAll(users)
+        users
+    }
+}
+// With timeout and cancellation
+suspend fun fetchWithTimeout(url: String): String {
+    return withTimeout(10_000) {
+        httpClient.get(url).bodyAsText()
+    }
+}
+```
+### Flow for Reactive Streams
+Use `Flow` instead of callbacks or RxJava. Use `stateIn` to convert a Flow to a
+`StateFlow` for UI observation. Apply operators like `map`, `filter`, `debounce`.
+```kotlin
+class SearchViewModel(private val repo: SearchRepo) : ViewModel() {
+    private val _query = MutableStateFlow("")
+    val results: StateFlow<List<Result>> = _query
+        .debounce(300)
+        .filter { it.length >= 2 }
+        .flatMapLatest { query -> repo.search(query) }
+        .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList())
+    fun onQueryChanged(text: String) {
+        _query.value = text
+    }
+}
+```
+### Sealed Classes and Interfaces
+Use sealed classes/interfaces to model closed type hierarchies. Combine with
+`when` expressions for exhaustive handling. The compiler enforces you handle
+every variant.
+```kotlin
+sealed interface UiState<out T> {
+    data object Loading : UiState<Nothing>
+    data class Success<T>(val data: T) : UiState<T>
+    data class Error(val message: String, val retry: (() -> Unit)? = null) : UiState<Nothing>
+}
+fun <T> render(state: UiState<T>) {
+    when (state) {
+        is UiState.Loading -> showSpinner()
+        is UiState.Success -> showData(state.data)
+        is UiState.Error -> showError(state.message, state.retry)
+        // No else needed — compiler ensures exhaustive
+    }
+}
+```
+### Extension Functions
+Add behavior to existing types without inheritance. Keep extensions focused and
+discoverable. Place them in a file named after the type they extend.
+```kotlin
+// StringExtensions.kt
+fun String.truncate(maxLength: Int, suffix: String = "..."): String {
+    return if (length <= maxLength) this
+    else take(maxLength - suffix.length) + suffix
+}
+fun String.toSlug(): String {
+    return lowercase()
+        .replace(Regex("[^a-z0-9\\s-]"), "")
+        .replace(Regex("\\s+"), "-")
+        .trim('-')
+}
+// Usage reads naturally
+val title = "A Very Long Article Title Here".truncate(20)
+val slug = "My Blog Post!".toSlug() // "my-blog-post"
+```
+### DSL Builders
+Use `@DslMarker` to prevent scope leaks. Use receiver lambdas (`T.() -> Unit`)
+to create nested builder syntax.
+```kotlin
+@DslMarker
+annotation class HtmlDsl
+@HtmlDsl
+class HtmlBuilder {
+    private val elements = mutableListOf<String>()
+    fun head(block: HeadBuilder.() -> Unit) {
+        elements += HeadBuilder().apply(block).build()
+    }
+    fun body(block: BodyBuilder.() -> Unit) {
+        elements += BodyBuilder().apply(block).build()
+    }
+    fun build(): String = "<html>${elements.joinToString("")}</html>"
+}
+fun html(block: HtmlBuilder.() -> Unit): String {
+    return HtmlBuilder().apply(block).build()
+}
+// Usage
+val page = html {
+    head { title("My Page") }
+    body { p("Hello, world!") }
+}
+```
+### Null Safety
+Use `?.` for safe calls, `?:` (Elvis) for defaults. Avoid `!!` except in tests.
+Use `require` / `check` for preconditions that throw on violation.
+```kotlin
+fun processUser(user: User?) {
+    // Safe call chain
+    val city = user?.address?.city ?: "Unknown"
+    // Smart cast after null check
+    user ?: return
+    // user is now non-null below
+    println(user.name)
+}
+fun createOrder(items: List<Item>) {
+    require(items.isNotEmpty()) { "Order must have at least one item" }
+    check(items.all { it.inStock }) { "All items must be in stock" }
+    // proceed with non-empty, validated items
+}
+```
+## Examples
+**Pattern: Result type for error handling without exceptions**
+```kotlin
+suspend fun fetchUser(id: String): Result<User> = runCatching {
+    val response = api.getUser(id)
+    response.toDomain()
+}
+// Caller
+fetchUser("123")
+    .onSuccess { user -> display(user) }
+    .onFailure { error -> log(error) }
+```
+**Pattern: Delegation for composition**
+```kotlin
+class LoggingList<T>(
+    private val inner: MutableList<T> = mutableListOf()
+) : MutableList<T> by inner {
+    override fun add(element: T): Boolean {
+        println("Adding: $element")
+        return inner.add(element)
+    }
+}
+```
+## Checklist
+- [ ] Coroutines use `coroutineScope` / `supervisorScope`, never `GlobalScope`
+- [ ] `withTimeout` on all network/IO operations
+- [ ] Sealed classes for closed type hierarchies with exhaustive `when`
+- [ ] Extension functions in dedicated files named after the extended type
+- [ ] DSLs use `@DslMarker` to prevent scope leaks
+- [ ] Zero `!!` in production code (use `requireNotNull` or `checkNotNull` with messages)
+- [ ] `StateFlow` for UI state, `SharedFlow` for events
+- [ ] `data class` for value objects, `value class` for type-safe wrappers
+- [ ] `require` / `check` for preconditions with descriptive messages
+- [ ] `runCatching` / `Result` for operations that can fail without exceptions

package/assets/skills/kubernetes-patterns.md ADDED Viewed

@@ -0,0 +1,326 @@
+---
+name: kubernetes-patterns
+description: Kubernetes patterns for deployments, services, configmaps, secrets, HPA, health probes, and RBAC.
+---
+# Kubernetes Patterns
+## When to Use
+Apply these patterns when deploying and managing applications on Kubernetes. Use
+this skill for writing Deployment manifests, exposing services, managing
+configuration and secrets, auto-scaling with HPA, configuring health probes, and
+setting up role-based access control.
+## How It Works
+### Deployments
+Define desired state declaratively. Use labels for selection and organization.
+Set resource requests and limits. Use rolling update strategy for zero-downtime
+deploys.
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: api-server
+  labels:
+    app: api-server
+    version: v1
+spec:
+  replicas: 3
+  selector:
+    matchLabels:
+      app: api-server
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxSurge: 1
+      maxUnavailable: 0
+  template:
+    metadata:
+      labels:
+        app: api-server
+        version: v1
+    spec:
+      terminationGracePeriodSeconds: 30
+      containers:
+        - name: api
+          image: registry.example.com/api:1.2.3
+          ports:
+            - containerPort: 3000
+              protocol: TCP
+          resources:
+            requests:
+              cpu: 250m
+              memory: 256Mi
+            limits:
+              cpu: 500m
+              memory: 512Mi
+          envFrom:
+            - configMapRef:
+                name: api-config
+            - secretRef:
+                name: api-secrets
+          readinessProbe:
+            httpGet:
+              path: /readyz
+              port: 3000
+            initialDelaySeconds: 5
+            periodSeconds: 10
+          livenessProbe:
+            httpGet:
+              path: /healthz
+              port: 3000
+            initialDelaySeconds: 15
+            periodSeconds: 20
+          lifecycle:
+            preStop:
+              exec:
+                command: ["/bin/sh", "-c", "sleep 5"]
+```
+### Services
+Use `ClusterIP` for internal communication, `LoadBalancer` for external traffic
+(or use Ingress). Match selectors to pod labels exactly.
+```yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: api-server
+spec:
+  type: ClusterIP
+  selector:
+    app: api-server
+  ports:
+    - port: 80
+      targetPort: 3000
+      protocol: TCP
+---
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: api-ingress
+  annotations:
+    nginx.ingress.kubernetes.io/ssl-redirect: "true"
+    nginx.ingress.kubernetes.io/rate-limit: "100"
+spec:
+  ingressClassName: nginx
+  tls:
+    - hosts: [api.example.com]
+      secretName: api-tls
+  rules:
+    - host: api.example.com
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: api-server
+                port:
+                  number: 80
+```
+### ConfigMaps and Secrets
+Use ConfigMaps for non-sensitive configuration. Use Secrets for credentials.
+Mount as environment variables or files. Never commit Secrets to git.
+```yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: api-config
+data:
+  NODE_ENV: production
+  LOG_LEVEL: info
+  PORT: "3000"
+  CORS_ORIGINS: "https://app.example.com"
+---
+apiVersion: v1
+kind: Secret
+metadata:
+  name: api-secrets
+type: Opaque
+stringData:
+  DATABASE_URL: postgresql://user:pass@db:5432/app
+  JWT_SECRET: your-secret-here
+  API_KEY: external-service-key
+```
+**External Secrets Operator** for production:
+```yaml
+apiVersion: external-secrets.io/v1beta1
+kind: ExternalSecret
+metadata:
+  name: api-secrets
+spec:
+  refreshInterval: 1h
+  secretStoreRef:
+    name: aws-secrets-manager
+    kind: ClusterSecretStore
+  target:
+    name: api-secrets
+  data:
+    - secretKey: DATABASE_URL
+      remoteRef:
+        key: production/api/database-url
+```
+### Health Probes
+Three types: startup (initial boot), readiness (can serve traffic), liveness
+(is the process healthy). Get the order and timing right.
+```yaml
+# Startup probe: wait for slow-starting apps
+startupProbe:
+  httpGet:
+    path: /healthz
+    port: 3000
+  failureThreshold: 30    # 30 * 10s = 5 minutes to start
+  periodSeconds: 10
+# Readiness probe: should this pod receive traffic?
+readinessProbe:
+  httpGet:
+    path: /readyz
+    port: 3000
+  initialDelaySeconds: 5
+  periodSeconds: 10
+  failureThreshold: 3
+# Liveness probe: is the process stuck?
+livenessProbe:
+  httpGet:
+    path: /healthz
+    port: 3000
+  initialDelaySeconds: 15
+  periodSeconds: 20
+  failureThreshold: 3
+```
+**Critical rules:**
+- Readiness checks downstream dependencies (DB, cache). Liveness does not.
+- If liveness fails, Kubernetes kills the pod. Make it lightweight.
+- Set `initialDelaySeconds` higher than your app's boot time.
+### Horizontal Pod Autoscaler (HPA)
+Scale based on CPU, memory, or custom metrics. Set `minReplicas` and `maxReplicas`
+to bound scaling. Ensure resource `requests` are set on pods.
+```yaml
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: api-server
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: api-server
+  minReplicas: 3
+  maxReplicas: 20
+  metrics:
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: 70
+    - type: Resource
+      resource:
+        name: memory
+        target:
+          type: Utilization
+          averageUtilization: 80
+  behavior:
+    scaleDown:
+      stabilizationWindowSeconds: 300
+      policies:
+        - type: Percent
+          value: 10
+          periodSeconds: 60
+    scaleUp:
+      stabilizationWindowSeconds: 30
+      policies:
+        - type: Percent
+          value: 50
+          periodSeconds: 60
+```
+### RBAC
+Principle of least privilege. Create ServiceAccounts per workload. Bind Roles
+to ServiceAccounts, not users. Use ClusterRole only for cluster-wide resources.
+```yaml
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: api-server
+  namespace: production
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: Role
+metadata:
+  name: api-server-role
+  namespace: production
+rules:
+  - apiGroups: [""]
+    resources: ["configmaps", "secrets"]
+    verbs: ["get", "list"]
+  - apiGroups: [""]
+    resources: ["pods"]
+    verbs: ["get", "list", "watch"]
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: RoleBinding
+metadata:
+  name: api-server-binding
+  namespace: production
+subjects:
+  - kind: ServiceAccount
+    name: api-server
+roleRef:
+  kind: Role
+  name: api-server-role
+  apiGroup: rbac.authorization.k8s.io
+```
+## Examples
+**Pattern: Pod Disruption Budget for high availability**
+```yaml
+apiVersion: policy/v1
+kind: PodDisruptionBudget
+metadata:
+  name: api-server
+spec:
+  minAvailable: 2
+  selector:
+    matchLabels:
+      app: api-server
+```
+## Checklist
+- [ ] Resource `requests` and `limits` set on every container
+- [ ] Rolling update with `maxUnavailable: 0` for zero-downtime deploys
+- [ ] Readiness probe checks downstream dependencies; liveness probe is lightweight
+- [ ] Startup probe for slow-starting applications
+- [ ] `preStop` hook with sleep to allow load balancer drain
+- [ ] ConfigMaps for config, Secrets for credentials (never in git)
+- [ ] External Secrets Operator for production secret management
+- [ ] HPA with CPU/memory targets and scale-down stabilization window
+- [ ] ServiceAccount per workload with minimal RBAC permissions
+- [ ] PodDisruptionBudget to maintain availability during node maintenance