@swarmcraftai/cli 0.6.0 → 0.7.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 +13 -0
- package/README.md +63 -0
- package/dist/main.cjs +16028 -13949
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,19 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to the SwarmCraft CLI are documented in this file.
|
|
4
4
|
|
|
5
|
+
## 0.7.1
|
|
6
|
+
|
|
7
|
+
- Adds account-independent project guidance and packet upgrades with preview, saved-provider preservation, conflict reporting, and recoverable writes.
|
|
8
|
+
- Adds `swarmcraft upgrade` and detailed, side-effect-free help for every command.
|
|
9
|
+
|
|
10
|
+
## 0.7.0
|
|
11
|
+
|
|
12
|
+
- Upgrades Operate to schema-based records and refreshed Work, Automate, Formalise, Import, and Handbook guidance.
|
|
13
|
+
- Adds reproducible source intake, deterministic knowledge navigation, and validated handbook exports.
|
|
14
|
+
- Adds reviewed upgrades for existing Operate repositories, with recovery checkpoints, validation, and preservation of owner edits.
|
|
15
|
+
- Seeds account-independent V3 task packets and guidance for optional board connection.
|
|
16
|
+
- Requires the coordinated API release for Operate 2.0 telemetry; deploy API and web before publishing this client.
|
|
17
|
+
|
|
5
18
|
## 0.6.0
|
|
6
19
|
|
|
7
20
|
- Adds Claude Code subscription support to repository bootstrap, Operate, and one-shot, with generated `.claude/skills` and owner-preserving `CLAUDE.md` guidance.
|
package/README.md
CHANGED
|
@@ -167,3 +167,66 @@ Cost telemetry remains unknown unless an explicit adapter supplies it; required
|
|
|
167
167
|
cost telemetry fails when absent. Dollar estimates are not subscription bills.
|
|
168
168
|
After correcting login, permissions, or a usage limit, resume the recorded run.
|
|
169
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.
|
|
211
|
+
|
|
212
|
+
## Upgrade an existing project repository
|
|
213
|
+
|
|
214
|
+
With CLI 0.7.1 or later, preview and apply workflow upgrades locally:
|
|
215
|
+
|
|
216
|
+
```sh
|
|
217
|
+
swarmcraft upgrade --workspace . --check
|
|
218
|
+
swarmcraft upgrade --workspace .
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
No account or API is needed. Upgrade keeps the repo's saved provider, updates unchanged
|
|
222
|
+
managed guidance, and preserves owner files and edited managed files. It migrates
|
|
223
|
+
unfinished and provisional packet metadata while retaining progress; completed packets
|
|
224
|
+
stay unchanged unless you pass `--include-completed`. Server-derived project context
|
|
225
|
+
is preserved offline. Review the result and `git diff` before committing. `--json`
|
|
226
|
+
returns a structured summary; exit 2 means preserved conflicts, and exit 1 means a
|
|
227
|
+
blocker or failure. Rerun after resolving the reported issue; do not regenerate packets.
|
|
228
|
+
|
|
229
|
+
Use `init` for initial project setup and `operate upgrade` for Operate repositories.
|
|
230
|
+
`init` still requires project access and can update board packet links. Learn exact
|
|
231
|
+
requirements, defaults and side effects with `swarmcraft help init` or
|
|
232
|
+
`swarmcraft upgrade --help`; help itself never authenticates or executes a workflow.
|