base_generator.py

#!/usr/bin/env python3

from abc import abstractmethod
from typing import List

from sync_ai_rules.core.generator_interface import OutputGenerator
from sync_ai_rules.core.rule_metadata import RuleMetadata


class BaseGenerator(OutputGenerator):
    """Base class for all generators with shared functionality."""

    @property
    def default_filenames(self) -> List[str]:
        """Default target files for all generators."""
        return [
            "AGENTS.md",
            ".github/copilot-instructions.md",
        ]

    @property
    def gitattributes_patterns(self) -> List[str]:
        return self.default_filenames

    def _format_heading(self, category: str) -> str:
        """Format category as heading."""
        return category.replace("-", " ").replace("_", " ").title()

    def _sort_rules_by_title(self, rules: List[RuleMetadata]) -> List[RuleMetadata]:
        """Sort rules alphabetically by title."""
        return sorted(rules, key=lambda r: r.title)

    @abstractmethod
    def _format_rule(self, rule: RuleMetadata) -> List[str]:
        """Format individual rule as markdown. Must be implemented by subclasses."""