Merge pull request #228 from avifenesh/fix/enhance-debate-consult-findings

chore: release v5.1.0

Author: avifenesh

.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "agentsys",
   "description": "13 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, topic research, agent config linting, cross-tool AI consultation, and structured AI debate",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -26,91 +26,91 @@
       "name": "next-task",
       "source": "./plugins/next-task",
       "description": "Master workflow orchestrator: autonomous workflow with model optimization (opus/sonnet/haiku), two-file state management, workflow enforcement gates, 14 specialist agents",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "productivity"
     },
     {
       "name": "ship",
       "source": "./plugins/ship",
       "description": "Complete PR workflow: commit to production, skips review when called from next-task, removes task from registry on cleanup, automatic rollback",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "deployment"
     },
     {
       "name": "deslop",
       "source": "./plugins/deslop",
       "description": "3-phase AI slop detection: regex patterns (HIGH), multi-pass analyzers (MEDIUM), CLI tools (LOW)",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "audit-project",
       "source": "./plugins/audit-project",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "drift-detect",
       "source": "./plugins/drift-detect",
       "description": "Deep repository analysis to realign project plans with code reality - detects drift, gaps, and creates prioritized reconstruction plans",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "productivity"
     },
     {
       "name": "enhance",
       "source": "./plugins/enhance",
       "description": "Master enhancement orchestrator: parallel analyzer execution for plugins, agents, docs, CLAUDE.md, and prompts with unified reporting",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "sync-docs",
       "source": "./plugins/sync-docs",
       "description": "Standalone documentation sync: find outdated refs, update CHANGELOG, flag stale examples based on code changes",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "repo-map",
       "source": "./plugins/repo-map",
       "description": "AST-based repository map generation using ast-grep with incremental updates for faster drift analysis",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "perf",
       "source": "./plugins/perf",
       "description": "Rigorous performance investigation workflow with baselines, profiling, hypotheses, and evidence-backed decisions",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "learn",
       "source": "./plugins/learn",
       "description": "Research topics online and create comprehensive learning guides with RAG-optimized indexes",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "productivity"
     },
     {
       "name": "agnix",
       "source": "./plugins/agnix",
       "description": "Lint agent configuration files (SKILL.md, CLAUDE.md, hooks, MCP) against 155 rules across 10+ AI tools",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "development"
     },
     {
       "name": "consult",
       "source": "./plugins/consult",
       "description": "Cross-tool AI consultation: get second opinions from Gemini CLI, Codex CLI, Claude Code, OpenCode, or Copilot CLI with model and thinking effort control",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "productivity"
     },
     {
       "name": "debate",
       "source": "./plugins/debate",
       "description": "Structured multi-round debate between AI tools with proposer/challenger roles and verdict",
-      "version": "5.0.3",
+      "version": "5.1.0",
       "category": "productivity"
     }
   ]

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "keywords": [
     "workflow",

CHANGELOG.md

@@ -9,6 +9,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.1.0] - 2026-02-18
+
+### Added
+
+- **`/debate` plugin** — New plugin for structured multi-round AI dialectic. Pick two tools (e.g. `codex vs gemini`), set 1–5 rounds, and get a proposer/challenger debate with a synthesized verdict. Supports natural language input, effort levels (`--effort=low|high|max`), and context injection (`--context=diff` or `--context=file=PATH`). Available on Claude Code, OpenCode, and Codex CLI.
+- **`/consult` multi-instance support** — Run N parallel consultations with the same tool using `--count=N` (or natural language: "ask 3 gemini about this"). Responses are numbered and a brief synthesis highlights agreements and differences.
+- **`/consult` natural language parsing** — Free-form queries are now parsed automatically without requiring explicit flags. "with codex about my auth approach", "ask gemini thoroughly about this design", or "3 claude opinions on error handling" all work out of the box.
+
+### Changed
+
+- **Agent model optimization** — `exploration-agent` and `learn-agent` switched from opus to sonnet, reducing cost and latency for exploration and research passes with no quality regression.
+
+### Fixed
+
+- **Debate `--context=file` path validation** — Added path containment checks to prevent directory traversal when passing file paths as context.
+- **Debate prompt hardening** — Context passthrough, canonical output redaction, and relaxed disagreement rules applied consistently across all debate rounds.
+- **Consult model/flag issues** — Hardened model flag handling and non-interactive invocation across all four supported tools (Claude, Gemini, Codex, OpenCode).
+
 ## [5.0.3] - 2026-02-17
 
 ### Fixed

adapters/codex/skills/debate/SKILL.md

@@ -81,7 +81,8 @@ Use a SINGLE request_user_input call for all missing params:
 request_user_input:
 > **Codex**: Each question MUST include a unique `id` field (e.g., `id: "q1"`).
   questions:
-    - header: "Proposer"                         # SKIP if proposer resolved
+    - id: "debate-proposer"
+      header: "Proposer"                         # SKIP if proposer resolved
       question: "Which tool should PROPOSE (argue for)?"
       options (only installed tools):
         - label: "Claude"       description: "Deep code reasoning"
@@ -90,28 +91,32 @@ request_user_input:
         - label: "OpenCode"     description: "Flexible model choice"
         - label: "Copilot"      description: "GitHub-integrated AI"
 
-    - header: "Challenger"                       # SKIP if challenger resolved
+    - id: "debate-challenger"
+      header: "Challenger"                       # SKIP if challenger resolved
       question: "Which tool should CHALLENGE (find flaws)?"
       options (only installed, excluding proposer):
         [same list minus the proposer tool]
 
-    - header: "Effort"                           # SKIP if effort resolved
+    - id: "debate-effort"
+      header: "Effort"                           # SKIP if effort resolved
       question: "What thinking effort level?"
       options:
         - label: "High (Recommended)"    description: "Thorough analysis for debate"
         - label: "Medium"                description: "Balanced speed and quality"
         - label: "Low"                   description: "Fast, minimal reasoning"
         - label: "Max"                   description: "Maximum reasoning depth"
 
-    - header: "Rounds"                           # SKIP if rounds resolved
+    - id: "debate-rounds"
+      header: "Rounds"                           # SKIP if rounds resolved
       question: "How many debate rounds?"
       options:
         - label: "2 (Recommended)"       description: "Propose + challenge + defend + respond"
         - label: "1 (Quick)"             description: "Single propose + challenge"
         - label: "3 (Extended)"          description: "Three full exchanges"
         - label: "5 (Exhaustive)"        description: "Five rounds, deep exploration"
 
-    - header: "Context"                          # SKIP if --context resolved
+    - id: "debate-context"
+      header: "Context"                          # SKIP if --context resolved
       question: "Include codebase context for both tools?"
       options:
         - label: "None (Recommended)"    description: "No extra context, just the topic"
@@ -127,7 +132,8 @@ If context resolved to "file":
   request_user_input:
 > **Codex**: Each question MUST include a unique `id` field (e.g., `id: "q1"`).
     questions:
-      - header: "File path"
+      - id: "debate-file-path"
+        header: "File path"
         question: "Which file should both tools see?"
         options:
           - label: "src/"               description: "Source directory file"

adapters/opencode/commands/debate.md

@@ -86,7 +86,8 @@ Use a SINGLE AskUserQuestion call for all missing params:
 ```
 AskUserQuestion:
   questions:
-    - header: "Proposer"                         # SKIP if proposer resolved
+    - id: "debate-proposer"
+      header: "Proposer"                         # SKIP if proposer resolved
       question: "Which tool should PROPOSE (argue for)?"
       multiSelect: false
       options (only installed tools):
@@ -96,13 +97,15 @@ AskUserQuestion:
         - label: "OpenCode"     description: "Flexible model choice"
         - label: "Copilot"      description: "GitHub-integrated AI"
 
-    - header: "Challenger"                       # SKIP if challenger resolved
+    - id: "debate-challenger"
+      header: "Challenger"                       # SKIP if challenger resolved
       question: "Which tool should CHALLENGE (find flaws)?"
       multiSelect: false
       options (only installed, excluding proposer):
         [same list minus the proposer tool]
 
-    - header: "Effort"                           # SKIP if effort resolved
+    - id: "debate-effort"
+      header: "Effort"                           # SKIP if effort resolved
       question: "What thinking effort level?"
       multiSelect: false
       options:
@@ -111,7 +114,8 @@ AskUserQuestion:
         - label: "Low"                   description: "Fast, minimal reasoning"
         - label: "Max"                   description: "Maximum reasoning depth"
 
-    - header: "Rounds"                           # SKIP if rounds resolved
+    - id: "debate-rounds"
+      header: "Rounds"                           # SKIP if rounds resolved
       question: "How many debate rounds?"
       multiSelect: false
       options:
@@ -120,7 +124,8 @@ AskUserQuestion:
         - label: "3 (Extended)"          description: "Three full exchanges"
         - label: "5 (Exhaustive)"        description: "Five rounds, deep exploration"
 
-    - header: "Context"                          # SKIP if --context resolved
+    - id: "debate-context"
+      header: "Context"                          # SKIP if --context resolved
       question: "Include codebase context for both tools?"
       multiSelect: false
       options:
@@ -136,7 +141,8 @@ If context resolved to "file":
   ```
   AskUserQuestion:
     questions:
-      - header: "File path"
+      - id: "debate-file-path"
+        header: "File path"
         question: "Which file should both tools see?"
         multiSelect: false
         options:

adapters/opencode/skills/agnix/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: agnix
 description: "Use when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'. Validates agent configuration files against 155 rules across 10+ AI tools."
-version: 5.0.3
+version: 5.1.0
 argument-hint: "[path] [--fix] [--strict] [--target=claude-code|cursor|codex]"
 ---
 

adapters/opencode/skills/consult/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: consult
 description: "Cross-tool AI consultation. Use when user asks to 'consult gemini', 'ask codex', 'get second opinion', 'cross-check with claude', 'consult another AI', 'ask opencode', 'copilot opinion', or wants a second opinion from a different AI tool."
-version: 5.0.3
+version: 5.1.0
 argument-hint: "[question] [--tool] [--effort] [--model] [--context] [--continue]"
 ---
 

adapters/opencode/skills/debate/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: debate
 description: "Structured AI debate templates and synthesis. Use when orchestrating multi-round debates between AI tools, 'debate topic', 'argue about', 'stress test idea', 'devil advocate'."
-version: 5.0.3
+version: 5.1.0
 argument-hint: "[topic] [--proposer=tool] [--challenger=tool] [--rounds=N] [--effort=level]"
 ---
 

adapters/opencode/skills/deslop/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: deslop
 description: "Use when user wants to clean AI slop from code. Use for cleanup, remove debug statements, find ghost code, repo hygiene."
-version: 5.0.3
+version: 5.1.0
 argument-hint: "[report|apply] [--scope=all|diff|path] [--thoroughness=quick|normal|deep]"
 ---
 

adapters/opencode/skills/discover-tasks/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: discover-tasks
 description: "Use when user asks to \"discover tasks\", \"find next task\", or \"prioritize issues\". Discovers and ranks tasks from GitHub, GitLab, local files, and custom sources."
-version: 5.0.3
+version: 5.1.0
 ---
 
 # discover-tasks