@mc1global/opencode-jarvis 0.13.0 → 0.13.1

package/scripts/setup/jarvis_wrapper.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# JARVIS Framework CLI Wrapper
+#
+# This script enables running JARVIS from any directory by:
+# 1. Setting JARVIS_HOME environment variable
+# 2. Activating the Python virtual environment
+# 3. Changing to the JARVIS directory
+# 4. Executing the opencode CLI with passed arguments
+#
+# Installation: Copy to ~/.local/bin/jarvis or run install_global.sh
+# Usage: jarvis [opencode arguments]
+#
+# Example:
+#   $ jarvis                    # Start JARVIS interactive mode
+#   $ jarvis --help             # Show opencode help
+#   $ jarvis -p "my prompt"     # Run with prompt
+
+set -e
+
+# JARVIS_HOME can be overridden via environment variable
+# Default is set during installation by install_global.sh
+JARVIS_HOME="${JARVIS_HOME:-__JARVIS_HOME_PLACEHOLDER__}"
+
+# Validate JARVIS_HOME exists
+if [ ! -d "$JARVIS_HOME" ]; then
+    echo "Error: JARVIS_HOME directory not found: $JARVIS_HOME" >&2
+    echo "Please set JARVIS_HOME environment variable or reinstall." >&2
+    exit 1
+fi
+
+# Validate virtual environment exists
+if [ ! -f "$JARVIS_HOME/.venv/bin/activate" ]; then
+    echo "Error: Virtual environment not found at $JARVIS_HOME/.venv" >&2
+    echo "Please run: cd $JARVIS_HOME && python -m venv .venv && pip install -r requirements.txt" >&2
+    exit 1
+fi
+
+# Add venv to PATH and activate
+export PATH="$JARVIS_HOME/.venv/bin:$PATH"
+source "$JARVIS_HOME/.venv/bin/activate"
+
+# Save original directory for context
+export JARVIS_CONTEXT_DIR="$(pwd)"
+
+# Change to JARVIS directory (required for opencode.json discovery)
+cd "$JARVIS_HOME"
+
+# Execute opencode CLI with all passed arguments
+exec opencode "$@"

package/scripts/setup/policy_check.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# Policy Check Helper for Agents
+# Usage: source scripts/policy_check.sh && check_policy <operation> <target> [tool]
+
+POLICY_MANAGER="$(dirname "$0")/policy_manager.py"
+
+# Check if policy manager exists
+if [ ! -f "$POLICY_MANAGER" ]; then
+    echo "error Policy manager not found: $POLICY_MANAGER" >&2
+    exit 1
+fi
+
+# Function: check_policy
+# Returns: 0=ALLOWED, 1=FORBIDDEN, 2=WARNING, 3=ERROR
+check_policy() {
+    local operation="$1"
+    local target="$2"
+    local tool="$3"
+
+    if [ -z "$operation" ]; then
+        echo "error Usage: check_policy <operation> <target> [tool]" >&2
+        return 3
+    fi
+
+    # Build command
+    local cmd="python \"$POLICY_MANAGER\" check \"$operation\""
+
+    if [ -n "$target" ]; then
+        cmd="$cmd --target=\"$target\""
+    fi
+
+    if [ -n "$tool" ]; then
+        cmd="$cmd --tool=\"$tool\""
+    fi
+
+    cmd="$cmd --format=toon"
+
+    # Execute and capture result
+    local output
+    output=$(eval $cmd 2>&1)
+    local exit_code=$?
+
+    # Display result
+    echo "$output"
+
+    return $exit_code
+}
+
+# Function: check_policy_json
+# Returns JSON output for parsing
+check_policy_json() {
+    local operation="$1"
+    local target="$2"
+    local tool="$3"
+
+    local cmd="python \"$POLICY_MANAGER\" check \"$operation\""
+
+    if [ -n "$target" ]; then
+        cmd="$cmd --target=\"$target\""
+    fi
+
+    if [ -n "$tool" ]; then
+        cmd="$cmd --tool=\"$tool\""
+    fi
+
+    cmd="$cmd --format=json"
+
+    eval $cmd 2>&1
+    return $?
+}
+
+# Function: policy_guard
+# Guards an operation - exits if FORBIDDEN
+policy_guard() {
+    local operation="$1"
+    local target="$2"
+    local tool="$3"
+    local description="${4:-this operation}"
+
+    echo " Checking policy for: $description..." >&2
+
+    local output
+    output=$(check_policy "$operation" "$target" "$tool")
+    local exit_code=$?
+
+    if [ $exit_code -eq 1 ]; then
+        echo "error FORBIDDEN: $description" >&2
+        echo "$output" >&2
+
+        # Extract alternative if available
+        local alt
+        alt=$(echo "$output" | grep -o 'alt: "[^"]*"' | cut -d'"' -f2)
+        if [ -n "$alt" ]; then
+            echo "info Alternative: $alt" >&2
+        fi
+
+        exit 1
+    elif [ $exit_code -eq 2 ]; then
+        echo "warning  WARNING: $description" >&2
+        echo "$output" >&2
+    else
+        echo "ok Policy check passed" >&2
+    fi
+
+    return 0
+}
+
+# Function: get_policy_alternative
+# Extract alternative action from policy response
+get_policy_alternative() {
+    local operation="$1"
+    local target="$2"
+    local tool="$3"
+
+    local output
+    output=$(check_policy_json "$operation" "$target" "$tool")
+
+    # Extract 'alt' field from JSON
+    echo "$output" | grep -o '"alt": "[^"]*"' | cut -d'"' -f4
+}
+
+# Export functions
+export -f check_policy
+export -f check_policy_json
+export -f policy_guard
+export -f get_policy_alternative

package/scripts/setup/register_all_skills.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""
+Register All Skills - Automatically registers all skills in settings.json
+
+This script scans .opencode/skills/ and registers all valid skills
+in .opencode/settings.json so they become available.
+"""
+
+import json
+import sys
+from pathlib import Path
+import re
+
+
+def extract_description(skill_path: Path) -> str:
+    """Extract description from skill.md frontmatter."""
+
+    skill_md = skill_path / "skill.md"
+    if not skill_md.exists():
+        skill_md = skill_path / "SKILL.md"
+
+    if not skill_md.exists():
+        return "No description available"
+
+    content = skill_md.read_text()
+
+    # Try to extract from frontmatter
+    frontmatter_match = re.search(r'^---\s*\n(.*?)\n---', content, re.DOTALL | re.MULTILINE)
+
+    if frontmatter_match:
+        frontmatter = frontmatter_match.group(1)
+        desc_match = re.search(r'description:\s*(.+?)(?:\n[a-z]|\Z)', frontmatter, re.IGNORECASE | re.DOTALL)
+        if desc_match:
+            return desc_match.group(1).strip().replace('\n', ' ')
+
+    # Fallback: first paragraph after heading
+    lines = content.split('\n')
+    for i, line in enumerate(lines):
+        if line.startswith('#') and i + 1 < len(lines):
+            next_line = lines[i + 1].strip()
+            if next_line and not next_line.startswith('#'):
+                return next_line
+
+    return f"Skill: {skill_path.name}"
+
+
+def register_all_skills():
+    """Register all skills in settings.json."""
+
+    project_root = Path(__file__).parent.parent
+    skills_dir = project_root / ".opencode" / "skills"
+    settings_file = project_root / ".opencode" / "settings.json"
+
+    print(" Scanning skills directory...")
+
+    if not skills_dir.exists():
+        print(f"error: Skills directory not found: {skills_dir}")
+        return False
+
+    # Find all valid skills
+    valid_skills = []
+    for skill_path in sorted(skills_dir.iterdir()):
+        if skill_path.is_dir():
+            skill_md = skill_path / "skill.md"
+            skill_md_upper = skill_path / "SKILL.md"
+
+            if skill_md.exists() or skill_md_upper.exists():
+                description = extract_description(skill_path)
+
+                valid_skills.append({
+                    "name": skill_path.name,
+                    "description": description,
+                    "path": f".opencode/skills/{skill_path.name}",
+                    "enabled": True
+                })
+
+    print(f"   Found {len(valid_skills)} valid skills")
+
+    # Load current settings
+    if settings_file.exists():
+        with open(settings_file) as f:
+            settings = json.load(f)
+    else:
+        settings = {}
+
+    # Backup original
+    backup_file = settings_file.with_suffix('.json.backup')
+    if settings_file.exists():
+        with open(backup_file, 'w') as f:
+            json.dump(settings, f, indent=2)
+        print(f"   Backup created: {backup_file}")
+
+    # Update skills section
+    settings["skills"] = valid_skills
+
+    # Write updated settings
+    with open(settings_file, 'w') as f:
+        json.dump(settings, f, indent=2)
+
+    print(f"\nok: Registered {len(valid_skills)} skills in settings.json")
+    print("\nRegistered skills:")
+    for skill in valid_skills[:10]:
+        print(f"  - {skill['name']}")
+    if len(valid_skills) > 10:
+        print(f"  ... and {len(valid_skills) - 10} more")
+
+    return True
+
+
+def main():
+    """Main entry point."""
+    print("\n" + "="*60)
+    print(" AUTO-REGISTER ALL SKILLS")
+    print("="*60)
+
+    success = register_all_skills()
+
+    if success:
+        print("\n All skills registered successfully!")
+        print("\nNext steps:")
+        print("  1. Restart Claude Code session to load skills")
+        print("  2. Skills will appear in available_skills list")
+        print("  3. Use: skill: \"skill-name\" to invoke them")
+    else:
+        print("\nerror: Failed to register skills")
+        return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/scripts/setup/setup.sh

@@ -0,0 +1,184 @@
+#!/bin/bash
+
+# =============================================================================
+# Jarvis Framework Boilerplate - Basic Setup
+# Installs Python dependencies using uv
+# =============================================================================
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}==============================================================================${NC}"
+echo -e "${BLUE}              Jarvis Framework - Basic Setup (Step 1/2)                       ${NC}"
+echo -e "${BLUE}==============================================================================${NC}"
+echo
+
+# =============================================================================
+# Function: Detect OS
+# =============================================================================
+detect_os() {
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "macos"
+    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+        echo "linux"
+    else
+        echo "unknown"
+    fi
+}
+
+OS=$(detect_os)
+echo -e "${GREEN}Detected OS: $OS${NC}"
+echo
+
+# =============================================================================
+# Step 1: Check Python 3.11+
+# =============================================================================
+echo -e "${YELLOW}[1/5] Checking Python installation...${NC}"
+
+if command -v python3 &> /dev/null; then
+    PYTHON_CMD=python3
+elif command -v python &> /dev/null; then
+    PYTHON_CMD=python
+else
+    echo -e "${RED}ERROR: Python not found!${NC}"
+    echo
+    echo "Please install Python 3.11+ first:"
+    if [[ "$OS" == "macos" ]]; then
+        echo "  brew install python@3.11"
+    elif [[ "$OS" == "linux" ]]; then
+        echo "  sudo apt install python3.11  # Ubuntu/Debian"
+        echo "  sudo dnf install python3.11  # Fedora"
+    fi
+    echo
+    echo "Or download from: https://www.python.org/downloads/"
+    exit 1
+fi
+
+# Check version
+PYTHON_VERSION=$($PYTHON_CMD --version 2>&1 | grep -oE '[0-9]+\.[0-9]+')
+MAJOR=$(echo $PYTHON_VERSION | cut -d. -f1)
+MINOR=$(echo $PYTHON_VERSION | cut -d. -f2)
+
+if [ "$MAJOR" -lt 3 ] || ([ "$MAJOR" -eq 3 ] && [ "$MINOR" -lt 11 ]); then
+    echo -e "${RED}ERROR: Python $PYTHON_VERSION found, but 3.11+ required${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}OK: Python $PYTHON_VERSION${NC}"
+echo
+
+# =============================================================================
+# Step 2: Install uv
+# =============================================================================
+echo -e "${YELLOW}[2/5] Checking uv package installer...${NC}"
+
+if command -v uv &> /dev/null; then
+    UV_VERSION=$(uv --version 2>&1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+    echo -e "${GREEN}OK: uv $UV_VERSION already installed${NC}"
+else
+    echo "Installing uv..."
+    if [[ "$OS" == "macos" ]] || [[ "$OS" == "linux" ]]; then
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+
+        # Add to PATH for current session
+        export PATH="$HOME/.cargo/bin:$PATH"
+
+        # Verify installation
+        if command -v uv &> /dev/null; then
+            echo -e "${GREEN}OK: uv installed successfully${NC}"
+            echo -e "${YELLOW}NOTE: Add to PATH permanently by adding this to ~/.bashrc or ~/.zshrc:${NC}"
+            echo -e "  export PATH=\"\$HOME/.cargo/bin:\$PATH\""
+        else
+            echo -e "${RED}ERROR: uv installation failed${NC}"
+            exit 1
+        fi
+    else
+        echo -e "${RED}ERROR: Unsupported OS for automatic uv installation${NC}"
+        echo "Please install uv manually: https://github.com/astral-sh/uv"
+        exit 1
+    fi
+fi
+echo
+
+# =============================================================================
+# Step 3: Create Virtual Environment
+# =============================================================================
+echo -e "${YELLOW}[3/5] Creating virtual environment...${NC}"
+
+if [ -d ".venv" ]; then
+    echo -e "${GREEN}OK: .venv already exists${NC}"
+else
+    uv venv .venv
+    echo -e "${GREEN}OK: .venv created${NC}"
+fi
+echo
+
+# =============================================================================
+# Step 4: Install Dependencies
+# =============================================================================
+echo -e "${YELLOW}[4/5] Installing Python dependencies...${NC}"
+
+# Activate virtual environment
+source .venv/bin/activate
+
+# Install dependencies using uv
+uv pip install -r requirements.txt
+
+echo -e "${GREEN}OK: Dependencies installed${NC}"
+echo
+
+# =============================================================================
+# Step 5: Create .env file
+# =============================================================================
+echo -e "${YELLOW}[5/5] Setting up environment configuration...${NC}"
+
+if [ ! -f ".env" ]; then
+    cat > .env << 'EOF'
+# Jarvis Framework Configuration
+
+# Logging
+LOG_LEVEL=INFO
+
+# Workspace
+DEFAULT_LANGUAGE=python
+
+# Ollama (optional - configure in advanced setup)
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL=llama3.2:3b
+
+# Anthropic (optional)
+# ANTHROPIC_API_KEY=your_key_here
+EOF
+    echo -e "${GREEN}OK: .env file created${NC}"
+else
+    echo -e "${GREEN}OK: .env file already exists${NC}"
+fi
+echo
+
+# =============================================================================
+# Success Summary
+# =============================================================================
+echo -e "${BLUE}==============================================================================${NC}"
+echo -e "${GREEN}            Basic Setup Complete! (Step 1/2)                                  ${NC}"
+echo -e "${BLUE}==============================================================================${NC}"
+echo
+echo "What was installed:"
+echo -e "  ${GREEN}✓${NC} Python $PYTHON_VERSION"
+echo -e "  ${GREEN}✓${NC} uv package manager"
+echo -e "  ${GREEN}✓${NC} Virtual environment (.venv)"
+echo -e "  ${GREEN}✓${NC} Python dependencies"
+echo -e "  ${GREEN}✓${NC} Environment configuration (.env)"
+echo
+echo -e "${YELLOW}NEXT STEP:${NC}"
+echo "Run the advanced setup to configure Ollama and RAG:"
+echo
+echo -e "  ${GREEN}source .venv/bin/activate${NC}"
+echo -e "  ${GREEN}python scripts/setup/setup_advanced.py${NC}"
+echo
+echo -e "${BLUE}==============================================================================${NC}"

package/scripts/setup/setup_advanced.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+"""
+Advanced setup workflow for the Jarvis Framework.
+
+This script runs the optional-but-recommended tasks that finish the local
+environment: RAG dependencies, Ollama models, context memory DB, skill
+registration, and hybrid routing configuration.
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import subprocess
+import sys
+from pathlib import Path
+from typing import List, Sequence
+
+PROJECT_ROOT = Path(__file__).resolve().parents[2]
+
+# Add project root to path for imports
+sys.path.insert(0, str(PROJECT_ROOT))
+
+
+class SetupTask:
+    """Structured representation of a setup step."""
+
+    def __init__(
+        self,
+        name: str,
+        command: Sequence[str],
+        description: str,
+        optional: bool = False,
+        env: dict[str, str] | None = None,
+    ) -> None:
+        self.name = name
+        self.command = list(command)
+        self.description = description
+        self.optional = optional
+        self.env = env or {}
+
+
+def detect_shell() -> str:
+    """Return command to invoke bash on current platform."""
+    if sys.platform.startswith("win"):
+        return "bash"
+    return "bash"
+
+
+def run_step(task: SetupTask, assume_yes: bool) -> None:
+    """Execute a single setup task with prompts and logging."""
+    if task.optional and not assume_yes:
+        response = input(f"Run optional step '{task.name}'? [Y/n]: ").strip().lower()
+        if response and response not in {"y", "yes"}:
+            print(f"Skipping {task.name}")
+            return
+
+    env = os.environ.copy()
+    env.update(task.env)
+
+    print("\n" + "=" * 70)
+    print(f"  {task.name}")
+    print("-" * 70)
+    print(task.description)
+    print("-" * 70)
+    print(f"Command: {' '.join(task.command)}")
+
+    try:
+        subprocess.run(task.command, cwd=PROJECT_ROOT, env=env, check=True)
+        print(f"  {task.name} completed")
+    except subprocess.CalledProcessError as exc:
+        print(f"  {task.name} exited with status {exc.returncode}")
+        print("    Review the logs above. Setup will continue.")
+
+
+def ensure_virtualenv() -> None:
+    """Warn if the user forgot to activate the virtual environment."""
+    venv = os.environ.get("VIRTUAL_ENV")
+    if not venv:
+        print("  It looks like the Python virtual environment is not active.")
+        print("    Activate it before running advanced setup:")
+        print("      source .venv/bin/activate")
+        print("    Continuing anyway...\n")
+
+
+def build_task_list() -> List[SetupTask]:
+    """Create the list of advanced setup steps."""
+    shell = detect_shell()
+    python_exe = sys.executable or "python3"
+
+    # Import here to get the actual path for documentation
+    from src.shared.paths import get_context_memory_db_path
+    db_path = get_context_memory_db_path()
+
+    return [
+        SetupTask(
+            name="Install RAG dependencies",
+            command=[python_exe, "scripts/setup/install_rag_dependencies.py"],
+            description="Installs Chromadb + Ollama Python bindings required by the semantic index.",
+        ),
+        SetupTask(
+            name="Install recommended Ollama models",
+            command=[shell, "scripts/setup/install_ollama_models.sh"],
+            description="Pulls locally hosted models for hybrid execution (qwen2.5-coder, deepseek, phi).",
+            optional=True,
+        ),
+        SetupTask(
+            name="Initialize context memory database",
+            command=[python_exe, "scripts/setup/init_database.py"],
+            description=f"Creates {db_path} with the latest schema + guardrail policies.",
+        ),
+        SetupTask(
+            name="Register Claude skills",
+            command=[python_exe, "scripts/setup/register_all_skills.py"],
+            description="Scans .opencode/skills and synchronizes .opencode/settings.json.",
+        ),
+        SetupTask(
+            name="Configure hybrid routing defaults",
+            command=[python_exe, "scripts/setup/configure_hybrid_routing.py"],
+            description="Detects available Ollama models and writes .jarvis_hybrid_routing.json.",
+            optional=True,
+        ),
+    ]
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Jarvis Framework advanced setup")
+    parser.add_argument(
+        "--yes",
+        "-y",
+        action="store_true",
+        help="Run all steps without prompting for optional tasks.",
+    )
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    ensure_virtualenv()
+
+    print("=" * 70)
+    print("  Jarvis Framework Advanced Setup")
+    print("=" * 70)
+
+    tasks = build_task_list()
+    for task in tasks:
+        run_step(task, assume_yes=args.yes)
+
+    print("\n  Advanced setup complete.")
+    print("Next steps:")
+    print("  - Index your codebase: python scripts/rag/jarvis_rag_v2.py index -d src/")
+    print("  - Verify search:       python scripts/rag/rag_cli.py search \"authentication\" -k 5")
+    print("  - Restart Claude Code to load updated skills.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())