@fro.bot/systematic 2.31.0 → 2.31.1

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.
Files changed (2) hide show
  1. package/package.json +5 -5
  2. package/skills/orchestrating-subagents/SKILL.md +7 -7
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fro.bot/systematic",
3
- "version": "2.31.0",
3
+ "version": "2.31.1",
4
4
  "description": "Structured engineering workflows for OpenCode",
5
5
  "type": "module",
6
6
  "homepage": "https://fro.bot/systematic",
@@ -66,18 +66,18 @@
66
66
  },
67
67
  "devDependencies": {
68
68
  "@biomejs/biome": "2.4.16",
69
- "@opencode-ai/plugin": "1.15.13",
70
- "@opencode-ai/sdk": "1.15.13",
69
+ "@opencode-ai/plugin": "1.17.3",
70
+ "@opencode-ai/sdk": "1.17.3",
71
71
  "@semantic-release/exec": "7.1.0",
72
72
  "@types/bun": "latest",
73
73
  "@types/js-yaml": "4.0.9",
74
- "@types/node": "24.13.0",
74
+ "@types/node": "24.13.2",
75
75
  "ajv": "8.20.0",
76
76
  "ajv-formats": "3.0.1",
77
77
  "conventional-changelog-conventionalcommits": "9.3.1",
78
78
  "markdownlint-cli": "0.48.0",
79
79
  "rimraf": "6.1.3",
80
- "semantic-release": "25.0.3",
80
+ "semantic-release": "25.0.5",
81
81
  "semantic-release-export-data": "1.2.0",
82
82
  "typescript": "6.0.3"
83
83
  },
package/skills/orchestrating-subagents/SKILL.md CHANGED
@@ -44,11 +44,11 @@ task({
44
44
  })
45
45
  ```
46
46
 
47
- **When background is available:** OpenCode exposes `task_status` in the tool list and the `task()` tool description includes background mode instructions. This requires `OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true` or the umbrella `OPENCODE_EXPERIMENTAL=true` flag.
47
+ **When background is available:** `OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true` (or the umbrella `OPENCODE_EXPERIMENTAL=true`) must be set. When enabled, `background: true` runs the subagent asynchronously. OpenCode automatically injects the result into the parent session as a synthetic message when the subagent completes. You are notified; you do not poll.
48
48
 
49
- **When background is unavailable:** `task_status` is not registered. Passing `background: true` returns an error. Fall back to foreground dispatch — dispatch subagents serially or in small foreground batches instead.
49
+ **When background is unavailable:** Passing `background: true` returns an error. Fall back to foreground dispatch — dispatch subagents serially or in small foreground batches instead.
50
50
 
51
- **Check before assuming:** If you see `task_status` in your available tools, background dispatch is enabled. If you do not see it, use foreground dispatch only.
51
+ **Check before assuming:** Rely on whether `background: true` is accepted (i.e., the env flag is set). If it returns an error, use foreground dispatch only.
52
52
 
53
53
  ## Serial vs Parallel Dispatch
54
54
 
@@ -119,7 +119,7 @@ After subagents complete, the orchestrator synthesizes results:
119
119
  - If a subagent returns an error or its output is incomplete, diagnose before dispatching dependent units.
120
120
  - Do not dispatch dependent units on a broken tree.
121
121
  - Retry a failed unit by dispatching a new `task()` call with a corrected prompt, or resume the prior session with `task_id`.
122
- - For background tasks (when available): use `task_status` to poll or wait for terminal state before retrying.
122
+ - For background tasks (when available): wait for the automatic completion notification (the result is injected into the parent session). Do not poll or sleep. Retry by dispatching a new `task()` with a corrected prompt, or resume with `task_id`.
123
123
 
124
124
  ## Quick Reference
125
125
 
@@ -128,7 +128,7 @@ After subagents complete, the orchestrator synthesizes results:
128
128
  | Units have dependencies | Serial foreground dispatch |
129
129
  | Units share files | Serial foreground dispatch |
130
130
  | Units are independent, no file overlap | Parallel foreground dispatch |
131
- | Background available + long-running work | Parallel background dispatch with `task_status` |
131
+ | Background available + long-running work | Parallel background dispatch; results are pushed back to the parent on completion (no polling) |
132
132
  | Background unavailable | Foreground only — serial or batched |
133
133
  | Subagent fails | Diagnose, fix prompt, retry with new `task()` or resume with `task_id` |
134
134
  | File collision detected post-parallel | Stage non-colliding files (if workflow owns git ops), re-run colliding units serially |
@@ -137,8 +137,8 @@ After subagents complete, the orchestrator synthesizes results:
137
137
 
138
138
  | Mistake | Fix |
139
139
  |---|---|
140
- | Assuming `task_status` is always available | Check tool list first; fall back to foreground if absent |
140
+ | Polling or sleeping to wait for a background subagent | Background results are pushed into the parent session automatically; never poll or sleep |
141
141
  | Parallel subagents staging or committing | Instruct subagents not to stage/commit; the current workflow owner handles git ops when applicable, otherwise synthesize file inventory and results for the caller or user |
142
142
  | Dispatching dependent units without waiting | Always wait for prerequisites to complete and verify their output |
143
143
  | Ignoring file overlap in parallel batches | Run the Parallel Safety Check before every parallel dispatch |
144
- | Using `background: true` without checking the flag | Only use when `task_status` appears in available tools |
144
+ | Using `background: true` without the experimental flag enabled | Only use background when `OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true`; otherwise dispatch foreground |