iriai-cli 0.2.0__tar.gz

iriai_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Iriai Platform Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iriai_cli-0.2.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: iriai-cli
+Version: 0.2.0
+Summary: CLI tool for integrating Iriai platform modules into local projects
+Author: Iriai Platform Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/thedanielzhang/iriai-cli
+Project-URL: Repository, https://github.com/thedanielzhang/iriai-cli.git
+Project-URL: Issues, https://github.com/thedanielzhang/iriai-cli/issues
+Keywords: iriai,cli,integration,modules
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# iriai-cli
+
+Command-line tool for integrating Iriai platform modules into your local projects.
+
+## Installation
+
+```bash
+pip install iriai-cli
+# or
+pipx install iriai-cli
+```
+
+## Usage
+
+```bash
+# List available modules
+iriai modules list
+
+# Analyze your project
+iriai analyze
+
+# Install a module
+iriai integrate auth-react --action install
+
+# Repair a misconfigured module
+iriai integrate auth-react --action repair
+
+# Install multiple modules
+iriai integrate auth-react auth-python pwa --action install
+```
+
+## Features
+
+- Local file integration (no Git commits required)
+- Pre-flight analysis and misconfiguration detection
+- LLM-powered code generation via engine API or locally via Claude Code (`--local`)
+- Interactive file write prompts (Apply/Skip/Overwrite-all)
+- Syntax-highlighted diffs
+- Secret file filtering (`.env`, `*.pem`, `*.key`, `credentials.*`, etc.)
+- Dry-run mode for previewing changes
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `IRIAI_ENGINE_URL` | `https://integration.iriai.app` | Integration engine base URL |
+| `IRIAI_API_TOKEN` | *(none)* | Bearer token for authenticated modules (get from deploy console) |
+| `IRIAI_MODULES_DIR` | *(fetched from API)* | Override: load module definitions from local YAML files instead of API |
+
+```bash
+# Point to local engine during development
+export IRIAI_ENGINE_URL=http://localhost:8005
+
+# Set API token for authenticated modules
+export IRIAI_API_TOKEN=your_token_here
+```
+
+## Commands
+
+### `iriai modules list`
+
+List all available modules with their versions and descriptions.
+
+### `iriai analyze`
+
+Analyze the current directory for module compatibility and misconfigurations. Creates a tarball of the project directory (excluding secrets and ignored files) and uploads it to the engine's `POST /api/analyze-local` endpoint.
+
+### `iriai integrate <modules...>`
+
+Integrate one or more modules into your project.
+
+Options:
+- `--action`: `install`, `repair`, or `overwrite` (default: `install`)
+- `--depth`: `core` or `full` (default: `full`)
+- `--yes`: Skip interactive prompts, apply all changes
+- `--dry-run`: Show what would be changed without writing files
+- `--local`: Run entirely locally via Claude Code (`claude -p`) instead of the engine API
+
+### Local Mode (`--local`)
+
+The `--local` flag runs LLM integration on your machine via Claude Code instead of the engine API:
+
+```bash
+iriai integrate auth-react --local
+```
+
+This mode:
+1. Fetches module definitions from the integration engine API
+2. Analyzes the project locally (same logic as the engine)
+3. Builds a prompt identical to `LLMIntegrator._build_prompt()`
+4. Invokes `claude -p` subprocess with a 5-minute timeout
+5. Parses the structured JSON response
+6. Applies file operations through interactive prompts
+
+**Requirements:** Claude Code CLI (`claude`) must be installed and on your PATH.
+
+**Note:** Profile matching is skipped in local mode (requires database). Most integrations work without profile-specific config.
+
+For development, set `IRIAI_MODULES_DIR` to load module definitions from local YAML files instead of the API.
+
+## License
+
+MIT

iriai_cli-0.2.0/README.md

@@ -0,0 +1,105 @@
+# iriai-cli
+
+Command-line tool for integrating Iriai platform modules into your local projects.
+
+## Installation
+
+```bash
+pip install iriai-cli
+# or
+pipx install iriai-cli
+```
+
+## Usage
+
+```bash
+# List available modules
+iriai modules list
+
+# Analyze your project
+iriai analyze
+
+# Install a module
+iriai integrate auth-react --action install
+
+# Repair a misconfigured module
+iriai integrate auth-react --action repair
+
+# Install multiple modules
+iriai integrate auth-react auth-python pwa --action install
+```
+
+## Features
+
+- Local file integration (no Git commits required)
+- Pre-flight analysis and misconfiguration detection
+- LLM-powered code generation via engine API or locally via Claude Code (`--local`)
+- Interactive file write prompts (Apply/Skip/Overwrite-all)
+- Syntax-highlighted diffs
+- Secret file filtering (`.env`, `*.pem`, `*.key`, `credentials.*`, etc.)
+- Dry-run mode for previewing changes
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `IRIAI_ENGINE_URL` | `https://integration.iriai.app` | Integration engine base URL |
+| `IRIAI_API_TOKEN` | *(none)* | Bearer token for authenticated modules (get from deploy console) |
+| `IRIAI_MODULES_DIR` | *(fetched from API)* | Override: load module definitions from local YAML files instead of API |
+
+```bash
+# Point to local engine during development
+export IRIAI_ENGINE_URL=http://localhost:8005
+
+# Set API token for authenticated modules
+export IRIAI_API_TOKEN=your_token_here
+```
+
+## Commands
+
+### `iriai modules list`
+
+List all available modules with their versions and descriptions.
+
+### `iriai analyze`
+
+Analyze the current directory for module compatibility and misconfigurations. Creates a tarball of the project directory (excluding secrets and ignored files) and uploads it to the engine's `POST /api/analyze-local` endpoint.
+
+### `iriai integrate <modules...>`
+
+Integrate one or more modules into your project.
+
+Options:
+- `--action`: `install`, `repair`, or `overwrite` (default: `install`)
+- `--depth`: `core` or `full` (default: `full`)
+- `--yes`: Skip interactive prompts, apply all changes
+- `--dry-run`: Show what would be changed without writing files
+- `--local`: Run entirely locally via Claude Code (`claude -p`) instead of the engine API
+
+### Local Mode (`--local`)
+
+The `--local` flag runs LLM integration on your machine via Claude Code instead of the engine API:
+
+```bash
+iriai integrate auth-react --local
+```
+
+This mode:
+1. Fetches module definitions from the integration engine API
+2. Analyzes the project locally (same logic as the engine)
+3. Builds a prompt identical to `LLMIntegrator._build_prompt()`
+4. Invokes `claude -p` subprocess with a 5-minute timeout
+5. Parses the structured JSON response
+6. Applies file operations through interactive prompts
+
+**Requirements:** Claude Code CLI (`claude`) must be installed and on your PATH.
+
+**Note:** Profile matching is skipped in local mode (requires database). Most integrations work without profile-specific config.
+
+For development, set `IRIAI_MODULES_DIR` to load module definitions from local YAML files instead of the API.
+
+## License
+
+MIT

iriai_cli-0.2.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "iriai-cli"
+version = "0.2.0"
+description = "CLI tool for integrating Iriai platform modules into local projects"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    {name = "Iriai Platform Team"}
+]
+keywords = ["iriai", "cli", "integration", "modules"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "click>=8.1.0",
+    "httpx>=0.27.0",
+    "pyyaml>=6.0",
+    "rich>=13.7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/thedanielzhang/iriai-cli"
+Repository = "https://github.com/thedanielzhang/iriai-cli.git"
+Issues = "https://github.com/thedanielzhang/iriai-cli/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "black>=24.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+iriai = "iriai_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ["py311"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"

iriai_cli-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

iriai_cli-0.2.0/src/iriai_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Iriai CLI — Local module integration tool."""
+
+__version__ = "0.1.0"

iriai_cli-0.2.0/src/iriai_cli/__main__.py

@@ -0,0 +1,6 @@
+"""CLI entry point."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

iriai_cli-0.2.0/src/iriai_cli/api_client.py

@@ -0,0 +1,169 @@
+"""HTTP client for integration engine API."""
+
+import logging
+from typing import Any
+
+import httpx
+from rich.console import Console
+
+from .config import config
+
+logger = logging.getLogger(__name__)
+console = Console()
+
+
+class APIError(Exception):
+    """Base error for API communication."""
+
+    def __init__(self, message: str, status_code: int | None = None):
+        self.status_code = status_code
+        super().__init__(message)
+
+
+class APIClient:
+    """Async HTTP client for the integration engine."""
+
+    def __init__(self, base_url: str | None = None, timeout: int = 30):
+        self.base_url = base_url or config.engine_url
+        self.timeout = timeout
+
+    async def get_modules(self) -> list[dict[str, Any]]:
+        """Fetch available modules.
+
+        Returns:
+            List of module metadata dicts.
+        """
+        async with httpx.AsyncClient(timeout=self.timeout) as client:
+            try:
+                response = await client.get(
+                    f"{self.base_url}/api/modules",
+                    headers=config.headers,
+                )
+                response.raise_for_status()
+                data = response.json()
+                return data.get("modules", [])
+            except httpx.HTTPStatusError as e:
+                raise APIError(
+                    f"Failed to fetch modules: {e.response.status_code}",
+                    status_code=e.response.status_code,
+                )
+            except httpx.RequestError as e:
+                raise APIError(f"Network error: {e}")
+
+    async def get_module_definition(self, name: str) -> dict[str, Any]:
+        """Fetch a full module definition by name.
+
+        Args:
+            name: Module name (e.g., "auth-react").
+
+        Returns:
+            Full module definition dict including prompt_template, analyze config, etc.
+        """
+        async with httpx.AsyncClient(timeout=self.timeout) as client:
+            try:
+                response = await client.get(
+                    f"{self.base_url}/api/modules/{name}",
+                    headers=config.headers,
+                )
+                response.raise_for_status()
+                return response.json()
+            except httpx.HTTPStatusError as e:
+                if e.response.status_code == 404:
+                    raise APIError(f"Module '{name}' not found", status_code=404)
+                raise APIError(
+                    f"Failed to fetch module '{name}': {e.response.status_code}",
+                    status_code=e.response.status_code,
+                )
+            except httpx.RequestError as e:
+                raise APIError(f"Network error: {e}")
+
+    async def analyze(self, tarball_path: str, modules: list[str] | None = None) -> dict[str, Any]:
+        """Analyze a project tarball via POST /api/analyze-local.
+
+        Args:
+            tarball_path: Path to .tar.gz file.
+            modules: Optional list of module names to check.
+
+        Returns:
+            Analysis result dict.
+        """
+        import json as _json
+
+        async with httpx.AsyncClient(timeout=60) as client:
+            try:
+                with open(tarball_path, "rb") as f:
+                    files = {"tarball": ("project.tar.gz", f, "application/gzip")}
+                    data = {}
+                    if modules:
+                        data["modules"] = _json.dumps(modules)
+                    headers = {}
+                    if config.api_token:
+                        headers["Authorization"] = f"Bearer {config.api_token}"
+                    response = await client.post(
+                        f"{self.base_url}/api/analyze-local",
+                        headers=headers,
+                        files=files,
+                        data=data,
+                    )
+                response.raise_for_status()
+                return response.json()
+            except httpx.HTTPStatusError as e:
+                raise APIError(
+                    f"Analysis failed: {e.response.status_code}",
+                    status_code=e.response.status_code,
+                )
+            except httpx.RequestError as e:
+                raise APIError(f"Network error: {e}")
+
+    async def integrate_local(
+        self,
+        tarball_path: str,
+        modules: dict[str, str],
+        integration_depth: str = "full",
+        competing_solution_choices: dict[str, str] | None = None,
+    ) -> dict[str, Any]:
+        """Trigger local integration.
+
+        Args:
+            tarball_path: Path to project tarball.
+            modules: Module name -> action mapping.
+            integration_depth: "core" or "full".
+            competing_solution_choices: Optional competing solution choices.
+
+        Returns:
+            Integration result dict with file operations.
+        """
+        import json
+
+        async with httpx.AsyncClient(timeout=120) as client:
+            try:
+                with open(tarball_path, "rb") as f:
+                    files = {"tarball": ("project.tar.gz", f, "application/gzip")}
+                    data = {
+                        "modules": json.dumps(modules),
+                        "integration_depth": integration_depth,
+                    }
+                    if competing_solution_choices:
+                        data["competing_solution_choices"] = json.dumps(
+                            competing_solution_choices
+                        )
+
+                    headers = {}
+                    if config.api_token:
+                        headers["Authorization"] = f"Bearer {config.api_token}"
+
+                    response = await client.post(
+                        f"{self.base_url}/api/integrate-local",
+                        headers=headers,
+                        files=files,
+                        data=data,
+                    )
+                response.raise_for_status()
+                return response.json()
+            except httpx.HTTPStatusError as e:
+                raise APIError(
+                    f"Integration failed: {e.response.status_code}",
+                    status_code=e.response.status_code,
+                )
+            except httpx.RequestError as e:
+                raise APIError(f"Network error: {e}")