taskchef 5.5.1 → 5.5.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/.codex-plugin/plugin.json +1 -1
- package/README.md +22 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -95,7 +95,7 @@ TaskChef replies with a link to the new Codex task. Open it to follow progress
|
|
|
95
95
|
or give the executor more instructions. The dispatcher is ready for another
|
|
96
96
|
request immediately.
|
|
97
97
|
|
|
98
|
-
The plugin's focused
|
|
98
|
+
The plugin's focused MCP tools prepare and record delegations directly in the
|
|
99
99
|
canonical workspace. They preserve TaskChef's lock and atomic-write guarantees
|
|
100
100
|
without shell quoting, stdin handling, temporary record files, or a separate
|
|
101
101
|
command-sandbox permission round trip.
|
|
@@ -205,8 +205,11 @@ The plugin has three skills:
|
|
|
205
205
|
- `$taskchef-delegate` routes requests and creates executor tasks
|
|
206
206
|
- `$taskchef-report` reads the task history and reports live executor state once
|
|
207
207
|
|
|
208
|
-
|
|
209
|
-
|
|
208
|
+
Normal delegation uses the plugin's bundled MCP tools. The bootstrap and report
|
|
209
|
+
skills continue to call the CLI for deterministic workspace administration,
|
|
210
|
+
task-history reads, and later recovery. The same CLI is also available for
|
|
211
|
+
direct inspection, benchmarking, and manual operations over the shared
|
|
212
|
+
workspace logic. Run it once with `npx` if you do not want a global installation:
|
|
210
213
|
|
|
211
214
|
```sh
|
|
212
215
|
npx taskchef help
|
|
@@ -218,9 +221,9 @@ For the shorter command used below, install it globally:
|
|
|
218
221
|
npm install --global taskchef
|
|
219
222
|
```
|
|
220
223
|
|
|
221
|
-
The npm package provides the data CLI. The Codex plugin provides the skills
|
|
222
|
-
|
|
223
|
-
`node bin/taskchef.js`.
|
|
224
|
+
The npm package provides the data CLI. The Codex plugin provides the skills and
|
|
225
|
+
focused MCP tools used during delegation; native Codex tools still create and
|
|
226
|
+
inspect executor tasks. From a source checkout, use `node bin/taskchef.js`.
|
|
224
227
|
|
|
225
228
|
```text
|
|
226
229
|
taskchef help
|
|
@@ -244,11 +247,14 @@ Workspace resolution is deterministic: `--workspace <path>`, then the
|
|
|
244
247
|
current directory is never an implicit workspace. Data commands accept
|
|
245
248
|
`--json` for machine-readable output. Run `taskchef help` for every option.
|
|
246
249
|
|
|
247
|
-
`taskchef dispatch prepare --json`
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
250
|
+
`taskchef dispatch prepare --json` is the CLI equivalent of the MCP
|
|
251
|
+
`prepare_dispatch` operation: it resolves the canonical workspace, loads and
|
|
252
|
+
validates configured projects, and returns a generated task UUID, preparation
|
|
253
|
+
timestamp, and exact correlation marker. Normal delegation calls the MCP tool;
|
|
254
|
+
the CLI command remains useful for diagnostics and benchmarks. `task record`
|
|
255
|
+
accepts one JSON value only from closed, non-interactive standard input and is
|
|
256
|
+
intended for manual recovery or direct CLI use, not the skill's normal
|
|
257
|
+
recording path.
|
|
252
258
|
|
|
253
259
|
For repeatable live delegation measurements, run
|
|
254
260
|
`npm run benchmark:e2e -- write`. It reads one non-interactive JSON value,
|
|
@@ -349,8 +355,11 @@ printf '%s\n' '{"id":"c0f010ff-84f2-4838-a69d-0ff1f5d721d7","project":"/workspac
|
|
|
349
355
|
taskchef task record --json
|
|
350
356
|
```
|
|
351
357
|
|
|
352
|
-
If a task has `threadId: null`, Codex can
|
|
353
|
-
the verified durable ID
|
|
358
|
+
If a task has `threadId: null`, a later Codex workflow can find its exact
|
|
359
|
+
marker and pass the verified durable ID through its prescribed interface. The
|
|
360
|
+
delegate skill uses the MCP `resolve_task` tool during bounded post-creation
|
|
361
|
+
recovery; the report skill and direct manual recovery use the equivalent CLI
|
|
362
|
+
operation below. Both reach the same atomic logic, which permits only the
|
|
354
363
|
one-way transition from null to one unique thread ID:
|
|
355
364
|
|
|
356
365
|
```sh
|