agentsys 5.0.2 → 5.1.0

package/adapters/opencode/skills/validate-delivery/SKILL.md

@@ -1,8 +1,7 @@
-<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
 ---
 name: validate-delivery
 description: "Use when user asks to \"validate delivery\", \"check readiness\", or \"verify completion\". Runs tests, build, and requirement checks with pass/fail instructions."
-version: 5.0.2
+version: 5.1.0
 ---
 
 # validate-delivery

package/lib/adapter-transforms.js

@@ -18,10 +18,30 @@ function transformBodyForOpenCode(content, repoRoot) {
   content = content.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, '${PLUGIN_ROOT}');
   content = content.replace(/\$CLAUDE_PLUGIN_ROOT/g, '$PLUGIN_ROOT');
 
-  content = content.replace(/\.claude\//g, '.opencode/');
-  content = content.replace(/\.claude'/g, ".opencode'");
-  content = content.replace(/\.claude"/g, '.opencode"');
-  content = content.replace(/\.claude`/g, '.opencode`');
+  // Replace .claude/ paths with .opencode/ but preserve platform documentation lists
+  // that enumerate all three platforms (Claude Code: .claude/, OpenCode: .opencode/, Codex: .codex/)
+  // Also preserve {AI_STATE_DIR} references which are platform-agnostic
+  content = content.replace(/\.claude\//g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    // Skip if inside a platform enumeration (e.g., "Claude Code: `.claude/`")
+    if (/Claude Code:/.test(context)) return match;
+    return '.opencode/';
+  });
+  content = content.replace(/\.claude'/g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    if (/Claude Code:/.test(context)) return match;
+    return ".opencode'";
+  });
+  content = content.replace(/\.claude"/g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    if (/Claude Code:/.test(context)) return match;
+    return '.opencode"';
+  });
+  content = content.replace(/\.claude`/g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    if (/Claude Code:/.test(context)) return match;
+    return '.opencode`';
+  });
 
   const plugins = discovery.discoverPlugins(repoRoot);
   if (plugins.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "A modular runtime and orchestration system for AI agents - works with Claude Code, OpenCode, and Codex CLI",
   "main": "lib/platform/detect-platform.js",
   "type": "commonjs",

package/plugins/agnix/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agnix",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "Lint agent configurations before they break your workflow. Validates Skills, Hooks, MCP, Memory, Plugins.",
   "author": {
     "name": "Avi Fenesh",

package/plugins/agnix/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.2
+version: 5.1.0
 argument-hint: "[path] [--fix] [--strict] [--target=claude-code|cursor|codex]"
 ---
 

package/plugins/audit-project/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "audit-project",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "Multi-agent iterative code review until zero issues remain",
   "author": {
     "name": "Avi Fenesh",

package/plugins/audit-project/lib/adapter-transforms.js

@@ -18,10 +18,30 @@ function transformBodyForOpenCode(content, repoRoot) {
   content = content.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, '${PLUGIN_ROOT}');
   content = content.replace(/\$CLAUDE_PLUGIN_ROOT/g, '$PLUGIN_ROOT');
 
-  content = content.replace(/\.claude\//g, '.opencode/');
-  content = content.replace(/\.claude'/g, ".opencode'");
-  content = content.replace(/\.claude"/g, '.opencode"');
-  content = content.replace(/\.claude`/g, '.opencode`');
+  // Replace .claude/ paths with .opencode/ but preserve platform documentation lists
+  // that enumerate all three platforms (Claude Code: .claude/, OpenCode: .opencode/, Codex: .codex/)
+  // Also preserve {AI_STATE_DIR} references which are platform-agnostic
+  content = content.replace(/\.claude\//g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    // Skip if inside a platform enumeration (e.g., "Claude Code: `.claude/`")
+    if (/Claude Code:/.test(context)) return match;
+    return '.opencode/';
+  });
+  content = content.replace(/\.claude'/g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    if (/Claude Code:/.test(context)) return match;
+    return ".opencode'";
+  });
+  content = content.replace(/\.claude"/g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    if (/Claude Code:/.test(context)) return match;
+    return '.opencode"';
+  });
+  content = content.replace(/\.claude`/g, (match, offset) => {
+    const context = content.substring(Math.max(0, offset - 60), offset + match.length + 10);
+    if (/Claude Code:/.test(context)) return match;
+    return '.opencode`';
+  });
 
   const plugins = discovery.discoverPlugins(repoRoot);
   if (plugins.length > 0) {

package/plugins/consult/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "consult",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "Cross-tool AI consultation: get second opinions from Gemini, Codex, Claude, OpenCode, or Copilot CLI",
   "author": {
     "name": "Avi Fenesh",

package/plugins/consult/agents/consult-agent.md

@@ -1,6 +1,6 @@
 ---
 name: consult-agent
-description: "Execute cross-tool AI consultations via Task spawning. Use when agents or workflows need a second opinion from Gemini, Codex, Claude, OpenCode, or Copilot."
+description: "Execute cross-tool AI consultations via Task spawning. Use when agents or workflows need a second opinion from Gemini, Codex, Claude, OpenCode, or Copilot. Supports multi-instance parallel consultations (count > 1)."
 tools:
   - Skill
   - Bash(claude:*)
@@ -22,11 +22,13 @@ model: sonnet
 
 You are the programmatic interface for cross-tool AI consultations. The consult plugin follows the standard Command -> Agent -> Skill pattern:
 
-- **Command** (`/consult`): User-facing entry point. Handles interactive parameter selection (tool picker, effort picker, model picker via AskUserQuestion). Invokes the consult skill directly. Does NOT spawn this agent.
-- **Agent** (this file): Programmatic entry point for other agents and workflows via Task(). Requires all parameters pre-resolved by the caller. Invokes the consult skill, then executes the CLI command it returns via Bash.
-- **Skill** (`consult`): Implementation source of truth. Provides provider configurations, model mappings, command templates, context packaging, and output parsing logic. Both the command and this agent invoke the skill before executing anything.
+- **Command** (`/consult`): User-facing entry point. Handles natural language parsing and interactive parameter selection. For single instance (count=1), invokes the consult skill directly. For multi-instance (count>1), spawns this agent.
+- **Agent** (this file): Programmatic entry point. Requires all parameters pre-resolved by the caller. Handles both single-instance (invoke skill) and multi-instance (parallel execution). Used by the command for multi-instance and by other agents/workflows via Task().
+- **Skill** (`consult`): Implementation source of truth. Provides provider configurations, model mappings, command templates, context packaging, and output parsing logic.
 
-Use this agent when the /consult command is not available (e.g., from other agents or automated workflows that need a second opinion).
+Use this agent for:
+1. Multi-instance consultations (count > 1) dispatched by the /consult command
+2. Programmatic consultations from other agents or automated workflows
 
 ## Why Sonnet Model
 
@@ -48,13 +50,28 @@ Extract from prompt. ALL parameters MUST be pre-resolved by the caller (the /con
 - **context**: Context mode (diff, file, none) - default: none
 - **continueSession**: Session ID or true/false
 - **sessionFile**: Path to session state file
+- **count**: Number of parallel instances (1-5, default: 1)
 
 If any required parameter is missing, return an error as plain JSON:
 ```json
 {"error": "Missing required parameter: [param]. The caller must resolve all parameters before spawning this agent."}
 ```
 
-### 2. Invoke Consult Skill (MUST)
+### 2. Route: Single vs Multi-Instance
+
+If both `continueSession` is set and `count > 1`, return:
+```json
+{"error": "Cannot use --continue with count > 1. Session resume applies to a single tool session."}
+```
+
+Validate count: if provided, must be 1-5. If out of range, return `{"error": "Instance count must be 1-5. Got: [count]"}`.
+
+If `count` is 1 (or not provided), follow the **Single Instance** path (Step 3).
+If `count` is 2-5, follow the **Multi-Instance** path (Step 4).
+
+### 3. Single Instance (count=1)
+
+#### 3a. Invoke Consult Skill (MUST)
 
 You MUST invoke the `consult` skill using the Skill tool. Pass all parsed arguments. The skill is the authoritative source for provider configurations, model mappings, command building, context packaging, session loading, and output parsing. Do not bypass the skill.
 
@@ -65,11 +82,11 @@ Args: [question] --tool=[tool] --effort=[effort] [--model=[model]] [--context=[c
 Example: "Review this function" --tool=claude --effort=high --model=opus
 ```
 
-### 3. Execute Command
+#### 3b. Execute Command
 
 Run the CLI command returned by the skill via Bash with a 120-second timeout.
 
-### 4. Parse and Return Result
+#### 3c. Parse and Return Result
 
 Parse the response using the method specified by the skill for the target tool, then format and display the result as human-friendly text:
 
@@ -80,12 +97,107 @@ The results of the consultation are:
 {response}
 ```
 
-Set `continuable: true` for Claude, Gemini, Codex, and OpenCode (tools with continuation support). Codex continuation is context-based (prior Q&A prepended to prompt) since `codex resume` is TUI-only. Claude, Gemini, and OpenCode support native session resume flags. Only Copilot is non-continuable.
+Set `continuable: true` for Claude, Gemini, Codex, and OpenCode (tools with session resume support). Only Copilot is non-continuable. Each tool uses a different resume mechanism: Claude/Gemini use `--resume`, Codex uses `codex exec resume`, OpenCode uses `--session`/`--continue`.
 
-### 5. Save Session State
+#### 3d. Save Session State
 
 Write session state to the sessionFile path provided by the command for continuity.
 
+### 4. Multi-Instance (count > 1)
+
+When count > 1, execute N parallel consultations with the same tool and parameters.
+
+#### 4a. Invoke Consult Skill Once
+
+Invoke the `consult` skill once to get the resolved command template and provider configuration. This gives you the exact CLI command to run for this tool/model/effort combination. Do NOT execute the command from the skill response yet.
+
+#### 4b. Write Indexed Temp Files
+
+Write the question to N indexed temp files using the Write tool:
+- `{AI_STATE_DIR}/consult/question-1.tmp`
+- `{AI_STATE_DIR}/consult/question-2.tmp`
+- ... through `question-{count}.tmp`
+
+Platform state directory:
+- Claude Code: `.claude/`
+- OpenCode: `.opencode/`
+- Codex CLI: `.codex/`
+
+All temp files contain the same question text (with context prepended if applicable).
+
+#### 4c. Execute N Commands in Parallel
+
+Run N Bash commands **in parallel** (multiple Bash tool calls in a single message). Each command uses the template from Step 4a but points to its own indexed temp file. Set 120-second timeout on each.
+
+Example for 3 parallel Codex calls:
+```
+Bash: codex exec "$(cat "{AI_STATE_DIR}/consult/question-1.tmp")" --json -m "gpt-5.3-codex" -c model_reasoning_effort="high"
+Bash: codex exec "$(cat "{AI_STATE_DIR}/consult/question-2.tmp")" --json -m "gpt-5.3-codex" -c model_reasoning_effort="high"
+Bash: codex exec "$(cat "{AI_STATE_DIR}/consult/question-3.tmp")" --json -m "gpt-5.3-codex" -c model_reasoning_effort="high"
+```
+
+#### 4d. Parse and Format Results
+
+Parse each response using the skill's output parsing rules for the target tool. Format as numbered responses:
+
+```
+# Multi-Consultation Results
+
+Tool: {tool}, Model: {model}, Effort: {effort}, Instances: {count}
+
+---
+
+## Response 1 (Duration: {duration_ms}ms)
+
+{response_1}
+
+---
+
+## Response 2 (Duration: {duration_ms}ms)
+
+{response_2}
+
+---
+
+[... for each instance ...]
+
+---
+
+## Synthesis
+
+Key agreement points:
+- [Common themes across responses]
+
+Key differences:
+- [Where responses diverge]
+```
+
+If some instances failed but others succeeded, show the successful responses and note failures:
+`[WARN] Instance {N} failed: {error}. Showing {M} of {count} responses.`
+
+#### 4e. Clean Up and Save State
+
+1. Delete all indexed temp files (`question-1.tmp` through `question-{count}.tmp`)
+2. Save multi-session state to `{AI_STATE_DIR}/consult/last-multi-session.json`:
+
+```json
+{
+  "tool": "codex",
+  "model": "gpt-5.3-codex",
+  "effort": "high",
+  "count": 3,
+  "timestamp": "{ISO 8601 timestamp of execution}",
+  "question": "original question text",
+  "sessions": [
+    {"session_id": "abc-123", "continuable": true},
+    {"session_id": "def-456", "continuable": true},
+    {"session_id": "ghi-789", "continuable": true}
+  ]
+}
+```
+
+3. Also save the first session to `{AI_STATE_DIR}/consult/last-session.json` (standard format) so `--continue` works.
+
 ## Error Handling
 
 | Error | Action |
@@ -98,26 +210,7 @@ Write session state to the sessionFile path provided by the command for continui
 
 ## Output Sanitization
 
-Before including any consulted tool's response in the output, scan the response text and redact matches for these patterns:
-
-| Pattern | Description | Replacement |
-|---------|-------------|-------------|
-| `sk-[a-zA-Z0-9_-]{20,}` | Anthropic API keys | `[REDACTED_API_KEY]` |
-| `sk-proj-[a-zA-Z0-9_-]{20,}` | OpenAI project keys | `[REDACTED_API_KEY]` |
-| `sk-ant-[a-zA-Z0-9_-]{20,}` | Anthropic API keys (ant prefix) | `[REDACTED_API_KEY]` |
-| `AIza[a-zA-Z0-9_-]{30,}` | Google API keys | `[REDACTED_API_KEY]` |
-| `ghp_[a-zA-Z0-9]{36,}` | GitHub personal access tokens | `[REDACTED_TOKEN]` |
-| `gho_[a-zA-Z0-9]{36,}` | GitHub OAuth tokens | `[REDACTED_TOKEN]` |
-| `github_pat_[a-zA-Z0-9_]{20,}` | GitHub fine-grained PATs | `[REDACTED_TOKEN]` |
-| `ANTHROPIC_API_KEY=[^\s]+` | Key assignment in env output | `ANTHROPIC_API_KEY=[REDACTED]` |
-| `OPENAI_API_KEY=[^\s]+` | Key assignment in env output | `OPENAI_API_KEY=[REDACTED]` |
-| `GOOGLE_API_KEY=[^\s]+` | Key assignment in env output | `GOOGLE_API_KEY=[REDACTED]` |
-| `GEMINI_API_KEY=[^\s]+` | Key assignment in env output | `GEMINI_API_KEY=[REDACTED]` |
-| `AKIA[A-Z0-9]{16}` | AWS access keys | `[REDACTED_AWS_KEY]` |
-| `ASIA[A-Z0-9]{16}` | AWS session tokens | `[REDACTED_AWS_KEY]` |
-| `Bearer [a-zA-Z0-9_-]{20,}` | Authorization headers | `Bearer [REDACTED]` |
-
-Apply redaction to the full response text before inserting into the result JSON. If any redaction occurs, append a note: `[WARN] Sensitive tokens were redacted from the response.`
+Apply the redaction patterns from the consult skill (`plugins/consult/skills/consult/SKILL.md`, Output Sanitization section). The skill is the canonical source for all redaction patterns.
 
 ## Critical Constraints