devscontext 0.1.0__py3-none-any.whl

devscontext/config.py

@@ -0,0 +1,264 @@
+"""Configuration loader for DevsContext.
+
+This module handles loading and parsing configuration from YAML files,
+with support for environment variable expansion.
+
+Example:
+    config = load_devscontext_config()
+    if config.sources.jira.enabled:
+        print(f"Jira URL: {config.sources.jira.base_url}")
+"""
+
+from __future__ import annotations
+
+import os
+import re
+from pathlib import Path
+from typing import Any
+
+import yaml
+from pydantic import BaseModel, Field
+
+from devscontext.constants import (
+    CONFIG_FILE_NAME,
+    DEFAULT_CACHE_MAX_SIZE,
+    DEFAULT_CACHE_TTL_SECONDS,
+)
+from devscontext.models import DevsContextConfig
+
+
+class JiraConfig(BaseModel):
+    """Jira adapter configuration.
+
+    Attributes:
+        base_url: The Jira instance URL (e.g., https://company.atlassian.net).
+        email: Email address for Jira authentication.
+        api_token: API token for Jira authentication.
+        enabled: Whether the Jira adapter is enabled.
+    """
+
+    base_url: str = Field(default="", description="Jira instance URL")
+    email: str = Field(default="", description="Jira authentication email")
+    api_token: str = Field(default="", description="Jira API token")
+    enabled: bool = Field(default=False, description="Whether adapter is enabled")
+
+
+class FirefliesConfig(BaseModel):
+    """Fireflies.ai adapter configuration.
+
+    Attributes:
+        api_key: API key for Fireflies.ai authentication.
+        enabled: Whether the Fireflies adapter is enabled.
+    """
+
+    api_key: str = Field(default="", description="Fireflies.ai API key")
+    enabled: bool = Field(default=False, description="Whether adapter is enabled")
+
+
+class LocalDocsConfig(BaseModel):
+    """Local documentation adapter configuration.
+
+    Attributes:
+        paths: List of directory paths to search for documentation.
+        enabled: Whether the local docs adapter is enabled.
+    """
+
+    paths: list[str] = Field(default_factory=list, description="Paths to doc directories")
+    enabled: bool = Field(default=True, description="Whether adapter is enabled")
+
+
+class AdaptersConfig(BaseModel):
+    """Configuration for all adapters.
+
+    Attributes:
+        jira: Jira adapter configuration.
+        fireflies: Fireflies adapter configuration.
+        local_docs: Local docs adapter configuration.
+    """
+
+    jira: JiraConfig = Field(default_factory=JiraConfig)
+    fireflies: FirefliesConfig = Field(default_factory=FirefliesConfig)
+    local_docs: LocalDocsConfig = Field(default_factory=LocalDocsConfig)
+
+
+class CacheConfig(BaseModel):
+    """Cache configuration.
+
+    Attributes:
+        ttl_seconds: Time-to-live in seconds for cache entries.
+        max_size: Maximum number of entries in the cache.
+    """
+
+    ttl_seconds: int = Field(
+        default=DEFAULT_CACHE_TTL_SECONDS,
+        description="Cache entry TTL in seconds",
+    )
+    max_size: int = Field(
+        default=DEFAULT_CACHE_MAX_SIZE,
+        description="Maximum cache entries",
+    )
+
+
+class Config(BaseModel):
+    """Root configuration for DevsContext.
+
+    Attributes:
+        adapters: Configuration for all adapters.
+        cache: Cache configuration.
+    """
+
+    adapters: AdaptersConfig = Field(default_factory=AdaptersConfig)
+    cache: CacheConfig = Field(default_factory=CacheConfig)
+
+
+# Pattern to match ${VAR_NAME} or $VAR_NAME
+ENV_VAR_PATTERN = re.compile(r"\$\{([^}]+)\}|\$([A-Za-z_][A-Za-z0-9_]*)")
+
+
+def expand_env_vars(value: Any) -> Any:
+    """Recursively expand environment variables in config values.
+
+    Supports both ${VAR_NAME} and $VAR_NAME syntax.
+    If the env var is not set, the placeholder is left unchanged.
+
+    Args:
+        value: The value to expand (can be str, dict, list, or primitive).
+
+    Returns:
+        The value with environment variables expanded.
+    """
+    if isinstance(value, str):
+
+        def replace_env_var(match: re.Match[str]) -> str:
+            # Group 1 is ${VAR}, group 2 is $VAR
+            var_name = match.group(1) or match.group(2)
+            return os.environ.get(var_name, match.group(0))
+
+        return ENV_VAR_PATTERN.sub(replace_env_var, value)
+
+    elif isinstance(value, dict):
+        return {k: expand_env_vars(v) for k, v in value.items()}
+
+    elif isinstance(value, list):
+        return [expand_env_vars(item) for item in value]
+
+    else:
+        return value
+
+
+def load_config(config_path: Path | None = None) -> Config:
+    """Load configuration from YAML file.
+
+    Environment variables in the format ${VAR_NAME} or $VAR_NAME are expanded.
+
+    Args:
+        config_path: Path to config file. If None, searches for .devscontext.yaml
+                    in current directory and parent directories.
+
+    Returns:
+        Loaded configuration with env vars expanded.
+    """
+    if config_path is None:
+        config_path = find_config_file()
+
+    if config_path is None or not config_path.exists():
+        return Config()
+
+    with open(config_path) as f:
+        data: dict[str, Any] = yaml.safe_load(f) or {}
+
+    # Expand environment variables
+    data = expand_env_vars(data)
+
+    return Config.model_validate(data)
+
+
+def find_config_file() -> Path | None:
+    """Search for .devscontext.yaml in current and parent directories.
+
+    Walks up the directory tree from the current working directory,
+    looking for a configuration file.
+
+    Returns:
+        Path to the config file if found, None otherwise.
+    """
+    current = Path.cwd()
+
+    for directory in [current, *current.parents]:
+        config_file = directory / CONFIG_FILE_NAME
+        if config_file.exists():
+            return config_file
+
+    return None
+
+
+def load_devscontext_config(config_path: Path | None = None) -> DevsContextConfig:
+    """Load DevsContextConfig from YAML file.
+
+    This is the new config loader that returns DevsContextConfig with
+    the sources/synthesis/cache structure.
+
+    Environment variables in the format ${VAR_NAME} or $VAR_NAME are expanded.
+
+    Args:
+        config_path: Path to config file. If None, searches for .devscontext.yaml
+                    in current directory and parent directories.
+
+    Returns:
+        Loaded DevsContextConfig with env vars expanded.
+    """
+    if config_path is None:
+        config_path = find_config_file()
+
+    if config_path is None or not config_path.exists():
+        return DevsContextConfig()
+
+    with open(config_path) as f:
+        data: dict[str, Any] = yaml.safe_load(f) or {}
+
+    # Expand environment variables
+    data = expand_env_vars(data)
+
+    # Transform old config format to new format if needed
+    if "adapters" in data and "sources" not in data:
+        data = _transform_legacy_config(data)
+
+    return DevsContextConfig.model_validate(data)
+
+
+def _transform_legacy_config(data: dict[str, Any]) -> dict[str, Any]:
+    """Transform legacy config format to new format.
+
+    Legacy format uses 'adapters' key with 'local_docs'.
+    New format uses 'sources' key with 'docs'.
+
+    Args:
+        data: Legacy config data.
+
+    Returns:
+        Transformed config data for DevsContextConfig.
+    """
+    adapters = data.pop("adapters", {})
+    cache = data.get("cache", {})
+
+    # Transform adapters to sources
+    sources: dict[str, Any] = {}
+
+    if "jira" in adapters:
+        sources["jira"] = adapters["jira"]
+
+    if "fireflies" in adapters:
+        sources["fireflies"] = adapters["fireflies"]
+
+    if "local_docs" in adapters:
+        sources["docs"] = adapters["local_docs"]
+
+    # Convert cache TTL from seconds to minutes if present
+    if "ttl_seconds" in cache and "ttl_minutes" not in cache:
+        cache["ttl_minutes"] = cache.pop("ttl_seconds") // 60
+
+    return {
+        "sources": sources,
+        "synthesis": data.get("synthesis", {}),
+        "cache": cache,
+    }

devscontext/constants.py

@@ -0,0 +1,107 @@
+"""Constants and configuration defaults for DevsContext.
+
+This module contains all magic values, default configurations, and constants
+used throughout the application. Import from here instead of hardcoding values.
+"""
+
+from typing import Final
+
+# =============================================================================
+# VERSION
+# =============================================================================
+VERSION: Final[str] = "0.1.0"
+
+# =============================================================================
+# CACHE DEFAULTS
+# =============================================================================
+DEFAULT_CACHE_TTL_SECONDS: Final[int] = 900  # 15 minutes
+DEFAULT_CACHE_MAX_SIZE: Final[int] = 100
+
+# =============================================================================
+# HTTP CLIENT DEFAULTS
+# =============================================================================
+DEFAULT_HTTP_TIMEOUT_SECONDS: Final[float] = 30.0
+DEFAULT_HTTP_MAX_RETRIES: Final[int] = 3
+
+# =============================================================================
+# JIRA API
+# =============================================================================
+JIRA_API_VERSION: Final[str] = "3"
+JIRA_API_BASE_PATH: Final[str] = f"/rest/api/{JIRA_API_VERSION}"
+JIRA_MAX_COMMENTS: Final[int] = 50
+JIRA_TICKET_FIELDS: Final[str] = (
+    "summary,description,status,priority,assignee,reporter,labels,issuetype,created,updated"
+)
+
+# =============================================================================
+# FIREFLIES API
+# =============================================================================
+FIREFLIES_API_URL: Final[str] = "https://api.fireflies.ai/graphql"
+FIREFLIES_MAX_TRANSCRIPTS: Final[int] = 10
+FIREFLIES_SEARCH_LIMIT: Final[int] = 5
+FIREFLIES_CONTEXT_WINDOW: Final[int] = 3  # Sentences before/after a match to include
+
+# =============================================================================
+# LOCAL DOCS
+# =============================================================================
+SUPPORTED_DOC_EXTENSIONS: Final[tuple[str, ...]] = (".md", ".markdown", ".txt", ".rst")
+MAX_DOC_FILE_SIZE_BYTES: Final[int] = 1_000_000  # 1MB
+MAX_DOCS_TO_SEARCH: Final[int] = 100
+
+# =============================================================================
+# SYNTHESIS / LLM
+# =============================================================================
+DEFAULT_LLM_MODEL: Final[str] = "claude-3-haiku-20240307"
+MAX_CONTEXT_LENGTH_CHARS: Final[int] = 100_000
+MAX_SYNTHESIS_INPUT_CHARS: Final[int] = 50_000
+
+# =============================================================================
+# MCP SERVER
+# =============================================================================
+MCP_SERVER_NAME: Final[str] = "devscontext"
+
+# =============================================================================
+# CONFIG FILE
+# =============================================================================
+CONFIG_FILE_NAME: Final[str] = ".devscontext.yaml"
+CONFIG_EXAMPLE_FILE_NAME: Final[str] = ".devscontext.yaml.example"
+
+# =============================================================================
+# LOGGING
+# =============================================================================
+LOG_FORMAT: Final[str] = "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s"
+LOG_DATE_FORMAT: Final[str] = "%Y-%m-%d %H:%M:%S"
+
+# =============================================================================
+# ADAPTER NAMES (for consistent referencing)
+# =============================================================================
+ADAPTER_JIRA: Final[str] = "jira"
+ADAPTER_FIREFLIES: Final[str] = "fireflies"
+ADAPTER_LOCAL_DOCS: Final[str] = "local_docs"
+ADAPTER_SLACK: Final[str] = "slack"
+ADAPTER_GMAIL: Final[str] = "gmail"
+
+# =============================================================================
+# SOURCE TYPES
+# =============================================================================
+SOURCE_TYPE_ISSUE_TRACKER: Final[str] = "issue_tracker"
+SOURCE_TYPE_MEETING: Final[str] = "meeting"
+SOURCE_TYPE_DOCUMENTATION: Final[str] = "documentation"
+SOURCE_TYPE_COMMUNICATION: Final[str] = "communication"
+SOURCE_TYPE_EMAIL: Final[str] = "email"
+
+# =============================================================================
+# SLACK API
+# =============================================================================
+SLACK_API_BASE_URL: Final[str] = "https://slack.com/api"
+SLACK_RATE_LIMIT_REQUESTS_PER_MINUTE: Final[int] = 50
+SLACK_CHANNEL_HISTORY_CACHE_TTL: Final[int] = 300  # 5 minutes
+SLACK_MAX_MESSAGES_PER_CHANNEL: Final[int] = 100
+SLACK_THREAD_REPLY_LIMIT: Final[int] = 50
+
+# =============================================================================
+# GMAIL API
+# =============================================================================
+GMAIL_API_SCOPES: Final[tuple[str, ...]] = ("https://www.googleapis.com/auth/gmail.readonly",)
+GMAIL_BODY_MAX_CHARS: Final[int] = 5000
+GMAIL_MAX_RESULTS_PER_QUERY: Final[int] = 25