few shots update

.ai/shots/backend_route.py

@@ -1,14 +1,18 @@
-# [DEF:Shot:FastAPI_Route:Example]
+# [DEF:BackendRouteShot:Module]
+# @TIER: STANDARD
+# @SEMANTICS: Route, Task, API, Async
 # @PURPOSE: Reference implementation of a task-based route using GRACE-Poly.
+# @LAYER: Interface (API)
 # @RELATION: IMPLEMENTS -> [DEF:Std:API_FastAPI]
+# @INVARIANT: TaskManager must be available in dependency graph.
 
-from typing import List, Dict, Any, Optional
+from typing import Dict, Any
 from fastapi import APIRouter, Depends, HTTPException, status
 from pydantic import BaseModel
 from ...core.logger import belief_scope
 from ...core.task_manager import TaskManager, Task
 from ...core.config_manager import ConfigManager
-from ...dependencies import get_task_manager, get_config_manager, has_permission, get_current_user
+from ...dependencies import get_task_manager, get_config_manager, get_current_user
 
 router = APIRouter()
 
@@ -21,37 +25,41 @@ class CreateTaskRequest(BaseModel):
 # @PURPOSE: Create and start a new task using TaskManager. Non-blocking.
 # @PARAM: request (CreateTaskRequest) - Plugin and params.
 # @PARAM: task_manager (TaskManager) - Async task executor.
-# @PARAM: config (ConfigManager) - Centralized configuration.
-# @PRE: plugin_id must exist; config must be initialized.
+# @PRE: plugin_id must match a registered plugin.
 # @POST: A new task is spawned; Task ID returned immediately.
+# @SIDE_EFFECT: Writes to DB, Trigger background worker.
 async def create_task(
     request: CreateTaskRequest,
     task_manager: TaskManager = Depends(get_task_manager),
     config: ConfigManager = Depends(get_config_manager),
     current_user = Depends(get_current_user)
 ):
-    # RBAC: Dynamic permission check
-    has_permission(f"plugin:{request.plugin_id}", "EXECUTE")(current_user)
-    
+    # Context Logging
     with belief_scope("create_task"):
         try:
-            # 1. Action: Resolve setting using ConfigManager (Example)
+            # 1. Action: Configuration Resolution
             timeout = config.get("TASKS_DEFAULT_TIMEOUT", 3600)
 
-            # 2. Action: Spawn async task via TaskManager
+            # 2. Action: Spawn async task
             # @RELATION: CALLS -> task_manager.create_task
             task = await task_manager.create_task(
                 plugin_id=request.plugin_id,
                 params={**request.params, "timeout": timeout}
             )
             return task
+            
+        except ValueError as e:
+             # 3. Recovery: Domain logic error mapping
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST, 
+                detail=str(e)
+            )
         except Exception as e:
-            # Evaluation: Proper error mapping and logging
-            # @UX_STATE: Error feedback to frontend
+            # @UX_STATE: Error feedback -> 500 Internal Error
             raise HTTPException(
                 status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, 
-                detail=f"Task creation failed: {str(e)}"
+                detail="Internal Task Spawning Error"
             )
 # [/DEF:create_task:Function]
 
-# [/DEF:Shot:FastAPI_Route]
+# [/DEF:BackendRouteShot:Module]