0xray 3.3.1 → 3.4.2

package/src/skills/researcher/SKILL.md

@@ -28,10 +28,23 @@ Multi-repo analysis, documentation lookup, and implementation examples.
 - **find_implementations**: Find implementations
 - **analyze_documentation**: Analyze documentation
 
-## Usage
+## When to invoke (autonomy-command)
 
-This skill provides research capabilities for researcher functionality.
+Lead dev dispatches researcher **before** major planning, refactors, or cross-repo work — not only when user says "research."
 
-## Integration
+| Trigger | Action |
+|---------|--------|
+| Major refactor / new phase | `search_codebase`, `get_documentation`, `find_implementation` |
+| Prior art / patterns | Search sibling repos (xray, groover, repertoire) |
+| Proposal analysis | `analyze_proposal` via xray-researcher MCP |
 
-Activated when research capabilities are requested through the skills system.
+## MCP tools (xray-researcher)
+
+- `get_documentation` — module/class docs (`target` required)
+- `search_codebase` — text search in workspace
+- `find_implementation` — locate implementations
+- `analyze_proposal` — governance-aware proposal review
+
+## Return shape for lead
+
+Summarize: findings (3–5 bullets), file paths, recommended next todos. Do not defer work back to lead without concrete patches or todos.

package/src/skills/strategist/SKILL.md

@@ -30,3 +30,15 @@ Think deeply before recommending. Consider trade-offs and long-term implications
 - Risk analysis and mitigation planning
 - High-level system design and framework evolution
 - Technical debt identification and prioritization
+
+## When to invoke (autonomy-command)
+
+Lead dev dispatches strategist when `analyze-complexity` score **>25** or work spans multiple repos/phases.
+
+| Output required | Format |
+|-----------------|--------|
+| Phased plan | Phase N + goal + definition of done |
+| Todo breakdown | ID, task, subagent assignment |
+| Risks | Top 3 with mitigations |
+
+Use `orchestrate-task` or Task subagent. Return actionable todos — not essays.

package/src/skills/testing-strategy/SKILL.md

@@ -38,6 +38,17 @@ This skill helps design and optimize testing strategies for:
 - Test coverage optimization
 - Testing best practices implementation
 
-## Integration
+## Per-suite triage (autonomy-command rule 3)
 
-Provides testing expertise and coverage analysis when requested through the skills system.
+After major changes, **do not** run the full test suite first.
+
+```text
+1. Identify affected test file(s) from the diff
+2. Run ONE suite: npm test -- path/to/focused.test.ts
+3. Read ALL failure output — triage root cause
+4. Fix → rerun that suite until green
+5. Repeat for each affected suite
+6. Only then: npm test (full suite gate)
+```
+
+Lead dev owns every failure. No "pre-existing" deferrals.

package/xray/config.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "./config.schema.json",
+  "description": "0xRay Framework - Token Management & Performance Configuration",
+  "token_management": {
+    "maxPromptTokens": 20000,
+    "warningThreshold": 15000,
+    "modelLimits": {},
+    "contextPruning": {
+      "enabled": true,
+      "aggressivePruning": true,
+      "preserveCriticalContext": true
+    }
+  },
+  "cache_settings": {
+    "enabled": true,
+    "max_size_mb": 25,
+    "ttl_seconds": 120,
+    "auto_cleanup_interval_seconds": 60
+  },
+  "memory_management": {
+    "max_heap_mb": 512,
+    "gc_interval_ms": 30000,
+    "force_gc_on_threshold": true
+  }
+}

package/xray/features.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "./features.schema.json",
+  "description": "0xRay Framework - Unified Feature Configuration",
+  "token_optimization": {
+    "enabled": true,
+    "max_context_tokens": 20000,
+    "prune_after_task": true,
+    "summarize_tool_outputs": true,
+    "context_compression": {
+      "enabled": true,
+      "threshold_tokens": 15000,
+      "compression_ratio": 0.4
+    }
+  },
+  "model_routing": {
+    "enabled": true
+  },
+  "batch_operations": {
+    "enabled": true,
+    "prefer_sed_for_replacements": true,
+    "parallel_file_updates": true,
+    "max_concurrent_edits": 10,
+    "auto_batch_threshold": 5
+  },
+  "multi_agent_orchestration": {
+    "enabled": true,
+    "coordination_model": "async-multi-agent",
+    "max_concurrent_agents": 3,
+    "task_distribution_strategy": "capability-based",
+    "conflict_resolution": "expert-priority",
+    "progress_tracking": true,
+    "session_persistence": true,
+    "lead_dev_mode": true,
+    "per_suite_test_triage": true,
+    "phased_plan_threshold": 25,
+    "auto_consult_major_work": true,
+    "no_new_surface": true
+  },
+  "autonomous_reporting": {
+    "enabled": true,
+    "interval_minutes": 60,
+    "auto_schedule": true,
+    "include_health_assessment": true,
+    "include_agent_activities": true,
+    "include_pipeline_operations": true,
+    "include_critical_issues": true,
+    "include_recommendations": true,
+    "report_retention_days": 30,
+    "notification_channels": [
+      "console"
+    ]
+  },
+  "agent_management": {
+    "disabled_agents": [],
+    "agent_models": {},
+    "performance_limits": {
+      "max_task_duration_ms": 30000,
+      "max_memory_usage_mb": 512,
+      "max_tokens_per_request": 16000
+    }
+  },
+  "refactoring": {
+    "enabled": true,
+    "automatic_detection": true,
+    "require_user_approval": false,
+    "max_complexity_threshold": 80,
+    "safe_mode": true,
+    "batch_mode": true
+  },
+  "activity_logging": {
+    "enabled": true,
+    "level": "info",
+    "include_performance_metrics": true,
+    "include_agent_states": false,
+    "include_token_usage": true,
+    "retention_days": 3,
+    "log_to_file": true,
+    "log_path": ".opencode/logs"
+  },
+  "security": {
+    "enabled": true,
+    "prompt_sanitization": true,
+    "vulnerability_scanning": true,
+    "code_review_enforcement": true,
+    "security_score_threshold": 70
+  },
+  "performance_monitoring": {
+    "enabled": true,
+    "real_time_metrics": true,
+    "benchmark_tracking": true,
+    "token_tracking": true,
+    "cost_tracking": true,
+    "alerting": {
+      "enabled": true,
+      "performance_degradation_threshold": 20,
+      "error_rate_threshold": 5,
+      "cost_threshold_daily": 10
+    }
+  },
+  "caching": {
+    "enabled": true,
+    "file_content_cache": true,
+    "search_result_cache": true,
+    "cache_ttl_seconds": 60,
+    "max_cache_size_mb": 25
+  },
+  "agent_spawn": {
+    "max_concurrent": 8,
+    "max_per_type": 3,
+    "spawn_cooldown_ms": 500,
+    "rate_limit_per_minute": 20
+  },
+  "delegation": {
+    "confidence_threshold": 0.5,
+    "enable_intelligent_routing": true
+  },
+  "complexity_thresholds": {
+    "simple": 15,
+    "moderate": 25,
+    "complex": 50,
+    "enterprise": 100
+  },
+  "analytics": {
+    "enabled": true,
+    "default_limit": 500,
+    "min_samples_for_calibration": 3,
+    "track_complexity_accuracy": true,
+    "track_agent_performance": true
+  },
+  "pattern_learning": {
+    "enabled": true,
+    "learning_interval_ms": 300000,
+    "auto_apply_threshold": 0.9,
+    "min_success_rate": 0.7
+  },
+  "memory_routing": {
+    "enabled": true,
+    "provider": "repertoire",
+    "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+    "config": {
+      "dataDir": "../repertoire/data",
+      "signalsPath": "../repertoire/data/curated_signals.json",
+      "logDir": "../repertoire/logs/groover-inference"
+    }
+  }
+}

package/xray/features.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://0xray.ai/schemas/features.schema.json",
+  "title": "0xRay Features Configuration",
+  "type": "object",
+  "properties": {
+    "version": { "type": "string" },
+    "description": { "type": "string" },
+    "memory_routing": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "provider": {
+          "type": "string",
+          "enum": ["null", "repertoire", "custom"]
+        },
+        "module_path": { "type": "string" },
+        "config": { "type": "object" }
+      },
+      "required": ["enabled", "provider"],
+      "if": {
+        "properties": {
+          "enabled": { "const": true },
+          "provider": { "enum": ["repertoire", "custom"] }
+        }
+      },
+      "then": {
+        "required": ["module_path"]
+      }
+    }
+  },
+  "additionalProperties": true
+}