few shots update

.ai/shots/plugin_example.py

@@ -1,6 +1,10 @@
-# [DEF:Shot:Plugin_Example:Example]
+# [DEF:PluginExampleShot:Module]
+# @TIER: STANDARD
+# @SEMANTICS: Plugin, Core, Extension
 # @PURPOSE: Reference implementation of a plugin following GRACE standards.
-# @RELATION: IMPLEMENTS -> [DEF:Std:Plugin]
+# @LAYER: Domain (Business Logic)
+# @RELATION: INHERITS -> PluginBase
+# @INVARIANT: get_schema must return valid JSON Schema.
 
 from typing import Dict, Any, Optional
 from ..core.plugin_base import PluginBase
@@ -11,28 +15,15 @@ class ExamplePlugin(PluginBase):
     def id(self) -> str:
         return "example-plugin"
 
-    @property
-    def name(self) -> str:
-        return "Example Plugin"
-
-    @property
-    def description(self) -> str:
-        return "A simple plugin that demonstrates structured logging and progress tracking."
-
-    @property
-    def version(self) -> str:
-        return "1.0.0"
-
     # [DEF:get_schema:Function]
     # @PURPOSE: Defines input validation schema.
+    # @POST: Returns dict compliant with JSON Schema draft 7.
     def get_schema(self) -> Dict[str, Any]:
         return {
             "type": "object",
             "properties": {
                 "message": {
                     "type": "string",
-                    "title": "Message",
-                    "description": "A message to log.",
                     "default": "Hello, GRACE!",
                 }
             },
@@ -41,27 +32,33 @@ class ExamplePlugin(PluginBase):
     # [/DEF:get_schema:Function]
 
     # [DEF:execute:Function]
-    # @PURPOSE: Core plugin logic with structured logging and progress reporting.
+    # @PURPOSE: Core plugin logic with structured logging and scope isolation.
     # @PARAM: params (Dict) - Validated input parameters.
-    # @PARAM: context (TaskContext) - Execution context with logging and progress tools.
-    async def execute(self, params: Dict[str, Any], context: Optional[TaskContext] = None):
-        message = params["message"]
+    # @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
         
-        # 1. Action: Structured Logging with Source Attribution
-        if context:
-            log = context.logger.with_source("example_plugin")
-            log.info(f"Starting execution with message: {message}")
-
-            # 2. Action: Progress Reporting
-            log.progress("Processing step 1...", percent=25)
-            # Simulating some async work...
-            # await some_async_op()
-
-            log.progress("Processing step 2...", percent=75)
-            log.info("Execution completed successfully.")
-        else:
-            # Fallback for manual/standalone execution
-            print(f"Standalone execution: {message}")
+        # 1. Action: System-level tracing (Rule VI)
+        with belief_scope("example_plugin_exec") as b_scope:
+            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
+                
+                # 2. Action: Progress Reporting
+                log.progress("Processing...", percent=50)
+                
+                # 3. Action: Finalize
+                log.info("Execution completed.")
+            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}")
     # [/DEF:execute:Function]
 
-# [/DEF:Shot:Plugin_Example]
+# [/DEF:PluginExampleShot:Module]