fix: cache annotation format (before import, with brackets)

- Annotation before import line (not after)
- Path wrapped in brackets: <path>
- Format: # you see: <.imports/...> <sha256:...>

REFERENCE: #40 (Import caching mechanism)

Author: tracer-mohist

src/workflow_as_list/executor/loader.py

@@ -73,18 +73,26 @@ def _has_cache_annotation(self, content: str, cache_path: str) -> bool:
     def _add_annotation_to_content(
         self, content: str, workflow_path: Path, cache_path: Path, hash_value: str
     ) -> str:
-        """Add cache annotation to workflow content."""
+        """Add cache annotation BEFORE import line (not after)."""
         lines = content.split("\n")
         output = []
+        added = set()  # Track which imports have annotations
 
         for i, line in enumerate(lines):
-            output.append(line)
-            # Add annotation after import lines
+            # Check if this is an import line without annotation
             if line.strip().startswith("import:"):
-                annotation = f"# you see: {cache_path} <{hash_value}>"
                 # Check if next line is already an annotation
-                if i + 1 < len(lines) and "# you see:" not in lines[i + 1]:
+                has_annotation = False
+                if i + 1 < len(lines) and "# you see:" in lines[i + 1]:
+                    has_annotation = True
+
+                if not has_annotation and str(workflow_path) not in added:
+                    # Add annotation BEFORE import line
+                    annotation = f"# you see: <{cache_path}> <{hash_value}>"
                     output.append(annotation)
+                    added.add(str(workflow_path))
+
+            output.append(line)
 
         return "\n".join(output)
 

workflow/test-import.workflow.list

@@ -5,8 +5,8 @@
 
 - (start) Test Import Workflow
   # Import base workflow for common steps
+# you see: <.imports/workflow/test-import.workflow.list> <sha256:f67debb9e7b8d86bdfaa071c6c22a15b85a69f720fb1c55de2dde1ac838b2505>
   import: ./main.workflow.list
-# you see: .imports/workflow/test-import.workflow.list <sha256:f67debb9e7b8d86bdfaa071c6c22a15b85a69f720fb1c55de2dde1ac838b2505>
 
 - (test) Local test step
   - Ask: Import caching works? (yes/no)