iris-devtester 1.9.2__tar.gz → 1.10.0__tar.gz

{iris_devtester-1.9.2 → iris_devtester-1.10.0}/AGENTS.md

@@ -287,3 +287,132 @@ The repository exposes core functionality as "Skills" to help AI agents work aut
 
 ## Recent Changes
 - 023-docs-cleanup: Added N/A (documentation only)
+---
+
+## COMPOUND KNOWLEDGE BASE & DEVELOPMENT ENVIRONMENT
+
+**Last Updated**: $(date +%Y-%m-%d)
+
+> Central registry of development knowledge, tools, capabilities, and automation
+
+
+### 📚 Knowledge Base
+
+**Location**: `~/.config/opencode/compound-knowledge/`
+
+
+**Structure**:
+- `global/` - Project-agnostic knowledge (frameworks, tools, patterns)
+- `projects/[name]/` - Project-specific knowledge (domain, architecture)
+
+**Stats**: 7 solutions (7 global, 0 project)
+
+**Quick Search**:
+```bash
+# Search everything
+grep -ri "keywords" ~/.config/opencode/compound-knowledge/
+
+# Global only
+grep -ri "keywords" ~/.config/opencode/compound-knowledge/global/
+
+# This project
+grep -ri "keywords" ~/.config/opencode/compound-knowledge/projects/$(basename $(pwd))/
+```
+
+**Time Savings**: First solve: 30min → Next solve: 3min (90% faster)
+
+
+### 🔌 MCP Servers
+
+- `atlassian` - local
+- `gemini-impl` - local
+- `hallucination-detector` - local
+- `jama` - local
+- `perplexity` - local
+- `playwright` - local
+- `qwen-impl` - local
+- `support-tools` - local
+
+### 🤖 Automation & Hooks
+
+**Orchestrator Behavior** (configured via `~/.config/opencode/oh-my-opencode-slim.json`):
+- **Before tasks**: Search compound KB for similar solutions
+- **After completion**: Remind to document solution
+
+**Periodic Maintenance** (recommended):
+```bash
+# Weekly: Regenerate KB index
+~/.config/opencode/compound-knowledge/generate-index.sh
+
+# Monthly: Review and consolidate similar solutions
+# Quarterly: Extract patterns from repeated solutions
+```
+
+**Auto-Documentation Triggers**:
+- Tests pass after fixing failure → Document solution
+- Error resolved → Document fix
+- Performance improved → Document optimization
+- Integration working → Document configuration
+
+
+### 🛠️ Tools & Utilities
+
+**Compound Engineering**:
+- `~/.config/opencode/compound-knowledge/new-solution.sh` - Create solution doc
+- `~/.config/opencode/compound-knowledge/generate-index.sh` - Regenerate index
+- `~/.config/opencode/compound-knowledge/sync-to-agents.sh` - Update AGENTS.md files
+
+**OpenCode Agents** (oh-my-opencode-slim):
+- `orchestrator` - Master coordinator (with compound engineering)
+- `explorer` - Codebase reconnaissance
+- `oracle` - Strategic advisor
+- `librarian` - External knowledge (websearch, context7, grep_app MCPs)
+- `designer` - UI/UX implementation
+- `fixer` - Fast implementation
+- `code-simplifier` - Post-work code refinement
+
+
+### 🎯 Skills
+
+**speckit** (feature specification):
+- `speckit.plan` - Implementation planning
+- `speckit.specify` - Feature specification
+- `speckit.tasks` - Task generation
+- `speckit.implement` - Implementation guidance
+
+
+### 📋 Quick Reference
+
+**Full Index**: `~/.config/opencode/compound-knowledge/INDEX.md`
+
+**Documentation Templates**:
+```markdown
+---
+title: "Problem description"
+category: [build-errors|test-failures|runtime-errors|performance-issues|
+          database-issues|security-issues|ui-bugs|integration-issues|logic-errors]
+date: YYYY-MM-DD
+severity: high|medium|low
+tags: [tag1, tag2]
+time_to_solve: XXmin
+---
+
+## Problem Symptom
+[What was observed]
+
+## Solution
+[How you fixed it]
+
+## Prevention
+[How to avoid future]
+```
+
+**Decision Tree** (Global vs Project-Specific):
+- Framework/tool issue → `global/`
+- General pattern → `global/`
+- Project domain logic → `projects/[name]/`
+- Project architecture → `projects/[name]/`
+- When in doubt → `global/`
+
+---
+

{iris_devtester-1.9.2 → iris_devtester-1.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris-devtester
-Version: 1.9.2
+Version: 1.10.0
 Summary: Battle-tested InterSystems IRIS infrastructure utilities for Python development
 Author-email: InterSystems Community <community@intersystems.com>
 Maintainer-email: Thomas Dyar <thomas.dyar@intersystems.com>
@@ -107,6 +107,89 @@ def test_connection():
         assert cursor.fetchone()[0] == 1
 ```
 
+## Container Editions
+
+Three canonical container editions are available:
+
+| Edition | Size | Use Case | Image |
+|---------|------|----------|-------|
+| **Community** | ~972MB | Development, testing | `intersystemsdc/iris-community` |
+| **Enterprise** | ~1GB+ | Production testing | `containers.intersystems.com/intersystems/iris` |
+| **Light** | **~580MB** | CI/CD pipelines | `caretdev/iris-community-light` |
+
+### Python API
+```python
+from iris_devtester.containers import IRISContainer
+
+# Community Edition (auto-detects ARM64 vs x86)
+with IRISContainer.community() as iris:
+    conn = iris.get_connection()
+
+# Light Edition (85% smaller, for CI/CD)
+with IRISContainer.light() as iris:
+    conn = iris.get_connection()
+
+# Enterprise Edition (requires license)
+with IRISContainer.enterprise(license_key="/path/to/iris.key") as iris:
+    conn = iris.get_connection()
+
+# Specify version
+with IRISContainer.community(version="2025.1") as iris:
+    conn = iris.get_connection()
+```
+
+### CLI Usage
+```bash
+# Community (default)
+iris-devtester container up
+
+# Light edition for CI/CD
+iris-devtester container up --edition light
+
+# Enterprise edition with license
+iris-devtester container up --edition enterprise --license /path/to/iris.key
+
+# List running IRIS containers
+iris-devtester container list
+```
+
+### Light Edition Details
+
+The Light edition removes components unnecessary for SQL-only workloads:
+- **Removed**: Interoperability/Ensemble, Management Portal, DeepSee/BI, CSP/REST
+- **Kept**: SQL engine, DBAPI, JDBC, ODBC, SQLAlchemy-IRIS support
+
+Perfect for microservices, automated testing, and Python/SQL pipelines.
+
+### Builder Methods
+```python
+# Set a custom container name (for debugging, logs, multiple containers)
+iris = IRISContainer.community().with_name("my-test-db")
+
+# Set credentials
+iris = IRISContainer.community().with_credentials("_SYSTEM", "MyPassword")
+
+# Pre-configure password (set via IRIS_PASSWORD env var at startup)
+iris = IRISContainer.community().with_preconfigured_password("MyPassword")
+
+# Chain multiple options
+with IRISContainer.community() \
+    .with_name("integration-test-db") \
+    .with_credentials("_SYSTEM", "TestPass123") as iris:
+    conn = iris.get_connection()
+```
+
+### Constructor Parameters
+```python
+IRISContainer(
+    image="intersystemsdc/iris-community:latest",  # Docker image
+    username="SuperUser",                           # Default username
+    password="SYS",                                 # Default password
+    namespace="USER",                               # Default namespace
+    name="my-container",                            # Container name (alternative to with_name)
+)
+```
+
 ## Key Features
 
 - **🔐 Automatic Password Management**: Remediates security flags using official system APIs.

{iris_devtester-1.9.2 → iris_devtester-1.10.0}/README.md

@@ -43,6 +43,89 @@ def test_connection():
         assert cursor.fetchone()[0] == 1
 ```
 
+## Container Editions
+
+Three canonical container editions are available:
+
+| Edition | Size | Use Case | Image |
+|---------|------|----------|-------|
+| **Community** | ~972MB | Development, testing | `intersystemsdc/iris-community` |
+| **Enterprise** | ~1GB+ | Production testing | `containers.intersystems.com/intersystems/iris` |
+| **Light** | **~580MB** | CI/CD pipelines | `caretdev/iris-community-light` |
+
+### Python API
+```python
+from iris_devtester.containers import IRISContainer
+
+# Community Edition (auto-detects ARM64 vs x86)
+with IRISContainer.community() as iris:
+    conn = iris.get_connection()
+
+# Light Edition (85% smaller, for CI/CD)
+with IRISContainer.light() as iris:
+    conn = iris.get_connection()
+
+# Enterprise Edition (requires license)
+with IRISContainer.enterprise(license_key="/path/to/iris.key") as iris:
+    conn = iris.get_connection()
+
+# Specify version
+with IRISContainer.community(version="2025.1") as iris:
+    conn = iris.get_connection()
+```
+
+### CLI Usage
+```bash
+# Community (default)
+iris-devtester container up
+
+# Light edition for CI/CD
+iris-devtester container up --edition light
+
+# Enterprise edition with license
+iris-devtester container up --edition enterprise --license /path/to/iris.key
+
+# List running IRIS containers
+iris-devtester container list
+```
+
+### Light Edition Details
+
+The Light edition removes components unnecessary for SQL-only workloads:
+- **Removed**: Interoperability/Ensemble, Management Portal, DeepSee/BI, CSP/REST
+- **Kept**: SQL engine, DBAPI, JDBC, ODBC, SQLAlchemy-IRIS support
+
+Perfect for microservices, automated testing, and Python/SQL pipelines.
+
+### Builder Methods
+```python
+# Set a custom container name (for debugging, logs, multiple containers)
+iris = IRISContainer.community().with_name("my-test-db")
+
+# Set credentials
+iris = IRISContainer.community().with_credentials("_SYSTEM", "MyPassword")
+
+# Pre-configure password (set via IRIS_PASSWORD env var at startup)
+iris = IRISContainer.community().with_preconfigured_password("MyPassword")
+
+# Chain multiple options
+with IRISContainer.community() \
+    .with_name("integration-test-db") \
+    .with_credentials("_SYSTEM", "TestPass123") as iris:
+    conn = iris.get_connection()
+```
+
+### Constructor Parameters
+```python
+IRISContainer(
+    image="intersystemsdc/iris-community:latest",  # Docker image
+    username="SuperUser",                           # Default username
+    password="SYS",                                 # Default password
+    namespace="USER",                               # Default namespace
+    name="my-container",                            # Container name (alternative to with_name)
+)
+```
+
 ## Key Features
 
 - **🔐 Automatic Password Management**: Remediates security flags using official system APIs.

{iris_devtester-1.9.2 → iris_devtester-1.10.0}/SKILL.md

@@ -3,7 +3,7 @@ name: iris-devtester
 description: Battle-tested InterSystems IRIS infrastructure utilities for Python database testing.
 triggers: [iris, database, testing, container, fixture, gof, connection, remediation]
 metadata:
-  version: 1.9.2
+  version: 1.10.0
   author: InterSystems Community
   principles: [library-first, dbapi-first, isolation-by-default, fail-fast]
 ---

{iris_devtester-1.9.2 → iris_devtester-1.10.0}/iris_devtester/__init__.py

@@ -26,7 +26,7 @@ LangChain Integration:
     ...     # Build your RAG app...
 """
 
-__version__ = "1.9.2"
+__version__ = "1.10.0"
 __author__ = "InterSystems Community"
 __license__ = "MIT"
 

{iris_devtester-1.9.2 → iris_devtester-1.10.0}/iris_devtester/cli/container.py

@@ -31,6 +31,25 @@ def container_group(ctx):
 @click.option(
     "--config", type=click.Path(exists=True), help="Path to iris-config.yml configuration file"
 )
+@click.option(
+    "--name",
+    type=str,
+    default=None,
+    help="Container name (default: iris_db)",
+)
+@click.option(
+    "--edition",
+    type=click.Choice(["community", "enterprise", "light"], case_sensitive=False),
+    default="community",
+    help="IRIS edition: community (default), enterprise (requires license), light (minimal for CI/CD)",
+)
+@click.option(
+    "--license",
+    "license_key",
+    type=click.Path(exists=True),
+    default=None,
+    help="Path to iris.key license file (required for enterprise edition)",
+)
 @click.option(
     "--detach/--no-detach",
     default=True,
@@ -41,7 +60,7 @@ def container_group(ctx):
 )
 @click.option("--cpf", help="Path to CPF merge file or raw CPF content")
 @click.pass_context
-def up(ctx, config, detach, timeout, cpf):
+def up(ctx, config, name, edition, license_key, detach, timeout, cpf):
     """
     Create and start IRIS container from configuration.
 
@@ -58,15 +77,18 @@ def up(ctx, config, detach, timeout, cpf):
         # Zero-config (uses Community edition defaults)
         iris-devtester container up
 
+        # Light edition for CI/CD (85% smaller, faster startup)
+        iris-devtester container up --edition light
+
+        # Enterprise edition with license
+        iris-devtester container up --edition enterprise --license /path/to/iris.key
+
+        # With custom container name
+        iris-devtester container up --name my-test-db
+
         # With custom configuration including volumes
         iris-devtester container up --config iris-config.yml
 
-        # Example iris-config.yml with volumes:
-        # edition: community
-        # volumes:
-        #   - ./workspace:/external/workspace
-        #   - ./config:/opt/config:ro
-
         # Foreground mode (see logs)
         iris-devtester container up --no-detach
     """
@@ -85,6 +107,37 @@ def up(ctx, config, detach, timeout, cpf):
                 container_config = ContainerConfig.default()
                 click.echo("⚡ Creating container from zero-config defaults")
 
+        # Override container name if provided via --name
+        if name:
+            container_config.container_name = name
+            click.echo(f"  → Container name: {name}")
+
+        # Override edition if provided via --edition
+        if edition:
+            edition_lower = edition.lower()
+            container_config.edition = edition_lower
+
+            # Set appropriate image based on edition
+            if edition_lower == "light":
+                # Light edition: caretdev/iris-community-light (85% smaller)
+                container_config.image_tag = "latest-em"
+                click.echo(
+                    click.style(f"  → Edition: light", fg="cyan")
+                    + " (minimal for CI/CD, ~580MB vs ~3.5GB)"
+                )
+            elif edition_lower == "enterprise":
+                if not license_key:
+                    raise click.ClickException(
+                        "Enterprise edition requires --license option.\n"
+                        "\n"
+                        "Usage: iris-devtester container up --edition enterprise --license /path/to/iris.key"
+                    )
+                container_config.license_key = license_key
+                click.echo(f"  → Edition: enterprise")
+                click.echo(f"  → License: {license_key}")
+            else:
+                click.echo(f"  → Edition: community")
+
         if cpf:
             container_config.cpf_merge = cpf
             click.echo(f"  → CPF Merge: {cpf[:50]}...")
@@ -95,6 +148,36 @@ def up(ctx, config, detach, timeout, cpf):
         if existing_container:
             # Container exists - check if running
             existing_container.reload()
+
+            # Warn if using default name and container already exists
+            # (user might be connecting to wrong container from different project)
+            if container_config.container_name == "iris_db" and not name:
+                existing_image = (
+                    existing_container.image.tags[0] if existing_container.image.tags else "unknown"
+                )
+                click.echo("")
+                click.echo(
+                    click.style(
+                        "⚠️  WARNING: Using default container name 'iris_db'", fg="yellow", bold=True
+                    )
+                )
+                click.echo(
+                    click.style(
+                        f"   A container with this name already exists (image: {existing_image})",
+                        fg="yellow",
+                    )
+                )
+                click.echo(
+                    click.style(
+                        "   If this is from a different project, use --name to avoid conflicts:",
+                        fg="yellow",
+                    )
+                )
+                click.echo(
+                    click.style("   iris-devtester container up --name my-project-db", fg="cyan")
+                )
+                click.echo("")
+
             if existing_container.status == "running":
                 click.echo(f"✓ Container '{container_config.container_name}' is already running")
 
@@ -228,6 +311,141 @@ def up(ctx, config, detach, timeout, cpf):
         ctx.exit(1)
 
 
+@container_group.command(name="list")
+@click.option(
+    "--all", "-a", "show_all", is_flag=True, help="Show all containers (including stopped)"
+)
+@click.option(
+    "--format",
+    "output_format",
+    type=click.Choice(["table", "json"], case_sensitive=False),
+    default="table",
+    help="Output format (default: table)",
+)
+@click.pass_context
+def list_containers(ctx, show_all, output_format):
+    """
+    List IRIS containers.
+
+    Shows all IRIS containers managed by iris-devtester, with their status,
+    edition, ports, and age.
+
+    \b
+    Examples:
+        # List running containers
+        iris-devtester container list
+
+        # List all containers (including stopped)
+        iris-devtester container list --all
+
+        # JSON output for scripting
+        iris-devtester container list --format json
+    """
+    from datetime import datetime
+
+    import docker
+
+    try:
+        client = docker.from_env()
+
+        # Find IRIS containers (by image name patterns)
+        iris_patterns = [
+            "iris-community",
+            "intersystems/iris",
+            "caretdev/iris",
+            "intersystemsdc/iris",
+        ]
+
+        containers = client.containers.list(all=show_all)
+        iris_containers = []
+
+        for container in containers:
+            image_name = (
+                container.image.tags[0] if container.image.tags else str(container.image.id)[:12]
+            )
+
+            # Check if this is an IRIS container
+            is_iris = any(pattern in image_name.lower() for pattern in iris_patterns)
+            if not is_iris:
+                continue
+
+            # Determine edition from image name
+            if "light" in image_name.lower():
+                edition = "light"
+            elif "community" in image_name.lower():
+                edition = "community"
+            else:
+                edition = "enterprise"
+
+            # Get port mappings
+            ports = container.attrs.get("NetworkSettings", {}).get("Ports", {})
+            port_str = "-"
+            if ports and ports.get("1972/tcp"):
+                host_port = ports["1972/tcp"][0]["HostPort"]
+                port_str = f"{host_port}->1972"
+
+            # Calculate age
+            created = container.attrs.get("Created", "")
+            age_str = "unknown"
+            if created:
+                try:
+                    # Parse ISO format timestamp
+                    created_dt = datetime.fromisoformat(created.replace("Z", "+00:00"))
+                    now = datetime.now(created_dt.tzinfo)
+                    delta = now - created_dt
+                    if delta.days > 0:
+                        age_str = f"{delta.days}d"
+                    elif delta.seconds > 3600:
+                        age_str = f"{delta.seconds // 3600}h"
+                    else:
+                        age_str = f"{delta.seconds // 60}m"
+                except Exception:
+                    pass
+
+            iris_containers.append(
+                {
+                    "name": container.name,
+                    "edition": edition,
+                    "status": container.status,
+                    "ports": port_str,
+                    "age": age_str,
+                    "image": image_name,
+                }
+            )
+
+        if output_format == "json":
+            import json as json_module
+
+            click.echo(json_module.dumps(iris_containers, indent=2))
+        else:
+            # Table format
+            if not iris_containers:
+                click.echo("No IRIS containers found.")
+                if not show_all:
+                    click.echo("Use --all to include stopped containers.")
+            else:
+                # Print header
+                click.echo(f"{'NAME':<20} {'EDITION':<12} {'STATUS':<10} {'PORTS':<15} {'AGE':<6}")
+                click.echo("-" * 65)
+
+                for c in iris_containers:
+                    status_color = "green" if c["status"] == "running" else "yellow"
+                    click.echo(
+                        f"{c['name']:<20} "
+                        f"{c['edition']:<12} "
+                        f"{click.style(c['status'], fg=status_color):<19} "
+                        f"{c['ports']:<15} "
+                        f"{c['age']:<6}"
+                    )
+
+    except docker.errors.DockerException as e:
+        progress.print_error(f"Docker error: {e}")
+        ctx.exit(1)
+    except Exception as e:
+        progress.print_error(f"Error listing containers: {e}")
+        ctx.exit(1)
+
+
 @container_group.command(name="start")
 @click.argument("container_name", required=False, default="iris_db")
 @click.option(
@@ -613,7 +831,7 @@ def remove(ctx, container_name, force, volumes):
 
 
 @container_group.command(name="reset-password")
-@click.argument("container_name")
+@click.argument("container_name", required=False, default="iris_db")
 @click.option("--user", default="_SYSTEM", help="Username to reset password for (default: _SYSTEM)")
 @click.option("--password", default="SYS", help="New password (default: SYS)")
 @click.option(
@@ -679,7 +897,7 @@ def reset_password_cmd(ctx, container_name, user, password, port):
 
 
 @container_group.command(name="test-connection")
-@click.argument("container_name")
+@click.argument("container_name", required=False, default="iris_db")
 @click.option(
     "--namespace", default="USER", help="IRIS namespace to test connection to (default: USER)"
 )
@@ -768,7 +986,7 @@ def test_connection_cmd(ctx, container_name, namespace, username, password):
 
 
 @container_group.command(name="enable-callin")
-@click.argument("container_name")
+@click.argument("container_name", required=False, default="iris_db")
 @click.option(
     "--timeout", type=int, default=30, help="Timeout in seconds for docker commands (default: 30)"
 )
@@ -808,9 +1026,6 @@ def enable_callin(ctx, container_name, timeout):
     except (ImportError, ModuleNotFoundError) as e:
         progress.print_error(f"enable_callin utility not available: {e}")
         ctx.exit(1)
-    except (click.exceptions.Exit, SystemExit, KeyboardInterrupt):
-        # Let Click handle these - don't catch them
-        raise
     except Exception as e:
         progress.print_error(f"Failed to enable CallIn: {e}")
         ctx.exit(1)