Skip to content

Commit 1e73ef8

Browse files
author
Lasim
committed
docs: Remove legacy device management documentation and update related links for clarity
1 parent f7edc37 commit 1e73ef8

14 files changed

+15
-362
lines changed

docs/development/backend/gateway-client-config.mdx

Lines changed: 0 additions & 78 deletions
This file was deleted.

docs/development/backend/oauth2-server.mdx

Lines changed: 0 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,6 @@ PKCE provides security for public clients (like CLI tools and MCP clients):
7272
Manages the authorization flow:
7373

7474
#### Client Validation
75-
- Validates static clients against whitelist (`deploystack-gateway-cli`)
7675
- Validates dynamic clients against database (`dynamic_oauth_clients` table)
7776
- Supports both pre-registered and dynamically registered clients
7877
- Extensible for additional client types
@@ -262,17 +261,6 @@ Scopes are enforced at the endpoint level:
262261

263262
## Client Types and Configuration
264263

265-
### Static Clients (Pre-registered)
266-
267-
**DeployStack Gateway CLI:**
268-
- **Client ID**: `deploystack-gateway-cli`
269-
- **Client Type**: Public (no secret)
270-
- **Redirect URIs**:
271-
- `http://localhost:8976/oauth/callback`
272-
- `http://127.0.0.1:8976/oauth/callback`
273-
- **Required**: PKCE with SHA256
274-
- **Token Lifetime**: 1-hour access, 30-day refresh
275-
276264
### Dynamic Clients (RFC 7591)
277265

278266
**VS Code MCP Extension:**
@@ -457,7 +445,6 @@ The backend validates OAuth scopes to control API access. Scope configuration mu
457445

458446
For the current list of supported scopes, check the source code at:
459447
- **Backend validation**: `services/backend/src/services/oauth/authorizationService.ts` in the `validateScope()` method
460-
- **Gateway requests**: `services/gateway/src/utils/auth-config.ts` in the `scopes` array
461448

462449
### Adding New Scopes
463450

@@ -519,18 +506,6 @@ server.get('/api/another-endpoint', {
519506

520507
Always coordinate scope changes between backend and client implementations.
521508

522-
## Gateway Integration
523-
524-
The OAuth2 server integrates with the DeployStack Gateway:
525-
526-
### Gateway OAuth Client
527-
528-
See [Gateway OAuth Implementation](/development/gateway/oauth) for:
529-
- Client-side PKCE generation
530-
- Browser integration
531-
- Callback server
532-
- Token storage
533-
- Automatic refresh
534509

535510
## MCP Client Integration
536511

@@ -576,7 +551,6 @@ The OAuth2 server supports MCP clients through dynamic registration:
576551
## Related Documentation
577552

578553
- [Backend Authentication System](/development/backend/auth) - Core authentication
579-
- [Gateway OAuth Implementation](/development/gateway/oauth) - Client-side OAuth
580554
- [Satellite OAuth Authentication](/development/satellite/oauth-authentication) - MCP client authentication
581555
- [Security Policy](/development/backend/security) - Security details
582556
- [API Documentation](/development/backend/api) - API reference

docs/development/backend/plugins.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -444,7 +444,7 @@ class MyPlugin implements Plugin {
444444
}
445445
```
446446

447-
For complete event documentation, see the [Global Event Bus](./events) guide.
447+
For complete event documentation, see the [Global Event Bus](/development/backend/events) guide.
448448

449449
### Access to Core Services
450450

docs/development/backend/satellite-communication.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -475,7 +475,7 @@ sqlite3 services/backend/persistent_data/database/deploystack.db
475475

476476
## API Documentation
477477

478-
For detailed API endpoints, request/response formats, and authentication patterns, see the [API Specification](../../api-spec) generated from the backend OpenAPI schema.
478+
For detailed API endpoints, request/response formats, and authentication patterns, see the [API Specification](/development/backend/api) generated from the backend OpenAPI schema.
479479

480480
## Related Documentation
481481

docs/development/satellite/architecture.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ MCP Client Satellite
113113
- `resources/templates/list` - List resource templates (returns empty array)
114114
- `prompts/list` - List available prompts (returns empty array)
115115

116-
For detailed information about tool discovery and execution, see [Tool Discovery Implementation](./tool-discovery).
116+
For detailed information about tool discovery and execution, see [Tool Discovery Implementation](/development/satellite/tool-discovery).
117117

118118
**Error Handling:**
119119
- JSON-RPC 2.0 compliant error responses
@@ -286,7 +286,7 @@ Satellite Backend
286286
- **Error Recovery**: Exponential backoff with maximum 5-minute intervals
287287
- **3-Second Response Time**: Immediate priority commands enable near real-time responses
288288

289-
For complete implementation details, see [Backend Polling Implementation](./polling).
289+
For complete implementation details, see [Backend Polling Implementation](/development/satellite/polling).
290290

291291
## Security Architecture
292292

@@ -375,7 +375,7 @@ Configuration → Spawn → Monitor → Health Check → Restart/Terminate
375375
- **Status Reporting**: Real-time metrics and health
376376
- **Command Processing**: Execute Backend commands
377377

378-
For detailed information about the polling implementation, see [Backend Polling Implementation](./polling).
378+
For detailed information about the polling implementation, see [Backend Polling Implementation](/development/satellite/polling).
379379

380380
### Phase 5: Enterprise Features
381381
- **OAuth 2.1 Authentication**: Full authentication server

docs/development/satellite/mcp-transport.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ data: {"timestamp": "2025-01-09T13:30:00.000Z"}
126126
- `tools/list` - List available tools from remote MCP servers
127127
- `tools/call` - Execute tools on remote MCP servers
128128

129-
For detailed information about tool discovery and execution, see [Tool Discovery Implementation](./tool-discovery).
129+
For detailed information about tool discovery and execution, see [Tool Discovery Implementation](/development/satellite/tool-discovery).
130130

131131
### Resources
132132
- `resources/list` - List available resources (returns empty array)
@@ -246,4 +246,4 @@ All transport protocols generate structured logs with:
246246
- Error conditions
247247
- Performance metrics
248248

249-
See [Logging Documentation](./logging) for detailed log format specifications.
249+
See [Logging Documentation](/development/satellite/logging) for detailed log format specifications.

docs/development/satellite/oauth-authentication.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ MCP Client Satellite Backend
5858
- Team-aware `tools/call` - validates team access before execution
5959
- Integrates with existing tool discovery and configuration systems
6060

61-
For detailed team isolation implementation, see [Team Isolation Implementation](./team-isolation).
61+
For detailed team isolation implementation, see [Team Isolation Implementation](/development/satellite/team-isolation).
6262

6363
**Dynamic Client Support:**
6464
- Supports RFC 7591 dynamically registered clients

docs/development/satellite/team-isolation.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { Callout } from 'fumadocs-ui/components/callout';
1010

1111
DeployStack Satellite implements OAuth 2.1 Resource Server-based team isolation to provide secure multi-tenant access to MCP servers. This system ensures complete separation of team resources while maintaining a unified MCP client interface.
1212

13-
For OAuth authentication details, see [OAuth Authentication Implementation](./oauth-authentication). For tool discovery mechanics, see [Tool Discovery Implementation](./tool-discovery).
13+
For OAuth authentication details, see [OAuth Authentication Implementation](/development/satellite/oauth-authentication). For tool discovery mechanics, see [Tool Discovery Implementation](/development/satellite/tool-discovery).
1414

1515
## Technical Architecture
1616

@@ -279,8 +279,8 @@ Team isolation maintains full MCP client compatibility:
279279

280280
## Related Documentation
281281

282-
- [OAuth Authentication Implementation](./oauth-authentication) - OAuth 2.1 Resource Server details
283-
- [Tool Discovery Implementation](./tool-discovery) - Tool caching and namespacing mechanics
284-
- [Satellite Architecture Design](./architecture) - Overall satellite architecture
285-
- [Backend Communication](./backend-communication) - Backend integration patterns
282+
- [OAuth Authentication Implementation](/development/satellite/oauth-authentication) - OAuth 2.1 Resource Server details
283+
- [Tool Discovery Implementation](/development/satellite/tool-discovery) - Tool caching and namespacing mechanics
284+
- [Satellite Architecture Design](/development/satellite/architecture) - Overall satellite architecture
285+
- [Backend Communication](/development/satellite/backend-communication) - Backend integration patterns
286286
- [Backend OAuth2 Server Implementation](/development/backend/oauth2-server) - OAuth server implementation

docs/development/satellite/tool-discovery.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { Callout } from 'fumadocs-ui/components/callout';
1010

1111
DeployStack Satellite implements automatic tool discovery from remote HTTP MCP servers, providing dynamic tool availability without manual configuration. This system enables MCP clients to discover and execute tools from external MCP servers through the satellite's proxy layer.
1212

13-
For information about the overall satellite architecture, see [Satellite Architecture Design](./architecture). For details about the MCP transport protocols that expose discovered tools, see [MCP Transport Protocols](./mcp-transport).
13+
For information about the overall satellite architecture, see [Satellite Architecture Design](/development/satellite/architecture). For details about the MCP transport protocols that expose discovered tools, see [MCP Transport Protocols](/development/satellite/mcp-transport).
1414

1515
## Technical Overview
1616

@@ -170,7 +170,7 @@ Internal Server: "context7-john-R36no6FGoMFEZO9nWJJLT"
170170
- **Internal Routing**: Uses full server name for team isolation
171171
- **Uniqueness**: Guaranteed unique names across all servers
172172

173-
For team-based server resolution, see [Team Isolation Implementation](./team-isolation).
173+
For team-based server resolution, see [Team Isolation Implementation](/development/satellite/team-isolation).
174174

175175
## SSE Response Processing
176176

docs/device-management.mdx

Lines changed: 0 additions & 139 deletions
This file was deleted.

0 commit comments

Comments
 (0)