@swarmcraftai/cli 0.5.1 → 0.7.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.
Files changed (4) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +62 -2
  3. package/dist/main.cjs +16222 -14408
  4. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,22 @@
2
2
 
3
3
  All notable changes to the SwarmCraft CLI are documented in this file.
4
4
 
5
+ ## 0.7.0
6
+
7
+ - Upgrades Operate to schema-based records and refreshed Work, Automate, Formalise, Import, and Handbook guidance.
8
+ - Adds reproducible source intake, deterministic knowledge navigation, and validated handbook exports.
9
+ - Adds reviewed upgrades for existing Operate repositories, with recovery checkpoints, validation, and preservation of owner edits.
10
+ - Seeds account-independent V3 task packets and guidance for optional board connection.
11
+ - Requires the coordinated API release for Operate 2.0 telemetry; deploy API and web before publishing this client.
12
+
13
+ ## 0.6.0
14
+
15
+ - Adds Claude Code subscription support to repository bootstrap, Operate, and one-shot, with generated `.claude/skills` and owner-preserving `CLAUDE.md` guidance.
16
+ - Checks local Claude subscription login, preserves macOS login discovery, and rejects API credential injection on that path.
17
+ - Preserves blocked run state after provider failures and supports do/check through human review and resume.
18
+ - Refreshes installation, native Windows, provider setup, permissions, and recovery instructions.
19
+ - Requires the coordinated API update for Claude Operate telemetry; deploy the API before this client.
20
+
5
21
  ## 0.5.1
6
22
 
7
23
  - Refreshes the npm README around customer installation and common workflows, with native PowerShell commands, Node/npm verification, managed-machine recovery and VS Code restart guidance.
package/README.md CHANGED
@@ -9,7 +9,7 @@ The CLI brings SwarmCraft workflows to your terminal. Use it to prepare a local
9
9
  - Node.js 20.19 or newer, npm, and Git.
10
10
  - A SwarmCraft account and a project with tasks ready to implement.
11
11
  - A local Git repository with unrelated changes committed or stashed.
12
- - Codex CLI or GitHub Copilot CLI installed and configured, or SwarmCraft Managed AI credits.
12
+ - Codex CLI, GitHub Copilot CLI, or Claude Code CLI installed and configured, or SwarmCraft Managed AI credits.
13
13
 
14
14
  On macOS and Windows, start with [SwarmCraft Setup](https://swarmcraft.ai/docs/set-up-and-connect/use-swarmcraft-setup) to prepare your environment.
15
15
 
@@ -89,12 +89,13 @@ swarmcraft init --project <project-id> --workspace . --agent-provider codex
89
89
 
90
90
  ## Choose an agent
91
91
 
92
+ - **Claude Code subscription:** use `--agent-provider claude` after local Claude sign-in.
92
93
  - **Codex:** use `--agent-provider codex`.
93
94
  - **GitHub Copilot:** use `--agent-provider copilot`.
94
95
  - **SwarmCraft Managed AI:** use `--agent-provider managed` with `one-shot`. The CLI shows your credit balance and an estimated stage range before starting. If credits run out, add credits and resume the blocked run.
95
96
  - **Custom commands and local models:** `--agent-command` overrides the provider command and supports models available through your agent, including local models. The template is executed through a shell, so use only commands you trust. Keep secrets out of command text; use `--agent-env-file` with `--agent-api-key-env-name` for provider credentials.
96
97
 
97
- Codex, Copilot, and custom providers use your own provider setup and are outside the Managed AI fee.
98
+ Codex, Copilot, Claude Code, and custom providers use your own provider setup and are outside the Managed AI fee.
98
99
 
99
100
  ## Inspect and resume work
100
101
 
@@ -148,3 +149,62 @@ Run `swarmcraft auth login` again if your session has expired. For Discovery dia
148
149
  Support bundles redact credentials; Discovery bundles exclude source and package content. Review any diagnostic files before sharing them.
149
150
 
150
151
  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).
152
+
153
+ ### Claude Code subscription runs
154
+
155
+ Select `--agent-provider claude` for bootstrap, Operate, or one-shot. Install the
156
+ standalone Claude Code CLI, run `claude auth login`, and confirm subscription
157
+ usage in `/status`. The VS Code extension alone does not install the terminal
158
+ command. SwarmCraft checks the effective `claude.ai` login without retaining
159
+ its output and rejects provider credential flags on this subscription path.
160
+
161
+ One-shot invokes `/swarmcraft-do` and `/swarmcraft-check` with `dontAsk`:
162
+ configure the necessary tool permissions in Claude before running; unapproved
163
+ tools are denied. The default never enables permission bypass or API-only bare
164
+ mode. Claude keeps ownership of login storage and sandbox settings. Use
165
+ `--max-agent-requests` to bound invocations; subscription limits still apply.
166
+ Cost telemetry remains unknown unless an explicit adapter supplies it; required
167
+ cost telemetry fails when absent. Dollar estimates are not subscription bills.
168
+ After correcting login, permissions, or a usage limit, resume the recorded run.
169
+ Live subscription/platform verification is tracked in the implementation plan.
170
+
171
+ `swarmcraft operate rebuild --workspace <path> [--json]` explicitly refreshes the
172
+ knowledge index and derived status. It runs local structural and Git-policy inspection,
173
+ preserves unrelated staged work, and neither commits nor contacts the API. `operate status`
174
+ and `operate validate` remain read-only. A registered private source can be unavailable in
175
+ this clone without being an unresolved source identity.
176
+
177
+ `swarmcraft operate import --workspace <path> --source-id source.guidance --title "Reference guidance" --timezone Australia/Brisbane --input <file>`
178
+ registers evidence locally and preserves a dated original snapshot. Add `--group <label>`
179
+ for a confirmed, non-sensitive grouping. Omit `--input` to register an operator statement;
180
+ retain the statement in knowledge. Use `--rebuild` without `--input` to regenerate a
181
+ registered source's derivative after checking the original digest. New source versions
182
+ require new IDs. Markdown/text and DOCX main-body text are supported; other formats
183
+ remain registered with retrieval pending. No import command commits or uploads files.
184
+
185
+ `swarmcraft operate handbook --workspace <path> --notes knowledge.review --title "Operations handbook" --timezone Australia/Brisbane`
186
+ creates a dated Markdown snapshot from explicitly selected reviewed notes. Optional
187
+ `--formats html,pdf` detects Pandoc and, for PDF, WeasyPrint. Format failures are recorded
188
+ in the edition manifest; completed Markdown remains available. Explicitly reviewed images
189
+ use `--reviewed-assets <comma-separated-repository-paths>`. Provisional notes require
190
+ `--include-provisional` and remain visibly labelled. Editions preserve earlier runs.
191
+
192
+ Exports remain ignored. `--track` declares approval to track this particular handbook;
193
+ it does not change ignore rules or commit anything. Review exact edition-file exceptions
194
+ before staging. Inspection only permits declared outputs whose bytes match their manifest,
195
+ not arbitrary exports beside them. Source notes remain the maintained originals.
196
+
197
+ ### Update an existing Operate repository
198
+
199
+ Run `swarmcraft operate upgrade --workspace <path> --check` to check compatibility without changes. Run `swarmcraft operate upgrade --workspace <path>` to apply a supported update. Both commands work locally without sign-in or activity reporting.
200
+
201
+ Finish your current Work checkpoint first. The upgrade requires clean tracked files and index, creates a pre-upgrade Git commit, validates the migration and managed-file reconciliation, then creates a separate upgrade commit. Nothing is pushed. Ignored and untracked files remain untouched; destination collisions stop the update. Custom skills, unsupported source catalogues and nonempty old rules tables require review before migration.
202
+
203
+ Rerun the command after an interruption to recover unchanged upgrade writes and retry. Recovery stops if later edits or Git history changes would be overwritten. A folder without an Operate locator needs first-time adoption rather than migration. See [Use Operate](https://swarmcraft.ai/docs/start-here/use-operate) for the editor workflow.
204
+
205
+ For source intake, `operate import --purpose workflow` preserves and registers an original without extracting it. Use `--purpose derived` for a searchable copy; when purpose is unclear, the Import skill selects workflow. To create a searchable copy later, use `--rebuild --purpose derived` with the same source ID and its verified original. Omitting `--purpose` retains the CLI's earlier derived-source behaviour.
206
+
207
+ An already seeded repository and its packet skills remain usable with your own
208
+ assistant without an ongoing SwarmCraft account. Packet work and review can finish
209
+ locally. Hosted one-shot orchestration and Managed AI still require sign-in; optional
210
+ board syncing is provided by the SwarmCraft extension when connected.