@mc1global/opencode-jarvis 0.13.1 → 0.14.0

package/.opencode/skills/config-manager/reference.md

@@ -1,416 +0,0 @@
-# Config Manager - Technical Reference
-
-## Command-Line Interface
-
-### Get Command
-Retrieve specific configuration values without loading entire YAML.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py get <key.path>
-```
-
-**Parameters:**
-- `key.path` - Dot-notation path to configuration value (e.g., `detection.score_threshold`)
-
-**Output Format:**
-```json
-{
-  "success": true,
-  "key": "synthetic.n_variations",
-  "value": 5,
-  "type": "int"
-}
-```
-
-**Exit Codes:**
-- `0` - Success
-- `1` - Key not found
-- `2` - Invalid YAML syntax
-
----
-
-### Set Command
-Update specific configuration values preserving comments and formatting.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py set <key.path> <value>
-```
-
-**Parameters:**
-- `key.path` - Dot-notation path to configuration value
-- `value` - New value (auto-typed: integers, floats, booleans, strings)
-
-**Type Conversion:**
-- `"5"` → `5` (int)
-- `"0.1"` → `0.1` (float)
-- `"true"` or `"false"` → boolean
-- Everything else → string
-
-**Output Format:**
-```json
-{
-  "success": true,
-  "key": "detection.score_threshold",
-  "old_value": 0.1,
-  "new_value": 0.05,
-  "type": "float"
-}
-```
-
----
-
-### Add Command
-Create new configuration keys, parameters, or entire groups/sections.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py add <key.path> [value] --type <type>
-```
-
-**Parameters:**
-- `key.path` - Dot-notation path for new key
-- `value` (optional) - Initial value (auto-generated if omitted)
-- `--type` - Value type: str, int, float, bool, dict, list
-
-**Type Defaults (when value omitted):**
-- `str` → `""`
-- `int` → `0`
-- `float` → `0.0`
-- `bool` → `false`
-- `dict` → `{}` (empty group/section)
-- `list` → `[]`
-
-**Output Format:**
-```json
-{
-  "success": true,
-  "key": "detection.new_param",
-  "value": 0.5,
-  "type": "float",
-  "message": "Added detection.new_param"
-}
-```
-
-**Examples:**
-```bash
-# Add float parameter
-uv run scripts/managers/config_manager.py add detection.threshold 0.5 --type float
-
-# Add empty group (section)
-uv run scripts/managers/config_manager.py add preprocessing.filters --type dict
-
-# Add nested parameter
-uv run scripts/managers/config_manager.py add preprocessing.filters.blur_kernel 5 --type int
-
-# Add list
-uv run scripts/managers/config_manager.py add detection.excluded_classes "floor,wall" --type list
-```
-
-**Exit Codes:**
-- `0` - Success
-- `1` - Key already exists (use `set` to modify)
-- `2` - Parent path doesn't exist
-
----
-
-### Remove Command
-Delete configuration keys, parameters, or entire groups/sections.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py remove <key.path>
-```
-
-**Parameters:**
-- `key.path` - Dot-notation path to key/section to remove
-
-**Output Format:**
-```json
-{
-  "success": true,
-  "key": "detection.old_param",
-  "deleted_value": 0.123,
-  "message": "Removed detection.old_param"
-}
-```
-
-**Examples:**
-```bash
-# Remove single parameter
-uv run scripts/managers/config_manager.py remove detection.old_threshold
-
-# Remove entire group/section (with all nested keys)
-uv run scripts/managers/config_manager.py remove preprocessing.filters
-```
-
-**Warning:** Removing a group/section deletes ALL nested keys. This action cannot be undone.
-
-**Exit Codes:**
-- `0` - Success
-- `1` - Key not found
-
----
-
-### Move Command
-Reorder/reorganize configuration keys within their parent section (z-index).
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py move <key.path> --direction <direction> [--steps N]
-```
-
-**Parameters:**
-- `key.path` - Dot-notation path to key to move
-- `--direction` - Movement direction:
-  - `up` - Move up N positions
-  - `down` - Move down N positions
-  - `top` - Move to first position in section
-  - `bottom` - Move to last position in section
-- `--steps` (optional) - Number of positions to move (default: 1)
-
-**Output Format:**
-```json
-{
-  "success": true,
-  "key": "detection.score_threshold",
-  "old_index": 6,
-  "new_index": 3,
-  "direction": "up",
-  "message": "Moved detection.score_threshold from position 6 to 3"
-}
-```
-
-**Examples:**
-```bash
-# Move parameter up 1 position
-uv run scripts/managers/config_manager.py move detection.score_threshold --direction up
-
-# Move parameter down 3 positions
-uv run scripts/managers/config_manager.py move detection.nms_threshold --direction down --steps 3
-
-# Move to top of section
-uv run scripts/managers/config_manager.py move detection.visualize_detections --direction top
-
-# Move to bottom of section
-uv run scripts/managers/config_manager.py move detection.max_detections --direction bottom
-```
-
-**Use Cases:**
-- Organize related parameters together
-- Move critical settings to top for visibility
-- Group experimental features at bottom
-- Maintain logical ordering in config file
-
-**Exit Codes:**
-- `0` - Success (including no-op if already at target position)
-- `1` - Key not found
-- `2` - Parent is not a dict/section
-
----
-
-### List Command
-List available configuration keys in a section.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py list [section]
-```
-
-**Parameters:**
-- `section` (optional) - Top-level section name (e.g., `detection`, `synthetic`)
-
-**Output Format (all keys):**
-```json
-{
-  "success": true,
-  "sections": ["synthetic", "detection", "clipping", "validation"]
-}
-```
-
-**Output Format (specific section):**
-```json
-{
-  "success": true,
-  "section": "detection",
-  "keys": [
-    "detection.model_path",
-    "detection.score_threshold",
-    "detection.nms_threshold",
-    ...
-  ]
-}
-```
-
----
-
-### Get-Section Command
-Retrieve entire configuration section.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py get-section <section>
-```
-
-**Parameters:**
-- `section` - Top-level section name
-
-**Output Format:**
-```json
-{
-  "success": true,
-  "section": "detection",
-  "data": {
-    "model_path": "models/obj_detection/product_yolov5_1_0_36.tflite",
-    "score_threshold": 0.05,
-    ...
-  }
-}
-```
-
----
-
-### Validate Command
-Validate configuration file syntax and structure.
-
-**Syntax:**
-```bash
-uv run scripts/managers/config_manager.py validate
-```
-
-**Output Format (valid):**
-```json
-{
-  "success": true,
-  "message": "Configuration is valid",
-  "sections": 5,
-  "total_keys": 47
-}
-```
-
-**Output Format (invalid):**
-```json
-{
-  "success": false,
-  "error": "YAML syntax error: ...",
-  "line": 42
-}
-```
-
----
-
-## Python API
-
-### ConfigManager Class
-
-```python
-from cli_commands.config_manager import ConfigManager
-
-manager = ConfigManager()
-
-# Get value
-result = manager.get("detection.score_threshold")
-# {"success": True, "key": "...", "value": 0.05, "type": "float"}
-
-# Set value
-result = manager.set("detection.score_threshold", 0.1)
-# {"success": True, "key": "...", "old_value": 0.05, "new_value": 0.1}
-
-# List keys
-result = manager.list_keys("detection")
-# {"success": True, "section": "detection", "keys": [...]}
-```
-
----
-
-## Configuration Structure
-
-### Top-Level Sections
-- `synthetic` - Image generation configuration
-- `detection` - Object detection parameters
-- `clipping` - Clip extraction settings
-- `validation` - Quality filtering thresholds
-
-### Common Key Paths
-
-**Generation:**
-- `synthetic.n_variations` (int) - Number of variations per image
-- `synthetic.model` (string) - Gemini model name
-- `synthetic.temperature` (float) - Generation temperature
-- `synthetic.use_sequence_prompts` (bool) - Enable cascade mode
-- `synthetic.sequence_prompt_pattern` (string) - Pattern for sequence prompts
-
-**Detection:**
-- `detection.score_threshold` (float) - Minimum confidence score
-- `detection.min_area_pixels` (int) - Minimum bbox area
-- `detection.aspect_ratio_deviation_threshold` (float) - Max AR deviation
-- `detection.min_bbox_area_ratio_to_reference` (float) - Min area ratio
-
-**Clipping:**
-- `clipping.target_size` (list) - Target dimensions [width, height]
-- `clipping.preserve_original_size` (bool) - Keep original bbox size
-- `clipping.aspect_ratio_tolerance_extraction` (float) - AR tolerance
-
-**Validation:**
-- `validation.enabled` (bool) - Enable quality filtering
-- `validation.blur_threshold` (float) - Min sharpness score
-- `validation.similarity_threshold` (float) - Min similarity to reference
-
----
-
-## Dependencies
-
-- `ruamel.yaml` - YAML manipulation preserving comments
-- `pathlib` - Path operations
-- `json` - Output formatting
-- `argparse` - CLI interface
-
-**Installation:**
-```bash
-source .venv/bin/activate
-uv pip install ruamel.yaml
-```
-
----
-
-## Error Handling
-
-**Common Errors:**
-
-1. **Key not found:**
-   ```json
-   {"success": false, "error": "Key 'invalid.key' not found"}
-   ```
-
-2. **Invalid value type:**
-   ```json
-   {"success": false, "error": "Cannot convert 'abc' to expected type"}
-   ```
-
-3. **YAML syntax error:**
-   ```json
-   {"success": false, "error": "YAML parse error at line 42"}
-   ```
-
-4. **File not found:**
-   ```json
-   {"success": false, "error": "Config file not found: config/config.yaml"}
-   ```
-
----
-
-## Performance
-
-- **Get operation**: O(n) where n = depth of key path
-- **Set operation**: O(n) + file write
-- **List operation**: O(n) where n = number of keys in section
-- **Validate operation**: O(n) where n = file size
-
-**Token usage:**
-- Get: ~50-100 tokens (only returns value, not entire file)
-- Set: ~100-150 tokens (includes old/new value)
-- List: ~200-500 tokens (depends on section size)
-- Validate: ~100 tokens (summary only)
-
-Compare to reading entire config.yaml: **~8000-10000 tokens** ❌

package/.opencode/skills/config-manager/scripts/config_base.py

@@ -1,189 +0,0 @@
-#!/usr/bin/env python3
-"""
-Config Manager Base - Core classes and utilities.
-
-Provides base functionality for YAML configuration management.
-"""
-
-import sys
-import json
-from pathlib import Path
-from typing import Any
-
-try:
-    from ruamel.yaml import YAML
-    from ruamel.yaml.comments import CommentedMap
-except ImportError:
-    print(
-        json.dumps(
-            {
-                "error": "ruamel.yaml not installed. Install with: uv pip install ruamel.yaml",
-                "success": False,
-            }
-        )
-    )
-    sys.exit(1)
-
-
-class ConfigBase:
-    """Base class for configuration management with YAML support."""
-
-    def __init__(self, config_path: str = "config/config.yaml"):
-        """
-        Initialize config manager.
-
-        Args:
-            config_path: Path to config.yaml relative to project root
-        """
-        # Resolve symlink to get actual script location
-        script_path = Path(__file__).resolve()
-
-        # If script is in .opencode/skills/config-manager/scripts/, go up 5 levels to project root
-        # Otherwise (symlinked from scripts/), go up 1 level
-        if ".opencode" in script_path.parts or ".claude" in script_path.parts:
-            # Running from .opencode/skills/config-manager/scripts/config_manager.py (OpenCode)
-            # parent = scripts, parent.parent = config-manager, .parent.parent.parent = skills,
-            # .parent.parent.parent.parent = .opencode, .parent.parent.parent.parent.parent = project_root
-            self.project_root = script_path.parent.parent.parent.parent.parent
-        else:
-            # Running from scripts/config_manager.py (symlink)
-            self.project_root = script_path.parent.parent
-
-        self.config_path = self.project_root / config_path
-        self.yaml = YAML()
-        self.yaml.preserve_quotes = True
-        self.yaml.indent(mapping=2, sequence=2, offset=0)
-
-    def _load_config(self) -> CommentedMap:
-        """Load config file."""
-        if not self.config_path.exists():
-            raise FileNotFoundError(f"Config file not found: {self.config_path}")
-
-        with open(self.config_path, "r", encoding="utf-8") as f:
-            return self.yaml.load(f)
-
-    def _save_config(self, config: CommentedMap) -> None:
-        """Save config file preserving comments and formatting."""
-        with open(self.config_path, "w", encoding="utf-8") as f:
-            self.yaml.dump(config, f)
-
-
-class ConfigPath:
-    """Utilities for working with dot-notation configuration paths."""
-
-    @staticmethod
-    def split(key_path: str) -> list[str]:
-        """Split dot-notation path into keys."""
-        return key_path.split(".")
-
-    @staticmethod
-    def navigate_to_parent(config: dict, key_path: str) -> tuple[dict, str]:
-        """
-        Navigate to parent of target key.
-
-        Args:
-            config: Configuration dictionary
-            key_path: Dot-separated path
-
-        Returns:
-            Tuple of (parent_dict, final_key)
-
-        Raises:
-            KeyError: If parent path doesn't exist
-        """
-        keys = ConfigPath.split(key_path)
-        current = config
-
-        for key in keys[:-1]:
-            if key not in current:
-                raise KeyError(f"Parent key '{key}' not found in path '{key_path}'")
-            if not isinstance(current[key], dict):
-                raise KeyError(f"Cannot navigate through non-dict at key '{key}'")
-            current = current[key]
-
-        return current, keys[-1]
-
-    @staticmethod
-    def get_value(config: dict, key_path: str) -> Any:
-        """
-        Get value from nested dict using dot notation.
-
-        Args:
-            config: Configuration dictionary
-            key_path: Dot-separated path (e.g., 'synthetic.n_variations')
-
-        Returns:
-            Value at key path
-
-        Raises:
-            KeyError: If path doesn't exist
-        """
-        keys = ConfigPath.split(key_path)
-        value = config
-
-        for key in keys:
-            if not isinstance(value, dict):
-                raise KeyError(f"Cannot navigate through non-dict at key '{key}'")
-            if key not in value:
-                raise KeyError(f"Key '{key}' not found in path '{key_path}'")
-            value = value[key]
-
-        return value
-
-
-class ConfigValue:
-    """Utilities for type conversion and value handling."""
-
-    @staticmethod
-    def convert_type(value: Any, target_type: type) -> Any:
-        """
-        Convert value to target type.
-
-        Args:
-            value: Value to convert
-            target_type: Target type
-
-        Returns:
-            Converted value
-        """
-        if isinstance(target_type, bool):
-            # Handle boolean strings
-            if isinstance(value, str):
-                return value.lower() in ("true", "yes", "1", "on")
-            return bool(value)
-        elif isinstance(target_type, int):
-            return int(value)
-        elif isinstance(target_type, float):
-            return float(value)
-        elif isinstance(target_type, str):
-            return str(value)
-        elif isinstance(target_type, list):
-            if isinstance(value, str):
-                # Try to parse as JSON list
-                import json
-
-                try:
-                    parsed = json.loads(value)
-                    if isinstance(parsed, list):
-                        return parsed
-                except json.JSONDecodeError:
-                    pass
-            return list(value) if not isinstance(value, list) else value
-        else:
-            return value
-
-    @staticmethod
-    def format_output(success: bool, **kwargs) -> dict:
-        """
-        Format operation output in consistent structure.
-
-        Args:
-            success: Operation success status
-            **kwargs: Additional fields for output
-
-        Returns:
-            Dictionary with success status and additional fields
-        """
-        result = {"success": success}
-        result.update(kwargs)
-        return result