@galaxy9day/executor-adapter 0.10.0 → 0.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -221,9 +221,16 @@ When `.trellis/` isn't present, the main orchestrator agent (Claude Code / Codex
221
221
  - Runtime files go to `/tmp/executor-adapter/pi-workers/<worker-id>/` instead of `.trellis/.runtime/pi-workers/<worker-id>/`
222
222
  - A fingerprint lock keyed on `(scope, extra_instructions)` prevents accidental concurrent identical dispatches
223
223
 
224
- ## Trellis sub-agent templates
224
+ ## Trellis 0.6 custom agents and skills
225
225
 
226
- This package ships ready-to-copy Claude Code / Trellis custom agent templates in `templates/claude/agents/`:
226
+ Trellis 0.6.x has two extension points that matter here:
227
+
228
+ - **Custom sub-agents** (`.trellis/agents/*.md` for channel runtime, or platform-specific agent files such as `.claude/agents/*.md`) isolate a role/prompt and can be spawned by the orchestrator.
229
+ - **Custom skills** (`*/skills/<name>/SKILL.md`) are auto-triggered workflow modules. They are the right place for usage policy, but not a replacement for the MCP server itself.
230
+
231
+ `executor-adapter` remains an MCP server. It is not a native Trellis channel provider, and it does not install or mutate `.trellis/agents` files. Trellis native channel workers should continue to use `.trellis/agents/implement.md` / `check.md` or your own channel agents. Use the templates below when you want a Claude Code sub-agent to call the MCP and summarize the executor result, keeping long dispatch output out of the main context.
232
+
233
+ This package ships ready-to-copy Claude Code custom agent templates in `templates/claude/agents/`:
227
234
 
228
235
  ```bash
229
236
  cp templates/claude/agents/*.md <your-project>/.claude/agents/
@@ -239,13 +246,14 @@ Task(subagent_type="trellis-pi-check")
239
246
 
240
247
  This keeps long dispatch output out of the main context. The sub-agent receives the MCP result, reads reports only when needed, and returns a short summary to the orchestrator.
241
248
 
242
- Use `trellis-codex-implement` for the normal GPT implementation path. Use `trellis-pi-implement` only when you explicitly want Pi provider routing for implementation, and `trellis-pi-check` for read-only cross-model review. The Codex template omits `model` so `codex exec` uses this machine's Codex default from `$CODEX_HOME/config.toml`; the Pi templates resolve logical routes from `~/.pi/config.toml`.
249
+ Use `trellis-codex-implement` for the normal GPT implementation path. Use `trellis-pi-implement` only when you explicitly want Pi provider routing for implementation, and `trellis-pi-check` for read-only cross-model review. The templates set `effort: xhigh` for the Claude Code sub-agent itself; the MCP `thinking` parameter separately defaults to `xhigh` for the Codex/Pi executor it launches. The Codex template omits `model` so `codex exec` uses this machine's Codex default from `$CODEX_HOME/config.toml`; the Pi templates resolve logical routes from `~/.pi/config.toml`.
243
250
 
244
- No Trellis `inject-subagent-context` hook edit is required. `dispatch` assembles Trellis task context itself from the task artifacts (`prd.md`, `design.md`, `implement.md`, `implement.jsonl`, and `check.jsonl` where applicable).
251
+ No Trellis `inject-subagent-context` hook edit is required. `dispatch` assembles Trellis task context itself from the task artifacts (`prd.md`, `design.md`, `implement.md`, `implement.jsonl`, and `check.jsonl` where applicable). For Codex/Pi/other platforms, translate these templates to the platform's native custom-agent syntax; do not put MCP tool names in `.trellis/agents/*.md`, because those files are provider-level channel runtime prompts, not MCP-capability declarations.
245
252
 
246
- See the Trellis custom agents docs: https://docs.trytrellis.app/advanced/custom-agents
253
+ See the Trellis docs:
247
254
 
248
- These files follow the Claude Code agent format. Users on other platforms (Cursor, OpenCode, Codex, or similar) should translate the frontmatter and tool declarations to their platform's native agent syntax.
255
+ - Custom agents: https://docs.trytrellis.app/advanced/custom-agents
256
+ - Custom skills: https://docs.trytrellis.app/advanced/custom-skills
249
257
 
250
258
  ## Forward compatibility
251
259
 
@@ -298,7 +306,7 @@ The full dispatch/verification protocol is documented in the executor-adapter sk
298
306
  | Node | 20 |
299
307
  | `pi` CLI (pi executor) | any recent version, on PATH |
300
308
  | `codex` CLI (codex executor) | any version with `codex exec --json` (2025+), on PATH, logged in via `codex login` |
301
- | Trellis (for channel mode) | `0.6.0-beta.10+` |
309
+ | Trellis (for channel mode) | `0.6.0+` (`0.6.2` tested) |
302
310
  | Trellis (for spec assembly) | any 0.5+ |
303
311
 
304
312
  ## License
package/index.js CHANGED
@@ -45,7 +45,7 @@ import { EXECUTORS, resolveExecutor } from './executors.js';
45
45
 
46
46
  const SERVER_NAME = 'executor-adapter';
47
47
  const LEGACY_SERVER_NAMES = ['pi-adapter'];
48
- const SERVER_VERSION = '0.10.0'; // keep in sync with package.json
48
+ const SERVER_VERSION = '0.10.2'; // keep in sync with package.json
49
49
  const TMP_RUNTIME_DIR = path.join(os.tmpdir(), SERVER_NAME);
50
50
  const CHANNEL_ENV_ALIASES = ['TRELLIS_CHANNEL', 'TRELLIS_CHANNEL_NAME'];
51
51
  const TRELLIS_BIN_ENV = 'TRELLIS_BINARY';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@galaxy9day/executor-adapter",
3
- "version": "0.10.0",
3
+ "version": "0.10.2",
4
4
  "description": "Multi-executor MCP (Codex CLI for GPT implementation, Pi CLI for cross-model review) for Trellis-aware and standalone use. Reads Trellis task artifacts, runs the executor in an isolated subprocess/worktree, and can optionally emit non-invasive Trellis channel audit messages.",
5
5
  "type": "module",
6
6
  "main": "index.js",
@@ -15,7 +15,7 @@
15
15
  "dependencies": {
16
16
  "@modelcontextprotocol/sdk": "^1.29.0",
17
17
  "@iarna/toml": "^2.2.5",
18
- "@mindfoldhq/trellis-core": "^0.6.0-beta.13"
18
+ "@mindfoldhq/trellis-core": "^0.6.2"
19
19
  },
20
20
  "engines": {
21
21
  "node": ">=20"
@@ -5,6 +5,7 @@ description: >-
5
5
  executor via executor-adapter in an isolated worktree, returning only a short
6
6
  summary with result_class, changed files, and apply command. Use this as the
7
7
  normal GPT implementation path for Trellis tasks.
8
+ effort: xhigh
8
9
  tools: mcp__executor-adapter__dispatch, mcp__executor-adapter__preview_prompt, mcp__executor-adapter__read_report, mcp__executor-adapter__smoke, Read, Grep, Glob, Bash
9
10
  ---
10
11
 
@@ -73,4 +74,3 @@ main orchestrator context. Dispatch only when the task is ready and bounded.
73
74
  - Do not trust executor exit code 0 without checking the auto-validation
74
75
  result.
75
76
  - If auto-validation fails, report the failure as a blocker or follow-up need.
76
- *** End Patch
@@ -4,6 +4,7 @@ description: >-
4
4
  Cross-model code review via the Pi reviewer model through executor-adapter; read-only;
5
5
  supplements, but does not replace, the orchestrator's own verification and
6
6
  native trellis-check. Returns severity-graded findings only.
7
+ effort: xhigh
7
8
  tools: mcp__executor-adapter__dispatch, mcp__executor-adapter__read_report, Read, Grep, Glob, Bash
8
9
  ---
9
10
 
@@ -4,6 +4,7 @@ description: >-
4
4
  Dispatch mechanical, well-specified implementation tasks to the Pi executor via
5
5
  the executor-adapter MCP only when provider routing outside Codex is explicitly
6
6
  needed. For normal GPT implementation, use trellis-codex-implement instead.
7
+ effort: xhigh
7
8
  tools: mcp__executor-adapter__dispatch, mcp__executor-adapter__preview_prompt, mcp__executor-adapter__read_report, mcp__executor-adapter__smoke, Read, Grep, Glob, Bash
8
9
  ---
9
10