refactor(plugins): rename recommendationProvider to userRecommendationProvider across codebase

Align the recommendation capability name with the established convention
where user-scoped plugin capabilities use the "user" prefix (matching
userReadSync), while system-level capabilities like metadataProvider
do not. Updates Rust backend, TypeScript SDK, plugin examples, frontend
components, tests, documentation, and regenerated OpenAPI types.

Author: AshDevFr

docs/api/openapi.json

@@ -31999,14 +31999,14 @@
         "description": "Plugin capabilities for display (user plugin context)",
         "required": [
           "readSync",
-          "recommendationProvider"
+          "userRecommendationProvider"
         ],
         "properties": {
           "readSync": {
             "type": "boolean",
             "description": "Can sync reading progress"
           },
-          "recommendationProvider": {
+          "userRecommendationProvider": {
             "type": "boolean",
             "description": "Can provide recommendations"
           }

docs/dev/plugins/sdk.md

@@ -191,7 +191,7 @@ interface PluginManifest {
 interface PluginCapabilities {
   seriesMetadataProvider?: boolean;
   syncProvider?: boolean;
-  recommendationProvider?: boolean;
+  userRecommendationProvider?: boolean;
 }
 
 interface CredentialField {

docs/dev/plugins/writing-plugins.md

@@ -178,7 +178,7 @@ interface PluginManifest {
   capabilities: {
     metadataProvider?: MetadataContentType[];  // Content types: ["series"] or ["series", "book"]
     syncProvider?: boolean;                     // Can sync reading progress (future)
-    recommendationProvider?: boolean;           // Can provide recommendations (future)
+    userRecommendationProvider?: boolean;       // Can provide recommendations (future)
   };
 
   // Optional

plugins/recommendations-anilist/src/manifest.ts

@@ -11,7 +11,7 @@ export const manifest = {
   homepage: "https://github.com/AshDevFr/codex",
   protocolVersion: "1.0",
   capabilities: {
-    recommendationProvider: true,
+    userRecommendationProvider: true,
   },
   requiredCredentials: [
     {
@@ -37,5 +37,5 @@ export const manifest = {
     ],
   },
 } as const satisfies PluginManifest & {
-  capabilities: { recommendationProvider: true };
+  capabilities: { userRecommendationProvider: true };
 };

plugins/sdk-typescript/src/server.ts

@@ -566,9 +566,9 @@ export function createSyncPlugin(options: SyncPluginOptions): void {
  * Options for creating a recommendation provider plugin
  */
 export interface RecommendationPluginOptions {
-  /** Plugin manifest - must have capabilities.recommendationProvider: true */
+  /** Plugin manifest - must have capabilities.userRecommendationProvider: true */
   manifest: PluginManifest & {
-    capabilities: { recommendationProvider: true };
+    capabilities: { userRecommendationProvider: true };
   };
   /** RecommendationProvider implementation */
   provider: RecommendationProvider;

plugins/sdk-typescript/src/types/capabilities.ts

@@ -223,7 +223,7 @@ export interface SyncProvider {
  * Plugins implementing this capability generate personalized suggestions
  * based on a user's library and reading history.
  *
- * Declare this capability in the plugin manifest with `recommendationProvider: true`.
+ * Declare this capability in the plugin manifest with `userRecommendationProvider: true`.
  */
 export interface RecommendationProvider {
   /** Get personalized recommendations */

plugins/sdk-typescript/src/types/manifest.ts

@@ -45,7 +45,7 @@ export interface PluginCapabilities {
    */
   externalIdSource?: string;
   /** Can provide recommendations */
-  recommendationProvider?: boolean;
+  userRecommendationProvider?: boolean;
 }
 
 /**

src/api/routes/v1/dto/user_plugins.rs

@@ -96,7 +96,7 @@ pub struct UserPluginCapabilitiesDto {
     /// Can sync reading progress
     pub read_sync: bool,
     /// Can provide recommendations
-    pub recommendation_provider: bool,
+    pub user_recommendation_provider: bool,
 }
 
 /// Request to update user plugin configuration

src/api/routes/v1/handlers/recommendations.rs

@@ -52,7 +52,7 @@ async fn find_recommendation_plugin(
                 .manifest
                 .as_ref()
                 .and_then(|m| serde_json::from_value::<PluginManifest>(m.clone()).ok())
-                .map(|m| m.capabilities.recommendation_provider)
+                .map(|m| m.capabilities.user_recommendation_provider)
                 .unwrap_or(false);
 
             if is_rec_provider {

src/api/routes/v1/handlers/user_plugins.rs

@@ -181,9 +181,9 @@ pub async fn list_user_plugins(
                         .as_ref()
                         .map(|m| m.capabilities.user_read_sync)
                         .unwrap_or(false),
-                    recommendation_provider: manifest
+                    user_recommendation_provider: manifest
                         .as_ref()
-                        .map(|m| m.capabilities.recommendation_provider)
+                        .map(|m| m.capabilities.user_recommendation_provider)
                         .unwrap_or(false),
                 },
             }