iris-devtester 1.9.1__tar.gz → 1.9.3__tar.gz

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/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.1 → iris_devtester-1.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris-devtester
-Version: 1.9.1
+Version: 1.9.3
 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,50 @@ def test_connection():
         assert cursor.fetchone()[0] == 1
 ```
 
+## Container API
+
+### Basic Usage
+```python
+from iris_devtester.containers import IRISContainer
+
+# Community Edition (auto-detects ARM64 vs x86)
+with IRISContainer.community() 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()
+```
+
+### 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.1 → iris_devtester-1.9.3}/README.md

@@ -43,6 +43,50 @@ def test_connection():
         assert cursor.fetchone()[0] == 1
 ```
 
+## Container API
+
+### Basic Usage
+```python
+from iris_devtester.containers import IRISContainer
+
+# Community Edition (auto-detects ARM64 vs x86)
+with IRISContainer.community() 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()
+```
+
+### 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.1 → iris_devtester-1.9.3}/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.1
+  version: 1.9.3
   author: InterSystems Community
   principles: [library-first, dbapi-first, isolation-by-default, fail-fast]
 ---

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/__init__.py

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

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/cli/container.py

@@ -31,6 +31,12 @@ 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(
     "--detach/--no-detach",
     default=True,
@@ -41,7 +47,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, detach, timeout, cpf):
     """
     Create and start IRIS container from configuration.
 
@@ -58,6 +64,9 @@ def up(ctx, config, detach, timeout, cpf):
         # Zero-config (uses Community edition defaults)
         iris-devtester container up
 
+        # 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
 
@@ -85,6 +94,11 @@ 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}")
+
         if cpf:
             container_config.cpf_merge = cpf
             click.echo(f"  → CPF Merge: {cpf[:50]}...")
@@ -95,6 +109,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")
 
@@ -808,9 +852,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)

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/config/container_config.py

@@ -3,9 +3,9 @@
 import os
 import re
 from pathlib import Path
-from typing import List, Literal, Optional
+from typing import List, Literal, Optional, Union
 
-from pydantic import BaseModel, Field, field_validator, model_validator
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
 from iris_devtester.config.yaml_loader import load_yaml
 
@@ -122,7 +122,7 @@ class ContainerConfig(BaseModel):
         return self
 
     @classmethod
-    def from_yaml(cls, file_path: str | Path) -> "ContainerConfig":
+    def from_yaml(cls, file_path: Union[str, Path]) -> "ContainerConfig":
         """
         Load configuration from YAML file.
 
@@ -290,10 +290,8 @@ class ContainerConfig(BaseModel):
 
         return errors
 
-    class Config:
-        """Pydantic model configuration."""
-
-        json_schema_extra = {
+    model_config = ConfigDict(
+        json_schema_extra={
             "example": {
                 "edition": "community",
                 "container_name": "iris_db",
@@ -306,3 +304,4 @@ class ContainerConfig(BaseModel):
                 "image_tag": "latest",
             }
         }
+    )

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/config/container_state.py

@@ -3,9 +3,9 @@
 from datetime import datetime
 from enum import Enum
 from pathlib import Path
-from typing import Dict, Literal, Optional
+from typing import Dict, Optional
 
-from pydantic import BaseModel, Field, field_validator
+from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 
 class ContainerStatus(str, Enum):
@@ -304,10 +304,8 @@ class ContainerState(BaseModel):
             "config_source": str(self.config_source) if self.config_source else None,
         }
 
-    class Config:
-        """Pydantic model configuration."""
-
-        json_schema_extra = {
+    model_config = ConfigDict(
+        json_schema_extra={
             "example": {
                 "container_id": "a1b2c3d4e5f6" + "0" * 52,  # 64 chars
                 "container_name": "iris_db",
@@ -316,8 +314,9 @@ class ContainerState(BaseModel):
                 "created_at": "2025-01-10T14:30:00Z",
                 "started_at": "2025-01-10T14:30:15Z",
                 "finished_at": None,
-                "ports": {1972: 1972, 52773: 52773},
+                "ports": {"1972": 1972, "52773": 52773},
                 "image": "intersystems/iris-community:latest",
                 "config_source": None,
             }
         }
+    )

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/config/yaml_loader.py

@@ -28,7 +28,7 @@ def load_yaml(file_path: Path) -> Dict[str, Any]:
             config = yaml.safe_load(f)
             if config is None:
                 return {}
-            return config
+            return dict(config)
         except yaml.YAMLError as e:
             raise yaml.YAMLError(f"Invalid YAML syntax in {file_path}: {e}")
 

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/containers/iris_container.py

@@ -1,10 +1,9 @@
 import logging
-import os
 import subprocess
 import time
-from typing import Any, Dict, List, Literal, Optional, Tuple, Type, Union
+from typing import Any, Optional
 
-from iris_devtester.config import IRISConfig, discover_config
+from iris_devtester.config import IRISConfig
 from iris_devtester.connections import get_connection
 
 logger = logging.getLogger(__name__)
@@ -185,7 +184,7 @@ class IRISContainer(IRISBase):
             if is_enabled:
                 self._callin_enabled = True
             return is_enabled
-        except:
+        except Exception:
             return False
 
     def get_test_namespace(self, prefix: str = "TEST") -> str:
@@ -238,9 +237,7 @@ class IRISContainer(IRISBase):
             self.host = self.get_container_host_ip()
             self._mapped_port = int(self.get_exposed_port(1972))  # Use internal port to get mapping
             config.host = self.host
-            config.port = (
-                self._mapped_port
-            )  # Config uses the host-mapped port for connections
+            config.port = self._mapped_port  # Config uses the host-mapped port for connections
         except Exception:
             pass
         return config

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/ports/registry.py

@@ -7,7 +7,7 @@ Provides atomic file-based persistence with file locking for concurrent safety.
 import json
 from datetime import datetime
 from pathlib import Path
-from typing import List, Optional
+from typing import List, Literal, Optional
 
 from filelock import FileLock, Timeout
 
@@ -89,7 +89,7 @@ class PortRegistry:
                     # Manual port assignment
                     self._validate_port_available(assignments, preferred_port, project_path)
                     port = preferred_port
-                    assignment_type = "manual"
+                    assignment_type: Literal["auto", "manual"] = "manual"
                 else:
                     # Auto-assignment
                     port = self._find_available_port(assignments)

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/utils/health_checks.py

@@ -379,7 +379,7 @@ def enable_callin_service(container: Container) -> None:
     """
     # Execute ObjectScript to enable CallIn
     objectscript_cmd = (
-        "iris session iris -U%SYS "
+        "iris session IRIS -U%SYS "
         '"Do ##class(Security.Services).Get("%Service_CallIn", .service) '
         "Set service.Enabled = 1 "
         'Do ##class(Security.Services).Modify("%Service_CallIn", .service)"'

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester/utils/password.py

@@ -572,7 +572,7 @@ Halt
             container_name,
             "sh",
             "-c",
-            f'iris session iris -U %SYS << "EOF"\n{objectscript_commands}\nEOF',
+            f'iris session IRIS -U %SYS << "EOF"\n{objectscript_commands}\nEOF',
         ]
 
         logger.info(f"Unexpiring passwords in container: {container_name}")
@@ -626,7 +626,7 @@ Halt
             "\n"
             "Manual fix:\n"
             f"  docker exec {container_name} bash -c 'echo \"do ##class(Security.Users)"
-            f'.UnExpireUserPasswords(\\"*\\")" | iris session iris -U %SYS\'\n',
+            f'.UnExpireUserPasswords(\\"*\\")" | iris session IRIS -U %SYS\'\n',
         )
 
 

{iris_devtester-1.9.1 → iris_devtester-1.9.3}/iris_devtester.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris-devtester
-Version: 1.9.1
+Version: 1.9.3
 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,50 @@ def test_connection():
         assert cursor.fetchone()[0] == 1
 ```
 
+## Container API
+
+### Basic Usage
+```python
+from iris_devtester.containers import IRISContainer
+
+# Community Edition (auto-detects ARM64 vs x86)
+with IRISContainer.community() 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()
+```
+
+### 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.1 → iris_devtester-1.9.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iris-devtester"
-version = "1.9.1"
+version = "1.9.3"
 description = "Battle-tested InterSystems IRIS infrastructure utilities for Python development"
 readme = "README.md"
 requires-python = ">=3.9"