@plitzi/cli 0.38.14 → 0.38.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/cli",
-  "version": "0.38.14",
+  "version": "0.38.15",
   "license": "AGPL-3.0",
   "description": "Command line for Plitzi: scaffold a project that renders a space, a plugin package, or an element of your own.",
   "files": [
@@ -21,14 +21,14 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@plitzi/sdk-authoring": "0.38.14",
+    "@plitzi/sdk-authoring": "0.38.15",
     "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "esbuild": "^0.28.2",
     "fflate": "^0.8.3"
   },
   "devDependencies": {
-    "@plitzi/sdk-shared": "0.38.14",
+    "@plitzi/sdk-shared": "0.38.15",
     "@types/node": "^26.6.4",
     "eslint": "^9.39.5",
     "eslint-plugin-import": "^2.32.0",

package/skills/plitzi-cli/SKILL.md

@@ -24,7 +24,7 @@ npx plitzi element remove ent-trust                     # an element taken out,
 npx plitzi element move ent-faq --before ent-pricing    # an element put elsewhere among its siblings
 npx plitzi verify                               # left passing? author, lints, types, tests, format, pages
 npx plitzi page check -- /about --width 1440,390     # whether a page is whole, in text
-npx plitzi explain navigate                     # what a name means: element, step, code, any export
+npx plitzi explain navigate                     # what a name means: element, step, code, any @plitzi export
 npx plitzi doctor                               # whether the project is whole; --fix the simple parts
 npx plitzi cert                                 # HTTPS for a phone on the Wi-Fi (with HOST=0.0.0.0)
 npx plitzi upgrade                              # the project up to this CLI (--write)

package/skills/plitzi-cli/reference/functions.md

@@ -17,7 +17,8 @@ A space's own server code — TypeScript tasks its actions run as steps, and rou
   nothing to the space. Credentials are `PLITZI_CREDENTIALS={"stripe":{"apiKey":"…"}}` in `.env` — what `dev` and the
   project's own server hand `ctx.fetch({ credential })`; in the cloud, the space's Credentials.
 - **An action that only runs one task** is `taskAction(tasks.make, { trigger: { type: 'call', access: 'public' } })`
-  (`@plitzi/sdk-authoring`): its input is the task's params, its id `<namespace>-<action>`. A param says what it
+  (`@plitzi/sdk-authoring`): its input is the task's params, its id `<namespace>-<action>` — and a plugin runs it typed by
+  both, `useServerAction<typeof make>(make.id)`: one operation is one task, never a `case` in one route. A param says what it
   takes — `required`, `maxLength`, `min`/`max` — and a call outside it is refused with the reason before `run`;
   `ctx.rateLimit('make', { most: 5, perSeconds: 600, refuse: 'Wait ten minutes' })` refuses over the limit alike.
 - **A run gets 100 ms of CPU and 10 s.** A task that needs more asks with `limits: { cpuMs, wallMs }` (or

package/skills/plitzi-cli/reference/plugins.md

@@ -14,7 +14,9 @@ plitzi plugin add ticker --prop interval:number=5000 --prop paused:boolean --tri
 
 **Say its shape and it is written in it**: `--prop name:type=default` (string, number, boolean; `list`/`json` for data
 a binding fills) per attribute — typed, bindable, with a control in its panel; `--trigger onTick:count` per event and
-what a flow reads, fired with `usePluginTrigger(declaration)` — `fire('onTick', { count })`, typed; `--callback reset` per action a flow calls; `--headless`
+what a flow reads, fired with `usePluginTrigger(declaration)` — `fire('onTick', { count })`, typed, and read by
+naming the step: `[named('tick', on('onTick')), …({ value: '{{ tick.count }}' })]`; `--callback reset` per action a
+flow calls; `--headless`
 for one with nothing to see. Without them it writes a counter showing the three ways an element talks to a space.
 
 Each is a folder (`src/plugins/SeatPicker/` in a project `create` wrote):