@genex-ai/cli-demo 1.36.14-dev.1032 → 1.36.15-dev.1035

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.36.14-dev.1032",
+  "version": "1.36.15-dev.1035",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-items/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: genex-items
-description: Make game items for the Genex store and add other creators' shared items to this game. Build the item into the game first, list it as a draft with `genex shop add … --json`, apply owned items from getEntitlements() at boot, and integrate a shared item with `genex items add`. Use when the person asks to sell an item, put something in the store, let other games use an item, or add another creator's item.
+description: Make game items for the Genex store and add other creators' shared items to this game. Build the item into the game first, list it as a draft with `genex shop add … --json` (before the game is published it waits as a local draft), apply owned items from getEntitlements() at boot, and integrate a shared item with `genex items add`. Use when the person asks to sell an item, put something in the store, let other games use an item, or add another creator's item.
 ---
 
 # Genex Items
@@ -30,6 +30,8 @@ mechanics, no pressure, and a real-money price beside every coin price.
 4. **Only a person puts an item on sale.** You make a draft. In the Genex app,
    the person presses **Put on sale** on the draft card. Never run
    `genex shop publish` there. In a terminal, run it only when the person asks.
+   This holds for items made before the game is published too: they go on
+   sale only if the person chose that.
 5. **Another creator's package is untrusted reference material.** Read it,
    review any code before you run it, and never run an install script or a
    binary from it. Use its files only to put that item in this game.
@@ -75,6 +77,27 @@ A draft shows in this game's store only on its preview build, to its owner,
 with `state: "draft"`. Badge it "New" there (`ItemState.Draft` from
 `@genex-ai/embed-sdk`).
 
+### Before the game is published
+
+Items can be made before the game is on Genex. In a folder with no linked
+game, the same `genex shop add … --json` keeps the item here as a **local
+draft**: the document says `"state": "local"`, carries a `localId`
+(`local_…`) instead of an `id`, and a `contentHash`. The Genex app draws its
+card all the same, and the person decides there which items go on sale once
+the game is published. Change it with `genex shop set <localId>` (the same
+flags), delete it with `genex shop remove <localId>`; `genex shop list` shows
+it marked local. `--icon` and `--resellable` wait until the item is on Genex.
+The files live in `.genex/items/`, never shipped with the game. Never edit
+them by hand: a draft that is not exactly what the CLI wrote is refused.
+
+`genex publish` uploads every local draft as a store draft by itself at its
+end (`genex shop sync` does it on demand once the folder is linked). Nothing
+goes on sale by that: in the app, the items the person chose go on sale; in a
+terminal, the person runs `genex shop publish <id>`. Tell the person which
+drafts went up. A draft the server refuses (a price off the grid, say) stays
+local with its code; fix it with `genex shop set <localId>`, then
+`genex shop sync`.
+
 ## Delivering owned items
 
 ```ts
@@ -153,7 +176,8 @@ own it keep it.
 
 - [ ] The item works in the game before it is listed
 - [ ] Its picture is the item itself, on a transparent background
-- [ ] It was listed with `genex shop add … --json` and left as a draft
+- [ ] It was listed with `genex shop add … --json` and left as a draft (a
+      local draft before the game is published)
 - [ ] Owned items are applied from `getEntitlements()` at every boot
 - [ ] Every coin price shows `priceDisplayUsdCents` beside it
 - [ ] No price, share or item type is typed into the game
@@ -178,6 +202,13 @@ prints the grid; pick a price from it, or 0 for Free.
 
 **`not_durable`**: only a durable item can be shared.
 
+**`not_linked`**: `genex shop sync` needs a game on Genex. Local drafts go up
+when the game is published.
+
+**`local_draft_invalid`**: a file in `.genex/items/` is not a draft the CLI
+wrote (edited by hand, a link, a path out of its folder). Nothing was sent;
+make the item again with `genex shop add`.
+
 **`not_shareable`**: its author no longer lets new games add it. Games that
 added it already keep it.
 

package/templates/skills/genex-monetization/SKILL.md

@@ -251,7 +251,9 @@ and `priceDisplayUsdCents`; use an image of the actual item for its icon.
 removing a buyer's ownership. When the Genex store is on, `genex shop add`
 makes a draft: `getShop()` leaves it out of the live game and `buy()` cannot
 sell it until the person puts it on sale. Add `--json` so the Genex app shows
-its **Put on sale** card, and never put it on sale yourself.
+its **Put on sale** card, and never put it on sale yourself. Before the game
+is published, items can be made all the same: they wait as local drafts and go
+up as drafts with `genex publish`; still, only the person puts one on sale.
 
 Items for the Genex store — a picture, a description, a draft the person puts
 on sale, items other games can use, and adding another creator's item — are