makeables 0.4.1 → 0.6.0

package/README.md

@@ -15,7 +15,7 @@ makeables skills get core
 
 Ask: “Use the makeables guide. Make an experimental badge from my photo at ~/Pictures/me.png. Show me both sides, then let’s refine it here.”
 
-For personalized badges, the guide asks for a photo if one is missing and asks before installing agent-browser for visual inspection. Cards and stickers do not need a portrait. It offers ai-cli only when a requested image transformation needs it. Image generation uses your own AI Gateway credentials and credits.
+For personalized badges, the guide asks for a photo if one is missing. It prefers native widget or browser inspection; agent-browser is optional. Cards and stickers do not need a portrait. It offers ai-cli only when a requested image transformation needs it. Image generation uses your own AI Gateway credentials and credits.
 
 ## Cards from the terminal
 
@@ -48,13 +48,52 @@ makeables doctor --json
 
 The installed skill is a small discovery stub maintained in [makeables-community](https://github.com/crafter-station/makeables-community). These guides and image-transfer helpers are bundled into the CLI, so no repository checkout or external skill script is required. Report bugs and feature requests in the [community issue tracker](https://github.com/crafter-station/makeables-community/issues).
 
-## One live preview
+## Embedded MCP App
+
+The skill chooses **MCP Apps → built-in browser → CLI + inline PNG**, based on
+capabilities actually available in the coding session. It does not open an
+external browser or install another integration to produce a preview.
+
+To connect the optional stdio server, use your host's MCP configuration with an
+existing directory dedicated to your designs:
+
+```json
+{
+  "mcpServers": {
+    "makeables": {
+      "command": "makeables",
+      "args": ["mcp", "--root", "/absolute/path/to/designs"]
+    }
+  }
+}
+```
+
+The exact configuration location depends on the host. Start a new host session
+if required; having the CLI installed does not register its MCP tools.
+`makeables_preview` exposes a self-contained MCP App: front/back, text and
+sticker-finish controls, plus host-mediated PNG, JSON and portable-package
+exports. The file is the state, shared with the CLI. Revisions reject stale
+edits. File access stays inside `--root`; there is no cloud service, login,
+localhost fetch or publication tool. Cards and badges show flat artwork;
+stickers use the same material PNG renderer as the website. A personalized
+badge opens from a complete package containing its portrait and participant.
+
+Hosts without MCP Apps receive text and a PNG from the same preview tool. A host
+without downloads can keep the local file and use CLI exports. To inspect the
+full layer editor or animated materials, continue with the same design in the
+built-in browser.
+
+`makeables render --file design.makeables.json --out preview.png` also exports
+the validated PNG from an editable portable package, keeping its portrait and
+other assets intact.
+
+## One live browser preview
 
 ```sh
 makeables studio start
 ```
 
-This opens your operating system’s default browser. An agent with a built-in browser panel should use `makeables studio start --no-open --json` and open the returned URL there. Keep the process running and reuse that tab while iterating.
+This prints a local URL without opening a browser. An agent with a built-in browser panel opens that URL there. Keep the process running and reuse that tab while iterating. `--open` explicitly opts into the operating system’s default browser; `--no-open` remains supported. If there is no built-in browser, use CLI rendering and show the resulting image in the conversation.
 
 The local preview embeds the real [badge editor](https://makeables.dev/make/badge) [card editor](https://makeables.dev/make/card) or [sticker editor](https://makeables.dev/make/sticker). Its local connection uses the same tools, revision checks and validation as native WebMCP. It works without native WebMCP in the preview browser. One tab owns a session; no separate browser-state synchronization is implied.
 
@@ -167,8 +206,8 @@ See [the portable format](../../docs/submission-format.md) for package limits an
 
 ### Stickers
 
-`makeables studio start --product sticker` opens the same Design Studio and CLI bridge.
-`makeables new sticker --style good-energy --out sticker.json` creates the shared document.
+`makeables studio start --product sticker` prints the URL for the same Design Studio and CLI bridge.
+`makeables new sticker --style typingmind-absolutely-right --out sticker.json` creates the shared document.
 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.

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

@@ -0,0 +1,43 @@
+[
+  {
+    "slug": "crafter",
+    "id": "12dd5570-2154-4f85-a6e4-f1459854bd43",
+    "originalDocumentSha256": "598c302c330c0b4eda22c046aa80d33045608bb373435853bca4ccc1473edac5",
+    "artworkSha256": "5b81e262846117778e24ac697b46e8e2c3299a2670ca0f8e152396626d385943",
+    "effectsSha256": "39b9b61b392a6fc94e824dac4ada0a4ce57b4c3c3ce8f89075ad463f7cefc6f0",
+    "model": "gpt-image-2",
+    "gateway": "Vercel AI Gateway",
+    "credit": "Railly Hugo",
+    "prompt": "crafter-prompt.txt",
+    "referenceCollection": "Ann Nguyen · TypingMind",
+    "referenceSlugs": ["absolutely-right", "agi-is-coming", "motion"],
+    "postProcessing": "Exact original Crafter vector mark composited over the generated approximation; chroma extraction and authored optical map."
+  },
+  {
+    "slug": "friday",
+    "id": "9539473f-c73a-4898-a140-2585ddfbc158",
+    "originalDocumentSha256": "0aabd1eee1b9f2858aa5199a3594989bfc4bb3e7626b82c23add8b16c7808f54",
+    "artworkSha256": "c5679d48d9a51c8cfdcc9e9268c388cf2788058204f4bf940b65b896797b46db",
+    "effectsSha256": "a86f268c5f6a49f3ba6460e1e5843465241ab9f6db65d44e5e9190dfa9990a26",
+    "model": "gpt-image-2",
+    "gateway": "Vercel AI Gateway",
+    "credit": "Railly Hugo",
+    "prompt": "friday-prompt.txt",
+    "referenceCollection": "Ann Nguyen · TypingMind",
+    "referenceSlugs": ["youre-cooked", "absolutely-right", "energy"]
+  },
+  {
+    "slug": "brew",
+    "id": "cf3f2e1a-4a31-42de-ad6c-8825303b2f09",
+    "originalDocumentSha256": "1092afc4765fd313a5e252ea6ea52183fa8071729f7893b75c2b4e8400094541",
+    "artworkSha256": "41144e8eb47b6960a2143e18a22852bc36b68fd86ddea6695df733568b80c764",
+    "effectsSha256": "8ed832869f78ead1adc9c8ac26d5eeaf89cea10023cc8d76e55f0264ff394fc6",
+    "model": "gpt-image-2",
+    "gateway": "Vercel AI Gateway",
+    "credit": "Railly Hugo",
+    "prompt": "brew-prompt.txt",
+    "referenceCollection": "Ann Nguyen · TypingMind",
+    "referenceSlugs": ["emotional-support", "cmd-enter", "energy"],
+    "postProcessing": "Exact original Crafter vector mark composited over the generated approximation; chroma extraction and authored optical map."
+  }
+]

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

@@ -0,0 +1,97 @@
+{
+  "creator": "Ann Nguyen / TypingMind",
+  "reference": "https://www.bubbbly.com/sticker-pack",
+  "inclusion": "Originals with their credit, explicitly requested by the Makeables maintainer on 2026-09-30. No upstream license is changed or inferred.",
+  "files": [
+    {
+      "file": "absolutely-right-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/absolutely-right-fx.webp",
+      "sha256": "8b4f6a588897c3c757a723ba1a6812c6325e3b5f2052168b23217b32b5fed12a"
+    },
+    {
+      "file": "absolutely-right.webp",
+      "source": "https://www.bubbbly.com/stickers/absolutely-right.webp",
+      "sha256": "fc12ee1b5e2a86e75cf02a47558781e7d4278638290b501d34fd547a4e856d18"
+    },
+    {
+      "file": "agi-disco-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/agi-disco-fx.webp",
+      "sha256": "f57264b6aee36dc1ec8d4aa9972b36ff6a7c97243af6c8607b56710c16dbf0b1"
+    },
+    {
+      "file": "agi-disco.webp",
+      "source": "https://www.bubbbly.com/stickers/agi-disco.webp",
+      "sha256": "a49fdec264045998347edc81087958eb5a79b20ec709954d1b545892fcebfffa"
+    },
+    {
+      "file": "agi-is-coming-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/agi-is-coming-fx.webp",
+      "sha256": "99b8938abef4ab66a0f43a06505c0c3b9dc01a5520c9862d177e02c562ee6149"
+    },
+    {
+      "file": "agi-is-coming.webp",
+      "source": "https://www.bubbbly.com/stickers/agi-is-coming.webp",
+      "sha256": "6d39579a32683b3db0b8177cdef753dca98b4dae3c70de84357b593406df9f53"
+    },
+    {
+      "file": "cmd-enter-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/cmd-enter-fx.webp",
+      "sha256": "1e51ecbcaee5e543b7ff869c0aea8268b1a8b7edff3f318cb651548c9154b7f1"
+    },
+    {
+      "file": "cmd-enter.webp",
+      "source": "https://www.bubbbly.com/stickers/cmd-enter.webp",
+      "sha256": "29e28e6ebfacbacaa896e9bb7bc0466e77df5745c9b0d5ada3e7e27525ad9217"
+    },
+    {
+      "file": "emotional-support-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/emotional-support-fx.webp",
+      "sha256": "fddc57829743ff9a85817096f9682b5c8a907818b99e0fc129f635c4869055b4"
+    },
+    {
+      "file": "emotional-support.webp",
+      "source": "https://www.bubbbly.com/stickers/emotional-support.webp",
+      "sha256": "79d92e1c0ea3dbe8bc1272248a30bfab70fc7eafa0b091bf960c4bb8ddb82c21"
+    },
+    {
+      "file": "energy-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/energy-fx.webp",
+      "sha256": "25a198945121ba9eca0f75023532606b5cada786bb50dc13b4bfa1aaabc2076b"
+    },
+    {
+      "file": "energy.webp",
+      "source": "https://www.bubbbly.com/stickers/energy.webp",
+      "sha256": "f52cea42b070a16b769befbc00c08d58fa6e3e19acfbb66072aa848b3267d06b"
+    },
+    {
+      "file": "motion-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/motion-fx.webp",
+      "sha256": "e9b6e35f947036c9505342a573f9ea4eb97feb35eaf77201a3028a9574f3537a"
+    },
+    {
+      "file": "motion.webp",
+      "source": "https://www.bubbbly.com/stickers/motion.webp",
+      "sha256": "32827e7d559ebd43c70deec79f3f7ac2abe9a2cb77989288596279e290ede189"
+    },
+    {
+      "file": "typingmind-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/typingmind-fx.webp",
+      "sha256": "b68a9422c77a92d6f3147bf3c056c05cedb398c6a9094fa36f2f388771b38b49"
+    },
+    {
+      "file": "typingmind.webp",
+      "source": "https://www.bubbbly.com/stickers/typingmind.webp",
+      "sha256": "34144e6c55b0028fa4f92b1baa5d43ef5cb1746e6db262369c5959db6cfa3d1b"
+    },
+    {
+      "file": "youre-cooked-fx.webp",
+      "source": "https://www.bubbbly.com/stickers/youre-cooked-fx.webp",
+      "sha256": "2d046f7bec55039c81b044c0c627aebeafd5a503be3c9a6e3e6f3c8331ce4f44"
+    },
+    {
+      "file": "youre-cooked.webp",
+      "source": "https://www.bubbbly.com/stickers/youre-cooked.webp",
+      "sha256": "ccba16cd69a5859b3a147ddc419399da8942bdbb07215cd8f90fb742b182061b"
+    }
+  ]
+}