@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
|
|
224
|
+
## Trellis 0.6 custom agents and skills
|
|
225
225
|
|
|
226
|
-
|
|
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
|
|
253
|
+
See the Trellis docs:
|
|
247
254
|
|
|
248
|
-
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|