repr-cli 0.1.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

repr/config.py

@@ -4,6 +4,7 @@ Configuration management for ~/.repr/ directory.
 
 import json
 import os
+import tempfile
 from datetime import datetime
 from pathlib import Path
 from typing import Any
@@ -14,6 +15,8 @@ from typing import Any
 
 # Environment detection
 _DEV_MODE = os.getenv("REPR_DEV", "").lower() in ("1", "true", "yes")
+_CI_MODE = os.getenv("REPR_CI", "").lower() in ("1", "true", "yes")
+_FORCED_MODE = os.getenv("REPR_MODE", "").lower()  # "local" or "cloud"
 
 # Production URLs
 PROD_API_BASE = "https://api.repr.dev/api/cli"
@@ -34,6 +37,16 @@ def is_dev_mode() -> bool:
     return _DEV_MODE
 
 
+def is_ci_mode() -> bool:
+    """Check if running in CI mode (safe defaults, no prompts)."""
+    return _CI_MODE
+
+
+def get_forced_mode() -> str | None:
+    """Get forced mode from environment (local/cloud)."""
+    return _FORCED_MODE if _FORCED_MODE in ("local", "cloud") else None
+
+
 def set_dev_mode(enabled: bool) -> None:
     """Set dev mode programmatically (for CLI --dev flag)."""
     global _DEV_MODE
@@ -44,15 +57,31 @@ def set_dev_mode(enabled: bool) -> None:
 # File Configuration
 # ============================================================================
 
-CONFIG_DIR = Path.home() / ".repr"
+# Support REPR_HOME override for multi-user/CI environments
+REPR_HOME = Path(os.getenv("REPR_HOME", Path.home() / ".repr"))
+CONFIG_DIR = REPR_HOME
 CONFIG_FILE = CONFIG_DIR / "config.json"
 PROFILES_DIR = CONFIG_DIR / "profiles"
 CACHE_DIR = CONFIG_DIR / "cache"
+AUDIT_DIR = CONFIG_DIR / "audit"
 REPO_HASHES_FILE = CACHE_DIR / "repo-hashes.json"
 
+# Version for config schema migrations
+CONFIG_VERSION = 3
+
 DEFAULT_CONFIG = {
-    "version": 1,
-    "auth": None,
+    "version": CONFIG_VERSION,
+    "auth": None,  # Now stores reference to keychain, not token itself
+    "profile": {
+        "username": None,  # Local username (generated if not set)
+        "claimed": False,  # Whether username is verified with repr.dev
+        "bio": None,
+        "location": None,
+        "website": None,
+        "twitter": None,
+        "linkedin": None,
+        "available": False,  # Available for work
+    },
     "settings": {
         "default_paths": ["~/code"],
         "skip_patterns": ["node_modules", "venv", ".venv", "vendor", "__pycache__", ".git"],
@@ -62,11 +91,39 @@ DEFAULT_CONFIG = {
         "last_profile": None,
     },
     "llm": {
-        "extraction_model": None,  # Model for extracting accomplishments (e.g., "gpt-4o-mini", "llama3.2")
-        "synthesis_model": None,  # Model for synthesizing profile (e.g., "gpt-4o", "llama3.2")
+        "default": "local",  # "local", "cloud", or "byok:<provider>"
+        "local_provider": None,  # "ollama", "lmstudio", "custom"
         "local_api_url": None,  # Local LLM API base URL (e.g., "http://localhost:11434/v1")
         "local_api_key": None,  # Local LLM API key (often "ollama" for Ollama)
+        "local_model": None,  # Model name for local LLM (e.g., "llama3.2")
+        "extraction_model": None,  # Model for extracting accomplishments
+        "synthesis_model": None,  # Model for synthesizing profile
+        "cloud_model": "gpt-4o-mini",  # Default cloud model
+        "cloud_send_diffs": False,  # Whether to send diffs to cloud (privacy setting)
+        "cloud_redact_paths": True,  # Whether to redact absolute paths
+        "cloud_redact_emails": False,  # Whether to redact author emails
+        "cloud_redact_patterns": [],  # Regex patterns to redact from commit messages
+        "cloud_allowlist_repos": [],  # Only these repos can use cloud (empty = all)
+        "byok": {},  # BYOK provider configs: {"openai": {"model": "gpt-4o-mini"}, ...}
+    },
+    "generation": {
+        "batch_size": 5,  # Commits per story
+        "auto_generate_on_hook": False,  # Auto-generate when hook runs
+        "default_template": "resume",  # Default story template
+        "token_limit": 100000,  # Max tokens per cloud request
+        "max_commits_per_batch": 50,  # Max commits per request
     },
+    "publish": {
+        "on_generate": "never",  # "never", "prompt", "always"
+        "on_sync": "prompt",  # "never", "prompt", "always"
+    },
+    "privacy": {
+        "lock_local_only": False,  # Disable cloud features entirely
+        "lock_permanent": False,  # Make local-only lock irreversible
+        "profile_visibility": "public",  # "public", "unlisted", "private"
+        "telemetry_enabled": False,  # Opt-in telemetry
+    },
+    "tracked_repos": [],  # List of {"path": str, "last_sync": str|None, "hook_installed": bool, "paused": bool}
 }
 
 
@@ -75,6 +132,32 @@ def ensure_directories() -> None:
     CONFIG_DIR.mkdir(exist_ok=True)
     PROFILES_DIR.mkdir(exist_ok=True)
     CACHE_DIR.mkdir(exist_ok=True)
+    AUDIT_DIR.mkdir(exist_ok=True)
+
+
+def _atomic_json_write(path: Path, data: dict) -> None:
+    """Write JSON to file atomically using temp file + rename."""
+    path.parent.mkdir(parents=True, exist_ok=True)
+    fd, tmp_path = tempfile.mkstemp(dir=path.parent, suffix=".tmp")
+    try:
+        with os.fdopen(fd, "w") as f:
+            json.dump(data, f, indent=2)
+        os.replace(tmp_path, path)
+    except Exception:
+        if os.path.exists(tmp_path):
+            os.unlink(tmp_path)
+        raise
+
+
+def _deep_merge(base: dict, overlay: dict) -> dict:
+    """Deep merge two dicts, with overlay taking precedence."""
+    result = base.copy()
+    for key, value in overlay.items():
+        if key in result and isinstance(result[key], dict) and isinstance(value, dict):
+            result[key] = _deep_merge(result[key], value)
+        else:
+            result[key] = value
+    return result
 
 
 def load_config() -> dict[str, Any]:
@@ -88,24 +171,107 @@ def load_config() -> dict[str, Any]:
     try:
         with open(CONFIG_FILE, "r") as f:
             config = json.load(f)
-            # Merge with defaults for any missing keys
-            return {**DEFAULT_CONFIG, **config}
+            # Deep merge with defaults for any missing keys
+            merged = _deep_merge(DEFAULT_CONFIG, config)
+            
+            # Check for config migration
+            if config.get("version", 1) < CONFIG_VERSION:
+                merged = _migrate_config(merged, config.get("version", 1))
+                save_config(merged)
+            
+            return merged
     except (json.JSONDecodeError, IOError):
         return DEFAULT_CONFIG.copy()
 
 
+def _migrate_config(config: dict, from_version: int) -> dict:
+    """Migrate config from older version."""
+    # Version 2 -> 3: Add BYOK, profile metadata, audit settings
+    if from_version < 3:
+        # Ensure new sections exist
+        if "profile" not in config:
+            config["profile"] = DEFAULT_CONFIG["profile"].copy()
+        if "publish" not in config:
+            config["publish"] = DEFAULT_CONFIG["publish"].copy()
+        if "llm" in config:
+            config["llm"].setdefault("byok", {})
+            config["llm"].setdefault("cloud_redact_emails", False)
+            config["llm"].setdefault("cloud_redact_patterns", [])
+            config["llm"].setdefault("cloud_allowlist_repos", [])
+    
+    config["version"] = CONFIG_VERSION
+    return config
+
+
 def save_config(config: dict[str, Any]) -> None:
-    """Save configuration to disk."""
+    """Save configuration to disk atomically.
+    
+    Uses write-to-temp-then-rename pattern to prevent corruption
+    if the process is interrupted during write.
+    """
     ensure_directories()
     
-    with open(CONFIG_FILE, "w") as f:
-        json.dump(config, f, indent=2, default=str)
+    # Write to temp file first, then atomic rename
+    fd, tmp_path = tempfile.mkstemp(dir=CONFIG_DIR, suffix=".tmp")
+    try:
+        with os.fdopen(fd, "w") as f:
+            json.dump(config, f, indent=2, default=str)
+        os.replace(tmp_path, CONFIG_FILE)  # Atomic on POSIX
+    except Exception:
+        # Clean up temp file on failure
+        if os.path.exists(tmp_path):
+            os.unlink(tmp_path)
+        raise
+
+
+def get_config_value(key: str) -> Any:
+    """Get a config value by dot-notation key (e.g., 'llm.default')."""
+    config = load_config()
+    parts = key.split(".")
+    value = config
+    for part in parts:
+        if isinstance(value, dict) and part in value:
+            value = value[part]
+        else:
+            return None
+    return value
+
+
+def set_config_value(key: str, value: Any) -> None:
+    """Set a config value by dot-notation key (e.g., 'llm.default')."""
+    config = load_config()
+    parts = key.split(".")
+    
+    # Navigate to parent
+    parent = config
+    for part in parts[:-1]:
+        if part not in parent:
+            parent[part] = {}
+        parent = parent[part]
+    
+    # Set value
+    parent[parts[-1]] = value
+    save_config(config)
 
 
 def get_auth() -> dict[str, Any] | None:
     """Get authentication info if available."""
     config = load_config()
-    return config.get("auth")
+    auth = config.get("auth")
+    
+    if not auth:
+        return None
+    
+    # If using keychain (v3+), retrieve token from keychain
+    if auth.get("token_keychain_ref"):
+        from .keychain import get_secret
+        token = get_secret(auth["token_keychain_ref"])
+        if token:
+            return {**auth, "access_token": token}
+        return None
+    
+    # Legacy plaintext token
+    return auth
 
 
 def set_auth(
@@ -114,22 +280,44 @@ def set_auth(
     email: str,
     litellm_api_key: str | None = None,
 ) -> None:
-    """Store authentication info."""
+    """Store authentication info securely."""
+    from .keychain import store_secret
+    
     config = load_config()
+    
+    # Store token in keychain
+    keychain_ref = f"auth_token_{user_id[:8]}"
+    store_secret(keychain_ref, access_token)
+    
     config["auth"] = {
-        "access_token": access_token,
+        "token_keychain_ref": keychain_ref,
         "user_id": user_id,
         "email": email,
         "authenticated_at": datetime.now().isoformat(),
     }
+    
     if litellm_api_key:
-        config["auth"]["litellm_api_key"] = litellm_api_key
+        litellm_ref = f"litellm_key_{user_id[:8]}"
+        store_secret(litellm_ref, litellm_api_key)
+        config["auth"]["litellm_keychain_ref"] = litellm_ref
+    
     save_config(config)
 
 
 def clear_auth() -> None:
     """Clear authentication info."""
+    from .keychain import delete_secret
+    
     config = load_config()
+    auth = config.get("auth")
+    
+    if auth:
+        # Remove from keychain
+        if auth.get("token_keychain_ref"):
+            delete_secret(auth["token_keychain_ref"])
+        if auth.get("litellm_keychain_ref"):
+            delete_secret(auth["litellm_keychain_ref"])
+    
     config["auth"] = None
     save_config(config)
 
@@ -152,10 +340,79 @@ def get_litellm_config() -> tuple[str | None, str | None]:
     Returns:
         Tuple of (litellm_url, litellm_api_key)
     """
+    from .keychain import get_secret
+    
     auth = get_auth()
     if not auth:
         return None, None
-    return auth.get("litellm_url"), auth.get("litellm_api_key")
+    
+    litellm_url = auth.get("litellm_url")
+    litellm_key = None
+    
+    if auth.get("litellm_keychain_ref"):
+        litellm_key = get_secret(auth["litellm_keychain_ref"])
+    elif auth.get("litellm_api_key"):  # Legacy
+        litellm_key = auth["litellm_api_key"]
+    
+    return litellm_url, litellm_key
+
+
+# ============================================================================
+# Privacy Configuration
+# ============================================================================
+
+def is_cloud_allowed() -> bool:
+    """Check if cloud operations are allowed.
+    
+    Cloud is blocked if:
+    - privacy.lock_local_only is True
+    - REPR_MODE=local is set
+    - REPR_CI=true is set
+    """
+    if _CI_MODE:
+        return False
+    if _FORCED_MODE == "local":
+        return False
+    
+    config = load_config()
+    privacy = config.get("privacy", {})
+    return not privacy.get("lock_local_only", False)
+
+
+def lock_local_only(permanent: bool = False) -> None:
+    """Lock to local-only mode.
+    
+    Args:
+        permanent: If True, lock cannot be reversed
+    """
+    config = load_config()
+    config["privacy"]["lock_local_only"] = True
+    if permanent:
+        config["privacy"]["lock_permanent"] = True
+    save_config(config)
+
+
+def unlock_local_only() -> bool:
+    """Unlock from local-only mode.
+    
+    Returns:
+        True if unlocked, False if permanently locked
+    """
+    config = load_config()
+    privacy = config.get("privacy", {})
+    
+    if privacy.get("lock_permanent"):
+        return False
+    
+    config["privacy"]["lock_local_only"] = False
+    save_config(config)
+    return True
+
+
+def get_privacy_settings() -> dict[str, Any]:
+    """Get current privacy settings."""
+    config = load_config()
+    return config.get("privacy", DEFAULT_CONFIG["privacy"])
 
 
 # ============================================================================
@@ -166,16 +423,10 @@ def get_llm_config() -> dict[str, Any]:
     """Get LLM configuration.
     
     Returns:
-        Dict with extraction_model, synthesis_model, local_api_url, local_api_key
+        Dict with full LLM config
     """
     config = load_config()
-    llm = config.get("llm", {})
-    return {
-        "extraction_model": llm.get("extraction_model"),
-        "synthesis_model": llm.get("synthesis_model"),
-        "local_api_url": llm.get("local_api_url"),
-        "local_api_key": llm.get("local_api_key"),
-    }
+    return config.get("llm", DEFAULT_CONFIG["llm"])
 
 
 def set_llm_config(
@@ -183,6 +434,8 @@ def set_llm_config(
     synthesis_model: str | None = None,
     local_api_url: str | None = None,
     local_api_key: str | None = None,
+    local_model: str | None = None,
+    default: str | None = None,
 ) -> None:
     """Set LLM configuration.
     
@@ -200,6 +453,10 @@ def set_llm_config(
         config["llm"]["local_api_url"] = local_api_url if local_api_url else None
     if local_api_key is not None:
         config["llm"]["local_api_key"] = local_api_key if local_api_key else None
+    if local_model is not None:
+        config["llm"]["local_model"] = local_model if local_model else None
+    if default is not None:
+        config["llm"]["default"] = default
     
     save_config(config)
 
@@ -211,6 +468,163 @@ def clear_llm_config() -> None:
     save_config(config)
 
 
+def get_default_llm_mode() -> str:
+    """Get the default LLM mode."""
+    config = load_config()
+    return config.get("llm", {}).get("default", "local")
+
+
+# ============================================================================
+# BYOK Configuration
+# ============================================================================
+
+BYOK_PROVIDERS = {
+    "openai": {
+        "name": "OpenAI",
+        "default_model": "gpt-4o-mini",
+        "base_url": "https://api.openai.com/v1",
+    },
+    "anthropic": {
+        "name": "Anthropic",
+        "default_model": "claude-3-sonnet-20240229",
+        "base_url": "https://api.anthropic.com/v1",
+    },
+    "groq": {
+        "name": "Groq",
+        "default_model": "llama-3.1-70b-versatile",
+        "base_url": "https://api.groq.com/openai/v1",
+    },
+    "together": {
+        "name": "Together AI",
+        "default_model": "meta-llama/Llama-3-70b-chat-hf",
+        "base_url": "https://api.together.xyz/v1",
+    },
+}
+
+
+def add_byok_provider(provider: str, api_key: str, model: str | None = None) -> bool:
+    """Add a BYOK provider.
+    
+    Args:
+        provider: Provider name (openai, anthropic, etc.)
+        api_key: API key for the provider
+        model: Optional model override
+    
+    Returns:
+        True if added successfully
+    """
+    from .keychain import store_secret
+    
+    if provider not in BYOK_PROVIDERS:
+        return False
+    
+    # Store API key in keychain
+    keychain_ref = f"byok_{provider}"
+    store_secret(keychain_ref, api_key)
+    
+    # Update config
+    config = load_config()
+    if "byok" not in config.get("llm", {}):
+        config["llm"]["byok"] = {}
+    
+    config["llm"]["byok"][provider] = {
+        "keychain_ref": keychain_ref,
+        "model": model or BYOK_PROVIDERS[provider]["default_model"],
+        "send_diffs": False,
+        "redact_paths": True,
+    }
+    
+    save_config(config)
+    return True
+
+
+def remove_byok_provider(provider: str) -> bool:
+    """Remove a BYOK provider.
+    
+    Args:
+        provider: Provider name
+    
+    Returns:
+        True if removed, False if not found
+    """
+    from .keychain import delete_secret
+    
+    config = load_config()
+    byok = config.get("llm", {}).get("byok", {})
+    
+    if provider not in byok:
+        return False
+    
+    # Remove from keychain
+    if byok[provider].get("keychain_ref"):
+        delete_secret(byok[provider]["keychain_ref"])
+    
+    del config["llm"]["byok"][provider]
+    save_config(config)
+    return True
+
+
+def get_byok_config(provider: str) -> dict[str, Any] | None:
+    """Get BYOK configuration for a provider.
+    
+    Returns:
+        Config dict with api_key included, or None if not configured
+    """
+    from .keychain import get_secret
+    
+    config = load_config()
+    byok = config.get("llm", {}).get("byok", {})
+    
+    if provider not in byok:
+        return None
+    
+    provider_config = byok[provider].copy()
+    
+    # Get API key from keychain
+    if provider_config.get("keychain_ref"):
+        api_key = get_secret(provider_config["keychain_ref"])
+        if api_key:
+            provider_config["api_key"] = api_key
+        else:
+            return None  # Key not found
+    
+    # Add provider info
+    if provider in BYOK_PROVIDERS:
+        provider_config["base_url"] = BYOK_PROVIDERS[provider]["base_url"]
+        provider_config["provider_name"] = BYOK_PROVIDERS[provider]["name"]
+    
+    return provider_config
+
+
+def list_byok_providers() -> list[str]:
+    """List configured BYOK providers."""
+    config = load_config()
+    return list(config.get("llm", {}).get("byok", {}).keys())
+
+
+# ============================================================================
+# Profile Configuration
+# ============================================================================
+
+def get_profile_config() -> dict[str, Any]:
+    """Get profile configuration."""
+    config = load_config()
+    return config.get("profile", DEFAULT_CONFIG["profile"])
+
+
+def set_profile_config(**kwargs) -> None:
+    """Set profile configuration fields."""
+    config = load_config()
+    if "profile" not in config:
+        config["profile"] = DEFAULT_CONFIG["profile"].copy()
+    
+    for key, value in kwargs.items():
+        if key in DEFAULT_CONFIG["profile"]:
+            config["profile"][key] = value
+    
+    save_config(config)
+
+
 def get_skip_patterns() -> list[str]:
     """Get list of patterns to skip during discovery."""
     config = load_config()
@@ -233,7 +647,9 @@ def get_sync_info() -> dict[str, Any]:
     return config.get("sync", {})
 
 
-# Profile management
+# ============================================================================
+# Profile File Management
+# ============================================================================
 
 def list_profiles() -> list[dict[str, Any]]:
     """List all saved profiles with metadata, sorted by modification time (newest first)."""
@@ -317,8 +733,7 @@ def save_profile(content: str, name: str | None = None, repos: list[dict[str, An
             "repos": repos,
             "created_at": datetime.now().isoformat(),
         }
-        with open(metadata_path, 'w') as f:
-            json.dump(metadata, f, indent=2)
+        _atomic_json_write(metadata_path, metadata)
     
     return profile_path
 
@@ -343,13 +758,14 @@ def save_repo_profile(content: str, repo_name: str, repo_metadata: dict[str, Any
         "repo": repo_metadata,
         "created_at": datetime.now().isoformat(),
     }
-    with open(metadata_path, 'w') as f:
-        json.dump(metadata, f, indent=2)
+    _atomic_json_write(metadata_path, metadata)
     
     return profile_path
 
 
-# Cache management
+# ============================================================================
+# Cache Management
+# ============================================================================
 
 def load_repo_hashes() -> dict[str, str]:
     """Load cached repository hashes."""
@@ -366,11 +782,19 @@ def load_repo_hashes() -> dict[str, str]:
 
 
 def save_repo_hashes(hashes: dict[str, str]) -> None:
-    """Save repository hashes to cache."""
+    """Save repository hashes to cache atomically."""
     ensure_directories()
     
-    with open(REPO_HASHES_FILE, "w") as f:
-        json.dump(hashes, f, indent=2)
+    # Write to temp file first, then atomic rename
+    fd, tmp_path = tempfile.mkstemp(dir=CACHE_DIR, suffix=".tmp")
+    try:
+        with os.fdopen(fd, "w") as f:
+            json.dump(hashes, f, indent=2)
+        os.replace(tmp_path, REPO_HASHES_FILE)
+    except Exception:
+        if os.path.exists(tmp_path):
+            os.unlink(tmp_path)
+        raise
 
 
 def get_repo_hash(repo_path: str) -> str | None:
@@ -390,3 +814,205 @@ def clear_cache() -> None:
     """Clear all cached data."""
     if REPO_HASHES_FILE.exists():
         REPO_HASHES_FILE.unlink()
+
+
+def get_cache_size() -> int:
+    """Get total size of cache directory in bytes."""
+    total = 0
+    if CACHE_DIR.exists():
+        for f in CACHE_DIR.rglob("*"):
+            if f.is_file():
+                total += f.stat().st_size
+    return total
+
+
+# ============================================================================
+# Tracked Repositories Management
+# ============================================================================
+
+def get_tracked_repos() -> list[dict[str, Any]]:
+    """Get list of tracked repositories.
+    
+    Returns:
+        List of dicts with 'path', 'last_sync', 'hook_installed', 'paused'
+    """
+    config = load_config()
+    return config.get("tracked_repos", [])
+
+
+def add_tracked_repo(path: str) -> None:
+    """Add a repository to tracked list.
+    
+    Args:
+        path: Absolute path to repository
+    """
+    config = load_config()
+    
+    # Normalize path
+    normalized_path = str(Path(path).expanduser().resolve())
+    
+    # Check if already tracked
+    tracked = config.get("tracked_repos", [])
+    for repo in tracked:
+        if repo["path"] == normalized_path:
+            return  # Already tracked
+    
+    # Add new repo
+    tracked.append({
+        "path": normalized_path,
+        "last_sync": None,
+        "hook_installed": False,
+        "paused": False,
+    })
+    
+    config["tracked_repos"] = tracked
+    save_config(config)
+
+
+def remove_tracked_repo(path: str) -> bool:
+    """Remove a repository from tracked list.
+    
+    Args:
+        path: Path to repository
+    
+    Returns:
+        True if removed, False if not found
+    """
+    config = load_config()
+    normalized_path = str(Path(path).expanduser().resolve())
+    
+    tracked = config.get("tracked_repos", [])
+    original_len = len(tracked)
+    
+    # Filter out the repo
+    tracked = [r for r in tracked if r["path"] != normalized_path]
+    
+    if len(tracked) < original_len:
+        config["tracked_repos"] = tracked
+        save_config(config)
+        return True
+    
+    return False
+
+
+def update_repo_sync(path: str, timestamp: str | None = None) -> None:
+    """Update last sync timestamp for a repository.
+    
+    Args:
+        path: Path to repository
+        timestamp: ISO format timestamp (default: now)
+    """
+    config = load_config()
+    normalized_path = str(Path(path).expanduser().resolve())
+    
+    if timestamp is None:
+        timestamp = datetime.now().isoformat()
+    
+    tracked = config.get("tracked_repos", [])
+    for repo in tracked:
+        if repo["path"] == normalized_path:
+            repo["last_sync"] = timestamp
+            break
+    
+    config["tracked_repos"] = tracked
+    save_config(config)
+
+
+def set_repo_hook_status(path: str, installed: bool) -> None:
+    """Set hook installation status for a repository.
+    
+    Args:
+        path: Path to repository
+        installed: Whether hook is installed
+    """
+    config = load_config()
+    normalized_path = str(Path(path).expanduser().resolve())
+    
+    tracked = config.get("tracked_repos", [])
+    for repo in tracked:
+        if repo["path"] == normalized_path:
+            repo["hook_installed"] = installed
+            break
+    
+    config["tracked_repos"] = tracked
+    save_config(config)
+
+
+def set_repo_paused(path: str, paused: bool) -> None:
+    """Set paused status for a repository.
+    
+    Args:
+        path: Path to repository
+        paused: Whether auto-tracking is paused
+    """
+    config = load_config()
+    normalized_path = str(Path(path).expanduser().resolve())
+    
+    tracked = config.get("tracked_repos", [])
+    for repo in tracked:
+        if repo["path"] == normalized_path:
+            repo["paused"] = paused
+            break
+    
+    config["tracked_repos"] = tracked
+    save_config(config)
+
+
+def get_repo_info(path: str) -> dict[str, Any] | None:
+    """Get tracking info for a specific repository.
+    
+    Args:
+        path: Path to repository
+    
+    Returns:
+        Repo info dict or None if not tracked
+    """
+    normalized_path = str(Path(path).expanduser().resolve())
+    tracked = get_tracked_repos()
+    
+    for repo in tracked:
+        if repo["path"] == normalized_path:
+            return repo
+    
+    return None
+
+
+# ============================================================================
+# Data Storage Info
+# ============================================================================
+
+def get_data_info() -> dict[str, Any]:
+    """Get information about local data storage."""
+    from .storage import STORIES_DIR, get_story_count
+    
+    ensure_directories()
+    
+    # Calculate sizes
+    def dir_size(path: Path) -> int:
+        total = 0
+        if path.exists():
+            for f in path.rglob("*"):
+                if f.is_file():
+                    total += f.stat().st_size
+        return total
+    
+    stories_size = dir_size(STORIES_DIR) if STORIES_DIR.exists() else 0
+    profiles_size = dir_size(PROFILES_DIR)
+    cache_size = dir_size(CACHE_DIR)
+    config_size = CONFIG_FILE.stat().st_size if CONFIG_FILE.exists() else 0
+    
+    return {
+        "stories_count": get_story_count(),
+        "stories_size": stories_size,
+        "profiles_size": profiles_size,
+        "cache_size": cache_size,
+        "config_size": config_size,
+        "total_size": stories_size + profiles_size + cache_size + config_size,
+        "paths": {
+            "home": str(REPR_HOME),
+            "stories": str(STORIES_DIR),
+            "profiles": str(PROFILES_DIR),
+            "cache": str(CACHE_DIR),
+            "config": str(CONFIG_FILE),
+        },
+    }