feat(gateway): implement Phase 1 connector API endpoints

[TelivANT]

📡 Phase 1 Connector API Implementation

✅ Implemented Endpoints

1. GET /v1/wiki/connectors

List all available connector types with metadata:

• Connector type and name
• Field definitions (name, type, required, options)
• Sensitive field marking
• Authentication requirements

Currently supports: Local, Git, S3 (more to be added)

2. POST /v1/wiki/connectors/test

Test connection with provided credentials:

• Validates connector configuration
• Returns connector ID (UUID v7)
• Returns connection metadata
• Error handling with error codes

Status: Basic structure (TODO: actual testing logic)

3. POST /v1/wiki/connectors/browse

Browse directory structure:

• Lists files and directories
• Returns file metadata (size, type, modified time)
• Supports nested navigation

Status: Basic structure (TODO: actual browsing logic)

🔧 Technical Details

UUID v7:

• Time-sortable UUIDs for connector IDs
• Better for database indexing
• Maintains chronological order

Data Structures:

ConnectorMetadata {
    type, name, description,
    auth_required, fields[]
}

ConnectorField {
    name, type, required,
    default, options, sensitive,
    description
}

Field Types:

• string, enum, boolean
• Sensitive marking for credentials
• Optional with defaults
• Enum with predefined options

📊 Code Stats

• wiki_connector.rs: 240 lines
• 3 API endpoints
• 8 data structures

🎯 Implementation Status

Phase 1 (This PR):

• ✅ API structure defined
• ✅ Routes integrated
• ✅ Metadata endpoint complete
• ⏳ Test/Browse endpoints (stubs)

Phase 2 (Next):

• Connector instantiation
• Actual connection testing
• Directory browsing implementation
• Session management

🧪 Testing

Manual Test:

# List connectors
curl http://localhost:3000/v1/wiki/connectors

# Test connection
curl -X POST http://localhost:3000/v1/wiki/connectors/test \
  -H "Content-Type: application/json" \
  -d '{
    "type": "git",
    "config": {
      "url": "https://github.com/user/repo.git",
      "auth_type": "token",
      "token": "ghp_xxx"
    }
  }'

📋 Next Steps

1. Implement connector instantiation from config
2. Implement actual connection testing
3. Implement directory browsing with storage connectors
4. Add session management for browsing
5. Add credential encryption

🔗 Related

• Design doc: docs/STORAGE_CONNECTOR_API.md
• Storage connectors: crates/memoryos-wiki-gen/src/storage/
• PR feat(wiki-gen): implement P0 storage connectors (Local + Git) #28, feat(wiki-gen): implement S3 and WebDAV connectors (P0 complete) #29, feat(wiki-gen): implement P1 storage connectors (OSS, COS, OBS, SFTP) #30: Storage connector implementations