makeables 0.8.0 → 0.10.0

package/README.md

@@ -162,20 +162,46 @@ gallery, or install the artwork on the phone. Cards, badges and stickers share `
 loads `makeables skills get wallet`.
 
 ```sh
+# Existing public card + previously confirmed saved target:
+makeables wallet install --submission "https://makeables.dev/make/card?submission=UUID" --target mercury-4535 --yes --json
+# First selection, with a user-confirmed label to remember after installation:
+makeables wallet install --submission UUID --remember mercury-4535 --label Mercury --last4 4535 --json
+# Local documents and complete packages also work:
 makeables wallet install --file card.json --json
-# Inspect the returned preview and confirm the tapped card.
-makeables wallet install --assets "/returned/prepared/assets" --card c-SELECTION --yes --json
+# Wait for selection-ready before asking the user to tap. Inspect the preview.
+makeables wallet install --assets "/returned/prepared/assets" --card c-SELECTION --remember mercury-4535 --label Mercury --last4 4535 --yes --json
+makeables wallet targets list --json
+# Register an existing verified backup without touching the phone:
+makeables wallet targets add --target mercury-4535 --backup b-BACKUP --label Mercury --last4 4535 --yes --json
 # Reuse the backupId from the installation receipt when restoration is requested.
 makeables wallet restore --backup b-BACKUP --yes
 ```
 
+Public submissions download directly with a bounded timeout and validated file
+hashes. Receipts include a real local package path, byte count and checksum.
+Raw card JSON, `{design: ...}` documents and portable JSON/ZIP packages are
+accepted. The complete artwork is preserved, including vectors and text.
+`wallet prep --submission UUID --out <directory>` prepares without a phone write.
+
 Wallet runs on a Mac with a USB-connected iPhone. `install` prepares once,
 returns the next selection step when needed, and applies only with an explicit
-`--card` or `--backup` plus `--yes`. Reuse `--assets` to avoid rendering again.
+`--target`, `--card` or `--backup` plus `--yes`. Reuse `--assets` to avoid rendering again.
+If saved targets exist and no target is specified, it returns `needs-target`
+with labels to choose from. Use `--scan` to select a different card.
+Names and optional last four digits are **user-confirmed labels**, not details
+retrieved from iOS. The scanner exposes opaque selections only. Each saved alias
+binds to a verified original backup; the helper checks device/card binding again
+before writing. Duplicate aliases fail before installation. `wallet targets
+remove --target <alias>` removes only the label, preserving its backup.
+`targetSaved: false` alongside `status: complete` means artwork installation
+succeeded but the label needs saving; do not repeat the write.
 With a capable companion, selection finishes on the first card event and
 installation reuses its Media connection. Older companions retain a full scan.
 Progress appears on stderr; stdout contains the result, backup verification
 and timing. A failed device operation is never automatically retried.
+`selection-ready` appears only after the activity stream handshake succeeds;
+ask the user to tap at that point. `wallet install --help` shows only that
+command's syntax. JSON result fields live under `data`.
 
 Capable companions also reuse the connection during restoration and batch
 removal of added artwork. Restore reports each phase, file counts and the
@@ -230,3 +256,15 @@ See [the portable format](../../docs/submission-format.md) for package limits an
 Use `makeables skills get stickers` for material editing, PNG/JSON export and the common
 `submit --dry-run` / consent / review lifecycle. Sticker packages contain a transparent
 material preview and editable layers, with no participant data.
+# Complete kits
+
+`makeables skills get kits` covers creating a collection from existing editable
+pieces or a raster artwork sheet. `kit render` composes native previews,
+`kit export` writes one validated portable ZIP, and `kit import` reopens it.
+`submit --file kit.makeables.zip --yes` sends the whole collection for one review.
+Creating, importing, rendering and exporting do not require authentication.
+
+Use `render --appearance material` for static sticker finishes or
+`--appearance flat` for artwork. Use `--compact` for small machine receipts.
+Optional `--trace ./session.jsonl` writes private local command timing;
+`MAKEABLES_TRACE_SESSION` groups multiple invocations under one opaque run ID.