@swarmcraftai/cli 0.7.2 → 0.8.0

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/CHANGELOG.md CHANGED
@@ -2,6 +2,13 @@
2
2
 
3
3
  All notable changes to the SwarmCraft CLI are documented in this file.
4
4
 
5
+ ## 0.8.0
6
+
7
+ - Adds account-independent one-shot execution for selected local plans, phases, and task packets, with a preview before execution.
8
+ - Executes ordered packets with explicit prerequisites, request limits, recoverable checkpoints, and resume support.
9
+ - Records required or explicitly skipped checking and review stages, and pauses when human review is required.
10
+ - Adds scoped upgrades for existing packets and refreshes planning guidance to hand approved work to local execution while preserving unrelated files.
11
+
5
12
  ## 0.7.2
6
13
 
7
14
  - Simplifies the npm README and consolidates detailed workflow and provider guidance into their owning references.
package/README.md CHANGED
@@ -168,3 +168,38 @@ Run `swarmcraft auth login` again if your session has expired. For Discovery dia
168
168
  Support bundles redact credentials; Discovery bundles exclude source and package content. Review any diagnostic files before sharing them.
169
169
 
170
170
  See the [one-shot walkthrough](https://swarmcraft.ai/docs/build-and-ship/deliver-with-the-one-shot-cli), [troubleshooting guide](https://swarmcraft.ai/docs/help-and-reference/troubleshoot-swarmcraft), or [contact support](https://swarmcraft.ai/login?next=%2Fapp%2Fsupport).
171
+
172
+ ## Execute a local plan
173
+
174
+ Local one-shot needs no SwarmCraft account or hosted project. Use V4 packets with
175
+ `recommendedOrder` and explicit UUID `dependsOn` arrays (`[]` for no prerequisites).
176
+ The plan must link packets beneath `Packet links:` under stable phase anchors.
177
+ Preview the selected work before execution:
178
+
179
+ ```bash
180
+ swarmcraft one-shot --workspace . --plan docs/plans/migration-plan.md --agent-provider claude --preview
181
+ swarmcraft one-shot --workspace . --plan docs/plans/migration-plan.md --agent-provider claude --checking off --reviewing off --commit-policy done
182
+ ```
183
+
184
+ Use repeatable `--phase <anchor>` to narrow the plan, or repeatable `--packet <path>`
185
+ for direct work. Local selectors cannot combine with hosted project/task selectors,
186
+ delegation or Managed AI. Local defaults keep checking and reviewing on. Explicit
187
+ `off` records skipped-stage policy without ticking unchecked items or claiming
188
+ human approval; implementation validation still applies. Commit or stash existing
189
+ changes first; local execution does not accept dirty-worktree overrides.
190
+
191
+ The run freezes scope, prerequisites and policy. `resume --workspace . --run <id>`
192
+ continues checkpoints without rereading the plan into a new task list. After
193
+ inspecting intentional packet edits (including human review), use
194
+ `--accept-packet-changes`; interrupted agent stages additionally require
195
+ `--retry-interrupted`. Identity, order and prerequisites cannot change on resume.
196
+ Start a new reviewed run when plan scope changes. Local exit codes are 0 for
197
+ complete scope, 2 for a workflow/budget stop or pending review, and 1 for errors.
198
+ Optional board connection can happen later through the extension.
199
+
200
+ To prepare selected legacy packets, preview
201
+ `swarmcraft upgrade --workspace . --ordered-packets --packet <path> --check`,
202
+ then repeat without `--check` to apply. Repeat `--packet` for the selected scope.
203
+ Numeric filename prefixes supply missing order; unresolved order blocks migration.
204
+ Declare reviewed `dependsOn` UUIDs explicitly afterward. The migration does not
205
+ assume legacy tasks are independent and does not rename files.