devsync 0.10.0__tar.gz → 0.12.0__tar.gz

devsync-0.12.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.1
+Name: devsync
+Version: 0.12.0
+Summary: Distribute and sync dev tool configurations across teams
+Author-email: Troy Larson <troy@calvinware.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/troylar/devsync
+Project-URL: Documentation, https://devsync.readthedocs.io
+Project-URL: Repository, https://github.com/troylar/devsync
+Project-URL: Issues, https://github.com/troylar/devsync/issues
+Keywords: cli,ai,config,mcp,cursor,copilot,claude,cline,codex,kiro,roo,windsurf
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.15.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: textual>=6.0.0
+Requires-Dist: GitPython>=3.1.45
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: black==24.10.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: invoke>=2.0.0; extra == "dev"
+Requires-Dist: build>=1.2.1; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.12.20240808; extra == "dev"
+
+<div align="center">
+
+# DevSync
+
+**AI-powered config distribution for AI coding assistants**
+
+[![CI](https://github.com/troylar/devsync/actions/workflows/ci.yml/badge.svg)](https://github.com/troylar/devsync/actions/workflows/ci.yml)
+[![Docs](https://readthedocs.org/projects/devsync/badge/?version=latest)](https://devsync.readthedocs.io)
+[![PyPI version](https://img.shields.io/pypi/v/devsync.svg)](https://pypi.org/project/devsync/)
+[![Coverage](https://codecov.io/gh/troylar/devsync/branch/main/graph/badge.svg)](https://codecov.io/gh/troylar/devsync)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Works with:** Aider | Amazon Q | Amp | Antigravity | Augment | Claude Code | Claude Desktop | Cline | Codex CLI | Continue.dev | Cursor | Gemini CLI | GitHub Copilot | JetBrains AI | Junie | Kiro | OpenCode | OpenHands | Roo Code | Tabnine | Trae | Windsurf | Zed
+
+</div>
+
+---
+
+DevSync uses LLM intelligence to extract coding practices from projects and adapt them to recipients' existing setups -- across 23+ AI coding assistants. Two commands: `extract` and `install`.
+
+## Quick Start
+
+```bash
+pip install devsync
+
+# One-time: configure your LLM provider
+devsync setup
+
+# Check detected AI tools
+devsync tools
+
+# Extract practices from a project
+devsync extract
+
+# Install a package into another project
+devsync install ./team-standards
+
+# Install from Git
+devsync install https://github.com/company/standards
+```
+
+No API key? DevSync works without one -- it falls back to file-copy mode. Add `--no-ai` to any command to force this.
+
+## Features
+
+- **AI-powered extraction** -- LLM reads your project's rules, MCP configs, and commands to produce abstract practice declarations
+- **AI-powered installation** -- LLM adapts incoming practices to your existing setup with intelligent merging
+- **23+ AI tool integrations** -- Claude Code, Cursor, Windsurf, GitHub Copilot, Kiro, Roo Code, Cline, Codex, and more
+- **MCP credential handling** -- prompts for credentials at install time, never stores them in repos
+- **v1 backward compatibility** -- old `ai-config-kit-package.yaml` packages still install via file-copy
+- **Graceful degradation** -- works without an API key, `--no-ai` flag for explicit file-copy mode
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `devsync setup` | Configure LLM provider (Anthropic, OpenAI, OpenRouter) |
+| `devsync tools` | Detect installed AI coding tools |
+| `devsync extract` | Extract practices from current project into a shareable package |
+| `devsync install <source>` | Install a package with AI-powered adaptation |
+| `devsync list` | Show installed packages |
+| `devsync uninstall <name>` | Remove an installed package |
+
+## Migrating from v1
+
+If you have v1 packages (`ai-config-kit-package.yaml`), they still work with `devsync install`. To upgrade them to v2 format:
+
+```bash
+devsync extract --upgrade ./old-package
+```
+
+## Documentation
+
+Full documentation at **[devsync.readthedocs.io](https://devsync.readthedocs.io)**:
+
+- [Getting Started](https://devsync.readthedocs.io/getting-started/installation/) -- installation, quickstart, core concepts
+- [CLI Reference](https://devsync.readthedocs.io/cli/) -- all commands with examples
+- [IDE Integrations](https://devsync.readthedocs.io/ide-integrations/) -- setup guides for each AI tool
+- [Packages](https://devsync.readthedocs.io/packages/) -- creating and installing config packages
+- [MCP Server](https://devsync.readthedocs.io/mcp-server/) -- MCP configuration management
+- [Tutorials](https://devsync.readthedocs.io/tutorials/team-config-repo/) -- step-by-step walkthroughs
+
+## Contributing
+
+```bash
+git clone https://github.com/troylar/devsync.git
+cd devsync
+pip install -e .[dev]
+invoke test
+```
+
+See the [contributing guide](https://devsync.readthedocs.io/advanced/contributing/) for details.
+
+## License
+
+MIT -- see [LICENSE](LICENSE).

devsync-0.12.0/README.md

@@ -0,0 +1,97 @@
+<div align="center">
+
+# DevSync
+
+**AI-powered config distribution for AI coding assistants**
+
+[![CI](https://github.com/troylar/devsync/actions/workflows/ci.yml/badge.svg)](https://github.com/troylar/devsync/actions/workflows/ci.yml)
+[![Docs](https://readthedocs.org/projects/devsync/badge/?version=latest)](https://devsync.readthedocs.io)
+[![PyPI version](https://img.shields.io/pypi/v/devsync.svg)](https://pypi.org/project/devsync/)
+[![Coverage](https://codecov.io/gh/troylar/devsync/branch/main/graph/badge.svg)](https://codecov.io/gh/troylar/devsync)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Works with:** Aider | Amazon Q | Amp | Antigravity | Augment | Claude Code | Claude Desktop | Cline | Codex CLI | Continue.dev | Cursor | Gemini CLI | GitHub Copilot | JetBrains AI | Junie | Kiro | OpenCode | OpenHands | Roo Code | Tabnine | Trae | Windsurf | Zed
+
+</div>
+
+---
+
+DevSync uses LLM intelligence to extract coding practices from projects and adapt them to recipients' existing setups -- across 23+ AI coding assistants. Two commands: `extract` and `install`.
+
+## Quick Start
+
+```bash
+pip install devsync
+
+# One-time: configure your LLM provider
+devsync setup
+
+# Check detected AI tools
+devsync tools
+
+# Extract practices from a project
+devsync extract
+
+# Install a package into another project
+devsync install ./team-standards
+
+# Install from Git
+devsync install https://github.com/company/standards
+```
+
+No API key? DevSync works without one -- it falls back to file-copy mode. Add `--no-ai` to any command to force this.
+
+## Features
+
+- **AI-powered extraction** -- LLM reads your project's rules, MCP configs, and commands to produce abstract practice declarations
+- **AI-powered installation** -- LLM adapts incoming practices to your existing setup with intelligent merging
+- **23+ AI tool integrations** -- Claude Code, Cursor, Windsurf, GitHub Copilot, Kiro, Roo Code, Cline, Codex, and more
+- **MCP credential handling** -- prompts for credentials at install time, never stores them in repos
+- **v1 backward compatibility** -- old `ai-config-kit-package.yaml` packages still install via file-copy
+- **Graceful degradation** -- works without an API key, `--no-ai` flag for explicit file-copy mode
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `devsync setup` | Configure LLM provider (Anthropic, OpenAI, OpenRouter) |
+| `devsync tools` | Detect installed AI coding tools |
+| `devsync extract` | Extract practices from current project into a shareable package |
+| `devsync install <source>` | Install a package with AI-powered adaptation |
+| `devsync list` | Show installed packages |
+| `devsync uninstall <name>` | Remove an installed package |
+
+## Migrating from v1
+
+If you have v1 packages (`ai-config-kit-package.yaml`), they still work with `devsync install`. To upgrade them to v2 format:
+
+```bash
+devsync extract --upgrade ./old-package
+```
+
+## Documentation
+
+Full documentation at **[devsync.readthedocs.io](https://devsync.readthedocs.io)**:
+
+- [Getting Started](https://devsync.readthedocs.io/getting-started/installation/) -- installation, quickstart, core concepts
+- [CLI Reference](https://devsync.readthedocs.io/cli/) -- all commands with examples
+- [IDE Integrations](https://devsync.readthedocs.io/ide-integrations/) -- setup guides for each AI tool
+- [Packages](https://devsync.readthedocs.io/packages/) -- creating and installing config packages
+- [MCP Server](https://devsync.readthedocs.io/mcp-server/) -- MCP configuration management
+- [Tutorials](https://devsync.readthedocs.io/tutorials/team-config-repo/) -- step-by-step walkthroughs
+
+## Contributing
+
+```bash
+git clone https://github.com/troylar/devsync.git
+cd devsync
+pip install -e .[dev]
+invoke test
+```
+
+See the [contributing guide](https://devsync.readthedocs.io/advanced/contributing/) for details.
+
+## License
+
+MIT -- see [LICENSE](LICENSE).

devsync-0.12.0/devsync/ai_tools/anteroom.py

@@ -0,0 +1,216 @@
+"""Anteroom AI tool integration."""
+
+import re
+import shutil
+from pathlib import Path
+from typing import Optional
+
+from devsync.ai_tools.base import AITool
+from devsync.core.models import AIToolType, InstallationScope, Instruction
+
+START_MARKER = "<!-- devsync:start:{name} -->"
+END_MARKER = "<!-- devsync:end:{name} -->"
+SECTION_PATTERN = r"<!-- devsync:start:{name} -->\n.*?\n<!-- devsync:end:{name} -->"
+
+
+class AnteroomTool(AITool):
+    """Integration for Anteroom.
+
+    Anteroom reads a single ANTEROOM.md file at the project root.
+    DevSync manages individual instruction sections using HTML comment markers:
+
+        <!-- devsync:start:instruction-name -->
+        ... instruction content ...
+        <!-- devsync:end:instruction-name -->
+    """
+
+    @property
+    def tool_type(self) -> AIToolType:
+        """Return the AI tool type identifier."""
+        return AIToolType.ANTEROOM
+
+    @property
+    def tool_name(self) -> str:
+        """Return human-readable tool name."""
+        return "Anteroom"
+
+    def is_installed(self) -> bool:
+        """Check if Anteroom is installed on the system.
+
+        Returns:
+            True if aroom binary is found on PATH or ~/.anteroom/ exists
+        """
+        if shutil.which("aroom") is not None:
+            return True
+        config_dir = Path.home() / ".anteroom"
+        return config_dir.exists()
+
+    def get_instructions_directory(self) -> Path:
+        """Get the directory where instructions should be installed.
+
+        Raises:
+            NotImplementedError: Anteroom only supports project-level installation
+        """
+        raise NotImplementedError(
+            f"{self.tool_name} global installation is not supported. "
+            "Anteroom uses project-level ANTEROOM.md only. "
+            "Please use project-level installation instead (--scope project)."
+        )
+
+    def get_instruction_file_extension(self) -> str:
+        """Get the file extension for Anteroom instructions.
+
+        Returns:
+            File extension including the dot
+        """
+        return ".md"
+
+    def get_project_instructions_directory(self, project_root: Path) -> Path:
+        """Get the directory for project-specific Anteroom instructions.
+
+        ANTEROOM.md lives at the project root.
+
+        Args:
+            project_root: Path to the project root directory
+
+        Returns:
+            Path to project root
+        """
+        return project_root
+
+    def get_instruction_path(
+        self,
+        instruction_name: str,
+        scope: InstallationScope = InstallationScope.GLOBAL,
+        project_root: Optional[Path] = None,
+    ) -> Path:
+        """Get the path to ANTEROOM.md.
+
+        Args:
+            instruction_name: Name of the instruction (unused for path)
+            scope: Installation scope (must be PROJECT)
+            project_root: Project root path
+
+        Returns:
+            Path to ANTEROOM.md
+
+        Raises:
+            ValueError: If scope is PROJECT but project_root is None
+            NotImplementedError: If scope is GLOBAL
+        """
+        if scope == InstallationScope.GLOBAL:
+            raise NotImplementedError(
+                f"{self.tool_name} global installation is not supported. "
+                "Please use project-level installation instead (--scope project)."
+            )
+        if project_root is None:
+            raise ValueError("project_root is required for PROJECT scope")
+        return project_root / "ANTEROOM.md"
+
+    def instruction_exists(
+        self,
+        instruction_name: str,
+        scope: InstallationScope = InstallationScope.GLOBAL,
+        project_root: Optional[Path] = None,
+    ) -> bool:
+        """Check if an instruction section exists in ANTEROOM.md.
+
+        Args:
+            instruction_name: Name of the instruction
+            scope: Installation scope
+            project_root: Project root path
+
+        Returns:
+            True if the instruction's section markers exist in ANTEROOM.md
+        """
+        try:
+            path = self.get_instruction_path(instruction_name, scope, project_root)
+            if not path.exists():
+                return False
+            content = path.read_text(encoding="utf-8")
+            start = START_MARKER.format(name=instruction_name)
+            return start in content
+        except (FileNotFoundError, ValueError, NotImplementedError):
+            return False
+
+    def install_instruction(
+        self,
+        instruction: Instruction,
+        overwrite: bool = False,
+        scope: InstallationScope = InstallationScope.GLOBAL,
+        project_root: Optional[Path] = None,
+    ) -> Path:
+        """Install an instruction as a section in ANTEROOM.md.
+
+        Args:
+            instruction: Instruction to install
+            overwrite: Whether to overwrite existing section
+            scope: Installation scope
+            project_root: Project root path
+
+        Returns:
+            Path to ANTEROOM.md
+
+        Raises:
+            FileExistsError: If instruction section exists and overwrite=False
+        """
+        path = self.get_instruction_path(instruction.name, scope, project_root)
+
+        start = START_MARKER.format(name=instruction.name)
+        end = END_MARKER.format(name=instruction.name)
+        section = f"{start}\n{instruction.content}\n{end}"
+
+        if path.exists():
+            content = path.read_text(encoding="utf-8")
+            if start in content:
+                if not overwrite:
+                    raise FileExistsError(f"Instruction already exists in ANTEROOM.md: {instruction.name}")
+                pattern = SECTION_PATTERN.format(name=re.escape(instruction.name))
+                content = re.sub(pattern, section, content, flags=re.DOTALL)
+                path.write_text(content, encoding="utf-8")
+                return path
+            if content and not content.endswith("\n"):
+                content += "\n"
+            content += "\n" + section + "\n"
+            path.write_text(content, encoding="utf-8")
+        else:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            path.write_text(section + "\n", encoding="utf-8")
+
+        return path
+
+    def uninstall_instruction(
+        self,
+        instruction_name: str,
+        scope: InstallationScope = InstallationScope.GLOBAL,
+        project_root: Optional[Path] = None,
+    ) -> bool:
+        """Remove an instruction section from ANTEROOM.md.
+
+        Args:
+            instruction_name: Name of instruction to remove
+            scope: Installation scope
+            project_root: Project root path
+
+        Returns:
+            True if section was removed, False if it didn't exist
+        """
+        try:
+            path = self.get_instruction_path(instruction_name, scope, project_root)
+            if not path.exists():
+                return False
+
+            content = path.read_text(encoding="utf-8")
+            start = START_MARKER.format(name=instruction_name)
+            if start not in content:
+                return False
+
+            pattern = SECTION_PATTERN.format(name=re.escape(instruction_name))
+            new_content = re.sub(pattern, "", content, flags=re.DOTALL)
+            new_content = re.sub(r"\n{3,}", "\n\n", new_content).strip()
+            if new_content:
+                new_content += "\n"
+            path.write_text(new_content, encoding="utf-8")
+            return True
+        except (FileNotFoundError, ValueError, NotImplementedError):
+            return False

{devsync-0.10.0 → devsync-0.12.0}/devsync/ai_tools/capability_registry.py

@@ -461,6 +461,24 @@ CAPABILITY_REGISTRY: dict[AIToolType, IDECapability] = {
             "DevSync manages sections within this file using HTML comment markers."
         ),
     ),
+    AIToolType.ANTEROOM: IDECapability(
+        tool_type=AIToolType.ANTEROOM,
+        tool_name="Anteroom",
+        supported_components={
+            ComponentType.INSTRUCTION,
+            ComponentType.RESOURCE,
+        },
+        instructions_directory="",
+        instruction_file_extension=".md",
+        supports_project_scope=True,
+        supports_global_scope=False,
+        mcp_config_path=None,
+        mcp_project_config_path=None,
+        notes=(
+            "Anteroom uses a single ANTEROOM.md file at the project root. "
+            "DevSync manages sections within this file using HTML comment markers."
+        ),
+    ),
     AIToolType.COPILOT: IDECapability(
         tool_type=AIToolType.COPILOT,
         tool_name="GitHub Copilot",

{devsync-0.10.0 → devsync-0.12.0}/devsync/ai_tools/detector.py

@@ -5,6 +5,7 @@ from typing import Optional
 from devsync.ai_tools.aider import AiderTool
 from devsync.ai_tools.amazonq import AmazonQTool
 from devsync.ai_tools.amp import AmpTool
+from devsync.ai_tools.anteroom import AnteroomTool
 from devsync.ai_tools.antigravity import AntigravityTool
 from devsync.ai_tools.augment import AugmentTool
 from devsync.ai_tools.base import AITool
@@ -56,6 +57,7 @@ class AIToolDetector:
             AIToolType.OPENHANDS: OpenHandsTool(),
             AIToolType.AMP: AmpTool(),
             AIToolType.OPENCODE: OpenCodeTool(),
+            AIToolType.ANTEROOM: AnteroomTool(),
         }
 
     def detect_installed_tools(self) -> list[AITool]:
@@ -132,6 +134,7 @@ class AIToolDetector:
             AIToolType.OPENHANDS,
             AIToolType.AMP,
             AIToolType.OPENCODE,
+            AIToolType.ANTEROOM,
         ]
 
         for tool_type in priority:

{devsync-0.10.0 → devsync-0.12.0}/devsync/ai_tools/translator.py

@@ -823,6 +823,34 @@ class OpenCodeTranslator(ComponentTranslator):
         raise NotImplementedError("OpenCode does not support MCP servers")
 
 
+class AnteroomTranslator(ComponentTranslator):
+    """Translator for Anteroom (ANTEROOM.md at project root)."""
+
+    @property
+    def tool_type(self) -> AIToolType:
+        return AIToolType.ANTEROOM
+
+    def translate_instruction(self, component: InstructionComponent, package_root: Path) -> TranslatedComponent:
+        """Translate instruction to Anteroom format with section markers."""
+        instruction_path = package_root / component.file
+        with open(instruction_path, "r") as f:
+            content = f.read()
+
+        wrapped = f"<!-- devsync:start:{component.name} -->\n{content}\n<!-- devsync:end:{component.name} -->"
+
+        return TranslatedComponent(
+            component_type=ComponentType.INSTRUCTION,
+            component_name=component.name,
+            target_path="ANTEROOM.md",
+            content=wrapped,
+            metadata={"section_based": True},
+        )
+
+    def translate_mcp_server(self, component: MCPServerComponent, package_root: Path) -> TranslatedComponent:
+        """Anteroom does not support MCP servers."""
+        raise NotImplementedError("Anteroom does not support MCP servers")
+
+
 class CopilotTranslator(ComponentTranslator):
     """Translator for GitHub Copilot (.github/instructions/)."""
 
@@ -899,6 +927,7 @@ def get_translator(tool_type: AIToolType) -> ComponentTranslator:
         AIToolType.OPENHANDS: OpenHandsTranslator,
         AIToolType.AMP: AmpTranslator,
         AIToolType.OPENCODE: OpenCodeTranslator,
+        AIToolType.ANTEROOM: AnteroomTranslator,
     }
 
     translator_class = translators.get(tool_type)