@mc1global/opencode-jarvis 0.13.0 → 0.13.1

package/package.json

@@ -1,70 +1,50 @@
 {
   "name": "@mc1global/opencode-jarvis",
-  "version": "0.13.0",
-  "description": "JARVIS Framework - OpenCode native plugin for multi-agent development with DDD architecture",
-  "author": "Julio Fabio de O. Chagas <julio.fabio@mc1global.com>",
-  "license": "SEE LICENSE IN LICENSE",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "bin": {
-    "jarvis-mcp": "dist/mcp-server.js",
-    "jarvis": "dist/cli/config-wizard.js"
-  },
+  "version": "0.13.1",
+  "description": "JARVIS Framework - Multi-agent orchestration with OpenCode integration",
+  "private": false,
+  "main": "index.js",
   "files": [
-    "dist/",
-    "templates/",
-    "scripts/setup/",
-    "LICENSE",
+    "src/",
+    "scripts/",
+    "config/",
+    ".opencode/",
     "README.md",
-    "QUICK-GUIDE.md"
+    "LICENSE",
+    "OPENCODE.md",
+    "pyproject.toml",
+    "requirements.txt"
   ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "node --experimental-vm-modules node_modules/.bin/jest",
-    "test:watch": "node --experimental-vm-modules node_modules/.bin/jest --watch",
-    "lint": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "prepack": "npm run clean && npm run build",
-    "check:lines": "find src -name '*.ts' ! -path '*/tests/*' -exec wc -l {} + | sort -rn | head -20",
-    "mcp:start": "bun run src/mcp-server.ts"
+    "postinstall": "echo 'JARVIS Framework installed successfully! Use: opencode --help for commands'"
   },
-  "engines": {
-    "node": ">=20.0.0"
+  "keywords": [
+    "jarvis-framework",
+    "multi-agent",
+    "orchestration",
+    "governance",
+    "opencode",
+    "ai",
+    "claude",
+    "automation"
+  ],
+  "author": "MC1 Global",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://dev.azure.com/mc1global/jarvis-framework/_git/jarvis-opencode"
   },
   "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
+    "access": "restricted"
   },
   "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.1.0"
+    "@types/node": ">=18.0.0"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.1",
-    "@langchain/textsplitters": "^1.0.1",
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "js-yaml": "^4.1.1",
-    "ollama": "^0.6.3",
-    "vectra": "^0.12.3"
+    "dotenv": "^16.6.0"
   },
-  "devDependencies": {
-    "@opencode-ai/plugin": "^1.1.65",
-    "@types/better-sqlite3": "^7.6.8",
-    "@types/bun": "^1.3.9",
-    "@types/jest": "^29.5.12",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "better-sqlite3": "^11.0.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "typescript": "^5.5.0"
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
   }
 }

package/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "jarvis-opencode"
+version = "1.0.0"
+description = "JARVIS - AI-powered development assistant"
+requires-python = ">=3.11"
+dependencies = [
+    "click>=8.3.1",
+    "langchain-chroma>=1.1.0",
+    "langchain-community>=0.4.1",
+    "langchain-core>=1.2.7",
+    "langchain-ollama>=1.0.1",
+    "pydantic>=2.12.5",
+    "python-pptx>=1.0.2",
+    "pyyaml>=6.0.3",
+    "rich>=14.3.1",
+    "ruamel-yaml>=0.19.1",
+]
+
+[tool.black]
+line-length = 120
+target-version = ['py311']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  # directories
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | build
+  | dist
+)/
+'''
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra -q --strict-markers"
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["*/tests/*", "*/__pycache__/*", "*/venv/*"]
+
+[tool.coverage.report]
+precision = 2
+show_missing = true
+skip_covered = false
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+]

package/requirements.txt

@@ -0,0 +1,139 @@
+# Jarvis Framework - Python Dependencies
+# Multi-language AI agent framework with DDD architecture
+
+# =============================================================================
+# CORE DEPENDENCIES
+# =============================================================================
+
+# CLI and Configuration
+click>=8.1.0                    # CLI framework
+pyyaml>=6.0                     # YAML configuration
+python-dotenv>=1.0.0            # Environment variables
+ruamel.yaml>=0.18.16            # Advanced YAML with comment preservation
+
+# Data Validation and Models
+pydantic>=2.0.0                 # Data validation and settings management
+pydantic-settings>=2.0.0        # Settings management with pydantic
+
+# =============================================================================
+# LANGCHAIN & LLM INTEGRATION
+# =============================================================================
+
+# LangChain Core (updated Jan 2026)
+langchain>=0.3.0                # LLM orchestration framework
+langchain-core>=1.0.0           # Core LangChain abstractions
+langchain-community>=0.3.0      # Community integrations
+
+# LangChain Ollama Integration
+langchain-ollama>=1.0.0         # Ollama LLM integration
+
+# LangChain Vector Stores
+langchain-chroma>=1.0.0         # Chroma vector store integration
+chromadb>=0.4.0                 # Chroma vector database
+
+# Text Processing
+langchain-text-splitters>=0.3.0 # Document chunking strategies
+
+# =============================================================================
+# MCP (MODEL CONTEXT PROTOCOL)
+# =============================================================================
+
+# FastMCP for MCP server implementation
+mcp>=0.1.0                      # Model Context Protocol SDK
+
+# =============================================================================
+# CONTEXT MEMORY & DATABASE
+# =============================================================================
+
+# SQLite is built-in to Python, no need to install
+# For enhanced features:
+requests>=2.31.0                # HTTP requests for external APIs
+
+# =============================================================================
+# WEB FRAMEWORK (for MCP server)
+# =============================================================================
+
+fastapi>=0.104.0                # Modern web framework
+uvicorn>=0.24.0                 # ASGI server
+starlette>=0.27.0               # ASGI framework (FastAPI dependency)
+python-multipart>=0.0.6         # Form data parsing
+
+# HTTP clients
+httpx>=0.25.0                   # Modern HTTP client
+httpx-sse>=0.4.0                # Server-sent events support
+
+# =============================================================================
+# LSP INTEGRATION (Language Server Protocol)
+# =============================================================================
+
+# Python LSP Server (for code navigation, symbol lookup, references)
+python-lsp-server>=1.10.0       # Python Language Server for LSP integration
+
+# Tree-sitter for syntax parsing fallback when LSP unavailable
+tree-sitter>=0.21,<0.22  # Required for tree-sitter-languages compatibility
+
+# =============================================================================
+# CODE QUALITY & TESTING
+# =============================================================================
+
+# Linting and Formatting
+flake8>=6.0.0                   # Python linting
+black>=23.0.0                   # Code formatting
+mypy>=1.0.0                     # Static type checking
+
+# Testing
+pytest>=7.4.0                   # Testing framework
+pytest-cov>=4.1.0               # Coverage reporting
+pytest-asyncio>=0.21.0          # Async test support
+
+# =============================================================================
+# UTILITIES
+# =============================================================================
+
+# Rich Output
+rich>=13.0.0                    # Pretty terminal output
+typer>=0.9.0                    # Modern CLI framework
+
+# Data Processing
+pandas>=2.0.0                   # Data manipulation (for CSV manager)
+
+# Security
+cryptography>=41.0.0            # Encryption and hashing
+
+# JSON Processing
+jsonschema>=4.0.0               # JSON schema validation
+
+# System Utilities
+psutil>=5.9.0                   # System and process utilities
+
+# =============================================================================
+# ANTHROPIC API (Optional - for hybrid mode)
+# =============================================================================
+
+anthropic>=0.25.0               # Anthropic Claude API client
+
+# =============================================================================
+# OPTIONAL DEPENDENCIES
+# =============================================================================
+
+# Jupyter Integration (for notebook support)
+# ipython>=8.0.0
+# jupyter>=1.0.0
+
+# Advanced YAML (already included above)
+# ruamel.yaml>=0.18.16
+
+# Telegram Integration (if needed)
+# python-telegram-bot>=20.0
+
+# =============================================================================
+# DEVELOPMENT DEPENDENCIES (install separately with: pip install -e .[dev])
+# =============================================================================
+
+# These are typically in pyproject.toml [project.optional-dependencies]
+# But listed here for reference:
+# - pytest-watch  # Auto-run tests
+# - pytest-xdist  # Parallel testing
+# - coverage      # Coverage reports
+# - pre-commit    # Git hooks
+tree-sitter-languages>=1.10.0  # Pre-built tree-sitter parsers

package/scripts/README.md

@@ -0,0 +1,160 @@
+# Scripts Organization
+
+## Core CLI Tools (Root Level)
+
+Primary interfaces used frequently by agents and users:
+
+- `context_memory_cli.py` - Context memory operations
+- `code_block_manager.py` - Code block operations
+- `file_manager.py` - File management
+- `workspace_manager.py` - Workspace operations
+- `user_story_manager.py` - User story management
+- `git_repo_manager.py` - Git operations
+
+## 📊 6-Sigma Directory Organization
+
+Following **6-sigma** principles for maximum clarity and maintainability:
+
+### tests/ 🧪
+**Purpose**: Test and validation scripts
+**When to use**: Test suites, integration tests, validation scripts
+**Examples**: `test_permission_hook.sh`, `test_rag_integration.py`
+
+### managers/ 📁
+**Purpose**: Specialized file format and resource managers (15+ files)
+**When to use**: Operations on specific file types or resources
+**Examples**: `yaml_manager.py`, `json_manager.py`, `policy_manager.py`
+
+### utilities/ 🔧
+**Purpose**: Helper utilities and monitoring tools (8+ files)
+**When to use**: General-purpose helper functions
+**Examples**: `help_loader.py`, `check_skills_loaded.py`
+
+### validators/ ✅
+**Purpose**: Code validation and compliance checking (11+ files)
+**When to use**: Syntax checking, linting, compliance validation
+**Examples**: `code_validator.py`, `operation_validator.py`
+
+### setup/ ⚙️
+**Purpose**: Installation and configuration scripts (19+ files)
+**When to use**: Initial setup, environment configuration
+**Examples**: `setup_all.sh`, `init_database.py`
+
+### maintenance/ 🔨
+**Purpose**: Maintenance operations and housekeeping
+**When to use**: Database cleanup, cache management, repairs
+**Examples**: `cleanup_db.py`, `rebuild_indexes.sh`
+
+### migrations/ 🔄
+**Purpose**: Database and project migration tools (10+ files)
+**When to use**: Schema changes, data migrations, version upgrades
+**Examples**: `migrate_v1_to_v2.py`, `upgrade_schema.sql`
+
+### rag/ 🔍
+**Purpose**: RAG V2 system and semantic search tools (10+ files)
+**When to use**: Semantic search, code intelligence, embeddings
+**Examples**: `rag_cli.py`, `code_intelligence.py`, `domain_mapper_v2.py`
+
+### llm/ 🤖
+**Purpose**: LLM operations and model management
+**When to use**: Direct LLM interactions, model selection, prompting
+**Examples**: `llm_client.py`, `model_selector.py`
+
+### sync/ 🔁
+**Purpose**: Boilerplate synchronization scripts (2+ files)
+**When to use**: Syncing templates, configurations across workspaces
+**Examples**: `sync_boilerplate.sh`
+
+### examples/ 📚
+**Purpose**: Example code and integration demonstrations (3+ files)
+**When to use**: Learning, templates, proof-of-concept
+**Examples**: `example_skill.py`, `integration_demo.py`
+
+### snapshot/ 📸
+**Purpose**: Snapshot management and backup tools
+**When to use**: Creating/restoring snapshots, backups
+**Examples**: `create_snapshot.sh`, `restore_from_snapshot.py`
+
+### obsolete/ 🗂️
+**Purpose**: Deprecated files kept for reference (17+ files)
+**When to use**: Historical reference only - DO NOT USE in production
+**Examples**: Old implementations, deprecated APIs
+
+### _temp/ ⏳
+**Purpose**: Temporary/transitional scripts (experimental)
+**When to use**: Work-in-progress, experiments, temporary solutions
+**Note**: Clean up periodically - these should migrate to proper directories
+
+## 🌳 Decision Tree: Where Should My Script Go?
+
+```
+Is it a test script?
+├─ YES → tests/
+└─ NO ↓
+
+Is it for setup/installation?
+├─ YES → setup/
+└─ NO ↓
+
+Is it for database migrations?
+├─ YES → migrations/
+└─ NO ↓
+
+Does it manage a specific file format (YAML, JSON, CSV)?
+├─ YES → managers/
+└─ NO ↓
+
+Does it validate/check code quality?
+├─ YES → validators/
+└─ NO ↓
+
+Is it for RAG/semantic search?
+├─ YES → rag/
+└─ NO ↓
+
+Is it for LLM operations?
+├─ YES → llm/
+└─ NO ↓
+
+Is it for maintenance/cleanup?
+├─ YES → maintenance/
+└─ NO ↓
+
+Is it a general utility/helper?
+├─ YES → utilities/
+└─ NO ↓
+
+Is it experimental/temporary?
+├─ YES → _temp/ (but plan to move it!)
+└─ NO ↓
+
+Is it an example/demonstration?
+├─ YES → examples/
+└─ NO → Ask for guidance!
+```
+
+## Quick Reference
+
+```bash
+# Core operations
+python scripts/context_memory_cli.py todo list
+python scripts/code_block_manager.py get-function <file> <func>
+
+# RAG operations
+python scripts/rag/rag_cli.py search "query"
+python scripts/rag/code_intelligence.py check-feature "feature"
+
+# Validation
+python scripts/validators/code_validator.py <file>
+
+# Testing
+scripts/tests/test_permission_hook.sh
+
+# Setup
+python scripts/setup/init_database.py
+```
+
+## See Also
+
+- `CLAUDE.md` - Complete usage guide
+- `.opencode/skills/` - Skill documentation

package/scripts/_help/.!13625!git_repo_manager.yaml

@@ -0,0 +1,31 @@
+name: git_repo_manager.py
+description: Git Repository Manager - Token-optimized with TOON outputs (90-95% savings)
+
+output_format:
+  default: TOON compact (ok:key:value,...)
+  verbose: Full formatted (use --verbose flag)
+  savings: 90-95% average
+
+design_principles:
+  - "Minimal commands (essential only)"
+  - "TOON format by default"
+  - "No emojis, no tables, no ASCII art"
+  - "Subprocess-based (no GitPython)"
+  - "DDD architecture"
+
+usage:
+  - python scripts/git_repo_manager.py <command> [options]
+
+commands:
+  status:
+    description: Show repository status (TOON format)
+    usage:
+      - python scripts/git_repo_manager.py status [--path=PATH] [--verbose]
+    output:
+      default: "ok:branch:main,modified:3,untracked:1"
+      verbose: "Branch: main\\nModified: 3 files\\n..."
+    examples:
+      - cmd: python scripts/git_repo_manager.py status
+        output: "ok:branch:enhancements/rag:modified:3:staged:1:untracked:1"
+      - cmd: python scripts/git_repo_manager.py status --path=/path/to/repo
+        output: "ok:branch:main"

package/scripts/_help/code_block_manager.yaml

@@ -0,0 +1,82 @@
+name: code_block_manager.py
+description: Extract and update code blocks (functions/classes) without loading entire file (96% token savings)
+
+usage:
+  - python scripts/code_block_manager.py <command> <file> [args]
+
+commands:
+  list-functions:
+    description: List all functions in a file
+    usage:
+      - python scripts/code_block_manager.py list-functions <file> [--language=python]
+    examples:
+      - python scripts/code_block_manager.py list-functions src/service.py
+      - python scripts/code_block_manager.py list-functions src/app.js --language=javascript
+
+  get-function:
+    description: Extract specific function code
+    usage:
+      - python scripts/code_block_manager.py get-function <file> <function_name>
+    examples:
+      - python scripts/code_block_manager.py get-function src/auth.py authenticate_user
+      - python scripts/code_block_manager.py get-function src/utils.py calculate_total
+
+  update-function:
+    description: Update function with new code
+    usage:
+      - python scripts/code_block_manager.py update-function <file> <function_name> --code="<new_code>"
+      - cat new_function.py | python scripts/code_block_manager.py update-function <file> <function_name> --stdin
+    options:
+      - flag: --code
+        description: New function code as string
+      - flag: --stdin
+        description: Read code from stdin
+      - flag: --dry-run
+        description: Preview changes without applying
+    examples:
+      - python scripts/code_block_manager.py update-function src/auth.py login --code="def login(): pass"
+      - cat new_auth.py | python scripts/code_block_manager.py update-function src/auth.py login --stdin
+
+  list-classes:
+    description: List all classes in a file
+    usage:
+      - python scripts/code_block_manager.py list-classes <file>
+    examples:
+      - python scripts/code_block_manager.py list-classes src/models.py
+
+  get-class:
+    description: Extract specific class code
+    usage:
+      - python scripts/code_block_manager.py get-class <file> <class_name>
+    examples:
+      - python scripts/code_block_manager.py get-class src/models.py User
+
+  update-class:
+    description: Update entire class
+    usage:
+      - python scripts/code_block_manager.py update-class <file> <class_name> --code="<new_code>"
+    examples:
+      - python scripts/code_block_manager.py update-class src/models.py User --code="class User: pass"
+
+  add-method:
+    description: Add method to existing class
+    usage:
+      - python scripts/code_block_manager.py add-method <file> <class_name> --method="<method_code>"
+    examples:
+      - python scripts/code_block_manager.py add-method src/models.py User --method="def get_email(self): return self.email"
+
+examples:
+  - "# List functions in file"
+  - python scripts/code_block_manager.py list-functions src/auth/service.py
+  - ""
+  - "# Extract specific function"
+  - python scripts/code_block_manager.py get-function src/auth/service.py authenticate
+  - ""
+  - "# Update function"
+  - python scripts/code_block_manager.py update-function src/auth/service.py authenticate --code="def authenticate(user): return True"
+
+notes:
+  - "Automatically creates .backup file before modifications"
+  - "Uses Ollama for code parsing (zero API cost)"
+  - "Saves 96% tokens vs reading entire file (7300 → 300 tokens)"
+  - "Works with Python, JavaScript, TypeScript, Go, Java, etc"