@swarmcraftai/cli 0.7.2 → 0.8.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,20 @@
2
2
 
3
3
  All notable changes to the SwarmCraft CLI are documented in this file.
4
4
 
5
+ ## 0.8.1
6
+
7
+ - Opens browser sign-in by default, with Google, GitHub, passkey, or password sign-in followed by CLI approval. Use `--no-browser` to open the link yourself or `--method password` for terminal password login; existing credential flags and environment variables remain supported.
8
+ - Accepts UTF-8 CSV files as Discovery Package sources without converting them to Markdown.
9
+ - Keeps generated discovery packages, previews, and run output out of Git while leaving task packets and project guidance trackable. Reports conflicting ignore rules or already-tracked artifacts for explicit repair.
10
+ - Prevents hosted one-shot task commits from including pre-existing changes, unrelated staged files, or generated runtime artifacts.
11
+
12
+ ## 0.8.0
13
+
14
+ - Adds account-independent one-shot execution for selected local plans, phases, and task packets, with a preview before execution.
15
+ - Executes ordered packets with explicit prerequisites, request limits, recoverable checkpoints, and resume support.
16
+ - Records required or explicitly skipped checking and review stages, and pauses when human review is required.
17
+ - Adds scoped upgrades for existing packets and refreshes planning guidance to hand approved work to local execution while preserving unrelated files.
18
+
5
19
  ## 0.7.2
6
20
 
7
21
  - Simplifies the npm README and consolidates detailed workflow and provider guidance into their owning references.
@@ -18,7 +32,7 @@ All notable changes to the SwarmCraft CLI are documented in this file.
18
32
  - Adds reproducible source intake, deterministic knowledge navigation, and validated handbook exports.
19
33
  - Adds reviewed upgrades for existing Operate repositories, with recovery checkpoints, validation, and preservation of owner edits.
20
34
  - Seeds account-independent V3 task packets and guidance for optional board connection.
21
- - Requires the coordinated API release for Operate 2.0 telemetry; deploy API and web before publishing this client.
35
+ - Requires the coordinated API release for Operate 2.0 telemetry.
22
36
 
23
37
  ## 0.6.0
24
38
 
@@ -26,7 +40,7 @@ All notable changes to the SwarmCraft CLI are documented in this file.
26
40
  - Checks local Claude subscription login, preserves macOS login discovery, and rejects API credential injection on that path.
27
41
  - Preserves blocked run state after provider failures and supports do/check through human review and resume.
28
42
  - Refreshes installation, native Windows, provider setup, permissions, and recovery instructions.
29
- - Requires the coordinated API update for Claude Operate telemetry; deploy the API before this client.
43
+ - Requires the coordinated API update for Claude Operate telemetry.
30
44
 
31
45
  ## 0.5.1
32
46
 
@@ -42,7 +56,7 @@ All notable changes to the SwarmCraft CLI are documented in this file.
42
56
  - Validates approved operational formalisation and source digests when preparing Deep Discovery evidence, blocking stale or cancelled approvals.
43
57
  - Adds SwarmCraft-managed AI to one-shot workflows, including credit balance and stage estimates, measured per-call consumption, and resumable insufficient-credit outcomes. Customer-supplied Codex, Copilot, and custom providers remain supported.
44
58
  - Seeds versioned project environment requirements from structured build profiles and documents local-model execution through custom agent commands.
45
- - Requires the matching API credit, Managed AI, and Operate telemetry contracts; deploy the coordinated API and web release before publishing this client.
59
+ - Requires the matching API credit, Managed AI, and Operate telemetry contracts.
46
60
 
47
61
  ## 0.4.2
48
62
 
package/README.md CHANGED
@@ -51,11 +51,11 @@ swarmcraft.cmd one-shot --project YOUR_PROJECT_ID --workspace . --agent-provider
51
51
  Sign in and find your project ID:
52
52
 
53
53
  ```bash
54
- swarmcraft auth login --email you@example.com
54
+ swarmcraft auth login
55
55
  swarmcraft projects list
56
56
  ```
57
57
 
58
- Login prompts for your password and any required verification code. Your CLI session is saved in `~/.swarmcraft/cli-session.json`; keep this file private.
58
+ Login opens your browser so you can use Google, GitHub, a passkey, or your SwarmCraft password, then approve the CLI connection. Use `--no-browser` to open the displayed link yourself. Press Ctrl+C to cancel. For explicit email/password login, use `swarmcraft auth login --method password`; do not enter your Google password. Existing credential flags and `SWARMCRAFT_EMAIL`/`SWARMCRAFT_PASSWORD` environment variables continue to select password login. Your CLI session is saved in `~/.swarmcraft/cli-session.json`; keep this file private.
59
59
 
60
60
  From your project's local Git repository, check your setup:
61
61
 
@@ -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.