@swarmcraftai/cli 0.1.6 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to the SwarmCraft CLI are documented in this file.
+
+## 0.3.0
+
+- Completes the clean cutover to tasks across API requests, local run manifests, packet metadata, and sync behavior.
+- Adds task-oriented one-shot options including `--task` and `--task-limit`, and records `taskId` throughout generated run artifacts.
+- Uses the production `/tasks` API and task-board payloads; upgrade the API, CLI, and extension together and regenerate existing packets because legacy compatibility aliases are not retained.
+- Seeds collaborative prototype files and review guidance into Deep Discovery workspaces.
+- Makes Deep Discovery recommendation-led and prototype-first, with explicit handling for owner corrections and known evidence gaps.
+
+## 0.2.0
+
+- Adds `discovery prepare`, `discovery validate`, and `discovery support-bundle` for the Deep Discovery workflow.
+- Builds deterministic, provider-free discovery packages from the nine reviewed discovery documents and explicitly selected local sources.
+- Adds canonical SHA-256 digests, immutable atomic package output, and a reviewable package preview.
+- Rejects changed, stale, unsafe, oversized, or mismatched sources and review documents before upload.
+- Adds content-safe progress and diagnostics, resumable run IDs, and redacted support bundles.
+- Shares the discovery package contract and repository seed behavior with the SwarmCraft VS Code extension.

package/README.md

@@ -2,7 +2,9 @@
 
 SwarmCraft CLI prepares a local repository for a SwarmCraft project board and runs packet-based agent workflows from the terminal.
 
-Use it to authenticate with SwarmCraft, list available projects, seed workspace guidance files, materialize ticket packets, run one-shot implementation passes, resume or inspect runs, and create support bundles.
+Use it to authenticate with SwarmCraft, list available projects, seed workspace guidance files, materialize task packets, run one-shot implementation passes, resume or inspect runs, and create support bundles.
+
+Deep Discovery uses the provider-neutral `@swarmcraft/discovery-package-contract` for exact-text packaging, canonical hashing, and local validation. The CLI never asks an AI provider to generate transport JSON or tasks and never contains SwarmCraft's private seven-slice compiler.
 
 ## Package Shape
 
@@ -59,7 +61,10 @@ Core commands:
 swarmcraft auth login --email <email>
 swarmcraft delegation start --user <customer-email-or-id> --reason <text> --expires-in-minutes 600
 swarmcraft projects list --delegation <delegation-id>
-swarmcraft init --project <project-id> --workspace <path> --delegation <delegation-id>
+swarmcraft discovery prepare --workspace <path>
+swarmcraft discovery validate --workspace <path>
+swarmcraft discovery support-bundle --workspace <path> --run <run-id>
+swarmcraft init --project <project-id> --workspace <path> --agent-provider codex --delegation <delegation-id>
 swarmcraft one-shot --project <project-id> --workspace <path> --agent-provider codex --delegation <delegation-id>
 swarmcraft one-shot --project <project-id> --workspace <path> --agent-provider codex --run-id <known-run-id>
 swarmcraft resume --run <run-id> --workspace <path> --delegation <delegation-id>
@@ -67,9 +72,21 @@ swarmcraft status --run <run-id> --workspace <path> --delegation <delegation-id>
 swarmcraft delegation end --delegation <delegation-id>
 ```
 
-`swarmcraft init` validates the workspace git state, seeds the shared SwarmCraft repo guidance files, materializes non-done ticket packets, links those packets back to SwarmCraft, and prints the next commands.
+`swarmcraft init` validates the workspace git state, seeds the shared SwarmCraft repo guidance files, materializes non-done task packets, links those packets back to SwarmCraft, and prints the next commands.
+
+The task contract is a clean cutover from the earlier project-ticket format. Upgrade the API, CLI, and VS Code extension together; old `ticketId` packet files and `--ticket` flags are not accepted. Preserve any owner-authored notes, remove the retired generated packet files, and run `swarmcraft init` again to materialize current `taskId` packets from the board.
+
+`swarmcraft discovery prepare` is projectless and deterministic. It requires the versioned discovery binding, `.swarmcraft/discovery.sources.json`, current selected-source digests, and all nine curated documents to be reviewed or explicitly not applicable. Repeated `--source` arguments must exactly match the aggregate owner-confirmed text projection when supplied by the extension. Empty, draft, unresolved, stale-sidecar, binary, secret-bearing, oversized, or mismatched preparation is blocked before upload.
+
+Preparation prints content-safe milestones as review state is checked, selected inputs are frozen, safety checks pass, the immutable digest is created, and the preview becomes ready. It normally completes in seconds and does not show a provider timer or artificial percentage.
+
+The CLI freezes the nine reviewed curated documents plus the exact selected `.md`/`.txt` sources and valid Markdown sidecars. It preserves the exact text and records roles, review states, sizes, SHA-256 digests, and sidecar provenance, then publishes atomically under `.swarmcraft/discovery-packages/<digest>/`. The preview lists exactly what may leave the machine. Reviewed curated documents are authoritative; selected sources are supporting evidence.
+
+Run diagnostics contain only schema version, phase, error class, timestamps, counts, byte/token estimates, and support codes—never document text or source paths. Durable feedback distinguishes incomplete discovery, stale input, cancellation, invalid packages, and internal failures. Support bundles exclude paths and Discovery Package content.
+
+`swarmcraft discovery validate` reruns deterministic package and local-staleness checks without launching a provider. Untracked and ignored owner-selected text is preserved and allowed but remains the owner's backup responsibility. A failed run never truncates, summarizes, or silently drops content: correct the reported review/source issue and prepare again.
 
-`swarmcraft one-shot` bootstraps the workspace, runs the doing lane through the selected agent provider, syncs packet updates back to SwarmCraft, writes `.swarmcraft/runs/<run-id>/manifest.json`, streams progress to the terminal, writes agent logs under `.swarmcraft/runs/<run-id>/logs/`, and moves accepted work to `done` by default. Customer one-shots should normally pair this with `--commit-policy done` so each completed ticket creates a local commit. Use `--checking on` or `--reviewing on` only for internal validation runs that deliberately need those extra lanes.
+`swarmcraft one-shot` bootstraps the workspace, runs the doing lane through the selected agent provider, syncs packet updates back to SwarmCraft, writes `.swarmcraft/runs/<run-id>/manifest.json`, streams progress to the terminal, writes agent logs under `.swarmcraft/runs/<run-id>/logs/`, and moves accepted work to `done` by default. Customer one-shots should normally pair this with `--commit-policy done` so each completed task creates a local commit. Use `--checking on` or `--reviewing on` only for internal validation runs that deliberately need those extra lanes.
 
 Useful safety and support commands: