few shots update

.ai/shots/plugin_example.py

@@ -9,15 +9,19 @@
 from typing import Dict, Any, Optional
 from ..core.plugin_base import PluginBase
 from ..core.task_manager.context import TaskContext
+# GRACE: Обязательный импорт семантического логгера
+from ..core.logger import logger, belief_scope
 
+# [DEF:ExamplePlugin:Class]
+# @PURPOSE: A sample plugin to demonstrate execution context and logging.
 class ExamplePlugin(PluginBase):
     @property
     def id(self) -> str:
         return "example-plugin"
 
-    # [DEF:get_schema:Function]
+    #[DEF:get_schema:Function]
     # @PURPOSE: Defines input validation schema.
-    # @POST: Returns dict compliant with JSON Schema draft 7.
+    # @DATA_CONTRACT: Input -> None, Output -> Dict (JSON Schema draft 7)
     def get_schema(self) -> Dict[str, Any]:
         return {
             "type": "object",
@@ -29,36 +33,43 @@ class ExamplePlugin(PluginBase):
             },
             "required": ["message"],
         }
-    # [/DEF:get_schema:Function]
+    #[/DEF:get_schema:Function]
 
     # [DEF:execute:Function]
     # @PURPOSE: Core plugin logic with structured logging and scope isolation.
-    # @PARAM: params (Dict) - Validated input parameters.
-    # @PARAM: context (TaskContext) - Execution tools (log, progress).
-    # @SIDE_EFFECT: Emits logs to centralized system.
-    async def execute(self, params: Dict, context: Optional = None):
-        message = params
+    # @DATA_CONTRACT: Input -> (params: Dict, context: Optional[TaskContext]), Output -> None
+    # @PRE: params must be validated against get_schema() before calling.
+    # @POST: Plugin payload is processed; progress is reported if context exists.
+    # @SIDE_EFFECT: Emits logs to centralized system and TaskContext.
+    async def execute(self, params: Dict, context: Optional[TaskContext] = None):
+        message = params.get("message", "Fallback")
         
-        # 1. Action: System-level tracing (Rule VI)
-        with belief_scope("example_plugin_exec") as b_scope:
+        # GRACE: Изоляция мыслей ИИ в Thread-Local scope
+        with belief_scope("example_plugin_exec"):
             if context:
-                # Task Logs: Пишем в пользовательский контекст выполнения задачи
                 # @RELATION: BINDS_TO -> context.logger
                 log = context.logger.with_source("example_plugin")
                 
-                b_scope.logger.info("Using provided TaskContext") # System log
-                log.info("Starting execution", data={"msg": message}) # Task log
+                # GRACE: [REASON] - Системный лог (Внутренняя мысль)
+                logger.reason("TaskContext provided. Binding task logger.", extra={"msg": message})
                 
-                # 2. Action: Progress Reporting
+                # Task Logs: Бизнес-логи (Уйдут в БД/Вебсокет пользователю)
+                log.info("Starting execution", extra={"msg": message})
                 log.progress("Processing...", percent=50)
-                
-                # 3. Action: Finalize
                 log.info("Execution completed.")
+                
+                # GRACE: [REFLECT] - Сверка успешного выхода
+                logger.reflect("Context execution finalized successfully")
             else:
-                # Standalone Fallback: Замыкаемся на системный scope
-                b_scope.logger.warning("No TaskContext provided. Running standalone.")
-                b_scope.logger.info("Standalone execution", data={"msg": message})
-                print(f"Standalone: {message}")
+                # GRACE:[EXPLORE] - Фолбэк ветка (Отклонение от нормы)
+                logger.explore("No TaskContext provided. Running standalone.")
+                
+                # Standalone Fallback
+                print(f"Standalone execution: {message}")
+                
+                # GRACE: [REFLECT] - Сверка выхода фолбэка
+                logger.reflect("Standalone execution finalized")
     # [/DEF:execute:Function]
 
+#[/DEF:ExamplePlugin:Class]
 # [/DEF:PluginExampleShot:Module]