@lovinka/vitrinka 1.1.1 → 1.5.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 (28) hide show
  1. package/README.md +28 -0
  2. package/dist/cli.js +524 -10
  3. package/dist/cli.js.map +1 -1
  4. package/dist/lib/token.js +26 -0
  5. package/dist/lib/token.js.map +1 -1
  6. package/dist/mcp.js +451 -19
  7. package/dist/mcp.js.map +1 -1
  8. package/package.json +6 -4
  9. package/skills/artifact/SKILL.md +82 -0
  10. package/skills/brainstorming/SKILL.md +107 -0
  11. package/skills/screenshot/SKILL.md +70 -0
  12. package/skills/screenshot/gallery.mjs +6 -0
  13. package/skills/vitrinka/cli.ts +39 -0
  14. package/skills/vitrinka/commands/listen.md +10 -0
  15. package/skills/vitrinka/listen/SKILL.md +193 -0
  16. package/skills/vitrinka/tests/_helpers.ts +108 -0
  17. package/skills/vitrinka/tests/derive.test.ts +118 -0
  18. package/skills/vitrinka/tests/dx.test.ts +264 -0
  19. package/skills/vitrinka/tests/embed.test.ts +96 -0
  20. package/skills/vitrinka/tests/index.test.ts +250 -0
  21. package/skills/vitrinka/tests/install-name.test.ts +111 -0
  22. package/skills/vitrinka/tests/manifest.test.ts +98 -0
  23. package/skills/vitrinka/tests/operator.test.ts +119 -0
  24. package/skills/vitrinka/tests/push.test.ts +115 -0
  25. package/skills/vitrinka/tests/scaffold.test.ts +173 -0
  26. package/skills/vitrinka/tests/shim.test.ts +28 -0
  27. package/skills/vitrinka/tests/snap.test.ts +175 -0
  28. package/skills/vitrinka/tests/watch.test.ts +204 -0
package/README.md CHANGED
@@ -21,10 +21,38 @@ becomes one HTTPS request against the deployed vitrinka Go server.
21
21
  # both bins on PATH
22
22
  npm i -g @lovinka/vitrinka
23
23
 
24
+ # one-command machine setup: Claude skills bundle (vitrinka + listen, screenshot,
25
+ # artifact, brainstorming) + the /vitrinka:listen command stub + PATH shim +
26
+ # shell completion + Claude Code UI wiring ([Y/n]-gated) — no repo checkout needed.
27
+ # (npm install itself has NO side effects; skills land only via this command,
28
+ # `vitrinka install-skills`, or the repo's install.sh.)
29
+ vitrinka install
30
+
24
31
  # register the MCP server (Claude Code, user scope) — no global install needed
25
32
  claude mcp add --scope user vitrinka -- npx -y --package=@lovinka/vitrinka vitrinka-mcp
26
33
  ```
27
34
 
35
+ `vitrinka install` also offers (interactive `[Y/n]`, or `--claude`/`--no-claude`)
36
+ to wire the **Claude Code UI** — re-runnable standalone as `vitrinka install-claude`:
37
+
38
+ - **Footer badge** — a `footerLinksRegexes` entry in `~/.claude/settings.json`
39
+ renders a clickable **🧷 board** badge in Claude Code's footer whenever a
40
+ `/boards/` URL appears in the conversation (clickable in every terminal;
41
+ needs Claude Code ≥ 2.1.176).
42
+ - **Statusline segment** — `~/.claude/vitrinka-statusline.sh` wraps your existing
43
+ statusline command (recorded on its `VITRINKA_ORIG=` line) and appends a
44
+ `🧷 <board-url>` segment when the session's `.screenshots/.vitrinka` descriptor
45
+ exists (plain-text URL — Claude Code strips OSC 8 from statusline output, and
46
+ terminals cmd+click-linkify visible URLs themselves); with no statusline configured it renders a minimal
47
+ `dir │ branch │ 🧷 board │ model` line itself. Needs `jq`; degrades to
48
+ pass-through without it, and never double-renders a board segment your own
49
+ statusline already prints.
50
+
51
+ Both steps are idempotent — re-runs detect the wiring and no-op. To remove:
52
+ delete `~/.claude/vitrinka-statusline.sh`, restore `statusLine.command` in
53
+ `~/.claude/settings.json` to the `VITRINKA_ORIG` value (or drop the key), and
54
+ remove the `footerLinksRegexes` entry whose pattern contains `/boards/`.
55
+
28
56
  For Claude Desktop or any other MCP client, add the equivalent entry by hand:
29
57
 
30
58
  ```json