@pruddiman/dispatch 1.4.3 → 1.5.0-beta.07e10a8-beta.07e10a8
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 +6 -16
- package/dist/cli.js +9326 -9555
- package/dist/cli.js.map +1 -1
- package/dist/mcp/dispatch-worker.js +7343 -0
- package/dist/mcp/dispatch-worker.js.map +1 -0
- package/package.json +21 -9
- package/skills/dispatch/SKILL.md +144 -0
- package/skills/dispatch/references/ordering-reference.md +215 -0
- package/skills/dispatch/references/troubleshooting.md +34 -0
- package/skills/dispatch/references/workflow-recipes.md +105 -0
package/README.md
CHANGED
|
@@ -130,8 +130,6 @@ dispatch --respec
|
|
|
130
130
|
# Group issues into a single feature branch and PR
|
|
131
131
|
dispatch --feature my-feature
|
|
132
132
|
|
|
133
|
-
# Run tests and fix failures via AI
|
|
134
|
-
dispatch --fix-tests
|
|
135
133
|
```
|
|
136
134
|
|
|
137
135
|
## Authentication
|
|
@@ -144,7 +142,7 @@ On first use (or when a cached token is missing/expired), Dispatch will:
|
|
|
144
142
|
2. You sign in and authorize Dispatch in the browser.
|
|
145
143
|
3. The token is cached locally at **`~/.dispatch/auth.json`** for future runs.
|
|
146
144
|
|
|
147
|
-
Authentication
|
|
145
|
+
Authentication happens **early in the CLI lifecycle** — during `dispatch config` (right after datasource selection) or at startup for `dispatch` and `dispatch --spec` runs — before any pipeline work begins. If tokens are already cached the check is instant; otherwise the device-code prompt appears while the terminal is still free, so it is never buried under pipeline output. No separate login step is needed.
|
|
148
146
|
|
|
149
147
|
**Re-authenticating:** Delete `~/.dispatch/auth.json` (or just the relevant platform key inside it) and run `dispatch` again to re-trigger the device flow.
|
|
150
148
|
|
|
@@ -155,7 +153,6 @@ Authentication is triggered automatically when you run `dispatch` with `--source
|
|
|
155
153
|
| **Dispatch** | *(default)* | Plan and execute tasks; manage full git lifecycle |
|
|
156
154
|
| **Spec generation** | `--spec` | Convert issues into structured markdown spec files |
|
|
157
155
|
| **Respec** | `--respec` | Regenerate existing specs (all, by ID, or by glob) |
|
|
158
|
-
| **Fix tests** | `--fix-tests` | Detect and auto-fix failing tests via AI |
|
|
159
156
|
| **Feature** | `--feature [name]` | Group issues into a single feature branch and PR |
|
|
160
157
|
|
|
161
158
|
## Task files
|
|
@@ -196,7 +193,6 @@ Config is stored at `.dispatch/config.json` (relative to the working directory w
|
|
|
196
193
|
"provider": "copilot",
|
|
197
194
|
"model": "claude-sonnet-4-5",
|
|
198
195
|
"source": "github",
|
|
199
|
-
"testTimeout": 60
|
|
200
196
|
}
|
|
201
197
|
```
|
|
202
198
|
|
|
@@ -205,8 +201,7 @@ Config is stored at `.dispatch/config.json` (relative to the working directory w
|
|
|
205
201
|
| `provider` | AI backend: `opencode` (default), `copilot`, `claude`, or `codex` |
|
|
206
202
|
| `model` | Model to use when spawning agents (provider-specific format) |
|
|
207
203
|
| `source` | Issue tracker: `github`, `azdevops`, or `md` |
|
|
208
|
-
| `
|
|
209
|
-
| `planTimeout` | Planning timeout in minutes (default: 10, range: 1–120) |
|
|
204
|
+
| `planTimeout` | Planning timeout in minutes (default: 30, range: 1–120) |
|
|
210
205
|
| `concurrency` | Max parallel dispatches (range: 1–64) |
|
|
211
206
|
| `org` | Azure DevOps organization URL |
|
|
212
207
|
| `project` | Azure DevOps project name |
|
|
@@ -230,14 +225,15 @@ Config is stored at `.dispatch/config.json` (relative to the working directory w
|
|
|
230
225
|
| `--feature [name]` | *(off)* | Group issues into a single feature branch and PR |
|
|
231
226
|
| `--force` | `false` | Ignore prior run state and re-run all tasks |
|
|
232
227
|
| `--concurrency <n>` | *(cpu/memory)* | Max parallel dispatches (max: 64) |
|
|
233
|
-
| `--plan-timeout <min>` | `
|
|
234
|
-
| `--retries <n>` | `
|
|
228
|
+
| `--plan-timeout <min>` | `30` | Planning timeout in minutes |
|
|
229
|
+
| `--retries <n>` | `3` | Retry attempts for all agents |
|
|
235
230
|
| `--plan-retries <n>` | *(from --retries)* | Retry attempts for the planner agent (overrides `--retries`) |
|
|
236
|
-
| `--test-timeout <min>` | `5` | Test timeout in minutes |
|
|
237
231
|
| `--server-url <url>` | *(none)* | Connect to a running provider server |
|
|
238
232
|
| `--cwd <dir>` | `process.cwd()` | Working directory |
|
|
239
233
|
| `--verbose` | `false` | Show detailed debug output |
|
|
240
234
|
|
|
235
|
+
In interactive dispatch runs, exhausted automatic retries pause the failed task in the dispatch UI so you can manually rerun it in place. A rerun re-enters the normal task lifecycle, including planning unless `--no-plan` is set; verbose or non-interactive runs will not wait for input and instead stop predictably with the task left failed.
|
|
236
|
+
|
|
241
237
|
### Spec mode
|
|
242
238
|
|
|
243
239
|
| Option | Description |
|
|
@@ -249,12 +245,6 @@ Config is stored at `.dispatch/config.json` (relative to the working directory w
|
|
|
249
245
|
| `--org <url>` | Azure DevOps organization URL |
|
|
250
246
|
| `--project <name>` | Azure DevOps project name |
|
|
251
247
|
|
|
252
|
-
### Fix tests mode
|
|
253
|
-
|
|
254
|
-
| Option | Description |
|
|
255
|
-
|--------|-------------|
|
|
256
|
-
| `--fix-tests [issue-ids...]` | Run tests and fix failures via AI. Optionally pass issue IDs to target specific branches in worktrees. |
|
|
257
|
-
|
|
258
248
|
## Datasource auto-detection
|
|
259
249
|
|
|
260
250
|
When `--source` is not provided, Dispatch inspects the git `origin` remote URL:
|