llm-ide-rules 0.5.0__py3-none-any.whl → 0.7.0__py3-none-any.whl

llm_ide_rules/commands/mcp.py

@@ -0,0 +1,119 @@
+"""
+MCP configuration management commands.
+"""
+
+import json5
+import typer
+from pathlib import Path
+
+from llm_ide_rules.agents import get_agent, get_all_agents
+from llm_ide_rules.mcp import McpConfig
+from llm_ide_rules.log import log
+
+mcp_app = typer.Typer(help="MCP configuration management")
+
+
+@mcp_app.command()
+def explode(
+    input_file: str = typer.Argument("mcp.json", help="Input unified MCP config file"),
+    scope: str = typer.Option(
+        "project", "--scope", "-s", help="Scope: project, global, or both"
+    ),
+    agent: str = typer.Option(
+        "all",
+        "--agent",
+        "-a",
+        help="Agent: claude, cursor, gemini, opencode, copilot, or all",
+    ),
+) -> None:
+    """Convert unified mcp.json to platform-specific configs."""
+    input_path = Path(input_file)
+    if not input_path.exists():
+        log.error("input file not found", file=input_file)
+        raise typer.Exit(1)
+
+    config = McpConfig.model_validate(json5.loads(input_path.read_text()))
+
+    if agent == "all":
+        agents = get_all_agents()
+    else:
+        agents = [get_agent(agent)]
+
+    for ag in agents:
+        if not ag.mcp_project_path:
+            continue
+
+        mcp_project_path = ag.mcp_project_path
+
+        servers = {
+            name: ag.transform_mcp_server(s) for name, s in config.servers.items()
+        }
+
+        if scope in ("project", "both"):
+            project_path = Path.cwd() / mcp_project_path
+            ag.write_mcp_config(servers, project_path)
+            log.info("wrote project config", agent=ag.name, path=str(project_path))
+
+        if scope in ("global", "both") and ag.mcp_global_path:
+            global_path = Path.home() / ag.mcp_global_path
+            ag.write_mcp_config(servers, global_path)
+            log.info("wrote global config", agent=ag.name, path=str(global_path))
+
+
+@mcp_app.command()
+def implode(
+    output_file: str = typer.Argument(
+        "mcp.json", help="Output unified MCP config file"
+    ),
+    source: str = typer.Option(
+        None, "--source", help="Source agent to read from (e.g., claude, cursor)"
+    ),
+    scope: str = typer.Option(
+        "project", "--scope", "-s", help="Scope: project or global"
+    ),
+) -> None:
+    """Merge platform-specific MCP configs into unified mcp.json."""
+    if not source:
+        log.error("source agent must be specified")
+        raise typer.Exit(1)
+
+    ag = get_agent(source)
+
+    if scope == "project":
+        mcp_project_path = ag.mcp_project_path
+        if not mcp_project_path:
+            log.error("project config path not defined for agent", agent=source)
+            raise typer.Exit(1)
+        source_path = Path.cwd() / mcp_project_path
+    else:
+        mcp_global_path = ag.mcp_global_path
+        if not mcp_global_path:
+            log.error("global config path not defined for agent", agent=source)
+            raise typer.Exit(1)
+        source_path = Path.home() / mcp_global_path
+
+    if not source_path.exists():
+        log.error("source config not found", path=str(source_path))
+        raise typer.Exit(1)
+
+    server_configs = ag.read_mcp_config(source_path)
+    if not server_configs:
+        log.error("no MCP servers found in config", path=str(source_path))
+        raise typer.Exit(1)
+
+    servers = {
+        name: ag.reverse_transform_mcp_server(name, config)
+        for name, config in server_configs.items()
+    }
+
+    config = McpConfig(servers=servers)
+    output_path = Path(output_file)
+
+    import json
+
+    output_path.write_text(
+        json.dumps(
+            config.model_dump(exclude_none=True, exclude_defaults=True), indent=2
+        )
+    )
+    log.info("wrote unified config", path=str(output_path))

llm_ide_rules/constants.py

@@ -1,36 +1,13 @@
 """Shared constants for explode and implode functionality."""
 
-import json
-import os
-from pathlib import Path
+VALID_AGENTS = ["cursor", "github", "claude", "gemini", "opencode", "all"]
 
-def load_section_globs(custom_config_path: str = None) -> dict:
-    """Load section globs from JSON config file.
-    
-    Args:
-        custom_config_path: Path to custom configuration file to override defaults
-    
-    Returns:
-        Dictionary mapping section headers to their file globs or None for prompts
-    """
-    if custom_config_path and os.path.exists(custom_config_path):
-        config_path = Path(custom_config_path)
-    else:
-        # Load default bundled config
-        config_path = Path(__file__).parent / "sections.json"
-    
-    with open(config_path, 'r') as f:
-        config = json.load(f)
-    
-    return config["section_globs"]
 
-# Default section globs - loaded from bundled JSON
-SECTION_GLOBS = load_section_globs()
-
-def header_to_filename(header):
+def header_to_filename(header: str) -> str:
     """Convert a section header to a filename."""
-    return header.lower().replace(' ', '-')
+    return header.lower().replace(" ", "-")
+
 
-def filename_to_header(filename):
+def filename_to_header(filename: str) -> str:
     """Convert a filename back to a section header."""
-    return filename.replace('-', ' ').title()
+    return filename.replace("-", " ").title()

llm_ide_rules/log.py

@@ -0,0 +1,9 @@
+"""Centralized logging configuration using structlog-config.
+
+This module configures structlog with opinionated defaults and exports a global logger.
+Import the `log` object from this module to use structured logging throughout the application.
+"""
+
+from structlog_config import configure_logger
+
+log = configure_logger()

llm_ide_rules/markdown_parser.py

@@ -0,0 +1,108 @@
+"""Markdown parsing utilities using markdown-it-py."""
+
+from typing import NamedTuple
+
+from markdown_it import MarkdownIt
+
+
+class SectionData(NamedTuple):
+    """Data for a parsed section."""
+
+    content: list[str]
+    glob_pattern: str | None
+
+
+def extract_glob_directive(
+    content_lines: list[str],
+) -> tuple[list[str], str | None]:
+    """Extract glob directive from section content if present.
+
+    Checks the first non-empty line after the header for 'globs: PATTERN'.
+
+    Args:
+        content_lines: Lines including the header
+
+    Returns:
+        Tuple of (content_without_directive, glob_pattern)
+        - glob_pattern is None if no directive found (means alwaysApply)
+        - glob_pattern is "manual" for manual-only sections
+    """
+    if not content_lines:
+        return content_lines, None
+
+    header_idx = None
+    for i, line in enumerate(content_lines):
+        if line.startswith("## "):
+            header_idx = i
+            break
+
+    if header_idx is None:
+        return content_lines, None
+
+    for i in range(header_idx + 1, len(content_lines)):
+        line = content_lines[i].strip()
+        if not line:
+            continue
+
+        if line.lower().startswith("globs: "):
+            glob_value = line[7:].strip()
+            filtered_content = content_lines[:i] + content_lines[i + 1 :]
+            return filtered_content, glob_value
+
+        break
+
+    return content_lines, None
+
+
+def parse_sections(text: str) -> tuple[list[str], dict[str, SectionData]]:
+    """Parse markdown text into general section and named sections.
+
+    Returns:
+        Tuple of (general_lines, sections_dict) where:
+        - general_lines: Lines before the first H2 header
+        - sections_dict: Dict mapping section names to SectionData (content + glob_pattern)
+    """
+    md = MarkdownIt()
+    tokens = md.parse(text)
+    lines = text.splitlines(keepends=True)
+
+    # Find all H2 headers
+    section_starts = []
+    for i, token in enumerate(tokens):
+        if token.type == "heading_open" and token.tag == "h2":
+            # Get the content of the header
+            # The next token is usually inline, which contains the text
+            if i + 1 < len(tokens) and tokens[i + 1].type == "inline":
+                header_content = tokens[i + 1].content.strip()
+                # token.map contains [start_line, end_line] (0-based)
+                if token.map:
+                    start_line = token.map[0]
+                    section_starts.append((start_line, header_content))
+
+    if not section_starts:
+        return lines, {}
+
+    # Extract general content (everything before first H2)
+    first_section_start = section_starts[0][0]
+    general_lines = lines[:first_section_start]
+
+    # Extract named sections
+    sections = {}
+    for i, (start_line, header_name) in enumerate(section_starts):
+        # End line is the start of the next section, or end of file
+        if i + 1 < len(section_starts):
+            end_line = section_starts[i + 1][0]
+        else:
+            end_line = len(lines)
+
+        # Extract all lines for this section
+        section_content = lines[start_line:end_line]
+
+        # Extract glob directive if present
+        filtered_content, glob_pattern = extract_glob_directive(section_content)
+
+        sections[header_name] = SectionData(
+            content=filtered_content, glob_pattern=glob_pattern
+        )
+
+    return general_lines, sections

llm_ide_rules/mcp/__init__.py

@@ -0,0 +1,7 @@
+"""
+MCP configuration management.
+"""
+
+from .models import McpConfig, McpServer
+
+__all__ = ["McpServer", "McpConfig"]

llm_ide_rules/mcp/models.py

@@ -0,0 +1,21 @@
+"""
+Pydantic models for unified MCP configuration.
+"""
+
+from pydantic import BaseModel, Field
+
+
+class McpServer(BaseModel):
+    """Unified MCP server definition."""
+
+    command: str | None = None
+    args: list[str] = Field(default_factory=list)
+    url: str | None = None
+    type: str | None = None
+    env: dict[str, str] | None = None
+
+
+class McpConfig(BaseModel):
+    """Unified mcp.json format."""
+
+    servers: dict[str, McpServer]

{llm_ide_rules-0.5.0.dist-info → llm_ide_rules-0.7.0.dist-info}/METADATA

@@ -1,20 +1,24 @@
 Metadata-Version: 2.3
 Name: llm-ide-rules
-Version: 0.5.0
+Version: 0.7.0
 Summary: CLI tool for managing LLM IDE prompts and rules
 Keywords: llm,ide,prompts,cursor,copilot
 Author: Michael Bianco
 Author-email: Michael Bianco <mike@mikebian.co>
 Requires-Dist: typer>=0.9.0
-Requires-Dist: structlog>=23.2.0
+Requires-Dist: structlog-config>=0.6.0
 Requires-Dist: requests>=2.25.0
-Requires-Python: >=3.9
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: json5>=0.9.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: markdown-it-py>=4.0.0
+Requires-Python: >=3.11
 Project-URL: Repository, https://github.com/iloveitaly/llm-ide-rules
 Description-Content-Type: text/markdown
 
 # Copilot, Cursor, Claude, Gemini, etc LLM Instructions
 
-Going to try to centralize all my prompts in a single place and create some scripts to help convert from copilot to cursor, etc.
+This project makes it easy to download prompts and implode/explode them so they can be used by various providers.
 
 I don't want to be tied to a specific IDE and it's a pain to have to edit instructions for various languages across a ton of different files.
 
@@ -22,25 +26,28 @@ Additionally, it becomes challenging to copy these prompts into various projects
 
 Some of the glob assumptions in this repo are specific to how I've chosen to organize python and typescript [in the python starter template](https://github.com/iloveitaly/python-starter-template) and what tooling (fastapi, etc) that I've chosen to use.
 
-## Installation
-
-You can run the `llm-ide-rules` CLI tool using uvx:
+## IDE Format Comparison
 
-```sh
-uvx llm-ide-rules
-```
+Different AI coding assistants use different formats for instructions and commands:
 
-Or install from the repository:
+| IDE | type | folder | Notes |
+|-----|------|--------|-------|
+| **Cursor** | instructions | `.cursor/rules/*.mdc` | Multiple plain markdown files |
+| **Cursor** | commands | `.cursor/commands/*.md` | Plain markdown, no frontmatter |
+| **Claude Code** | instructions | `CLAUDE.md` | Single markdown file at root |
+| **Claude Code** | instructions | `AGENT.md` | Single markdown file at root (agent-specific) |
+| **Claude Code** | commands | `.claude/commands/*.md` | Plain markdown, no frontmatter |
+| **GitHub Copilot** | instructions | `.github/copilot-instructions.md` | Single markdown file |
+| **GitHub Copilot** | instructions | `.github/instructions/*.instructions.md` | Multiple instruction files |
+| **GitHub Copilot** | prompts | `.github/prompts/*.prompt.md` | YAML frontmatter with `mode: 'agent'` |
+| **Gemini CLI** | instructions | `GEMINI.md` | Single markdown file at root |
+| **Gemini CLI** | commands | `.gemini/commands/*.toml` | TOML format, supports `{{args}}` and shell commands |
+| **OpenCode** | commands | `.opencode/commands/*.md` | Plain markdown, no frontmatter |
 
-```sh
-uv tool install git+https://github.com/iloveitaly/llm-ide-rules.git
-```
+## Installation
 
 ```sh
-git clone https://github.com/iloveitaly/llm-ide-rules.git
-cd llm-ide-rules
-uv sync
-source .venv/bin/activate
+uvx llm-ide-rules@latest --help
 ```
 
 ## Usage
@@ -55,7 +62,10 @@ uvx llm-ide-rules explode [input_file]
 
 # Bundle rule files back into a single instruction file
 uvx llm-ide-rules implode cursor [output_file]     # Bundle Cursor rules
-uvx llm-ide-rules implode github [output_file]    # Bundle GitHub/Copilot instructions
+uvx llm-ide-rules implode github [output_file]     # Bundle GitHub/Copilot instructions
+uvx llm-ide-rules implode claude [output_file]     # Bundle Claude Code commands
+uvx llm-ide-rules implode gemini [output_file]     # Bundle Gemini CLI commands
+uvx llm-ide-rules implode opencode [output_file]   # Bundle OpenCode commands
 
 # Download instruction files from repositories
 uvx llm-ide-rules download [instruction_types]    # Download everything by default
@@ -66,21 +76,26 @@ uvx llm-ide-rules download --repo other/repo      # Download from different repo
 uvx llm-ide-rules delete [instruction_types]      # Delete everything by default
 uvx llm-ide-rules delete cursor gemini            # Delete specific types
 uvx llm-ide-rules delete --yes                    # Skip confirmation prompt
-
 ```
 
 ### Examples
 
 ```sh
-# Explode instructions.md into .cursor/rules/ and .github/instructions/
+# Explode instructions.md into all supported formats (cursor, github, claude, gemini, opencode)
 uvx llm-ide-rules explode instructions.md
 
+# Explode for a specific agent only
+uvx llm-ide-rules explode instructions.md --agent opencode
+
 # Bundle Cursor rules back into a single file
 uvx llm-ide-rules implode cursor bundled-instructions.md
 
 # Bundle GitHub instructions with verbose logging
 uvx llm-ide-rules implode github --verbose instructions.md
 
+# Bundle OpenCode commands into commands.md
+uvx llm-ide-rules implode opencode
+
 # Download everything from default repository
 uvx llm-ide-rules download
 
@@ -100,44 +115,6 @@ uvx llm-ide-rules delete cursor gemini --target ./my-project
 uvx llm-ide-rules delete --yes
 ```
 
-### IDE Command Format Comparison
-
-Different AI coding assistants use different formats for commands:
-
-| IDE | Directory | Format | Notes |
-|-----|-----------|--------|-------|
-| **Cursor** | `.cursor/commands/` | `.md` (plain markdown) | Simple, no frontmatter |
-| **Claude Code** | `.claude/commands/` | `.md` (plain markdown) | Simple, no frontmatter |
-| **GitHub Copilot** | `.github/prompts/` | `.prompt.md` (YAML + markdown) | Requires frontmatter with `mode: 'agent'` |
-| **Gemini CLI** | `.gemini/commands/` | `.toml` | Uses TOML format, supports `{{args}}` and shell commands |
-
-## Development
-
-### Using the CLI for Development
-
-The CLI replaces the old standalone scripts. Use the CLI commands in your development workflow:
-
-```shell
-# Setup the environment
-uv sync
-
-# Explode instructions into separate rule files
-uvx llm-ide-rules explode
-
-# Bundle rules back into instructions
-uvx llm-ide-rules implode cursor instructions.md
-```
-
-### Building and Testing
-
-```shell
-# Build the package
-uv build
-
-# Run tests
-pytest
-```
-
 ## Extracting Changes
 
 The idea of this repo is you'll copy prompts into your various projects. Then, if you improve a prompt in a project, you can pull that change into this upstream repo.

llm_ide_rules-0.7.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+llm_ide_rules/__init__.py,sha256=jr4i_EenGGu4xPpuAdZYEA3oOQZCBau5v65uFJr8YsM,2201
+llm_ide_rules/__main__.py,sha256=8maIDGnEcSUBs9lXg7YEevCXPC0fisYPC2gAEXHfHGM,145
+llm_ide_rules/agents/__init__.py,sha256=-KfKLr_qG26t2OXi1dA-gCesPDqS1ARGa6hELdoyCo0,905
+llm_ide_rules/agents/base.py,sha256=BZCW-Ikmj-YsZzqzE5GOsWg68uOlSeCztENmqOZOYLo,10434
+llm_ide_rules/agents/claude.py,sha256=07qKYmrX1ScWhLATK3sRClhddbb8iaJd9ZiaUdhb8aA,3176
+llm_ide_rules/agents/cursor.py,sha256=3nfbagRtAMXhyPVY6rpOe-XnEJVHOZiVIW9hKeTmSPg,5939
+llm_ide_rules/agents/gemini.py,sha256=sALl6NuX9wNL0cQ5UYclDQOBt-MlF1TUpPnW5Bk9i4g,5518
+llm_ide_rules/agents/github.py,sha256=aEilEXCiRmRLtCpArhzRO12ZyqL6-sGKczvmQbGzlLE,6950
+llm_ide_rules/agents/opencode.py,sha256=6aOwfns2DvynvWNSpidjyK3erxEahfa7bUJeml_APhg,3993
+llm_ide_rules/commands/delete.py,sha256=m8hSDD5jruj6QN0w8zuRmrmX-SfscXjuEWwrGy3v0fs,5490
+llm_ide_rules/commands/download.py,sha256=X6RAPXXXX5aseTWZHFTzHTrbzGP6GMofsZAC4iyO-oQ,14384
+llm_ide_rules/commands/explode.py,sha256=auCx-LqRee93zHv7CqISDp_uiCK_xrEJWlrMBuKD4Dg,9384
+llm_ide_rules/commands/implode.py,sha256=KHaOkkpz4vqAXhQh-iE5ftvrtDtFuSz0itXNQpKigls,6971
+llm_ide_rules/commands/mcp.py,sha256=61juJyWe7BQrOisWH67-ynTBe3xjBPGq-s-HAzPWVrU,3680
+llm_ide_rules/constants.py,sha256=WDz1_LFKzQe3m2pM8nCrDS47a16OMKFMZo2VK3rkX7E,427
+llm_ide_rules/log.py,sha256=hfkCLaTf2juQ7n67BYNREUrFxXDh6hqNcN2Pt9YTOo8,322
+llm_ide_rules/markdown_parser.py,sha256=-S3sxrfFe1DRkNdu0dgUId1SMhUnfCZFMm9P7CZagUs,3418
+llm_ide_rules/mcp/__init__.py,sha256=g73PAMhN7jDqmTBGskWJg2atpPj_-tiVY9ww7YqO2Yw,118
+llm_ide_rules/mcp/models.py,sha256=gYzhgdWQwhH3pmj6OWVFWNNKRgxcblXeE3car2Tv8O4,440
+llm_ide_rules-0.7.0.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+llm_ide_rules-0.7.0.dist-info/entry_points.txt,sha256=xsALXWBwSEifz-2Mike7s2SwqNu1taLs_-EcmGrONeM,54
+llm_ide_rules-0.7.0.dist-info/METADATA,sha256=uuHchmwl2QlV-V_CXT76NgVD7vqvBeo3MDKWjDt7qX4,5355
+llm_ide_rules-0.7.0.dist-info/RECORD,,

{llm_ide_rules-0.5.0.dist-info → llm_ide_rules-0.7.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.8.11
+Generator: uv 0.9.26
 Root-Is-Purelib: true
-Tag: py3-none-any
+Tag: py3-none-any

llm_ide_rules/sections.json

@@ -1,27 +0,0 @@
-{
-  "section_globs": {
-    "Python": "**/*.py",
-    "Python App": "**/*.py",
-    "Pytest Integration Tests": "tests/integration/**/*.py",
-    "Pytest Tests": "tests/**/*.py",
-    "Python Route Tests": "tests/routes/**/*.py",
-    "Alembic Migrations": "migrations/versions/*.py",
-    "FastAPI": "app/routes/**/*.py",
-    "React": "**/*.tsx",
-    "React Router": "web/app/routes/**/*.tsx",
-    "React Router Client Loader": null,
-    "Shell": "**/*.sh",
-    "TypeScript": "**/*.ts,**/*.tsx",
-    "TypeScript DocString": null,
-    "Secrets": null,
-    "Dev In Browser": null,
-    "Fastapi Stripe": null,
-    "Fix Tests": null,
-    "Implement Fastapi Routes": null,
-    "Plan Only": null,
-    "Python Command": null,
-    "Refactor On Instructions": null,
-    "Standalone Python Scripts": null,
-    "Stripe Backend": null
-  }
-}

llm_ide_rules-0.5.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-llm_ide_rules/__init__.py,sha256=494c58df084291e4e427a1a36f78306224ea83305531dcff5c566c2fb53e16ce,1472
-llm_ide_rules/__main__.py,sha256=881447dbad0fe837590fa8224f1d0dd70416fd5344779978d07744ff8e0cf868,144
-llm_ide_rules/commands/delete.py,sha256=6ed0a44b1be1d950180831681d79e3a0be91cd37296e30e7a0d821d49292ebf4,5812
-llm_ide_rules/commands/download.py,sha256=06c2a841db5fe0b0f7f3e8c99ad198c8e07e53d8801fb4d95e802ecee60cda31,11022
-llm_ide_rules/commands/explode.py,sha256=59df4bb542397c9204332ba563a95c49d236a82ebc6af81378b2798f8adc2e77,14779
-llm_ide_rules/commands/implode.py,sha256=f3e9ff754530c06d7eacb20fc37ae8d958218f02df2a0f48eac1d5c6a9a749be,16743
-llm_ide_rules/constants.py,sha256=1182b9757ca58d038a4878d1b55570aac4f0287f1a5ab5af8d68331b799b0686,1118
-llm_ide_rules/sections.json,sha256=e82bf37f8a7bd919c881d7cc084cdfd82e1f9e6ff5385c74b18c14996bcac3c1,822
-llm_ide_rules-0.5.0.dist-info/WHEEL,sha256=0f7d664a881437bddec71c703c3c2f01fd13581519f95130abcc96e296ef0426,79
-llm_ide_rules-0.5.0.dist-info/entry_points.txt,sha256=c6c00b5d607048489fcfed8c8a47bbb364b0a8dbb5b5a2ecffe11c986ace35e3,54
-llm_ide_rules-0.5.0.dist-info/METADATA,sha256=af671c42110d55d0670a3aef9007b890dcb5d6335add807d36d8baadf3e802a3,4898
-llm_ide_rules-0.5.0.dist-info/RECORD,,