stillmade-sdk 0.1.36 → 0.1.38

package/README.md

@@ -8,7 +8,10 @@ Build, test and package Blocks for [StillMade](https://stillmade.shop).
 npm install --save-dev stillmade-sdk
 ```
 
-Needs Node.js 22 or later. Everything it runs ships inside the package. From a downloaded SDK folder, run `node packages/block-cli/cli.js` wherever this page says `npx stillmade-block`.
+Needs Node.js 22 or later. Everything it runs ships inside the package. The same SDK is also a download,
+`/block-sdk/stillmade-sdk-0.1.0.zip` on the StillMade site. `stillmade-block` is its command line in every
+StillMade guide: `npx stillmade-block` after the install above, or `node <sdk>/packages/block-cli/cli.js` where
+`<sdk>` is the folder you extracted the download into.
 
 ## Build a Block
 
@@ -16,13 +19,23 @@ Needs Node.js 22 or later. Everything it runs ships inside the package. From a d
 npx stillmade-block create my-block javascript   # create --list shows every template
 npx stillmade-block validate my-block
 npx stillmade-block test my-block                # add --mock for hosted operations: no credits
-npx stillmade-block gate .                       # the readiness check StillMade runs
-npx stillmade-block pack my-block my-block.stillmade-block --original   # the file to import in StillMade
+npx stillmade-block dev my-block                 # the Block's interface in your browser, reloaded on save
+npx stillmade-block gate my-block                # the readiness check StillMade runs
+npx stillmade-block pack my-block                # the file to import in StillMade
 ```
 
-A Block is not ready until `gate` passes. `pack --original` declares the code as your own work and
-writes the `.stillmade-block` file StillMade imports and remixes; without a file name and `--original`,
-`pack` writes a legacy JSON package instead. In StillMade, choose Create, then Import (or Import folder).
+A Block is not ready until `gate` passes. Run it on the Block's own folder: `gate .` in a folder that also
+holds the extracted SDK checks the SDK's examples too. `pack` runs the tests again and writes one file,
+named by the Block's runtime:
+
+| Runtime | `pack my-block` writes |
+| --- | --- |
+| `module`, or a frame view with files in `src/view-files/` | `<id>-<version>.stillmade-module.json` |
+| `recipe`, `javascript`, `capability`, `comfyui` | `<id>-<version>.stillmade.json` |
+
+In StillMade, choose Create, then Import, and pick that file (or pick the Block folder with Import folder).
+A new Block needs no `.stillmade-block` archive: `pack --original` writes one only for recipe, JavaScript,
+capability and ComfyUI source (PORTABLE.md) and refuses a module Block.
 From JavaScript, `import {defineBlock} from 'stillmade-sdk'` is the same API as `packages/block-sdk/index.js`.
 
 ## For coding agents

package/REMIX.md

@@ -87,6 +87,12 @@ attribution; removing it requires a separate rights review, not a source edit.
 
 ## Outside StillMade
 
+Outside StillMade you remix only your own Blocks: one you imported or built, including a
+newer version you edited in StillMade and downloaded from your versions (**Download
+source + SDK**) to take back to your coding agent. Another person's Block is remixed only
+in StillMade, as above: StillMade offers no download of it, and an import whose original
+is another person's Block is refused with "Their Blocks can be remixed only in StillMade".
+
 Use the CLI shipped in the downloadable SDK:
 
 ```sh