specforge-mcp 0.1.0

package/dist/config/docs-registry.json

@@ -0,0 +1,94 @@
+{
+  "frameworks": {
+    "next.js": { "base": "https://nextjs.org/docs", "search": "https://nextjs.org/docs?q={topic}" },
+    "react": { "base": "https://react.dev", "search": "https://react.dev/search?q={topic}" },
+    "vue": { "base": "https://vuejs.org/guide", "search": "https://vuejs.org/search?q={topic}" },
+    "angular": { "base": "https://angular.dev", "search": "https://angular.dev/search?q={topic}" },
+    "svelte": { "base": "https://svelte.dev/docs", "search": "https://svelte.dev/search?q={topic}" },
+    "django": {
+      "base": "https://docs.djangoproject.com",
+      "search": "https://docs.djangoproject.com/en/stable/search/?q={topic}"
+    },
+    "flask": {
+      "base": "https://flask.palletsprojects.com",
+      "search": "https://flask.palletsprojects.com/en/stable/search/?q={topic}"
+    },
+    "fastapi": { "base": "https://fastapi.tiangolo.com", "search": "https://fastapi.tiangolo.com/search/?q={topic}" },
+    "express": { "base": "https://expressjs.com", "search": "https://expressjs.com/en/search.html?q={topic}" },
+    "gin": { "base": "https://gin-gonic.com/docs", "search": "https://gin-gonic.com/docs/?q={topic}" },
+    "laravel": { "base": "https://laravel.com/docs", "search": "https://laravel.com/docs?q={topic}" },
+    "spring": {
+      "base": "https://docs.spring.io/spring-boot/reference",
+      "search": "https://docs.spring.io/spring-boot/reference/?q={topic}"
+    },
+    "rails": { "base": "https://guides.rubyonrails.org", "search": "https://guides.rubyonrails.org/?q={topic}" },
+    "dotnet": {
+      "base": "https://learn.microsoft.com/en-us/dotnet",
+      "search": "https://learn.microsoft.com/en-us/search/?terms={topic}&scope=.NET"
+    },
+    "astro": { "base": "https://docs.astro.build", "search": "https://docs.astro.build/search?q={topic}" },
+    "remix": { "base": "https://remix.run/docs", "search": "https://remix.run/docs?q={topic}" },
+    "nuxt": { "base": "https://nuxt.com/docs", "search": "https://nuxt.com/docs?q={topic}" },
+    "solid": { "base": "https://www.solidjs.com/docs", "search": "https://www.solidjs.com/docs?q={topic}" },
+    "hono": { "base": "https://hono.dev/docs", "search": "https://hono.dev/docs?q={topic}" },
+    "expo": { "base": "https://docs.expo.dev", "search": "https://docs.expo.dev/search?q={topic}" },
+    "flutter": { "base": "https://docs.flutter.dev", "search": "https://docs.flutter.dev/search?q={topic}" },
+    "tailwind": { "base": "https://tailwindcss.com/docs", "search": "https://tailwindcss.com/docs?q={topic}" },
+    "prisma": { "base": "https://www.prisma.io/docs", "search": "https://www.prisma.io/docs?q={topic}" },
+    "drizzle": { "base": "https://orm.drizzle.team/docs", "search": "https://orm.drizzle.team/docs?q={topic}" }
+  },
+  "languages": {
+    "typescript": {
+      "base": "https://www.typescriptlang.org/docs",
+      "search": "https://www.typescriptlang.org/search?q={topic}"
+    },
+    "python": { "base": "https://docs.python.org/3", "search": "https://docs.python.org/3/search.html?q={topic}" },
+    "go": { "base": "https://go.dev/doc", "search": "https://pkg.go.dev/search?q={topic}" },
+    "rust": { "base": "https://doc.rust-lang.org/book", "search": "https://doc.rust-lang.org/std/?search={topic}" },
+    "java": {
+      "base": "https://docs.oracle.com/en/java",
+      "search": "https://docs.oracle.com/search/?q={topic}&category=java"
+    },
+    "php": {
+      "base": "https://www.php.net/manual/en",
+      "search": "https://www.php.net/manual-lookup.php?pattern={topic}"
+    },
+    "ruby": { "base": "https://ruby-doc.org", "search": "https://ruby-doc.org/search.html?q={topic}" },
+    "csharp": {
+      "base": "https://learn.microsoft.com/en-us/dotnet/csharp",
+      "search": "https://learn.microsoft.com/en-us/search/?terms={topic}&scope=.NET"
+    },
+    "kotlin": { "base": "https://kotlinlang.org/docs", "search": "https://kotlinlang.org/docs/?q={topic}" },
+    "swift": {
+      "base": "https://developer.apple.com/documentation/swift",
+      "search": "https://developer.apple.com/search/?q={topic}"
+    },
+    "dart": { "base": "https://dart.dev/guides", "search": "https://dart.dev/search?q={topic}" },
+    "elixir": {
+      "base": "https://elixir-lang.org/docs.html",
+      "search": "https://hexdocs.pm/elixir/search.html?q={topic}"
+    }
+  },
+  "services": {
+    "supabase": { "base": "https://supabase.com/docs", "search": "https://supabase.com/docs/search?q={topic}" },
+    "stripe": { "base": "https://docs.stripe.com", "search": "https://docs.stripe.com/search?query={topic}" },
+    "firebase": {
+      "base": "https://firebase.google.com/docs",
+      "search": "https://firebase.google.com/docs/search?q={topic}"
+    },
+    "aws": { "base": "https://docs.aws.amazon.com", "search": "https://docs.aws.amazon.com/search?q={topic}" },
+    "vercel": { "base": "https://vercel.com/docs", "search": "https://vercel.com/docs?q={topic}" },
+    "railway": { "base": "https://docs.railway.com", "search": "https://docs.railway.com/search?q={topic}" },
+    "planetscale": { "base": "https://planetscale.com/docs", "search": "https://planetscale.com/docs?q={topic}" },
+    "neon": { "base": "https://neon.tech/docs", "search": "https://neon.tech/docs?q={topic}" },
+    "turso": { "base": "https://docs.turso.tech", "search": "https://docs.turso.tech/search?q={topic}" },
+    "fly.io": { "base": "https://fly.io/docs", "search": "https://fly.io/docs/search?q={topic}" },
+    "cloudflare": {
+      "base": "https://developers.cloudflare.com",
+      "search": "https://developers.cloudflare.com/?q={topic}"
+    },
+    "openai": { "base": "https://platform.openai.com/docs", "search": "https://platform.openai.com/docs?q={topic}" },
+    "langchain": { "base": "https://docs.langchain.com", "search": "https://docs.langchain.com/search?q={topic}" },
+    "anthropic": { "base": "https://docs.anthropic.com", "search": "https://docs.anthropic.com/search?q={topic}" }
+  }
+}

package/dist/config/edge-db-catalog.json

@@ -0,0 +1,89 @@
+{
+  "schemaRecommendations": [
+    {
+      "provider": "turso",
+      "when": [
+        "app is multi-tenant",
+        "isolation-per-tenant required",
+        "data per tenant < 1GB",
+        "global low-latency reads needed"
+      ],
+      "justification": "Turso provides a separate SQLite database per tenant. Isolation is enforced at the database level — no cross-tenant SQL is possible by design. The libSQL edge network offers <40ms read latency from 5 continents. Embedded replicas enable sub-millisecond local reads for read-heavy workloads.",
+      "avoidWhen": [
+        "cross-tenant JOINs required",
+        "analytical / OLAP queries",
+        "data per tenant > 1GB",
+        "distributed transactions across tenants"
+      ]
+    },
+    {
+      "provider": "cloudflare-d1",
+      "when": [
+        "server is a Cloudflare Worker",
+        "low-complexity data per request or per user",
+        "ultra-low latency from Workers required",
+        "no need for multi-tenant isolation across D1 databases"
+      ],
+      "justification": "Cloudflare D1 is a managed SQLite binding for Workers. Queries execute co-located with the Worker near the user with near-zero overhead. Migrations are managed by Wrangler CLI. Best suited for simple schemas used within a single Worker scope.",
+      "avoidWhen": [
+        "complex relational schemas with many JOINs",
+        "large datasets (> 10GB total)",
+        "cross-Worker data sharing",
+        "write-heavy workloads requiring strong consistency"
+      ]
+    },
+    {
+      "provider": "none",
+      "when": [
+        "cross-tenant JOINs required",
+        "analytical or OLAP queries",
+        "data per tenant > 1GB",
+        "distributed transactions across tenants"
+      ],
+      "justification": "Standard managed Postgres (e.g., Supabase, Neon, PlanetScale) is recommended when edge SQLite constraints are too restrictive. Postgres supports cross-schema joins, OLAP extensions, and horizontal scaling via read replicas.",
+      "avoidWhen": ["strict tenant isolation without row-level security", "ultra-low latency edge reads"]
+    }
+  ],
+  "criteriaTemplates": [
+    {
+      "id": "turso-tenant-isolation",
+      "trigger": "turso",
+      "criterion": "Each tenant has their own Turso database — cross-tenant access requires an explicit API call, never a SQL JOIN across databases"
+    },
+    {
+      "id": "turso-embedded-replica-writes",
+      "trigger": "embedded-replica",
+      "criterion": "Embedded replica configured for read-heavy services — writes go to the primary Turso database, reads go to the local embedded replica"
+    },
+    {
+      "id": "d1-binding-scoped",
+      "trigger": "cloudflare-d1",
+      "criterion": "D1 binding scoped to the specific Worker — no global access; migrations tracked with Wrangler (`wrangler d1 migrations apply`)"
+    }
+  ],
+  "antiPatterns": [
+    {
+      "id": "shared-sqlite-file",
+      "name": "Single SQLite file shared across tenants",
+      "signal": "better-sqlite3 with a fixed single file path in a multi-tenant project",
+      "severity": "error",
+      "message": "Single SQLite file shared across tenants causes race conditions and data leakage"
+    },
+    {
+      "id": "d1-no-migrations",
+      "name": "D1 without migration tracking",
+      "signal": "wrangler.toml present but missing migrations_dir",
+      "severity": "warning",
+      "message": "Schema drift risk — D1 migrations not tracked"
+    }
+  ],
+  "testTemplates": [
+    {
+      "id": "d1-vitest-pool-workers",
+      "trigger": "cloudflare-d1",
+      "framework": "@cloudflare/vitest-pool-workers",
+      "setupSnippet": "import { env, createExecutionContext, waitOnExecutionContext } from 'cloudflare:test';\nimport { describe, it, expect, beforeEach } from 'vitest';\n\ndescribe('D1 database tests', () => {\n  beforeEach(async () => {\n    // Reset D1 state between tests via env.DB\n    await env.DB.exec('DELETE FROM your_table');\n  });\n\n  it('should insert and query a record', async () => {\n    await env.DB.prepare('INSERT INTO your_table (id, name) VALUES (?, ?)').bind(1, 'test').run();\n    const result = await env.DB.prepare('SELECT * FROM your_table WHERE id = ?').bind(1).first();\n    expect(result?.name).toBe('test');\n  });\n});",
+      "description": "Use @cloudflare/vitest-pool-workers to mock D1 binding via env.DB in worker test context"
+    }
+  ]
+}

package/dist/config/env-patterns.json

@@ -0,0 +1,164 @@
+{
+  "_description": "Patterns for env var detection by language, with known service dashboards and formats",
+  "detectionPatterns": {
+    "typescript": ["process\\.env\\.([A-Z_][A-Z0-9_]*)", "process\\.env\\[(['\"])([A-Z_][A-Z0-9_]*)\\1\\]"],
+    "javascript": ["process\\.env\\.([A-Z_][A-Z0-9_]*)", "process\\.env\\[(['\"])([A-Z_][A-Z0-9_]*)\\1\\]"],
+    "python": [
+      "os\\.environ\\[(['\"])([A-Z_][A-Z0-9_]*)\\1\\]",
+      "os\\.environ\\.get\\((['\"])([A-Z_][A-Z0-9_]*)\\1",
+      "os\\.getenv\\((['\"])([A-Z_][A-Z0-9_]*)\\1"
+    ],
+    "go": ["os\\.Getenv\\((['\"])([A-Z_][A-Z0-9_]*)\\1\\)"],
+    "rust": ["env::var\\((['\"])([A-Z_][A-Z0-9_]*)\\1\\)", "std::env::var\\((['\"])([A-Z_][A-Z0-9_]*)\\1\\)"],
+    "java": ["System\\.getenv\\((['\"])([A-Z_][A-Z0-9_]*)\\1\\)"]
+  },
+  "secretPatterns": [
+    "(?:sk_live|sk_test)_[A-Za-z0-9]{20,}",
+    "(?:pk_live|pk_test)_[A-Za-z0-9]{20,}",
+    "ghp_[A-Za-z0-9]{36}",
+    "github_pat_[A-Za-z0-9_]{82}",
+    "ghs_[A-Za-z0-9]{36}",
+    "xoxb-[0-9]+-[A-Za-z0-9]+",
+    "xoxp-[0-9]+-[A-Za-z0-9]+",
+    "AKIA[0-9A-Z]{16}",
+    "(?:eyJhbGciOiJIUzI1NiJ9)[A-Za-z0-9._-]{20,}",
+    "(?:password|passwd|secret|api_key|apikey|token|auth_token)\\s*=\\s*['\"][^'\"]{8,}['\"]"
+  ],
+  "services": {
+    "SUPABASE": {
+      "prefix": ["SUPABASE_", "NEXT_PUBLIC_SUPABASE_"],
+      "description": "Supabase backend-as-a-service",
+      "dashboardUrl": "https://supabase.com/dashboard",
+      "vars": {
+        "SUPABASE_URL": {
+          "description": "Supabase project URL",
+          "format": "https://<project-ref>.supabase.co",
+          "howToObtain": "Go to Supabase dashboard > Settings > API > Project URL",
+          "estimatedTime": "2 minutes"
+        },
+        "SUPABASE_ANON_KEY": {
+          "description": "Supabase anonymous/public key",
+          "format": "eyJh... (JWT)",
+          "howToObtain": "Go to Supabase dashboard > Settings > API > anon key",
+          "estimatedTime": "2 minutes"
+        },
+        "SUPABASE_SERVICE_ROLE_KEY": {
+          "description": "Supabase service role key (admin)",
+          "format": "eyJh... (JWT)",
+          "howToObtain": "Go to Supabase dashboard > Settings > API > service_role key",
+          "estimatedTime": "2 minutes",
+          "isSecret": true
+        }
+      }
+    },
+    "STRIPE": {
+      "prefix": ["STRIPE_"],
+      "description": "Stripe payment processing",
+      "dashboardUrl": "https://dashboard.stripe.com",
+      "vars": {
+        "STRIPE_SECRET_KEY": {
+          "description": "Stripe secret API key",
+          "format": "sk_live_... or sk_test_...",
+          "howToObtain": "Stripe Dashboard > Developers > API keys > Secret key",
+          "estimatedTime": "2 minutes",
+          "isSecret": true
+        },
+        "STRIPE_PUBLISHABLE_KEY": {
+          "description": "Stripe publishable key",
+          "format": "pk_live_... or pk_test_...",
+          "howToObtain": "Stripe Dashboard > Developers > API keys > Publishable key",
+          "estimatedTime": "2 minutes"
+        },
+        "STRIPE_WEBHOOK_SECRET": {
+          "description": "Stripe webhook endpoint secret",
+          "format": "whsec_...",
+          "howToObtain": "Stripe Dashboard > Developers > Webhooks > your endpoint > Signing secret",
+          "estimatedTime": "5 minutes",
+          "isSecret": true
+        }
+      }
+    },
+    "FIREBASE": {
+      "prefix": ["FIREBASE_", "NEXT_PUBLIC_FIREBASE_"],
+      "description": "Google Firebase",
+      "dashboardUrl": "https://console.firebase.google.com",
+      "vars": {
+        "FIREBASE_API_KEY": {
+          "description": "Firebase web API key",
+          "format": "AIza...",
+          "howToObtain": "Firebase Console > Project settings > General > Web API Key",
+          "estimatedTime": "3 minutes"
+        },
+        "FIREBASE_PROJECT_ID": {
+          "description": "Firebase project ID",
+          "format": "my-project-id",
+          "howToObtain": "Firebase Console > Project settings > General > Project ID",
+          "estimatedTime": "1 minute"
+        }
+      }
+    },
+    "DATABASE": {
+      "prefix": ["DATABASE_URL", "DB_", "POSTGRES_", "MYSQL_", "MONGO_"],
+      "description": "Database connection",
+      "dashboardUrl": null,
+      "vars": {
+        "DATABASE_URL": {
+          "description": "Full database connection URL",
+          "format": "postgresql://user:password@host:5432/dbname",
+          "howToObtain": "Get from your database provider dashboard",
+          "estimatedTime": "5 minutes",
+          "isSecret": true
+        }
+      }
+    },
+    "OPENAI": {
+      "prefix": ["OPENAI_"],
+      "description": "OpenAI API",
+      "dashboardUrl": "https://platform.openai.com",
+      "vars": {
+        "OPENAI_API_KEY": {
+          "description": "OpenAI API key",
+          "format": "sk-...",
+          "howToObtain": "OpenAI Platform > API keys > Create new secret key",
+          "estimatedTime": "3 minutes",
+          "isSecret": true
+        }
+      }
+    },
+    "ANTHROPIC": {
+      "prefix": ["ANTHROPIC_"],
+      "description": "Anthropic Claude API",
+      "dashboardUrl": "https://console.anthropic.com",
+      "vars": {
+        "ANTHROPIC_API_KEY": {
+          "description": "Anthropic API key",
+          "format": "sk-ant-...",
+          "howToObtain": "Anthropic Console > API Keys > Create Key",
+          "estimatedTime": "3 minutes",
+          "isSecret": true
+        }
+      }
+    },
+    "AWS": {
+      "prefix": ["AWS_"],
+      "description": "Amazon Web Services",
+      "dashboardUrl": "https://aws.amazon.com/console/",
+      "vars": {
+        "AWS_ACCESS_KEY_ID": {
+          "description": "AWS access key ID",
+          "format": "AKIA...",
+          "howToObtain": "AWS Console > IAM > Users > your user > Security credentials > Create access key",
+          "estimatedTime": "5 minutes",
+          "isSecret": true
+        },
+        "AWS_SECRET_ACCESS_KEY": {
+          "description": "AWS secret access key",
+          "format": "alphanumeric 40 chars",
+          "howToObtain": "Created together with AWS_ACCESS_KEY_ID",
+          "estimatedTime": "5 minutes",
+          "isSecret": true
+        }
+      }
+    }
+  }
+}

package/dist/config/event-brokers.json

@@ -0,0 +1,63 @@
+{
+  "brokers": [
+    {
+      "id": "kafka",
+      "displayName": "Apache Kafka",
+      "deliveryGuarantee": "at-least-once",
+      "supportsExactlyOnce": true,
+      "exactlyOnceNote": "Requires idempotent producer + transactional API",
+      "dlqSupport": "native-via-retry-topic",
+      "schemaRegistrySupport": true,
+      "schemaRegistryNote": "Confluent Schema Registry or AWS Glue Schema Registry",
+      "detectionPatterns": ["kafka", "confluent", "MSK", "kafkajs", "kafka-node"]
+    },
+    {
+      "id": "rabbitmq",
+      "displayName": "RabbitMQ",
+      "deliveryGuarantee": "at-least-once",
+      "supportsExactlyOnce": false,
+      "dlqSupport": "dead-letter-exchange",
+      "schemaRegistrySupport": false,
+      "detectionPatterns": ["rabbitmq", "amqp", "amqplib"]
+    },
+    {
+      "id": "sqs-sns",
+      "displayName": "AWS SQS / SNS",
+      "deliveryGuarantee": "at-least-once",
+      "supportsExactlyOnce": false,
+      "dlqSupport": "native-sqs-dlq",
+      "schemaRegistrySupport": false,
+      "detectionPatterns": ["sqs", "sns", "@aws-sdk/client-sqs", "@aws-sdk/client-sns"]
+    },
+    {
+      "id": "nats",
+      "displayName": "NATS / NATS JetStream",
+      "deliveryGuarantee": "at-most-once",
+      "supportsExactlyOnce": false,
+      "exactlyOnceNote": "JetStream provides at-least-once; exactly-once requires dedup window",
+      "dlqSupport": "jetstream-nack",
+      "schemaRegistrySupport": false,
+      "detectionPatterns": ["nats", "nats.ws"]
+    },
+    {
+      "id": "eventbridge",
+      "displayName": "AWS EventBridge",
+      "deliveryGuarantee": "at-least-once",
+      "supportsExactlyOnce": false,
+      "dlqSupport": "native-dlq-sqs",
+      "schemaRegistrySupport": true,
+      "schemaRegistryNote": "EventBridge Schema Registry with discovery",
+      "detectionPatterns": ["eventbridge", "@aws-sdk/client-eventbridge"]
+    },
+    {
+      "id": "pubsub",
+      "displayName": "Google Cloud Pub/Sub",
+      "deliveryGuarantee": "at-least-once",
+      "supportsExactlyOnce": false,
+      "dlqSupport": "dead-letter-topic",
+      "schemaRegistrySupport": true,
+      "schemaRegistryNote": "Cloud Pub/Sub Schema validation with Avro or Protocol Buffers",
+      "detectionPatterns": ["@google-cloud/pubsub", "pubsub"]
+    }
+  ]
+}

package/dist/config/hypermedia-tooling.json

@@ -0,0 +1,189 @@
+{
+  "_description": "SPEC-043: Hypermedia & backend-first tooling catalog. Keys are 'framework:language' combos.",
+  "htmx:python": {
+    "frameworks": [
+      {
+        "name": "Django + django-htmx",
+        "description": "Django with django-htmx middleware for HX-Request detection",
+        "install": "pip install django django-htmx",
+        "docsUrl": "https://django-htmx.readthedocs.io/"
+      },
+      {
+        "name": "FastAPI + Jinja2",
+        "description": "FastAPI with Jinja2 template engine for server-rendered fragments",
+        "install": "pip install fastapi jinja2 httpx",
+        "docsUrl": "https://fastapi.tiangolo.com/advanced/templates/"
+      },
+      {
+        "name": "Flask + Jinja2",
+        "description": "Flask with built-in Jinja2 for hypermedia-driven apps",
+        "install": "pip install flask",
+        "docsUrl": "https://flask.palletsprojects.com/en/latest/templating/"
+      }
+    ],
+    "testing": [
+      {
+        "name": "pytest-django",
+        "description": "Test Django views with Django test Client — validates HTML fragments",
+        "install": "pip install pytest-django",
+        "docsUrl": "https://pytest-django.readthedocs.io/"
+      },
+      {
+        "name": "httpx + BeautifulSoup4",
+        "description": "Test FastAPI/Flask endpoints; parse HTML response with bs4",
+        "install": "pip install httpx beautifulsoup4",
+        "docsUrl": "https://www.python-httpx.org/"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "htmx:go": {
+    "frameworks": [
+      {
+        "name": "Chi + html/template",
+        "description": "Chi router with Go's native html/template for typed server-side rendering",
+        "install": "go get github.com/go-chi/chi/v5",
+        "docsUrl": "https://go-chi.io/"
+      },
+      {
+        "name": "Gin + html/template",
+        "description": "Gin framework with native Go templates",
+        "install": "go get github.com/gin-gonic/gin",
+        "docsUrl": "https://gin-gonic.com/"
+      },
+      {
+        "name": "templ",
+        "description": "Type-safe Go HTML templating with compile-time checks",
+        "install": "go install github.com/a-h/templ/cmd/templ@latest",
+        "docsUrl": "https://templ.guide/"
+      }
+    ],
+    "testing": [
+      {
+        "name": "net/http/httptest + goquery",
+        "description": "Standard Go test server with goquery for HTML assertions",
+        "install": "go get github.com/PuerkitoBio/goquery",
+        "docsUrl": "https://pkg.go.dev/github.com/PuerkitoBio/goquery"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "htmx:php": {
+    "frameworks": [
+      {
+        "name": "Laravel + Blade",
+        "description": "Laravel with Blade templates — first-class HTMX support via response fragments",
+        "install": "composer create-project laravel/laravel myapp",
+        "docsUrl": "https://laravel.com/docs/blade"
+      }
+    ],
+    "testing": [
+      {
+        "name": "PHPUnit + Laravel HTTP tests",
+        "description": "Laravel's built-in HTTP testing with assertSee / assertElement for HTML",
+        "install": "composer require --dev phpunit/phpunit",
+        "docsUrl": "https://laravel.com/docs/http-tests"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "htmx:ruby": {
+    "frameworks": [
+      {
+        "name": "Rails + ERB",
+        "description": "Rails with ERB templates and turbo-rails gem for Turbo integration",
+        "install": "gem install rails && bundle add turbo-rails",
+        "docsUrl": "https://turbo.hotwire.dev/"
+      }
+    ],
+    "testing": [
+      {
+        "name": "RSpec + Capybara + rack-test",
+        "description": "RSpec request specs with rack-test for HTTP assertions on HTML responses",
+        "install": "bundle add rspec-rails capybara",
+        "docsUrl": "https://rspec.info/"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "htmx:java": {
+    "frameworks": [
+      {
+        "name": "Spring Boot + Thymeleaf",
+        "description": "Spring Boot with Thymeleaf for server-rendered HTML fragments",
+        "install": "spring init --dependencies=web,thymeleaf myapp",
+        "docsUrl": "https://www.thymeleaf.org/"
+      }
+    ],
+    "testing": [
+      {
+        "name": "Spring MVC Test",
+        "description": "MockMvc for testing Spring MVC controllers and HTML response assertions",
+        "install": "testImplementation 'org.springframework.boot:spring-boot-starter-test'",
+        "docsUrl": "https://docs.spring.io/spring-framework/docs/current/reference/html/testing.html"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "htmx:javascript": {
+    "frameworks": [
+      {
+        "name": "Express + Nunjucks/EJS",
+        "description": "Node.js Express with Nunjucks or EJS for SSR + HTMX fragments",
+        "install": "npm install express nunjucks",
+        "docsUrl": "https://mozilla.github.io/nunjucks/"
+      },
+      {
+        "name": "Hono + JSX",
+        "description": "Hono with JSX renderer for fast SSR hypermedia apps",
+        "install": "npm install hono",
+        "docsUrl": "https://hono.dev/"
+      }
+    ],
+    "testing": [
+      {
+        "name": "Playwright SSR",
+        "description": "Playwright for full-page and fragment HTML assertions in SSR apps",
+        "install": "npm install -D @playwright/test",
+        "docsUrl": "https://playwright.dev/"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "hotwire-turbo:ruby": {
+    "frameworks": [
+      {
+        "name": "Rails + turbo-rails + Stimulus",
+        "description": "Full Hotwire stack: Turbo Frames, Turbo Streams, Stimulus controllers",
+        "install": "bundle add turbo-rails stimulus-rails",
+        "docsUrl": "https://turbo.hotwire.dev/"
+      }
+    ],
+    "testing": [
+      {
+        "name": "RSpec + rack-test",
+        "description": "Test Turbo Stream responses and frame replacements via rack-test",
+        "install": "bundle add rspec-rails",
+        "docsUrl": "https://rspec.info/"
+      }
+    ],
+    "htmxExtensions": []
+  },
+  "_htmxExtensions": {
+    "htmx-ext-json-enc": {
+      "name": "htmx-ext-json-enc",
+      "description": "Send JSON instead of URL-encoded form data",
+      "docsUrl": "https://htmx.org/extensions/json-enc/"
+    },
+    "htmx-ext-ws": {
+      "name": "htmx-ext-ws",
+      "description": "WebSocket extension for real-time HTMX updates",
+      "docsUrl": "https://htmx.org/extensions/ws/"
+    },
+    "htmx-ext-sse": {
+      "name": "htmx-ext-sse",
+      "description": "Server-Sent Events for push-based HTMX updates",
+      "docsUrl": "https://htmx.org/extensions/sse/"
+    }
+  }
+}