@kaptures/cli 0.5.0 → 0.6.1

package/README.md

@@ -9,14 +9,14 @@ matching `@kaptures/storybook@0.2.0` preview adapter. Kapture does not fall back
 to Storybook private globals, legacy decorators, or Chromatic parameters.
 
 ```bash
-npx -y @kaptures/cli@0.2.0 --help
-npx -y @kaptures/cli@0.2.0 browser install
+npx -y @kaptures/cli@0.5.0 --help
+npx -y @kaptures/cli@0.5.0 browser install
 ```
 
 ## Compare Storybooks
 
 ```bash
-npx -y @kaptures/cli@0.2.0 test \
+npx -y @kaptures/cli@0.5.0 test \
   --base-dir .kapture/storybook/base \
   --head-dir .kapture/storybook/head \
   --base-revision "$BASE_SHA" \
@@ -25,7 +25,7 @@ npx -y @kaptures/cli@0.2.0 test \
   --install-browser \
   --output .kapture
 
-npx -y @kaptures/cli@0.2.0 validate \
+npx -y @kaptures/cli@0.5.0 validate \
   --report .kapture/report/report.json
 ```
 
@@ -37,6 +37,23 @@ base or head revision changes beyond the configured threshold, the snapshot is
 reported as `unstable` with repeat and self-diff PNG evidence. Unstable
 snapshots remain visible but do not block CI or enter the approval count.
 
+## CI setup
+
+The next minor release adds `kapture ci --package-manager npm|yarn|pnpm|bun`.
+It generates complete capture, report, and approval workflows without
+overwriting existing files. The same templates appear in the documentation's
+package-manager tabs. Connect your own static deployment step before enabling
+the report workflow; its placeholder intentionally fails until configured.
+
+Kapture owns artifact validation, capture, review preparation and approval.
+Your project owns dependency installation, Storybook builds, fonts, hosting
+credentials and immutable deployment URLs. No external private Action
+repository is required.
+
+`test --github-artifacts` preserves capture-error reports for upload; a
+successful capture job is not a passing visual review. The trusted report
+workflow publishes the final status and independently finalizes failed runs.
+
 ## MCP for agents
 
 Serve one local or public HTTPS report through the official Model Context
@@ -62,7 +79,7 @@ of project-relative Git diff paths to select only stories whose base or head
 dependency graph is affected:
 
 ```bash
-npx -y @kaptures/cli@0.2.0 plan \
+npx -y @kaptures/cli@0.5.0 plan \
   --base-dir .kapture/storybook/base \
   --head-dir .kapture/storybook/head \
   --changed-files .kapture/changed-files.json \
@@ -83,7 +100,7 @@ artifact is downloaded. To publish a browser URL from a privileged workflow,
 rebuild the untrusted artifact with the dashboard embedded in the pinned CLI:
 
 ```bash
-npx -y @kaptures/cli@0.2.0 report build \
+npx -y @kaptures/cli@0.5.0 report build \
   --input downloaded-kapture-report \
   --output trusted-kapture-report
 ```
@@ -139,46 +156,46 @@ The raw branch ref remains report metadata; a separate collision-resistant
 `preview-alias` is used only where a DNS-safe hosting branch is required.
 
 ```bash
-npx -y @kaptures/cli@0.2.0 github reconcile-run \
+npx -y @kaptures/cli@0.5.0 github reconcile-run \
   --capture-workflow-path .github/workflows/visual-capture.yml \
   --base-branch main \
   --status-context "Kapture Visual Review"
 
-npx -y @kaptures/cli@0.2.0 github prepare-run \
+npx -y @kaptures/cli@0.5.0 github prepare-run \
   --capture-workflow-path .github/workflows/visual-capture.yml \
   --base-branch main \
   --output "$RUNNER_TEMP/kapture-trusted/report" \
   --receipt "$RUNNER_TEMP/kapture-trusted/receipt.json" \
   --storybook-url ./storybook/
 
-npx -y @kaptures/cli@0.2.0 github prepare-storybook-run \
+npx -y @kaptures/cli@0.5.0 github prepare-storybook-run \
   --capture-workflow-path .github/workflows/visual-capture.yml \
   --base-branch main \
   --receipt "$RUNNER_TEMP/kapture-trusted/receipt.json" \
   --output "$RUNNER_TEMP/kapture-trusted/report/storybook"
 
-npx -y @kaptures/cli@0.2.0 github publish-run \
+npx -y @kaptures/cli@0.5.0 github publish-run \
   --receipt "$RUNNER_TEMP/kapture-trusted/receipt.json" \
   --report "$RUNNER_TEMP/kapture-trusted/report/report.json" \
-  --report-url "https://1a2b3c4d.example-kapture.pages.dev/" \
+  --report-url "https://reports.example.com/builds/1a2b3c4d/" \
   --status-context "Kapture Visual Review"
 
-npx -y @kaptures/cli@0.2.0 github cleanup \
+npx -y @kaptures/cli@0.5.0 github cleanup \
   --receipt "$RUNNER_TEMP/kapture-trusted/receipt.json"
 
-npx -y @kaptures/cli@0.2.0 github finalize-run \
+npx -y @kaptures/cli@0.5.0 github finalize-run \
   --capture-workflow-path .github/workflows/visual-capture.yml \
   --base-branch main \
   --status-context "Kapture Visual Review"
 
-npx -y @kaptures/cli@0.2.0 github verify \
+npx -y @kaptures/cli@0.5.0 github verify \
   --report .kapture/report/report.json
 
-npx -y @kaptures/cli@0.2.0 github report \
+npx -y @kaptures/cli@0.5.0 github report \
   --report trusted-kapture-report/report.json \
-  --report-url "https://1a2b3c4d.example-kapture.pages.dev/"
+  --report-url "https://reports.example.com/builds/1a2b3c4d/"
 
-npx -y @kaptures/cli@0.2.0 github approve
+npx -y @kaptures/cli@0.5.0 github approve
 ```
 
 GitHub commands read authentication and event data only from `GITHUB_TOKEN`