cycode 3.15.3.dev7__py3-none-any.whl → 3.15.4.dev1__py3-none-any.whl

cycode/cli/apps/ai_guardrails/scan/claude_config.py

@@ -1,159 +0,0 @@
-"""Reader for ~/.claude.json configuration file.
-
-Extracts user email from the Claude Code global config file
-for use in AI guardrails scan enrichment.
-"""
-
-import json
-from pathlib import Path
-from typing import Optional
-
-from cycode.logger import get_logger
-
-logger = get_logger('AI Guardrails Claude Config')
-
-_CLAUDE_CONFIG_PATH = Path.home() / '.claude.json'
-_CLAUDE_SETTINGS_PATH = Path.home() / '.claude' / 'settings.json'
-
-
-def load_claude_config(config_path: Optional[Path] = None) -> Optional[dict]:
-    """Load and parse ~/.claude.json.
-
-    Args:
-        config_path: Override path for testing. Defaults to ~/.claude.json.
-
-    Returns:
-        Parsed dict or None if file is missing or invalid.
-    """
-    path = config_path or _CLAUDE_CONFIG_PATH
-    if not path.exists():
-        logger.debug('Claude config file not found', extra={'path': str(path)})
-        return None
-    try:
-        content = path.read_text(encoding='utf-8')
-        return json.loads(content)
-    except Exception as e:
-        logger.debug('Failed to load Claude config file', exc_info=e)
-        return None
-
-
-def get_user_email(config: dict) -> Optional[str]:
-    """Extract user email from Claude config.
-
-    Reads oauthAccount.emailAddress from the config dict.
-    """
-    return config.get('oauthAccount', {}).get('emailAddress')
-
-
-def get_mcp_servers(config: dict) -> Optional[dict]:
-    """Extract MCP servers from Claude config.
-
-    Reads mcpServers from the config dict.
-    """
-    return config.get('mcpServers')
-
-
-def load_claude_settings(settings_path: Optional[Path] = None) -> Optional[dict]:
-    """Load and parse ~/.claude/settings.json.
-
-    Args:
-        settings_path: Override path for testing. Defaults to ~/.claude/settings.json.
-
-    Returns:
-        Parsed dict or None if file is missing or invalid.
-    """
-    path = settings_path or _CLAUDE_SETTINGS_PATH
-    if not path.exists():
-        logger.debug('Claude settings file not found', extra={'path': str(path)})
-        return None
-    try:
-        content = path.read_text(encoding='utf-8')
-        return json.loads(content)
-    except Exception as e:
-        logger.debug('Failed to load Claude settings file', exc_info=e)
-        return None
-
-
-def _resolve_marketplace_path(marketplace: dict) -> Optional[Path]:
-    """
-    Resolve filesystem path for a directory-type marketplace.
-    """
-    source = marketplace.get('source', {})
-    if source.get('source') != 'directory':
-        return None
-    raw = source.get('path')
-    if not raw:
-        return None
-    path = Path(raw)
-    return path if path.is_dir() else None
-
-
-def _load_plugin_json_file(plugin_path: Path, relative_path: str) -> Optional[dict]:
-    """Load and parse a JSON file inside a plugin directory.
-
-    Returns None if the file is missing, unreadable, or has invalid JSON.
-    """
-    target = plugin_path / relative_path
-    if not target.exists():
-        return None
-    try:
-        return json.loads(target.read_text(encoding='utf-8'))
-    except Exception as e:
-        logger.debug('Failed to load plugin file', extra={'path': str(target)}, exc_info=e)
-        return None
-
-
-def resolve_plugins(settings: dict) -> tuple[dict, dict]:
-    """Resolve enabled plugins to their MCP servers and metadata.
-
-    Walks enabledPlugins from claude settings, resolves each plugin's 'marketplace' directory
-    via the 'extraKnownMarketplaces' field, and reads:
-      - <path>/.mcp.json for MCP servers (merged into a flat dict)
-      - <path>/.claude-plugin/plugin.json for metadata (name, version, description)
-
-    Args:
-        settings: Parsed ~/.claude/settings.json dict.
-
-    Returns:
-        Tuple of (merged_mcp_servers, enriched_plugins):
-          - merged_mcp_servers: {server_name: server_config, ...}
-          - enriched_plugins: {plugin_key: {"enabled": True, "name": ..., ...}, ...}
-    """
-    enabled = settings.get('enabledPlugins') or {}
-    marketplaces = settings.get('extraKnownMarketplaces') or {}
-    merged_mcp: dict = {}
-    enriched: dict = {}
-
-    for plugin_key, is_enabled in enabled.items():
-        if not is_enabled:
-            continue
-
-        entry: dict = {'enabled': True}
-        enriched[plugin_key] = entry
-
-        if '@' not in plugin_key:
-            continue
-
-        _plugin_name, marketplace_name = plugin_key.split('@', 1)
-        marketplace = marketplaces.get(marketplace_name)
-        if not marketplace:
-            continue
-
-        plugin_path = _resolve_marketplace_path(marketplace)
-        if plugin_path is None:
-            continue
-
-        metadata = _load_plugin_json_file(plugin_path, '.claude-plugin/plugin.json') or {}
-        for field in ('name', 'version', 'description'):
-            if field in metadata:
-                entry[field] = metadata[field]
-
-        mcp_config = _load_plugin_json_file(plugin_path, '.mcp.json') or {}
-        plugin_server_names = []
-        for server_name, server_cfg in (mcp_config.get('mcpServers') or {}).items():
-            merged_mcp[server_name] = server_cfg
-            plugin_server_names.append(server_name)
-        if plugin_server_names:
-            entry['mcp_server_names'] = plugin_server_names
-
-    return merged_mcp, enriched

cycode/cli/apps/ai_guardrails/scan/cursor_config.py

@@ -1,36 +0,0 @@
-"""Reader for ~/.cursor/mcp.json configuration file.
-
-Extracts MCP server definitions from the Cursor global config file
-for use in AI guardrails session-context reporting.
-"""
-
-import json
-from pathlib import Path
-from typing import Optional
-
-from cycode.logger import get_logger
-
-logger = get_logger('AI Guardrails Cursor Config')
-
-_CURSOR_MCP_CONFIG_PATH = Path.home() / '.cursor' / 'mcp.json'
-
-
-def load_cursor_config(config_path: Optional[Path] = None) -> Optional[dict]:
-    """Load and parse ~/.cursor/mcp.json.
-
-    Args:
-        config_path: Override path for testing. Defaults to ~/.cursor/mcp.json.
-
-    Returns:
-        Parsed dict or None if file is missing or invalid.
-    """
-    path = config_path or _CURSOR_MCP_CONFIG_PATH
-    if not path.exists():
-        logger.debug('Cursor MCP config file not found', extra={'path': str(path)})
-        return None
-    try:
-        content = path.read_text(encoding='utf-8')
-        return json.loads(content)
-    except Exception as e:
-        logger.debug('Failed to load Cursor MCP config file', exc_info=e)
-        return None

cycode/cli/apps/ai_guardrails/scan/response_builders.py

@@ -1,135 +0,0 @@
-"""
-Response builders for different AI IDE hooks.
-
-Each IDE has its own response format for hooks. This module provides
-an abstract interface and concrete implementations for each supported IDE.
-"""
-
-from abc import ABC, abstractmethod
-
-from cycode.cli.apps.ai_guardrails.consts import AIIDEType
-
-
-class IDEResponseBuilder(ABC):
-    """Abstract base class for IDE-specific response builders."""
-
-    @abstractmethod
-    def allow_permission(self) -> dict:
-        """Build response to allow file read or MCP execution."""
-
-    @abstractmethod
-    def deny_permission(self, user_message: str, agent_message: str) -> dict:
-        """Build response to deny file read or MCP execution."""
-
-    @abstractmethod
-    def ask_permission(self, user_message: str, agent_message: str) -> dict:
-        """Build response to ask user for permission (warn mode)."""
-
-    @abstractmethod
-    def allow_prompt(self) -> dict:
-        """Build response to allow prompt submission."""
-
-    @abstractmethod
-    def deny_prompt(self, user_message: str) -> dict:
-        """Build response to deny prompt submission."""
-
-
-class CursorResponseBuilder(IDEResponseBuilder):
-    """Response builder for Cursor IDE hooks.
-
-    Cursor hook response formats:
-    - beforeSubmitPrompt: {"continue": bool, "user_message": str}
-    - beforeReadFile: {"permission": str, "user_message": str, "agent_message": str}
-    - beforeMCPExecution: {"permission": str, "user_message": str, "agent_message": str}
-    """
-
-    def allow_permission(self) -> dict:
-        """Allow file read or MCP execution."""
-        return {'permission': 'allow'}
-
-    def deny_permission(self, user_message: str, agent_message: str) -> dict:
-        """Deny file read or MCP execution."""
-        return {'permission': 'deny', 'user_message': user_message, 'agent_message': agent_message}
-
-    def ask_permission(self, user_message: str, agent_message: str) -> dict:
-        """Ask user for permission (warn mode)."""
-        return {'permission': 'ask', 'user_message': user_message, 'agent_message': agent_message}
-
-    def allow_prompt(self) -> dict:
-        """Allow prompt submission."""
-        return {'continue': True}
-
-    def deny_prompt(self, user_message: str) -> dict:
-        """Deny prompt submission."""
-        return {'continue': False, 'user_message': user_message}
-
-
-class ClaudeCodeResponseBuilder(IDEResponseBuilder):
-    """Response builder for Claude Code IDE hooks.
-
-    Claude Code hook response formats:
-    - UserPromptSubmit: {} for allow, {"decision": "block", "reason": str} for deny
-    - PreToolUse: hookSpecificOutput with permissionDecision (allow/deny/ask)
-    """
-
-    def allow_permission(self) -> dict:
-        """Allow file read or MCP execution."""
-        return {
-            'hookSpecificOutput': {
-                'hookEventName': 'PreToolUse',
-                'permissionDecision': 'allow',
-            }
-        }
-
-    def deny_permission(self, user_message: str, agent_message: str) -> dict:
-        """Deny file read or MCP execution."""
-        return {
-            'hookSpecificOutput': {
-                'hookEventName': 'PreToolUse',
-                'permissionDecision': 'deny',
-                'permissionDecisionReason': user_message,
-            }
-        }
-
-    def ask_permission(self, user_message: str, agent_message: str) -> dict:
-        """Ask user for permission (warn mode)."""
-        return {
-            'hookSpecificOutput': {
-                'hookEventName': 'PreToolUse',
-                'permissionDecision': 'ask',
-                'permissionDecisionReason': user_message,
-            }
-        }
-
-    def allow_prompt(self) -> dict:
-        """Allow prompt submission (empty response means allow)."""
-        return {}
-
-    def deny_prompt(self, user_message: str) -> dict:
-        """Deny prompt submission."""
-        return {'decision': 'block', 'reason': user_message}
-
-
-# Registry of response builders by IDE type
-_RESPONSE_BUILDERS: dict[str, IDEResponseBuilder] = {
-    AIIDEType.CURSOR: CursorResponseBuilder(),
-    AIIDEType.CLAUDE_CODE: ClaudeCodeResponseBuilder(),
-}
-
-
-def get_response_builder(ide: str = AIIDEType.CURSOR.value) -> IDEResponseBuilder:
-    """Get the response builder for a specific IDE.
-
-    Args:
-        ide: The IDE name (e.g., 'cursor', 'claude-code') or AIIDEType enum
-
-    Returns:
-        IDEResponseBuilder instance for the specified IDE
-
-    Raises:
-        ValueError: If the IDE is not supported
-    """
-    builder = _RESPONSE_BUILDERS.get(ide.lower())
-    if not builder:
-        raise ValueError(f'Unsupported IDE: {ide}. Supported IDEs: {list(_RESPONSE_BUILDERS.keys())}')
-    return builder