scc-cli 1.4.0__py3-none-any.whl

scc_cli/subprocess_utils.py

@@ -0,0 +1,88 @@
+"""
+Provide subprocess utilities for consistent error handling.
+
+Define wrapper functions for subprocess execution with graceful timeout
+and missing executable handling.
+"""
+
+import shutil
+import subprocess
+
+
+def run_command(
+    cmd: list[str],
+    timeout: int = 10,
+    cwd: str | None = None,
+) -> str | None:
+    """Run command, return stdout if successful, None otherwise.
+
+    Handle timeouts and missing executables gracefully.
+
+    Args:
+        cmd: Command and arguments as list of strings.
+        timeout: Maximum seconds to wait for command.
+        cwd: Working directory for command execution.
+
+    Returns:
+        Stripped stdout on success, None on any failure.
+    """
+    # Pre-check: handle empty command list
+    if not cmd:
+        return None
+
+    # Pre-check: is the executable available?
+    if not shutil.which(cmd[0]):
+        return None
+
+    try:
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+            cwd=cwd,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
+        pass
+    return None
+
+
+def run_command_bool(
+    cmd: list[str],
+    timeout: int = 10,
+    cwd: str | None = None,
+) -> bool:
+    """Run command, return True if exit code is 0.
+
+    Args:
+        cmd: Command and arguments as list of strings.
+        timeout: Maximum seconds to wait for command.
+        cwd: Working directory for command execution.
+
+    Returns:
+        True if command succeeded (exit code 0), False otherwise.
+    """
+    return run_command(cmd, timeout, cwd) is not None
+
+
+def run_command_lines(
+    cmd: list[str],
+    timeout: int = 10,
+    cwd: str | None = None,
+) -> list[str]:
+    """Run command, return stdout split into lines.
+
+    Args:
+        cmd: Command and arguments as list of strings.
+        timeout: Maximum seconds to wait for command.
+        cwd: Working directory for command execution.
+
+    Returns:
+        List of output lines on success, empty list on failure.
+    """
+    output = run_command(cmd, timeout, cwd)
+    if output is None:
+        return []
+    return [line for line in output.split("\n") if line.strip()]

scc_cli/teams.py

@@ -0,0 +1,339 @@
+"""
+Team profile management.
+
+Simplified architecture: SCC generates extraKnownMarketplaces + enabledPlugins,
+Claude Code handles plugin fetching, installation, and updates natively.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any
+
+from . import config as config_module
+from .theme import Indicators
+
+if TYPE_CHECKING:
+    from .ui.list_screen import ListItem
+
+
+@dataclass
+class TeamInfo:
+    """Information about a team profile.
+
+    Provides a typed representation of team data for use in the UI layer.
+    Use from_dict() to construct from raw config dicts, and to_list_item()
+    to convert for display in pickers.
+
+    Attributes:
+        name: Team/profile name (unique identifier).
+        description: Human-readable team description.
+        plugin: Optional plugin name for the team.
+        marketplace: Optional marketplace name.
+        marketplace_type: Optional marketplace type (e.g., "github").
+        marketplace_repo: Optional marketplace repository path.
+        credential_status: Credential state ("valid", "expired", "expiring", None).
+    """
+
+    name: str
+    description: str = ""
+    plugin: str | None = None
+    marketplace: str | None = None
+    marketplace_type: str | None = None
+    marketplace_repo: str | None = None
+    credential_status: str | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> TeamInfo:
+        """Create TeamInfo from a dict representation.
+
+        Args:
+            data: Dict with team fields (from list_teams or get_team_details).
+
+        Returns:
+            TeamInfo dataclass instance.
+        """
+        return cls(
+            name=data.get("name", "unknown"),
+            description=data.get("description", ""),
+            plugin=data.get("plugin"),
+            marketplace=data.get("marketplace"),
+            marketplace_type=data.get("marketplace_type"),
+            marketplace_repo=data.get("marketplace_repo"),
+            credential_status=data.get("credential_status"),
+        )
+
+    def to_list_item(self, *, current_team: str | None = None) -> ListItem[TeamInfo]:
+        """Convert to ListItem for display in pickers.
+
+        Args:
+            current_team: Currently selected team name (marked with indicator).
+
+        Returns:
+            ListItem suitable for ListScreen display.
+
+        Example:
+            >>> team = TeamInfo(name="platform", description="Platform team")
+            >>> item = team.to_list_item(current_team="platform")
+            >>> item.label
+            '✓ platform'
+        """
+        from .ui.list_screen import ListItem
+
+        is_current = current_team is not None and self.name == current_team
+
+        # Build label with current indicator
+        label = f"{Indicators.get('PASS')} {self.name}" if is_current else self.name
+
+        # Check for credential/governance status
+        governance_status: str | None = None
+        if self.credential_status == "expired":
+            governance_status = "blocked"
+        elif self.credential_status == "expiring":
+            governance_status = "warning"
+
+        # Build description parts
+        desc_parts: list[str] = []
+        if self.description:
+            desc_parts.append(self.description)
+        if self.credential_status == "expired":
+            desc_parts.append("(credentials expired)")
+        elif self.credential_status == "expiring":
+            desc_parts.append("(credentials expiring)")
+
+        return ListItem(
+            value=self,
+            label=label,
+            description="  ".join(desc_parts),
+            governance_status=governance_status,
+        )
+
+
+def list_teams(
+    cfg: dict[str, Any], org_config: dict[str, Any] | None = None
+) -> list[dict[str, Any]]:
+    """List available teams from configuration.
+
+    Args:
+        cfg: User config (used for legacy fallback)
+        org_config: Organization config with profiles. If provided, uses
+            NEW architecture. If None, falls back to legacy behavior.
+
+    Returns:
+        List of team dicts with name, description, plugin
+    """
+    # NEW architecture: use org_config for profiles
+    if org_config is not None:
+        profiles = org_config.get("profiles", {})
+    else:
+        # Legacy fallback
+        profiles = cfg.get("profiles", {})
+
+    teams = []
+    for name, info in profiles.items():
+        teams.append(
+            {
+                "name": name,
+                "description": info.get("description", ""),
+                "plugin": info.get("plugin"),
+            }
+        )
+
+    return teams
+
+
+def get_team_details(
+    team: str, cfg: dict[str, Any], org_config: dict[str, Any] | None = None
+) -> dict[str, Any] | None:
+    """Get detailed information for a specific team.
+
+    Args:
+        team: Team/profile name.
+        cfg: User config (used for legacy fallback).
+        org_config: Organization config. If provided, uses NEW architecture.
+
+    Returns:
+        Team details dict, or None if team doesn't exist.
+    """
+    # NEW architecture: use org_config for profiles
+    if org_config is not None:
+        profiles = org_config.get("profiles", {})
+        marketplaces = org_config.get("marketplaces", [])
+    else:
+        # Legacy fallback
+        profiles = cfg.get("profiles", {})
+        marketplaces = []
+
+    team_info = profiles.get(team)
+    if not team_info:
+        return None
+
+    # Get marketplace info
+    if org_config is not None:
+        # NEW: look up marketplace by name from org_config
+        marketplace_name = team_info.get("marketplace")
+        marketplace: dict[str, Any] = next(
+            (m for m in marketplaces if m.get("name") == marketplace_name),
+            {},
+        )
+        return {
+            "name": team,
+            "description": team_info.get("description", ""),
+            "plugin": team_info.get("plugin"),
+            "marketplace": marketplace.get("name"),
+            "marketplace_type": marketplace.get("type"),
+            "marketplace_repo": marketplace.get("repo"),
+        }
+    else:
+        # Legacy: single marketplace in cfg
+        marketplace = cfg.get("marketplace", {})
+        return {
+            "name": team,
+            "description": team_info.get("description", ""),
+            "plugin": team_info.get("plugin"),
+            "marketplace": marketplace.get("name"),
+            "marketplace_repo": marketplace.get("repo"),
+        }
+
+
+def get_team_sandbox_settings(team_name: str, cfg: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Generate sandbox settings for a team profile.
+
+    Return settings.json content with extraKnownMarketplaces
+    and enabledPlugins configured for Claude Code.
+
+    This is the core function of the simplified architecture:
+    - SCC injects these settings into the Docker sandbox volume
+    - Claude Code sees extraKnownMarketplaces and fetches the marketplace
+    - Claude Code installs the specified plugin automatically
+    - Teams maintain their plugins in the marketplace repo
+
+    Args:
+        team_name: Name of the team profile (e.g., "api-team").
+        cfg: Optional config dict. If None, load from config file.
+
+    Returns:
+        Dict with extraKnownMarketplaces and enabledPlugins for settings.json.
+        Return empty dict if team has no plugin configured.
+    """
+    if cfg is None:
+        cfg = config_module.load_config()
+
+    marketplace = cfg.get("marketplace", {})
+    marketplace_name = marketplace.get("name", "sundsvall")
+    marketplace_repo = marketplace.get("repo", "sundsvall/claude-plugins-marketplace")
+
+    profile = cfg.get("profiles", {}).get(team_name, {})
+    plugin_name = profile.get("plugin")
+
+    # No plugin configured for this profile
+    if not plugin_name:
+        return {}
+
+    # Generate settings that Claude Code understands
+    return {
+        "extraKnownMarketplaces": {
+            marketplace_name: {
+                "source": {
+                    "source": "github",
+                    "repo": marketplace_repo,
+                }
+            }
+        },
+        "enabledPlugins": [f"{plugin_name}@{marketplace_name}"],
+    }
+
+
+def get_team_plugin_id(team_name: str, cfg: dict[str, Any] | None = None) -> str | None:
+    """Get the full plugin ID for a team (e.g., "api-team@sundsvall").
+
+    Args:
+        team_name: Name of the team profile.
+        cfg: Optional config dict. If None, load from config file.
+
+    Returns:
+        Full plugin ID string, or None if team has no plugin configured.
+    """
+    if cfg is None:
+        cfg = config_module.load_config()
+
+    marketplace = cfg.get("marketplace", {})
+    marketplace_name = marketplace.get("name", "sundsvall")
+
+    profile = cfg.get("profiles", {}).get(team_name, {})
+    plugin_name = profile.get("plugin")
+
+    if not plugin_name:
+        return None
+
+    return f"{plugin_name}@{marketplace_name}"
+
+
+def validate_team_profile(
+    team_name: str,
+    cfg: dict[str, Any] | None = None,
+    org_config: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    """Validate a team profile configuration.
+
+    Args:
+        team_name: Name of the team/profile to validate.
+        cfg: User config (deprecated, kept for backward compatibility).
+        org_config: Organization config with profiles and marketplaces.
+            If provided, use NEW architecture. If None, fall back to
+            legacy behavior (reading profiles from cfg).
+
+    Returns:
+        Dict with keys: valid (bool), team (str), plugin (str or None),
+        errors (list of str), warnings (list of str).
+    """
+    if cfg is None:
+        cfg = config_module.load_config()
+
+    result: dict[str, Any] = {
+        "valid": True,
+        "team": team_name,
+        "plugin": None,
+        "errors": [],
+        "warnings": [],
+    }
+
+    # NEW architecture: use org_config for profiles
+    if org_config is not None:
+        profiles = org_config.get("profiles", {})
+        marketplaces = org_config.get("marketplaces", [])
+    else:
+        # Legacy fallback: read from user config (deprecated)
+        profiles = cfg.get("profiles", {})
+        marketplaces = []
+
+    # Check if team exists
+    if team_name not in profiles:
+        result["valid"] = False
+        result["errors"].append(f"Team '{team_name}' not found in profiles")
+        return result
+
+    profile = profiles[team_name]
+    result["plugin"] = profile.get("plugin")
+
+    # Check marketplace configuration (NEW architecture)
+    if org_config is not None:
+        marketplace_name = profile.get("marketplace")
+        if marketplace_name:
+            # Find the marketplace in org_config
+            marketplace_found = any(m.get("name") == marketplace_name for m in marketplaces)
+            if not marketplace_found:
+                result["warnings"].append(f"Marketplace '{marketplace_name}' not found")
+    else:
+        # Legacy: check single marketplace
+        marketplace = cfg.get("marketplace", {})
+        if not marketplace.get("repo"):
+            result["warnings"].append("No marketplace repo configured")
+
+    # Check if plugin is configured (not required for 'base' profile)
+    if not result["plugin"] and team_name != "base":
+        result["warnings"].append(
+            f"Team '{team_name}' has no plugin configured - using base settings"
+        )
+
+    return result

scc_cli/templates/__init__.py

@@ -0,0 +1,2 @@
+# Templates package for SCC
+# Contains template files like statusline.sh

scc_cli/templates/org/minimal.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://scc-cli.dev/schemas/org-v1.json",
+  "schema_version": "{{SCHEMA_VERSION}}",
+  "min_cli_version": "{{MIN_CLI_VERSION}}",
+  "organization": {
+    "name": "{{ORG_NAME}}",
+    "id": "{{ORG_NAME}}",
+    "contact": "admin@{{ORG_DOMAIN}}"
+  },
+  "defaults": {
+    "profile": "base",
+    "cache_ttl_hours": 24
+  },
+  "profiles": {
+    "base": {
+      "description": "Default profile with no plugins"
+    }
+  }
+}

scc_cli/templates/org/reference.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://scc-cli.dev/schemas/org-v1.json",
+  "schema_version": "{{SCHEMA_VERSION}}",
+  "min_cli_version": "{{MIN_CLI_VERSION}}",
+  "organization": {
+    "name": "{{ORG_NAME}}",
+    "id": "{{ORG_NAME}}",
+    "contact": "admin@{{ORG_DOMAIN}}"
+  },
+  "marketplaces": [
+    {
+      "name": "github-public",
+      "type": "github",
+      "repo": "{{ORG_NAME}}/claude-plugins-marketplace",
+      "ref": "main",
+      "auth": null
+    },
+    {
+      "name": "github-private",
+      "type": "github",
+      "repo": "{{ORG_NAME}}/claude-plugins-private",
+      "ref": "v1.0.0",
+      "auth": "env:GITHUB_TOKEN"
+    },
+    {
+      "name": "gitlab-self-hosted",
+      "type": "gitlab",
+      "host": "gitlab.{{ORG_DOMAIN}}",
+      "repo": "devtools/plugins",
+      "ref": "main",
+      "auth": "env:GITLAB_TOKEN"
+    },
+    {
+      "name": "custom-https",
+      "type": "https",
+      "url": "https://plugins.{{ORG_DOMAIN}}/marketplace.json",
+      "auth": "env:CUSTOM_API_KEY"
+    }
+  ],
+  "defaults": {
+    "profile": "base",
+    "cache_ttl_hours": 24
+  },
+  "profiles": {
+    "base": {
+      "description": "Default profile without plugins - safe baseline"
+    },
+    "platform": {
+      "description": "Platform engineering with infrastructure tools",
+      "plugin": "platform-tools",
+      "marketplace": "github-public"
+    },
+    "backend": {
+      "description": "Backend development with API and database tools",
+      "plugin": "backend-tools",
+      "marketplace": "github-public"
+    },
+    "frontend": {
+      "description": "Frontend development with UI component tools",
+      "plugin": "frontend-tools",
+      "marketplace": "github-public"
+    },
+    "security": {
+      "description": "Security team with audit and scanning tools",
+      "plugin": "security-tools",
+      "marketplace": "github-private"
+    },
+    "devops": {
+      "description": "DevOps with CI/CD and deployment tools",
+      "plugin": "devops-tools",
+      "marketplace": "gitlab-self-hosted"
+    }
+  }
+}

scc_cli/templates/org/strict.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://scc-cli.dev/schemas/org-v1.json",
+  "schema_version": "{{SCHEMA_VERSION}}",
+  "min_cli_version": "{{MIN_CLI_VERSION}}",
+  "organization": {
+    "name": "{{ORG_NAME}}",
+    "id": "{{ORG_NAME}}",
+    "contact": "security@{{ORG_DOMAIN}}"
+  },
+  "marketplaces": [
+    {
+      "name": "{{ORG_NAME}}-secure",
+      "type": "github",
+      "repo": "{{ORG_NAME}}/claude-plugins-secure",
+      "ref": "v1.0.0",
+      "auth": "env:GITHUB_TOKEN"
+    }
+  ],
+  "defaults": {
+    "profile": "restricted",
+    "cache_ttl_hours": 1
+  },
+  "profiles": {
+    "restricted": {
+      "description": "Restricted access - security-audited plugins only"
+    },
+    "approved": {
+      "description": "Approved plugins for general development",
+      "plugin": "approved-base",
+      "marketplace": "{{ORG_NAME}}-secure"
+    },
+    "audit": {
+      "description": "Audit and compliance team",
+      "plugin": "audit-tools",
+      "marketplace": "{{ORG_NAME}}-secure"
+    }
+  }
+}

scc_cli/templates/org/teams.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://scc-cli.dev/schemas/org-v1.json",
+  "schema_version": "{{SCHEMA_VERSION}}",
+  "min_cli_version": "{{MIN_CLI_VERSION}}",
+  "organization": {
+    "name": "{{ORG_NAME}}",
+    "id": "{{ORG_NAME}}",
+    "contact": "admin@{{ORG_DOMAIN}}"
+  },
+  "marketplaces": [
+    {
+      "name": "{{ORG_NAME}}-plugins",
+      "type": "github",
+      "repo": "{{ORG_NAME}}/claude-plugins-marketplace",
+      "ref": "main"
+    }
+  ],
+  "defaults": {
+    "profile": "base",
+    "cache_ttl_hours": 24
+  },
+  "profiles": {
+    "base": {
+      "description": "Default profile without team-specific plugins"
+    },
+    "platform": {
+      "description": "Platform engineering team",
+      "plugin": "platform-team",
+      "marketplace": "{{ORG_NAME}}-plugins"
+    },
+    "backend": {
+      "description": "Backend development team",
+      "plugin": "backend-team",
+      "marketplace": "{{ORG_NAME}}-plugins"
+    },
+    "frontend": {
+      "description": "Frontend development team",
+      "plugin": "frontend-team",
+      "marketplace": "{{ORG_NAME}}-plugins"
+    }
+  }
+}

scc_cli/templates/statusline.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+# SCC Status Line for Claude Code
+# Shows: Model | Git branch/worktree | Lines changed
+#
+# Install: scc statusline --install
+# This script receives JSON from Claude Code via stdin
+
+# Read JSON input from stdin
+input=$(cat)
+
+# Extract values using jq
+MODEL=$(echo "$input" | jq -r '.model.display_name // "Unknown"')
+CURRENT_DIR=$(echo "$input" | jq -r '.workspace.current_dir // "."')
+PROJECT_DIR=$(echo "$input" | jq -r '.workspace.project_dir // "."')
+LINES_ADDED=$(echo "$input" | jq -r '.cost.total_lines_added // 0')
+LINES_REMOVED=$(echo "$input" | jq -r '.cost.total_lines_removed // 0')
+
+# Colors
+CYAN="\033[36m"
+GREEN="\033[32m"
+RED="\033[31m"
+MAGENTA="\033[35m"
+YELLOW="\033[33m"
+WHITE="\033[1;37m"
+DIM="\033[2m"
+RESET="\033[0m"
+
+# Git information
+GIT_INFO=""
+cd "$CURRENT_DIR" 2>/dev/null || cd "$PROJECT_DIR" 2>/dev/null
+
+if git rev-parse --git-dir > /dev/null 2>&1; then
+    # Get branch name
+    BRANCH=$(git branch --show-current 2>/dev/null)
+    if [ -z "$BRANCH" ]; then
+        # Detached HEAD - show short SHA
+        BRANCH=$(git rev-parse --short HEAD 2>/dev/null || echo "detached")
+    fi
+
+    # Check if we're in a worktree
+    GIT_DIR=$(git rev-parse --git-dir 2>/dev/null)
+
+    if [[ "$GIT_DIR" == *".git/worktrees/"* ]]; then
+        # In a worktree - show ⎇ icon
+        WORKTREE_NAME=$(basename "$(dirname "$GIT_DIR")" 2>/dev/null)
+        GIT_INFO="${MAGENTA}⎇ ${WORKTREE_NAME}${RESET}:${CYAN}${BRANCH}${RESET}"
+    else
+        # Regular repo - show 🌿 icon
+        GIT_INFO="${CYAN}🌿 ${BRANCH}${RESET}"
+    fi
+
+    # Check for uncommitted changes
+    if ! git diff --quiet 2>/dev/null || ! git diff --cached --quiet 2>/dev/null; then
+        GIT_INFO="${GIT_INFO}${YELLOW}*${RESET}"
+    fi
+fi
+
+# Lines changed (only show if any changes made)
+LINES_INFO=""
+if [ "$LINES_ADDED" -gt 0 ] || [ "$LINES_REMOVED" -gt 0 ]; then
+    LINES_INFO=" ${DIM}|${RESET} ${GREEN}+${LINES_ADDED}${RESET} ${RED}-${LINES_REMOVED}${RESET}"
+fi
+
+# Build the status line
+# Format: [Model] 🌿 branch* | +156 -23
+OUTPUT="${WHITE}[${MODEL}]${RESET}"
+
+if [ -n "$GIT_INFO" ]; then
+    OUTPUT="${OUTPUT} ${GIT_INFO}"
+fi
+
+OUTPUT="${OUTPUT}${LINES_INFO}"
+
+# Output (printf handles escape codes)
+printf "%b\n" "$OUTPUT"