makeables 0.7.0 → 0.9.0

package/README.md

@@ -162,15 +162,57 @@ gallery, or install the artwork on the phone. Cards, badges and stickers share `
 loads `makeables skills get wallet`.
 
 ```sh
-makeables wallet setup
-makeables wallet prep --file card.json --out wallet-preview
-makeables wallet list
-makeables wallet apply --file card.json --card c-SELECTION --yes
-makeables wallet backups
+# 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
+# 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
 ```
 
-Wallet runs on a Mac with a USB-connected iPhone. Setup downloads a versioned,
+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
+`--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
+verified original backup. Apply returns a restore handoff; both operations
+save private receipts. `wallet backups --backup b-BACKUP` retrieves the current
+backup status and its last completed operation without a card scan. A saved
+success may predate a later failure. Transport durations are part of phase
+timings, not extra time to add to the total. A CLI-only update does not replace
+the companion; check `wallet doctor` capabilities when diagnosing old behavior.
+
+Setup downloads a versioned,
 checksum-verified companion containing the runtime, native bridges and artwork
 exporter; no source checkout or developer toolchain is required. `apply` changes
 the artwork of a selected existing card; `restore` removes that custom design
@@ -183,9 +225,12 @@ without touching a device. `MAKEABLES_WALLET_HELPER` selects a compatible local
 companion for development; `MAKEABLES_WALLET_HOME` and `MAKEABLES_WALLET_BACKUPS`
 override its private storage locations.
 
-Wallet artwork changes use experimental, unofficial device services. Apply has
-been tested on a Wallet card; restoration of an actual Wallet card remains
-unverified. Keep the original backups and inspect the guide before device work.
+Wallet artwork changes use experimental, unofficial device services. Apply and
+restoration have been tested on a Wallet card. The September 30, 2026 restore
+used companion 0.2.0's one-shot transport and was visually confirmed by the user.
+The optimized persistent/batched path still needs device validation; this is
+not a broad compatibility or speed guarantee. Keep the original backups and
+inspect the guide before device work.
 
 ## Share any design
 

package/dist/assets/stickers/moraleja/provenance.json

@@ -0,0 +1,223 @@
+{
+  "creator": {
+    "label": "moraleja.co",
+    "url": "https://moraleja.co"
+  },
+  "supplied": "2026-09-30",
+  "archive": "01. STICKERS-20260930T201956Z-1-001.zip",
+  "authorization": "The maintainer supplied these files and explicitly requested all stickers be included in Makeables with moraleja.co credit. This is not an independently verified upstream license or rights-holder grant.",
+  "transformation": "Complete source composition rendered with sharp/librsvg. Only fully transparent outer padding trimmed; artwork fitted within 896 px and centered on a transparent 1024 px square, encoded as lossless WebP. Original bytes preserved in apps/web/sticker-sources/moraleja.",
+  "entries": [
+    {
+      "slug": "claude-01",
+      "source": "CLAUDE-01.svg",
+      "sourceSha256": "7e15a027c8a9c0165f96245871c6503681b631a7bccd2dd3df964932ec91e7ad",
+      "preview": "claude-01.webp",
+      "previewSha256": "441ac492b0a214fc5e38a7feaf3bcff219234a3d927a37b1627d1218edd1b08e"
+    },
+    {
+      "slug": "claude-02",
+      "source": "CLAUDE-02.svg",
+      "sourceSha256": "68064527ec12a96b75450ffa2452cb7f76e66670bbfa3003f5defa74803f6447",
+      "preview": "claude-02.webp",
+      "previewSha256": "74dbaa9ce9240ca5aa66bc53aa4b439b3997568c1f8e1cf86254b27e0b1d20e3"
+    },
+    {
+      "slug": "claude-03",
+      "source": "CLAUDE-03.svg",
+      "sourceSha256": "48e765d655f12b272f223fc10b37246d0a8cceda9d2cc5f585772f4dd2d16f0a",
+      "preview": "claude-03.webp",
+      "previewSha256": "63342e00610c3b155b878bec82da30f9956c9ad617b9a65263b1b864265d8afc"
+    },
+    {
+      "slug": "code-brew-pereira",
+      "source": "CODE-BREW-PEREIRA.svg",
+      "sourceSha256": "21f375bb45cbe0874bb50a238048b10ef3e1b9bffb85f0876212c9f4d33030f5",
+      "preview": "code-brew-pereira.webp",
+      "previewSha256": "bbe4d36ceae88525a79b90029211255bb6e5a33abcdd87e7673abfc0d4208d45"
+    },
+    {
+      "slug": "code-brew-san-01",
+      "source": "CODE-BREW-SAN-01.svg",
+      "sourceSha256": "4856cebac16eb465fd9a2e41a8a0640d1d2c2efae0aa8f787ac1f5243b1bfc8a",
+      "preview": "code-brew-san-01.webp",
+      "previewSha256": "abc29311ca7e914a5fff8498ad42c7d1974a5f6efc5b3adda570406d568ba2fd"
+    },
+    {
+      "slug": "code-brew-san-02",
+      "source": "CODE-BREW-SAN-02.svg",
+      "sourceSha256": "f1ac7704a523192a321bb2105ab1bf5bf95e2fedcf796840f08017aa86708251",
+      "preview": "code-brew-san-02.webp",
+      "previewSha256": "0c6224bedbf46f1be5e66f9ff7ae5d81446e43130b831a6875630123e5cf6f89"
+    },
+    {
+      "slug": "cooking",
+      "source": "COOKING.svg",
+      "sourceSha256": "7fa82becb804d6bd2921169953179a344ef7e31a7804fe59eacfe9875a5e9eb6",
+      "preview": "cooking.webp",
+      "previewSha256": "466a10a3b4ed2fa17d7664b07dfd003abb4012311e6f2d974a0fbf386d983be8"
+    },
+    {
+      "slug": "crafter-01",
+      "source": "CRAFTER-01.svg",
+      "sourceSha256": "36eb6172c5bbbe92ef7a144f758811c474d449fffd8f33848b51fa9f1c13bf2b",
+      "preview": "crafter-01.webp",
+      "previewSha256": "47e88a9ef7408c3e27706e6a3c14236a71b6fa830327b99b554225a83a09fca2"
+    },
+    {
+      "slug": "crafter-station",
+      "source": "CRAFTER-STATION.svg",
+      "sourceSha256": "e152b14faacbf4784cee5600c28ea85a7fe304d888d87d27f105c31ccfd41486",
+      "preview": "crafter-station.webp",
+      "previewSha256": "ca7cbe65d9dd67a919859f7266824b79a12f81619f51388376f3ed716f5281a0"
+    },
+    {
+      "slug": "curious",
+      "source": "Curious.png",
+      "sourceSha256": "953214a5c0ebcc66565767bb471f618f87e3b98dfeb9d21eedd755eba16fe8ea",
+      "preview": "curious.webp",
+      "previewSha256": "2240e76c15e05e6f412c0b4c3297ba1eda70c9cf6869efcb34f93cfd50282246"
+    },
+    {
+      "slug": "jsi",
+      "source": "JSI.svg",
+      "sourceSha256": "f5dd7c55fcec492e8833626ecf60e979cca71fc723b6d302a9813c897284cb0a",
+      "preview": "jsi.webp",
+      "previewSha256": "19be514b3e870679ac674c12d71f342962f8df973a7501e2d954da8078e58bad"
+    },
+    {
+      "slug": "kebo-01",
+      "source": "KEBO-01.svg",
+      "sourceSha256": "377434e65f58f884484f01de9f3a27efd82f845d8a357588d3a821bf895c88d9",
+      "preview": "kebo-01.webp",
+      "previewSha256": "ac60b41316743a18ae0b0e3cf2ec4b5e0a9c9786a9170eca995d5cec0747f999"
+    },
+    {
+      "slug": "kebo-02",
+      "source": "KEBO-02.svg",
+      "sourceSha256": "b6a68683ddb32757c82312bfe745d7b8fdce4829782206c22dc1a6ac7e98aac1",
+      "preview": "kebo-02.webp",
+      "previewSha256": "02112761ee177e9d028f1516b534838afd83da5771bd5ff77f191a5bf0baa315"
+    },
+    {
+      "slug": "kebo-03",
+      "source": "KEBO-03.svg",
+      "sourceSha256": "bad412e08c252885297c796233d1d15d773c433682bb4f8309c6e3208feb6cbd",
+      "preview": "kebo-03.webp",
+      "previewSha256": "8d6a8972f20c953316c8c75febb2fd83b5794e2565804580310f56ec6819862b"
+    },
+    {
+      "slug": "kebo-04",
+      "source": "KEBO-04.svg",
+      "sourceSha256": "1b722cf7ef6e4fb40df7dfa999fb0b80119168248a62d76dbf34566ebdba33a4",
+      "preview": "kebo-04.webp",
+      "previewSha256": "04579cde2deb8f2f8fc6bb259efa4bb217da71d2d114affb4839d5fbeb19d609"
+    },
+    {
+      "slug": "kebo-brand",
+      "source": "KEBO-BRAND.svg",
+      "sourceSha256": "516d9bde705418ef92f80450b60666c30234eca69cf8babd3627bf0d58053248",
+      "preview": "kebo-brand.webp",
+      "previewSha256": "9766216e9cdb9188db23cfc14f06bf220af4f8b0ea50967b08e7a978168e7919"
+    },
+    {
+      "slug": "maca",
+      "source": "MACA.svg",
+      "sourceSha256": "efc339c96dfc44c43f52810c2c2553f09968bd4b3200a609cebcd5545b893dcd",
+      "preview": "maca.webp",
+      "previewSha256": "ea3f23957f4cd846cd1d2f58fc572b1b746ef35219ece06414dae8f1b831e6db"
+    },
+    {
+      "slug": "moraleja-01",
+      "source": "MORALEJA-01.svg",
+      "sourceSha256": "80fe9cecbaf0cd8512848d4c4dbf946556de7cee1b8006cc72a2c80d2fb917d3",
+      "preview": "moraleja-01.webp",
+      "previewSha256": "090bb928d52df041fe2dc4161ceda43fa3aaad73a9ac99039756a62d929a0e84"
+    },
+    {
+      "slug": "moraleja-lfg",
+      "source": "MORALEJA-LFG.svg",
+      "sourceSha256": "b4a5df77b894898cbdad9a885d7f48384025805a97086fbd4bdf32681420f0d3",
+      "preview": "moraleja-lfg.webp",
+      "previewSha256": "7dc89dfa7014778796eb9f3e1934bfd93698ffcee11e07d3efd11e1f9a054441"
+    },
+    {
+      "slug": "pawboard",
+      "source": "PAWBOARD.svg",
+      "sourceSha256": "0d463d941147f5fc23d9fc6115a1f616cc979a2c88b1493f23f05a9b6327dc61",
+      "preview": "pawboard.webp",
+      "previewSha256": "484e462578a50fc01c01b16e1a008ef647737d1016ad512ecce5a3728cb3f470"
+    },
+    {
+      "slug": "qwstzw",
+      "source": "Qwstzw.svg",
+      "sourceSha256": "653113c9a4852903ad78b202328a82e0c3ff181227d1dadb468e8558c8109067",
+      "preview": "qwstzw.webp",
+      "previewSha256": "6dc1f4dabf7a369ebdf06275bf6a063e61d602583c119d4b7eb94ee68732264f"
+    },
+    {
+      "slug": "repo-o-fake",
+      "source": "REPO-O-FAKE.svg",
+      "sourceSha256": "afa71ecbec67be1136a8e90d86d54a4021f0840b91a3cce7f60e3511345cad8f",
+      "preview": "repo-o-fake.webp",
+      "previewSha256": "94550577c446875cd6caae54de0db8163b17fcfe17944c984ee0a85a836af1fa"
+    },
+    {
+      "slug": "she-ships",
+      "source": "SHE-SHIPS.svg",
+      "sourceSha256": "ee60583ca97501ee4ba5ff72b56d415dca734a1a4ad901ad8fd89585d6ab9083",
+      "preview": "she-ships.webp",
+      "previewSha256": "3050e16af0572454be8bc07d82df79d0cca5f3ff7b9194a8c42d42e6aaf0b467"
+    },
+    {
+      "slug": "ship-or-sink",
+      "source": "SHIP-OR-SINK.svg",
+      "sourceSha256": "ac51df999285ed8ca6192752d94bdf5a95d647096d1c850a6bf45609843b697a",
+      "preview": "ship-or-sink.webp",
+      "previewSha256": "b0606aae9b3fb5a4561ea10abc317fa0370ca09d58d35d431ad843c004750d53"
+    },
+    {
+      "slug": "shippeando",
+      "source": "SHIPPEANDO.svg",
+      "sourceSha256": "189d47a3e3b904085d83c8ea73d76b0c123fa665b4dafad60ad578eb5e70bbd3",
+      "preview": "shippeando.webp",
+      "previewSha256": "3ffb1841720f662d2685ae329602e50fff4ecad560fbb1183777868e0bec7996"
+    },
+    {
+      "slug": "shippervivbes",
+      "source": "SHIPPERVIVBES.svg",
+      "sourceSha256": "f0355b19d81ba4ae4e4e957f6baf5eb5b2e80b8117bd8321dd261be8b7d54f33",
+      "preview": "shippervivbes.webp",
+      "previewSha256": "48330fc01398ca3a71f01a1cff24964125a4c13fb5469fd25d1d7b0e1499a288",
+      "note": "Source requires Monoblock Bold. The maintainer approved a bold monospace preview fallback on 2026-09-30; original SVG unchanged."
+    },
+    {
+      "slug": "shipping",
+      "source": "SHIPPING.svg",
+      "sourceSha256": "29a35b46ccaa7d286e1d23bd3d9e2197756ff2104f5f594f8e3e403878173d58",
+      "preview": "shipping.webp",
+      "previewSha256": "c0930d942a17c5f799d7b6f09e17bcaa86ad3971e8d506be5994d423bf9fc0ed"
+    },
+    {
+      "slug": "taste",
+      "source": "TASTE.svg",
+      "sourceSha256": "778f92611b061be47a625984e1be95a165a9c2f30c471e9cb4e25f9b6124a03a",
+      "preview": "taste.webp",
+      "previewSha256": "1aa9ce5056aa33a7813decc6d5de43fee311d4a1487109f0737714654377117c"
+    },
+    {
+      "slug": "tsb",
+      "source": "TSB.svg",
+      "sourceSha256": "b68f92de19cec3b1d838cb418a795613785aacd3b19b03d6baac9dda95b0174e",
+      "preview": "tsb.webp",
+      "previewSha256": "3893e7c2e42964fcbd02de230b195e5378092d24bd5d2b9d42e6d9ab4d6df32a"
+    },
+    {
+      "slug": "vibing",
+      "source": "VIBING.svg",
+      "sourceSha256": "e354f5369e9ffb506846a2547b28519c77f4686ec3a56a3a071c19b7ce5dcbb8",
+      "preview": "vibing.webp",
+      "previewSha256": "adc8d0872bc636ffc31eb71a2a09b3f9343b998b971cc88cd530d23ac91b5f9c"
+    }
+  ]
+}