feat(discovery): add HTTP polling-based service discovery configuration

- Introduced HTTPConfig struct for HTTP polling-based discovery settings.
- Updated Config struct to include HTTPConfig.
- Implemented push and deregister functionality to a specified gateway URL.
- Enhanced service registration and deregistration logging.
- Added support for default tags in OpenAPI schema generation, making fields with default values implicitly optional.
- Updated tests to verify behavior of default tags and their precedence over required and optional tags.

Author: juicycleff

app_impl.go

@@ -667,11 +667,12 @@ func (a *app) Run() error {
 
 	// Create HTTP server
 	a.httpServer = &http.Server{
-		Addr:         a.config.HTTPAddress,
-		Handler:      a.router,
-		ReadTimeout:  a.config.HTTPTimeout,
-		WriteTimeout: a.config.HTTPTimeout,
-		IdleTimeout:  a.config.HTTPTimeout * 2,
+		Addr:              a.config.HTTPAddress,
+		Handler:           a.router,
+		ReadTimeout:       a.config.HTTPTimeout,
+		ReadHeaderTimeout: 10 * time.Second,
+		WriteTimeout:      a.config.HTTPTimeout,
+		IdleTimeout:       a.config.HTTPTimeout * 2,
 	}
 
 	// Print startup banner

cmd/forge/go.mod

@@ -89,7 +89,7 @@ require (
 	github.com/xdg-go/scram v1.1.2 // indirect
 	github.com/xdg-go/stringprep v1.0.4 // indirect
 	github.com/xraph/confy v0.1.0 // indirect
-	github.com/xraph/go-utils v1.0.0 // indirect
+	github.com/xraph/go-utils v1.1.0 // indirect
 	github.com/xraph/vessel v1.0.0 // indirect
 	github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 // indirect
 	go.mongodb.org/mongo-driver v1.17.4 // indirect

cmd/forge/go.sum

@@ -306,8 +306,8 @@ github.com/xdg-go/stringprep v1.0.4 h1:XLI/Ng3O1Atzq0oBs3TWm+5ZVgkq2aqdlvP9JtoZ6
 github.com/xdg-go/stringprep v1.0.4/go.mod h1:mPGuuIYwz7CmR2bT9j4GbQqutWS1zV24gijq1dTyGkM=
 github.com/xraph/confy v0.1.0 h1:dAdI/ShnkU5PEXVsfR86swoWj6XjJ37BdPQpBIUmg9M=
 github.com/xraph/confy v0.1.0/go.mod h1:/uhVfKibPR+kn7MI9LkVVekk84NP0sxsKZ9sFQoQ5Kc=
-github.com/xraph/go-utils v1.0.0 h1:P1jOvtDlC5xZyGtnIhypFfPUBgpfyrwESY4TK4P2I5g=
-github.com/xraph/go-utils v1.0.0/go.mod h1:yp+PD9dXSA7tA9Pxmuveg5E7Ht1iHIVov8yMvanMG7U=
+github.com/xraph/go-utils v1.1.0 h1:bPO4C/mwm0I5ZZa3RxbwUqKhy3Vnxvm3s98vmX8CrjY=
+github.com/xraph/go-utils v1.1.0/go.mod h1:tZN4SuGy9otCo6dETp7Cvkgyiy0BvaJaZbTBv4Euvo4=
 github.com/xraph/vessel v1.0.0 h1:n2q30d0OGPENpFfmOUgEuS99Y+X6b6WTfzdOHiE4Ds0=
 github.com/xraph/vessel v1.0.0/go.mod h1:quT3UWDXZF0RLL34H3ijXP9kVnh2pdfnn0f2s3ezChA=
 github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78 h1:ilQV1hzziu+LLM3zUTJ0trRztfwgjqKnBWNtSRkbmwM=

docs/content/blog/gateway-configuration.mdx

@@ -8,6 +8,12 @@ tags: [gateway, load-balancing, circuit-breaker, production]
 coverGradient: "from-cyan-500/20 via-blue-500/10 to-transparent"
 ---
 
+import { Callout } from 'fumadocs-ui/components/callout';
+
+<Callout type="warn" title="Deprecated">
+The Gateway extension is deprecated. Please use **Bastion** instead, which provides a more robust API gateway with improved performance and scalability.
+</Callout>
+
 ## Why a Built-In Gateway
 
 Most Go services eventually need a reverse proxy, rate limiter, or circuit breaker in front of their upstream dependencies. Instead of deploying a separate Nginx, Envoy, or Kong instance, Forge ships a gateway extension that runs in-process — same binary, same observability, same configuration system.

docs/content/docs/extensions/ai/index.mdx

@@ -4,6 +4,19 @@ description: Implementation-accurate guide for the Forge AI extension
 ---
 
 import { Cards, Card } from 'fumadocs-ui/components/card';
+import { Callout } from 'fumadocs-ui/components/callout';
+
+<Callout type="warn" title="Deprecated">
+The AI extension is deprecated and will be removed in a future release. It has been replaced by a family of specialized extensions:
+
+- **Cortex** — LLM abstraction and agent orchestration
+- **Shield** — AI guardrails and content filtering
+- **Sentinel** — AI monitoring and observability
+- **Weave** — RAG pipelines and workflow orchestration
+- **Nexus** — AI model hub and inference management
+
+Please migrate to these extensions for new projects.
+</Callout>
 
 ## Overview
 

docs/content/docs/extensions/complete-catalog.mdx

@@ -7,17 +7,17 @@ All extension modules currently available in `extensions/*` in this repository:
 
 | Extension | Docs | Package |
 |---|---|---|
-| AI | `/docs/extensions/ai` | `github.com/xraph/forge/extensions/ai` |
+| AI (Deprecated) | `/docs/extensions/ai` | `github.com/xraph/forge/extensions/ai` — use Cortex, Shield, Sentinel, Weave, Nexus instead |
 | Auth | `/docs/extensions/auth` | `github.com/xraph/forge/extensions/auth` |
 | Cache | `/docs/extensions/cache` | `github.com/xraph/forge/extensions/cache` |
 | Consensus | `/docs/extensions/consensus` | `github.com/xraph/forge/extensions/consensus` |
 | Cron | `/docs/extensions/cron` | `github.com/xraph/forge/extensions/cron` |
 | Dashboard | `/docs/extensions/dashboard` | `github.com/xraph/forge/extensions/dashboard` |
-| Database | `/docs/extensions/database` | `github.com/xraph/forge/extensions/database` |
+| Database (Deprecated) | `/docs/extensions/database` | `github.com/xraph/forge/extensions/database` — use Grove instead |
 | Discovery | `/docs/extensions/discovery` | `github.com/xraph/forge/extensions/discovery` |
 | Events | `/docs/extensions/events` | `github.com/xraph/forge/extensions/events` |
 | Features | `/docs/extensions/features` | `github.com/xraph/forge/extensions/features` |
-| Gateway | `/docs/extensions/gateway` | `github.com/xraph/forge/extensions/gateway` |
+| Gateway (Deprecated) | `/docs/extensions/gateway` | `github.com/xraph/forge/extensions/gateway` — use Bastion instead |
 | GraphQL | `/docs/extensions/graphql` | `github.com/xraph/forge/extensions/graphql` |
 | gRPC | `/docs/extensions/grpc` | `github.com/xraph/forge/extensions/grpc` |
 | HLS | `/docs/extensions/hls` | `github.com/xraph/forge/extensions/hls` |
@@ -28,7 +28,7 @@ All extension modules currently available in `extensions/*` in this repository:
 | Queue | `/docs/extensions/queue` | `github.com/xraph/forge/extensions/queue` |
 | Search | `/docs/extensions/search` | `github.com/xraph/forge/extensions/search` |
 | Security | `/docs/extensions/security` | `github.com/xraph/forge/extensions/security` |
-| Storage | `/docs/extensions/storage` | `github.com/xraph/forge/extensions/storage` |
+| Storage (Deprecated) | `/docs/extensions/storage` | `github.com/xraph/forge/extensions/storage` — use Trove instead |
 | Streaming | `/docs/extensions/streaming` | `github.com/xraph/forge/extensions/streaming` |
 | WebRTC | `/docs/extensions/webrtc` | `github.com/xraph/forge/extensions/webrtc` |
 

docs/content/docs/extensions/database/index.mdx

@@ -4,6 +4,11 @@ description: Implementation-accurate guide for Forge database extension
 ---
 
 import { Cards, Card } from 'fumadocs-ui/components/card';
+import { Callout } from 'fumadocs-ui/components/callout';
+
+<Callout type="warn" title="Deprecated">
+The Database extension is deprecated and will be removed in a future release. Please migrate to **Grove**, which provides an improved database layer with better performance, more drivers, and enhanced query capabilities.
+</Callout>
 
 ## Overview
 

docs/content/docs/extensions/gateway/index.mdx

@@ -4,6 +4,11 @@ description: API gateway with FARP service discovery, multi-protocol proxying, a
 ---
 
 import { Cards, Card } from 'fumadocs-ui/components/card';
+import { Callout } from 'fumadocs-ui/components/callout';
+
+<Callout type="warn" title="Deprecated">
+The Gateway extension is deprecated and will be removed in a future release. Please migrate to **Bastion**, which provides a more robust API gateway with improved performance, enhanced security, and better scalability for production workloads.
+</Callout>
 
 ## Overview
 

docs/content/docs/extensions/index.mdx

@@ -23,7 +23,7 @@ All extension packages and import paths in one reference.
 
 <Cards>
 <Card title="Data and Storage" href="/docs/extensions/database">
-Database, cache, search, and object/file storage.
+Grove (database), cache, search, and Trove (object storage). Legacy Database and Storage extensions are deprecated.
 </Card>
 <Card title="Messaging" href="/docs/extensions/events">
 Events, queue workers, Kafka, and MQTT.
@@ -35,12 +35,12 @@ gRPC, GraphQL, oRPC, and MCP transport surfaces.
 Streaming, WebRTC, and HLS for real-time systems.
 </Card>
 <Card title="Platform and Infrastructure" href="/docs/extensions/gateway">
-Gateway, discovery, scheduling, operations UI, and consensus.
+Bastion (API gateway), discovery, scheduling, operations UI, and consensus. Legacy Gateway extension is deprecated.
 </Card>
 <Card title="Security and Access" href="/docs/extensions/auth">
 Authentication, security controls, and feature flags.
 </Card>
 <Card title="AI" href="/docs/extensions/ai">
-AI SDK integration, agent workflows, and inference/training surfaces.
+Cortex, Shield, Sentinel, Weave, and Nexus. Legacy AI extension is deprecated.
 </Card>
 </Cards>

docs/content/docs/extensions/storage/index.mdx

@@ -4,6 +4,11 @@ description: Unified object storage with S3, GCS, Azure, and local filesystem ba
 ---
 
 import { Cards, Card } from 'fumadocs-ui/components/card';
+import { Callout } from 'fumadocs-ui/components/callout';
+
+<Callout type="warn" title="Deprecated">
+The Storage extension is deprecated and will be removed in a future release. Please migrate to **Trove**, which provides an improved object storage layer with additional backends and enhanced capabilities.
+</Callout>
 
 ## Overview