julee 0.1.0__tar.gz → 0.1.2__tar.gz

{julee-0.1.0/src/julee.egg-info → julee-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: julee
-Version: 0.1.0
+Version: 0.1.2
 Summary: Julee - Clean architecture for accountable and transparent digital supply chains
 Author-email: Pyx Industries <chris@pyx.io>
 License: GPL-3.0
@@ -45,6 +45,7 @@ Requires-Dist: factory-boy>=3.2.0; extra == "dev"
 Requires-Dist: mypy>=1.7.0; extra == "dev"
 Requires-Dist: types-PyYAML; extra == "dev"
 Requires-Dist: types-jsonschema; extra == "dev"
+Requires-Dist: types-python-dateutil; extra == "dev"
 Requires-Dist: black>=24.0.0; extra == "dev"
 Requires-Dist: ruff>=0.5.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
@@ -57,6 +58,7 @@ Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
 Requires-Dist: furo>=2023.9.10; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "docs"
 Requires-Dist: sphinxcontrib-mermaid>=0.9.2; extra == "docs"
+Requires-Dist: sphinxcontrib-plantuml>=0.25; extra == "docs"
 Requires-Dist: sphinx-autoapi>=3.0.0; extra == "docs"
 Dynamic: license-file
 

{julee-0.1.0 → julee-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "julee"
-version = "0.1.0"
+version = "0.1.2"
 description = "Julee - Clean architecture for accountable and transparent digital supply chains"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -61,6 +61,7 @@ dev = [
     "mypy>=1.7.0",
     "types-PyYAML",
     "types-jsonschema",
+    "types-python-dateutil",
     # Code quality
     "black>=24.0.0",
     "ruff>=0.5.0",
@@ -78,6 +79,7 @@ docs = [
     "furo>=2023.9.10",
     "sphinx-autodoc-typehints>=1.25.0",
     "sphinxcontrib-mermaid>=0.9.2",
+    "sphinxcontrib-plantuml>=0.25",
     "sphinx-autoapi>=3.0.0",
 ]
 
@@ -103,6 +105,9 @@ asyncio_mode = "auto"
 addopts = [
     "--strict-markers",
     "--tb=short",
+    "--cov=src/julee",
+    "--cov-report=term-missing",
+    "--cov-report=html",
 ]
 
 [tool.coverage.run]

{julee-0.1.0 → julee-0.1.2}/src/julee/__init__.py

@@ -1,3 +1,3 @@
 """Julee - Clean architecture for accountable and transparent digital supply chains."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

{julee-0.1.0 → julee-0.1.2}/src/julee/domain/models/assembly_specification/knowledge_service_query.py

@@ -37,26 +37,30 @@ class KnowledgeServiceQuery(BaseModel):
 
     Examples of query_metadata usage:
 
-    For Anthropic services:
+    For Anthropic services::
+
         query_metadata = {
             "model": "claude-sonnet-4-20250514",
             "max_tokens": 4000,
             "temperature": 0.1
         }
 
-    For OpenAI services:
+    For OpenAI services::
+
         query_metadata = {
             "model": "gpt-4",
             "temperature": 0.2,
             "top_p": 0.9
         }
 
-    For custom services:
+    For custom services::
+
         query_metadata = {
             "endpoint": "custom-model-v2",
             "timeout": 30,
             "retries": 3
         }
+
     """
 
     # Core query identification

{julee-0.1.0 → julee-0.1.2}/src/julee/domain/models/policy/policy.py

@@ -38,9 +38,11 @@ class Policy(BaseModel):
     be applied to improve document quality before re-validation.
 
     The policy operates in two modes:
+
     1. Validation-only: Calculates scores and passes/fails based on criteria
     2. Validation with transformation: Calculates scores, applies
        transformations, then re-calculates scores for final pass/fail
+
     """
 
     # Core policy identification

{julee-0.1.0 → julee-0.1.2}/src/julee/domain/repositories/base.py

@@ -51,10 +51,12 @@ class BaseRepository(Protocol[T]):
         Returns:
             Entity if found, None otherwise
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must be idempotent: multiple calls return same result
         - Should handle missing entities gracefully (return None)
         - Loads complete entity with all relationships
+
         """
         ...
 
@@ -67,7 +69,8 @@ class BaseRepository(Protocol[T]):
         Returns:
             Dict mapping entity_id to entity (or None if not found)
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must be idempotent: multiple calls return same result
         - Should handle missing entities gracefully (return None for missing)
         - Implementations may optimize with batch operations or fall back
@@ -75,10 +78,12 @@ class BaseRepository(Protocol[T]):
         - Keys in returned dict correspond exactly to input entity_ids
         - Missing entities have None values in the returned dict
 
-        Workflow Context:
+        .. rubric:: Workflow Context
+
         In Temporal workflows, this method is implemented as an activity
         to ensure batch operations are durably stored and consistent
         across workflow replays.
+
         """
         ...
 
@@ -88,11 +93,13 @@ class BaseRepository(Protocol[T]):
         Args:
             entity: Complete entity to save
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must be idempotent: saving same entity state is safe
         - Should update the updated_at timestamp
         - Must save complete entity with all relationships
         - Handles both new entities and updates to existing ones
+
         """
         ...
 
@@ -102,24 +109,30 @@ class BaseRepository(Protocol[T]):
         Returns:
             List of all entities in the repository
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must be idempotent: multiple calls return same result
         - Returns empty list if no entities exist
         - Should return entities in a consistent order (e.g., by ID)
         - For large datasets, consider pagination at the use case level
 
-        Workflow Context:
+        .. rubric:: Workflow Context
+
         In Temporal workflows, this method is implemented as an activity
         to ensure the list operation is durably stored and consistent
         across workflow replays.
 
-        Default Implementation:
+        .. rubric:: Default Implementation
+
         Base protocol provides a default that returns empty list.
         Repository implementations should override this method as needed.
 
-        TODO: This default implementation returns empty list to avoid
-        breaking existing repositories. Specific repositories should
-        implement proper list_all() functionality as needed.
+        .. note::
+
+            This default implementation returns empty list to avoid
+            breaking existing repositories. Specific repositories should
+            implement proper list_all() functionality as needed.
+
         """
         return []
 
@@ -132,15 +145,18 @@ class BaseRepository(Protocol[T]):
         Returns:
             Unique entity ID string
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must generate globally unique identifiers
         - May use UUIDs, database sequences, or distributed ID generators
         - Should be fast and reliable
         - Failure here should be rare but handled gracefully
 
-        Workflow Context:
+        .. rubric:: Workflow Context
+
         In Temporal workflows, this method is implemented as an activity
         to ensure the generated ID is durably stored and consistent
         across workflow replays.
+
         """
         ...

{julee-0.1.0 → julee-0.1.2}/src/julee/domain/use_cases/extract_assemble_data.py

@@ -57,6 +57,7 @@ class ExtractAssembleDataUseCase:
     methods and expects them to work correctly.
 
     Architectural Notes:
+
     - This class contains pure business logic with no framework dependencies
     - Repository dependencies are injected via constructor
       (dependency inversion)
@@ -64,6 +65,7 @@ class ExtractAssembleDataUseCase:
     - The use case works with domain objects exclusively
     - Deterministic execution is guaranteed by avoiding
       non-deterministic operations
+
     """
 
     def __init__(
@@ -91,7 +93,8 @@ class ExtractAssembleDataUseCase:
                 operations
             now_fn: Function to get current time (for workflow compatibility)
 
-        Note:
+        .. note::
+
             The repositories passed here may be concrete implementations
             (for testing or direct execution) or workflow stubs (for
             Temporal workflow execution). The use case doesn't know or care
@@ -99,6 +102,7 @@ class ExtractAssembleDataUseCase:
 
             Repositories are validated at construction time to catch
             configuration errors early in the application lifecycle.
+
         """
         # Validate at construction time for early error detection
         self.document_repo = ensure_repository_protocol(
@@ -135,6 +139,7 @@ class ExtractAssembleDataUseCase:
         assembly.
 
         This method orchestrates the core assembly workflow:
+
         1. Generates a unique assembly ID
         2. Retrieves the assembly specification
         3. Stores the initial assembly in the repository
@@ -156,6 +161,7 @@ class ExtractAssembleDataUseCase:
         Raises:
             ValueError: If required entities are not found or invalid
             RuntimeError: If assembly processing fails
+
         """
         logger.debug(
             "Starting data assembly use case",
@@ -267,6 +273,7 @@ class ExtractAssembleDataUseCase:
 
         Raises:
             RuntimeError: If registration fails
+
         """
         registrations = {}
 
@@ -351,6 +358,7 @@ class ExtractAssembleDataUseCase:
         Perform a single assembly iteration using knowledge services.
 
         This method:
+
         1. Executes all knowledge service queries defined in the specification
         2. Stitches together the query results into a complete JSON document
         3. Creates and stores the assembled document
@@ -368,6 +376,7 @@ class ExtractAssembleDataUseCase:
         Raises:
             ValueError: If required entities are not found
             RuntimeError: If knowledge service operations fail
+
         """
         # Initialize the result data structure
         assembled_data: Dict[str, Any] = {}

{julee-0.1.0 → julee-0.1.2}/src/julee/domain/use_cases/validate_document.py

@@ -58,6 +58,7 @@ class ValidateDocumentUseCase:
     methods and expects them to work correctly.
 
     Architectural Notes:
+
     - This class contains pure business logic with no framework dependencies
     - Repository dependencies are injected via constructor
       (dependency inversion)
@@ -65,6 +66,7 @@ class ValidateDocumentUseCase:
     - The use case works with domain objects exclusively
     - Deterministic execution is guaranteed by avoiding
       non-deterministic operations
+
     """
 
     def __init__(
@@ -93,7 +95,8 @@ class ValidateDocumentUseCase:
             now_fn: Function to get current time (e.g., workflow.now for
                 Temporal workflows)
 
-        Note:
+        .. note::
+
             The repositories passed here may be concrete implementations
             (for testing or direct execution) or workflow stubs (for
             Temporal workflow execution). The use case doesn't know or care
@@ -101,6 +104,7 @@ class ValidateDocumentUseCase:
 
             Repositories are validated at construction time to catch
             configuration errors early in the application lifecycle.
+
         """
         # Validate at construction time for early error detection
         self.document_repo = ensure_repository_protocol(
@@ -133,6 +137,7 @@ class ValidateDocumentUseCase:
         Validate a document against a policy and return the validation result.
 
         This method orchestrates the core validation workflow:
+
         1. Generates a unique validation ID
         2. Retrieves the document and policy
         3. Creates and stores the initial validation record
@@ -152,6 +157,7 @@ class ValidateDocumentUseCase:
         Raises:
             ValueError: If required entities are not found or invalid
             RuntimeError: If validation processing fails
+
         """
         logger.debug(
             "Starting document validation use case",
@@ -429,6 +435,7 @@ class ValidateDocumentUseCase:
 
         Returns:
             Dict mapping knowledge_service_id to service_file_id
+
         """
         registrations = {}
         required_service_ids = {
@@ -471,6 +478,7 @@ class ValidateDocumentUseCase:
 
         Returns:
             List of (query_id, actual_score) tuples
+
         """
         validation_scores = []
 
@@ -556,6 +564,7 @@ class ValidateDocumentUseCase:
 
         Returns:
             True if all required scores were met or exceeded, False otherwise
+
         """
         # Convert to dictionaries for easier lookup
         actual_scores_dict = dict(actual_scores)
@@ -601,6 +610,7 @@ class ValidateDocumentUseCase:
         Raises:
             ValueError: If transformation queries are not found or fail
             RuntimeError: If document transformation fails
+
         """
         if not policy.transformation_queries:
             raise ValueError("No transformation queries provided")
@@ -717,6 +727,7 @@ class ValidateDocumentUseCase:
 
         Raises:
             ValueError: If no valid JSON content can be extracted from result
+
         """
         response_text = result_data.get("response", "")
         if not response_text:

{julee-0.1.0 → julee-0.1.2}/src/julee/repositories/__init__.py

@@ -5,13 +5,16 @@ This package contains concrete implementations of the repository interfaces
 defined in julee.domain.repositories.
 
 Implementation packages:
+
 - memory: In-memory implementations for testing
 - minio: MinIO-based implementations for production
 - temporal: Temporal workflow proxy implementations
 
-Import implementations using their full module paths, e.g.:
+Import implementations using their full module paths, e.g.::
+
     from julee.repositories.memory import MemoryDocumentRepository
     from julee.repositories.minio.document import (
         MinioDocumentRepository,
     )
+
 """

{julee-0.1.0 → julee-0.1.2}/src/julee/repositories/memory/assembly_specification.py

@@ -36,6 +36,7 @@ class MemoryAssemblySpecificationRepository(
     dictionaries.
 
     This implementation stores assembly specifications in memory:
+
     - Specifications: Dictionary keyed by assembly_specification_id containing
       AssemblySpecification objects
 

{julee-0.1.0 → julee-0.1.2}/src/julee/repositories/memory/knowledge_service_config.py

@@ -36,6 +36,7 @@ class MemoryKnowledgeServiceConfigRepository(
     dictionaries.
 
     This implementation stores knowledge service configurations in memory:
+
     - Knowledge Services: Dictionary keyed by knowledge_service_id containing
       KnowledgeServiceConfig objects
 

{julee-0.1.0 → julee-0.1.2}/src/julee/repositories/memory/knowledge_service_query.py

@@ -35,6 +35,7 @@ class MemoryKnowledgeServiceQueryRepository(
     dictionaries.
 
     This implementation stores knowledge service queries in memory:
+
     - Queries: Dictionary keyed by query_id containing KnowledgeServiceQuery
       objects
 

{julee-0.1.0 → julee-0.1.2}/src/julee/repositories/minio/knowledge_service_config.py

@@ -34,12 +34,12 @@ class MinioKnowledgeServiceConfigRepository(
 
     This implementation stores knowledge service configurations as JSON
     objects:
+
     - Knowledge Service Configs: JSON objects in the
       "knowledge-service-configs" bucket
 
     Each configuration is stored with its knowledge_service_id as the object
-    name
-    for efficient retrieval and updates.
+    name for efficient retrieval and updates.
     """
 
     def __init__(self, client: MinioClient) -> None:

{julee-0.1.0 → julee-0.1.2}/src/julee/services/knowledge_service/knowledge_service.py

@@ -92,17 +92,20 @@ class KnowledgeService(Protocol):
             FileRegistrationResult containing registration details and the
             service's internal file identifier
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must be idempotent: re-registering same document returns same result
         - Should handle service unavailability gracefully
         - Must return the service's internal file ID for future queries
         - Document content is accessed directly from the Document object
         - Should handle various document formats and sizes
 
-        Workflow Context:
+        .. rubric:: Workflow Context
+
         In Temporal workflows, this method is implemented as an activity
         to ensure registration results are durably stored and consistent
         across workflow replays.
+
         """
         ...
 
@@ -141,7 +144,8 @@ class KnowledgeService(Protocol):
         Returns:
             QueryResult containing query results and execution metadata
 
-        Implementation Notes:
+        .. rubric:: Implementation Notes
+
         - Must be idempotent: same query returns consistent results
         - Service file IDs are provided as context to enhance query responses
         - Should handle service unavailability gracefully
@@ -152,9 +156,11 @@ class KnowledgeService(Protocol):
         - Should validate that service_file_ids exist in the service before
           including them in the query context
 
-        Workflow Context:
+        .. rubric:: Workflow Context
+
         In Temporal workflows, this method is implemented as an activity
         to ensure query results are durably stored and can be replayed
         consistently.
+
         """
         ...

{julee-0.1.0 → julee-0.1.2}/src/julee/util/repositories.py

@@ -23,11 +23,9 @@ class FileStorageRepository(Protocol):
             FileMetadata object with details about the uploaded file.
 
         Implementation Notes:
-        - Must be idempotent: uploading the same file_id multiple times is
-          safe.
+        - Must be idempotent: uploading the same file_id multiple times is safe.
         - Should return metadata including the actual size and content type.
-        - Must perform security validation: file size limits, content type
-          verification, and filename sanitization.
+        - Must perform security validation: file size limits, content type verification, and filename sanitization.
         - Should reject files that don't match declared content type.
         """
         ...

{julee-0.1.0 → julee-0.1.2}/src/julee/util/temporal/activities.py

@@ -79,7 +79,7 @@ def collect_activities_from_instances(*instances: Any) -> list[Any]:
 
     Args:
         *instances: Repository and service instances decorated with
-                   @temporal_activity_registration
+            @temporal_activity_registration
 
     Returns:
         List of activity methods ready for Worker registration

{julee-0.1.0 → julee-0.1.2}/src/julee/util/temporal/decorators.py

@@ -123,13 +123,10 @@ def temporal_activity_registration(
     name.
 
     Args:
-        activity_prefix: Prefix for activity names (e.g.,
-        "sample.payment_repo.minio") Method names will be appended to create
-        full activity names like "sample.payment_repo.minio.process_payment"
+        activity_prefix: Prefix for activity names (e.g., "sample.payment_repo.minio"). Method names will be appended to create full activity names like "sample.payment_repo.minio.process_payment"
 
     Returns:
-        The decorated class with all async methods wrapped as Temporal
-        activities
+        The decorated class with all async methods wrapped as Temporal activities
 
     Example:
         @temporal_activity_registration("sample.payment_repo.minio")
@@ -137,12 +134,9 @@ def temporal_activity_registration(
             pass
 
         # This automatically creates activities for all protocol methods:
-        # - process_payment ->
-        #   "sample.payment_repo.minio.process_payment"
-        # - get_payment ->
-        #   "sample.payment_repo.minio.get_payment"
-        # - refund_payment ->
-        #   "sample.payment_repo.minio.refund_payment"
+        # - process_payment -> "sample.payment_repo.minio.process_payment"
+        # - get_payment -> "sample.payment_repo.minio.get_payment"
+        # - refund_payment -> "sample.payment_repo.minio.refund_payment"
     """
 
     def decorator(cls: Type[T]) -> Type[T]:
@@ -226,8 +220,8 @@ def temporal_workflow_proxy(
         retry_methods: List of method names that should use retry policies
 
     Returns:
-        The decorated class with all protocol methods implemented as
-        workflow activity calls
+        The decorated class with all protocol methods implemented as workflow
+        activity calls
 
     Example:
         @temporal_workflow_proxy(
@@ -241,8 +235,7 @@ def temporal_workflow_proxy(
         # This automatically creates workflow methods for all methods:
         # - get() -> calls "julee.document_repo.minio.get" activity
         # - save() -> calls "julee.document_repo.minio.save" with retry
-        # - generate_id() -> calls "julee.document_repo.minio.generate_id"
-        #   with retry
+        # - generate_id() -> calls "julee.document_repo.minio.generate_id" with retry
     """
 
     def decorator(cls: Type[T]) -> Type[T]:

{julee-0.1.0 → julee-0.1.2/src/julee.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: julee
-Version: 0.1.0
+Version: 0.1.2
 Summary: Julee - Clean architecture for accountable and transparent digital supply chains
 Author-email: Pyx Industries <chris@pyx.io>
 License: GPL-3.0
@@ -45,6 +45,7 @@ Requires-Dist: factory-boy>=3.2.0; extra == "dev"
 Requires-Dist: mypy>=1.7.0; extra == "dev"
 Requires-Dist: types-PyYAML; extra == "dev"
 Requires-Dist: types-jsonschema; extra == "dev"
+Requires-Dist: types-python-dateutil; extra == "dev"
 Requires-Dist: black>=24.0.0; extra == "dev"
 Requires-Dist: ruff>=0.5.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
@@ -57,6 +58,7 @@ Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
 Requires-Dist: furo>=2023.9.10; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "docs"
 Requires-Dist: sphinxcontrib-mermaid>=0.9.2; extra == "docs"
+Requires-Dist: sphinxcontrib-plantuml>=0.25; extra == "docs"
 Requires-Dist: sphinx-autoapi>=3.0.0; extra == "docs"
 Dynamic: license-file
 

{julee-0.1.0 → julee-0.1.2}/src/julee.egg-info/requires.txt

@@ -24,6 +24,7 @@ factory-boy>=3.2.0
 mypy>=1.7.0
 types-PyYAML
 types-jsonschema
+types-python-dateutil
 black>=24.0.0
 ruff>=0.5.0
 pre-commit>=3.0.0
@@ -37,4 +38,5 @@ sphinx-rtd-theme>=2.0.0
 furo>=2023.9.10
 sphinx-autodoc-typehints>=1.25.0
 sphinxcontrib-mermaid>=0.9.2
+sphinxcontrib-plantuml>=0.25
 sphinx-autoapi>=3.0.0