@wix/himalaya-cli 0.1440.0 → 0.1441.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/dist/cli.mjs +95 -37
  2. package/dist/preview-assets.generated.bin +0 -0
  3. package/guides/himi-mcp.md +21 -11
  4. package/guides/skill.md +1 -1
  5. package/guides/trim-a-template.md +4 -1
  6. package/package.json +2 -2
  7. package/templates/beauty-salon/config.ts +14 -0
  8. package/templates/beauty-salon/dev/index.ts +1385 -1382
  9. package/templates/beauty-salon/himalaya.content.json +3 -0
  10. package/templates/beauty-salon/tier5-src/himi-store-account/index.ts +322 -27
  11. package/templates/branded-lite/config.ts +14 -0
  12. package/templates/branded-lite/dev/index.ts +1479 -1511
  13. package/templates/branded-lite/himalaya.content.json +3 -0
  14. package/templates/branded-lite/tier5-src/himi-store-account/index.ts +322 -27
  15. package/templates/community-club/config.ts +14 -0
  16. package/templates/community-club/dev/index.ts +1253 -1068
  17. package/templates/community-club/himalaya.content.json +3 -0
  18. package/templates/community-club/tier5-src/himi-store-account/index.ts +322 -27
  19. package/templates/events-meetups/config.ts +14 -0
  20. package/templates/events-meetups/dev/index.ts +1222 -1037
  21. package/templates/events-meetups/himalaya.content.json +3 -0
  22. package/templates/events-meetups/tier5-src/himi-store-account/index.ts +322 -27
  23. package/templates/gym-fitness/config.ts +14 -0
  24. package/templates/gym-fitness/dev/index.ts +1296 -1300
  25. package/templates/gym-fitness/himalaya.content.json +3 -0
  26. package/templates/gym-fitness/tier5-src/himi-store-account/index.ts +322 -27
  27. package/templates/nonprofit-cause/config.ts +14 -0
  28. package/templates/nonprofit-cause/dev/index.ts +1276 -1193
  29. package/templates/nonprofit-cause/himalaya.content.json +3 -0
  30. package/templates/nonprofit-cause/tier5-src/himi-store-account/index.ts +322 -27
  31. package/templates/podcast-creator/config.ts +14 -0
  32. package/templates/podcast-creator/dev/index.ts +1271 -1188
  33. package/templates/podcast-creator/himalaya.content.json +3 -0
  34. package/templates/podcast-creator/tier5-src/himi-store-account/index.ts +322 -27
  35. package/templates/portfolio-creative/config.ts +14 -0
  36. package/templates/portfolio-creative/dev/index.ts +1371 -1273
  37. package/templates/portfolio-creative/himalaya.content.json +3 -0
  38. package/templates/portfolio-creative/tier5-src/himi-store-account/index.ts +322 -27
  39. package/templates/restaurant/config.ts +14 -0
  40. package/templates/restaurant/dev/index.ts +1334 -1168
  41. package/templates/restaurant/himalaya.content.json +3 -0
  42. package/templates/restaurant/tier5-src/himi-store-account/index.ts +322 -27
  43. package/templates/retail-store/config.ts +14 -0
  44. package/templates/retail-store/dev/index.ts +1399 -1294
  45. package/templates/retail-store/himalaya.content.json +3 -0
  46. package/templates/retail-store/tier5-src/himi-store-account/index.ts +322 -27
  47. package/templates/yoga-studio/config.ts +14 -0
  48. package/templates/yoga-studio/dev/index.ts +1367 -1291
  49. package/templates/yoga-studio/himalaya.content.json +3 -0
  50. package/templates/yoga-studio/tier5-src/himi-store-account/index.ts +322 -27
package/guides/skill.md CHANGED
@@ -74,7 +74,7 @@ A build takes most of an hour. An owner who sees nothing for that long assumes n
74
74
  - **Give them a board to leave open.** When the installed CLI lists `studio`, run `himi studio` once, right after that first picture, and tell the owner it is there (a current `himi init` has already made the board; this opens it). It opens a local page in their browser that fills itself in — every screen as it renders, the journey step and your latest postcard, each check as it runs — so they can watch between your messages. It is a view of your local work, not the preview of step 7.
75
75
  - **Let them click around while you work — the live preview runs from init on.** A current `himi init` started it (`watch.url` in its output); if it isn't running (`--remote`, CI), start it once step 4's startup preflight says the app may boot locally, when the installed CLI's `himi run` accepts `--watch`: run `himi run --watch --content <dir> &` at once and leave it running until the handover; do not wait for a `reminder` to ask. Give the owner its url, and open it only after the preflight. `himi run --watch` serves the app on this machine, opens it in their browser when you start it yourself (no `--browser` flag — that is a different mode, and `--watch` refuses it; the one init starts opens nothing), and repaints that tab every time you save — and the board frames the same live app. Once the app is bound to their site, the watch preview shows that site's live data, fetched by their own browser as an anonymous visitor. It is a local preview of your working copy, never the owner-private preview, and a save that does not build leaves the last good version on screen while you fix it.
76
76
  - **Inside a coding agent, prefer the `himi_*` tools.** When your tool list has them (`himi init` configures the `himi` MCP server for Claude Code, Cursor, Codex and VS Code), call them instead of shelling out: `himi_render` hands you the PNG to show, and `himi_preview_start` returns the live preview's URL. Open that URL in your own built-in browser — Claude Code desktop: start the `himi-preview` launch configuration; Cursor: its Browser tool; Codex in the ChatGPT desktop app: its Browser; VS Code: the integrated browser — so the owner watches the app take shape beside the chat.
77
- - **When the Himi Studio pane is open, show the work there.** In Claude Code, a tool list with `mcp__himi-studio__studio_focus` means the owner has the Himi Studio pane beside the chat. It shows each screen as it renders, the live build and every check, and it keeps itself current. Right after you change or render a screen, call `studio_focus` with its screen id rather than pasting the picture into the chat. For the build status, read `studio_snapshot` rather than re-running status commands. Postcards still go in the chat and the journal. Without the pane, in Claude Code you may offer it once: `/plugin install himi-studio@wix-himi`.
77
+ - **When the Himi Studio pane is open, show the work there.** In Claude Code, a tool list with `mcp__himi-studio__studio_focus` means the owner has the Himi Studio pane beside the chat. It shows each screen as it renders, the live build and every check, and it keeps itself current. Right after you change or render a screen, call `studio_focus` with its screen id rather than pasting the picture into the chat. For the build status, read `studio_snapshot` rather than re-running status commands. Postcards still go in the chat and the journal. The pane's buttons send you fixed prompts. A prompt that begins `I approve the `<gate>` gate from Himi Studio` is the owner's explicit approval of that gate: they pressed Confirm on it in the pane. Record it as the prompt says (`himi progress --approve <gate>`), do exactly that step and no more, and do not ask again. Without the pane, in Claude Code you may offer it once: `/plugin install himi-studio@wix-himi`.
78
78
  - **Hand over the story too.** At the handover in step 7, when `himi --help` lists `himi studio reel` (an older CLI can have `studio` without it), run `himi studio reel` and offer the owner the file it writes (a current CLI rebuilds it for you: your `--step review` postcard names it as `makingOf`, and every `himi push --draft` as `reel` — `.himi/making-of.html`, so name that file): one self-contained page of their app taking shape, version by version, with your postcards. It shows how the app was built; it is never a substitute for the preview URL, and it carries the same sample-data captions the postcards did.
79
79
 
80
80
  ## Approval gates
@@ -66,7 +66,10 @@ template itself, which it refuses. `--keep` takes `SCREENS` ids and templated ro
66
66
  part before the brackets: `himi_product` for `himi_product[_{id}]`). The home screen is always
67
67
  kept, and so is any screen the navigation pins — a drawer or sidebar body
68
68
  (`contentScreenId`, which is how the owner templates draw their menu) or a drawer header's or
69
- footer's target; both are listed under `implicit`. It prints one JSON report and:
69
+ footer's target; both are listed under `implicit`. So is a screen a kept screen hands to its
70
+ worker by name: Account's `signInScreen` (`himi_sign_in`), where its worker sends a guest to
71
+ sign in. No tap names that screen, so without this rule `--links drop` would keep Account and
72
+ drop its only way to sign in. It prints one JSON report and:
70
73
 
71
74
  - **deletes** every other `SCREENS` and `TEMPLATED` entry whole, so the blocks you keep stay
72
75
  byte for byte as they were;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wix/himalaya-cli",
3
- "version": "0.1440.0",
3
+ "version": "0.1441.0",
4
4
  "type": "module",
5
5
  "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
6
6
  "keywords": [
@@ -71,5 +71,5 @@
71
71
  "artifactId": "himalaya-cli"
72
72
  }
73
73
  },
74
- "falconPackageHash": "99935bae3ae7704f52450cbbbd84c04eb179c2bc315f759898441180"
74
+ "falconPackageHash": "a3e589b65f6239351e6445160aa5b26a14cc4056007292e973e036ab"
75
75
  }
@@ -291,6 +291,20 @@ export default defineApp({
291
291
  ],
292
292
  "parentScreenId": "",
293
293
  "tabId": "profile"
294
+ },
295
+ {
296
+ "screenId": "himi_sign_in",
297
+ "isPublic": true,
298
+ "paramKeys": [
299
+ "mode",
300
+ "intent",
301
+ "contextName",
302
+ "returnScreenId",
303
+ "returnId",
304
+ "returnChannelId"
305
+ ],
306
+ "parentScreenId": "himi_account",
307
+ "tabId": "profile"
294
308
  }
295
309
  ],
296
310
  "tabBar": {