@plitzi/cli 0.38.8 → 0.38.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/cli",
-  "version": "0.38.8",
+  "version": "0.38.10",
   "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.8",
+    "@plitzi/sdk-authoring": "0.38.10",
     "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "esbuild": "^0.28.2",
     "fflate": "^0.8.3"
   },
   "devDependencies": {
-    "@plitzi/sdk-shared": "0.38.8",
+    "@plitzi/sdk-shared": "0.38.10",
     "@types/node": "^26.6.4",
     "eslint": "^9.39.5",
     "eslint-plugin-import": "^2.32.0",

package/skills/plitzi-cli/SKILL.md

@@ -4,9 +4,11 @@ description: >-
   Use the Plitzi command line (@plitzi/cli, `plitzi …` or `npx @plitzi/cli …`) instead of hand-writing what it
   generates: scaffold a project that renders a space, add plugins to it or build a plugin package, pack, upload and
   install one, edit a space's functions, take a space on Plitzi out as a self-hosted project and back (`create --from`,
-  `space pull`, `space push`), and check a project (`doctor`) or how its space's source is written (`space lint`). Use whenever the task is
-  to start a Plitzi project, create or change a plugin, pack, upload or install one, pull/push/try a space's functions,
-  move a space to a server of its own and back, or work out which space the CLI is connected to.
+  `space pull`, `space push`), check a project (`doctor`) or how its space's source is written (`space lint`), and
+  write a report to Plitzi of what broke, misled or cost time (`feedback`). Use whenever the task is to start a Plitzi
+  project, create or change a plugin, pack, upload or install one, pull/push/try a space's functions, move a space to a
+  server of its own and back, work out which space the CLI is connected to — or when the person asks for a report,
+  feedback or a list of what went wrong with Plitzi.
 ---
 
 # The Plitzi CLI
@@ -31,11 +33,15 @@ npx plitzi feedback                             # a report to Plitzi, for the pe
 ## Running it as an agent
 
 - **Which check.** All of it before you finish: `verify` — only what fails is printed. The space alone: `npm run
-  author`; a page: `page check`. The project around them: `doctor`, before `space push`.
+  author`; a page: `page check`. The project around them: `doctor`, before `space push`. Pages for signed-in visitors
+  are checked as the account `.env` names (`PLITZI_CHECK_USER`, `PLITZI_CHECK_PASSWORD`); `verify` says when none is.
 - **`create` never decides for the person.** With nobody at the terminal it writes nothing and prints each choice as a
   question: ask the user, then run again with their answers as flags. Never guess them.
 - **Signing in happens in the browser** (`login`, `space use`, a first `plugin upload`): tell the person a tab is waiting.
 - **One space at a time** — the one `whoami --json` names; `plitzi space use` switches it.
+- **A report to Plitzi** — the person asks for a report, feedback, the bugs found or what cost time: `npx plitzi
+  feedback` (`--previous <link>` continues an earlier one). It reads the versions and `doctor` itself and writes the
+  page; fill it and publish it as its brief says, rather than a report of your own making.
 - **Read stdout, exit code and stderr apart.** The answer is on stdout (`--json`: one line); exit 1 means it did not do
   what was asked. A refusal says what to change: change it — the same refusal twice says to stop and ask.
 

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

@@ -19,7 +19,7 @@ What a project gives you, so you use it rather than rebuild it:
 | `npx plitzi element where <id\|class\|words>` | where the code writes an element: file:line and the call — edit it there, not the files around it. `npx plitzi element edit <id> --set content="…"` writes an attribute in it, `remove <id>` takes it out, `move <id> --before <id>` reorders it — each checked |
 | `check -- /path --width 1440,390` | whether a page is whole, in text: elements on screen, overflow, console, refused requests, failed flows, a binding its data lacks; `--state`, `--element <id>`: what it holds; `--ssr`: SSR misses; `--as <user>`; `--json` |
 | `npx plitzi page import <url>` | a page the user owns, as a start: tokens, its blocks' layout, lists as `data/*.json` — never the words. **Only when the user asks**; a site not on this machine needs `--account`: ask first |
-| `shot -- /path --width 390 --scheme dark` | a picture of one page — `--clip <element>` one element, `--frames 4` what moves, `--compare <url>` what differs from another site |
+| `shot -- /path --width 390 --scheme dark` | a picture of one page — `--clip <element>` one element, `--frames 4` what moves (`--from load`: as the page arrives), `--steps "click a; wait 300; frames 6 150; shot"` a whole interaction, `--compare <url>` what differs from another site, `--as <user>` signed in (said, when the page sent it elsewhere) |
 | `visual` | a browser asserts every element the space names is visible |
 | `typecheck`, `lint`, `format` | before calling a change done |