julee 0.1.0__py3-none-any.whl

julee/repositories/temporal/activities.py

@@ -0,0 +1,114 @@
+"""
+Temporal activity wrapper classes for the julee domain.
+
+This module contains all @temporal_activity_registration decorated classes
+that wrap pure backend repositories as Temporal activities. These classes are
+imported by the worker to register activities with Temporal.
+
+The classes follow the naming pattern documented in systemPatterns.org:
+- Activity names: {domain}.{repo_name}.{method}
+- Each repository type gets its own activity prefix
+"""
+
+from julee.util.temporal.decorators import temporal_activity_registration
+from julee.repositories.minio.assembly import MinioAssemblyRepository
+from julee.repositories.minio.assembly_specification import (
+    MinioAssemblySpecificationRepository,
+)
+from julee.repositories.minio.document import MinioDocumentRepository
+from julee.repositories.minio.knowledge_service_config import (
+    MinioKnowledgeServiceConfigRepository,
+)
+from julee.repositories.minio.knowledge_service_query import (
+    MinioKnowledgeServiceQueryRepository,
+)
+from julee.repositories.minio.policy import (
+    MinioPolicyRepository,
+)
+from julee.repositories.minio.document_policy_validation import (
+    MinioDocumentPolicyValidationRepository,
+)
+
+# Import activity name bases from shared module
+from julee.repositories.temporal.activity_names import (
+    ASSEMBLY_ACTIVITY_BASE,
+    ASSEMBLY_SPECIFICATION_ACTIVITY_BASE,
+    DOCUMENT_ACTIVITY_BASE,
+    KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE,
+    KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE,
+    POLICY_ACTIVITY_BASE,
+    DOCUMENT_POLICY_VALIDATION_ACTIVITY_BASE,
+)
+
+
+@temporal_activity_registration(ASSEMBLY_ACTIVITY_BASE)
+class TemporalMinioAssemblyRepository(MinioAssemblyRepository):
+    """Temporal activity wrapper for MinioAssemblyRepository."""
+
+    pass
+
+
+@temporal_activity_registration(ASSEMBLY_SPECIFICATION_ACTIVITY_BASE)
+class TemporalMinioAssemblySpecificationRepository(
+    MinioAssemblySpecificationRepository
+):
+    """Temporal activity wrapper for MinioAssemblySpecificationRepository."""
+
+    pass
+
+
+@temporal_activity_registration(DOCUMENT_ACTIVITY_BASE)
+class TemporalMinioDocumentRepository(MinioDocumentRepository):
+    """Temporal activity wrapper for MinioDocumentRepository."""
+
+    pass
+
+
+@temporal_activity_registration(KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE)
+class TemporalMinioKnowledgeServiceConfigRepository(
+    MinioKnowledgeServiceConfigRepository
+):
+    """Temporal activity wrapper for MinioKnowledgeServiceConfigRepository."""
+
+    pass
+
+
+@temporal_activity_registration(KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE)
+class TemporalMinioKnowledgeServiceQueryRepository(
+    MinioKnowledgeServiceQueryRepository
+):
+    """Temporal activity wrapper for MinioKnowledgeServiceQueryRepository."""
+
+    pass
+
+
+@temporal_activity_registration(POLICY_ACTIVITY_BASE)
+class TemporalMinioPolicyRepository(MinioPolicyRepository):
+    """Temporal activity wrapper for MinioPolicyRepository."""
+
+    pass
+
+
+@temporal_activity_registration(DOCUMENT_POLICY_VALIDATION_ACTIVITY_BASE)
+class TemporalMinioDocumentPolicyValidationRepository(
+    MinioDocumentPolicyValidationRepository
+):
+    """Temporal activity wrapper for DocumentPolicyValidationRepository."""
+
+    pass
+
+
+# Export the temporal repository classes for use in worker.py
+__all__ = [
+    "TemporalMinioAssemblyRepository",
+    "TemporalMinioAssemblySpecificationRepository",
+    "TemporalMinioDocumentRepository",
+    "TemporalMinioKnowledgeServiceConfigRepository",
+    "TemporalMinioKnowledgeServiceQueryRepository",
+    # Export constants for proxy consistency
+    "ASSEMBLY_ACTIVITY_BASE",
+    "ASSEMBLY_SPECIFICATION_ACTIVITY_BASE",
+    "DOCUMENT_ACTIVITY_BASE",
+    "KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE",
+    "KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE",
+]

julee/repositories/temporal/activity_names.py

@@ -0,0 +1,34 @@
+"""
+Shared activity name constants for the julee domain.
+
+This module contains activity name base constants that are shared between
+activities.py and proxies.py, avoiding the need for either module to import
+from the other, which would create problematic transitive dependencies.
+
+By isolating these constants in their own module, we maintain DRY principles
+while preserving Temporal's workflow sandbox restrictions. The proxies module
+can import these constants without transitively importing non-deterministic
+backend code from activities.py.
+"""
+
+# Activity name bases - shared constants for consistency between
+# activity registrations and workflow proxies
+ASSEMBLY_ACTIVITY_BASE = "julee.assembly_repo.minio"
+ASSEMBLY_SPECIFICATION_ACTIVITY_BASE = "julee.assembly_specification_repo.minio"
+DOCUMENT_ACTIVITY_BASE = "julee.document_repo.minio"
+KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE = "julee.knowledge_service_config_repo.minio"
+KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE = "julee.knowledge_service_query_repo.minio"
+POLICY_ACTIVITY_BASE = "julee.policy_repo.minio"
+DOCUMENT_POLICY_VALIDATION_ACTIVITY_BASE = "julee.document_policy_validation_repo.minio"
+
+
+# Export all constants
+__all__ = [
+    "ASSEMBLY_ACTIVITY_BASE",
+    "ASSEMBLY_SPECIFICATION_ACTIVITY_BASE",
+    "DOCUMENT_ACTIVITY_BASE",
+    "KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE",
+    "KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE",
+    "POLICY_ACTIVITY_BASE",
+    "DOCUMENT_POLICY_VALIDATION_ACTIVITY_BASE",
+]

julee/repositories/temporal/proxies.py

@@ -0,0 +1,159 @@
+"""
+Workflow-safe proxy classes for the julee domain.
+
+This module contains all @temporal_workflow_proxy decorated classes that
+delegate to Temporal activities from within workflows. These classes are
+isolated from backend imports to avoid Temporal's workflow sandbox
+restrictions.
+
+The proxy classes automatically generate methods that call
+workflow.execute_activity() with the appropriate activity names, timeouts,
+and retry policies.
+"""
+
+from julee.util.temporal.decorators import temporal_workflow_proxy
+from julee.domain.repositories.assembly import AssemblyRepository
+from julee.domain.repositories.assembly_specification import (
+    AssemblySpecificationRepository,
+)
+from julee.domain.repositories.document import DocumentRepository
+from julee.domain.repositories.knowledge_service_config import (
+    KnowledgeServiceConfigRepository,
+)
+from julee.domain.repositories.knowledge_service_query import (
+    KnowledgeServiceQueryRepository,
+)
+from julee.domain.repositories.policy import PolicyRepository
+from julee.domain.repositories.document_policy_validation import (
+    DocumentPolicyValidationRepository,
+)
+
+# Import activity name bases from shared module
+from julee.repositories.temporal.activity_names import (
+    ASSEMBLY_ACTIVITY_BASE,
+    ASSEMBLY_SPECIFICATION_ACTIVITY_BASE,
+    DOCUMENT_ACTIVITY_BASE,
+    KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE,
+    KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE,
+    POLICY_ACTIVITY_BASE,
+    DOCUMENT_POLICY_VALIDATION_ACTIVITY_BASE,
+)
+
+
+@temporal_workflow_proxy(
+    activity_base=ASSEMBLY_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowAssemblyRepositoryProxy(AssemblyRepository):
+    """
+    Workflow implementation of AssemblyRepository that calls activities.
+    All methods are automatically generated by the @temporal_workflow_proxy
+    decorator.
+    """
+
+    pass
+
+
+@temporal_workflow_proxy(
+    activity_base=ASSEMBLY_SPECIFICATION_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowAssemblySpecificationRepositoryProxy(AssemblySpecificationRepository):
+    """
+    Workflow implementation of AssemblySpecificationRepository that calls
+    activities.
+    All methods are automatically generated by the @temporal_workflow_proxy
+    decorator.
+    """
+
+    pass
+
+
+@temporal_workflow_proxy(
+    activity_base=DOCUMENT_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowDocumentRepositoryProxy(DocumentRepository):
+    """
+    Workflow implementation of DocumentRepository that calls activities.
+    All methods are automatically generated by the @temporal_workflow_proxy
+    decorator.
+    """
+
+    pass
+
+
+@temporal_workflow_proxy(
+    activity_base=KNOWLEDGE_SERVICE_CONFIG_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowKnowledgeServiceConfigRepositoryProxy(KnowledgeServiceConfigRepository):
+    """
+    Workflow implementation of KnowledgeServiceConfigRepository that calls
+    activities.
+    All methods are automatically generated by the @temporal_workflow_proxy
+    decorator.
+    """
+
+    pass
+
+
+@temporal_workflow_proxy(
+    activity_base=KNOWLEDGE_SERVICE_QUERY_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowKnowledgeServiceQueryRepositoryProxy(KnowledgeServiceQueryRepository):
+    """
+    Workflow implementation of KnowledgeServiceQueryRepository that calls
+    activities. All methods are automatically generated by the
+    @temporal_workflow_proxy decorator.
+    """
+
+    pass
+
+
+@temporal_workflow_proxy(
+    activity_base=POLICY_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowPolicyRepositoryProxy(PolicyRepository):
+    """
+    Workflow implementation of PolicyRepository that calls activities.
+    All methods are automatically generated by the @temporal_workflow_proxy
+    decorator.
+    """
+
+    pass
+
+
+@temporal_workflow_proxy(
+    activity_base=DOCUMENT_POLICY_VALIDATION_ACTIVITY_BASE,
+    default_timeout_seconds=30,
+    retry_methods=["save", "generate_id"],
+)
+class WorkflowDocumentPolicyValidationRepositoryProxy(
+    DocumentPolicyValidationRepository
+):
+    """
+    Workflow implementation of DocumentPolicyValidationRepository that calls
+    activities. All methods are automatically generated by the
+    @temporal_workflow_proxy decorator.
+    """
+
+    pass
+
+
+# Export the workflow proxy classes
+__all__ = [
+    "WorkflowAssemblyRepositoryProxy",
+    "WorkflowAssemblySpecificationRepositoryProxy",
+    "WorkflowDocumentRepositoryProxy",
+    "WorkflowKnowledgeServiceConfigRepositoryProxy",
+    "WorkflowKnowledgeServiceQueryRepositoryProxy",
+]

julee/services/__init__.py

@@ -0,0 +1,18 @@
+"""
+Services for julee domain.
+
+This module provides service classes and factory functions for interacting
+with external services in the Capture, Extract, Assemble, Publish workflow.
+
+The services layer handles external integrations while the repository layer
+handles local metadata persistence. Services are organized by service type
+into submodules, each with their own protocols and implementations.
+"""
+
+# Re-export knowledge service components
+from .knowledge_service import KnowledgeService
+
+__all__ = [
+    # Knowledge Service
+    "KnowledgeService",
+]

julee/services/knowledge_service/__init__.py

@@ -0,0 +1,48 @@
+"""
+Knowledge Service module for julee domain.
+
+This module provides the KnowledgeService protocol and factory function for
+creating configured knowledge service instances. The factory routes to the
+appropriate implementation based on the service_api configuration.
+"""
+
+import logging
+
+from .knowledge_service import (
+    KnowledgeService,
+    QueryResult,
+    FileRegistrationResult,
+)
+
+
+logger = logging.getLogger(__name__)
+
+
+def ensure_knowledge_service(service: object) -> KnowledgeService:
+    """Ensure an object satisfies the KnowledgeService protocol.
+
+    Args:
+        service: The service implementation to validate
+
+    Returns:
+        The validated service (type checker knows it satisfies
+        KnowledgeService)
+
+    Raises:
+        TypeError: If the service doesn't satisfy the protocol
+    """
+    if not isinstance(service, KnowledgeService):
+        raise TypeError(
+            f"Service {type(service).__name__} does not satisfy "
+            f"KnowledgeService protocol"
+        )
+
+    return service
+
+
+__all__ = [
+    "KnowledgeService",
+    "ensure_knowledge_service",
+    "QueryResult",
+    "FileRegistrationResult",
+]

julee/services/knowledge_service/anthropic/__init__.py

@@ -0,0 +1,12 @@
+"""
+Anthropic service implementations for julee domain.
+
+This module exports Anthropic-specific implementations of service protocols
+for the Capture, Extract, Assemble, Publish workflow.
+"""
+
+from .knowledge_service import AnthropicKnowledgeService
+
+__all__ = [
+    "AnthropicKnowledgeService",
+]