vibespot 1.6.5 → 1.8.0

package/README.md

@@ -37,11 +37,21 @@ Requires Node.js 18+. No HubSpot CLI install needed — vibeSpot talks to HubSpo
 
 Type what you want on the left. Watch real HubSpot modules render on the right — Split, Plan, and Code views, all live. A four-stage agentic pipeline (Intent → Architect → Module Developer → Quality Check) generates modules in parallel and auto-fixes common HubL issues before they reach you.
 
-### 2. Deliberate before you generate — Plan mode
+### 2. Check the work before the expensive build — Checkpoints
 
-<img src="assets/readme/02-plan-mode.png" alt="Plan mode: AI asks elicitation questions and builds a markdown plan" width="100%">
+<p align="center">
+  <img src="assets/readme/02-checkpoints.png" alt="Design checkpoint card: palette, type specimen, sample hero, and the estimated build cost — with approve, steer, skip, and cancel actions" width="360">
+</p>
+
+By default vibeSpot doesn't run the whole pipeline in one blind shot. It pauses at cheap seams and shows you a card before spending tokens on the parallel module build:
 
-Vague brief? Toggle Plan mode. vibeSpot asks the questions a senior designer would — audience, primary CTA, sections, voice — and builds a markdown plan in the right pane. Generation is hard-gated until you approve. Pre-canned templates skip the cold start for common page types.
+- **Brand intake** — when your theme has no style system yet, vibeSpot asks first: bring your brand (colors, code, an existing theme, a live site, your voice) or let it choose for you.
+- **Design checkpoint** — palette swatches, a type specimen, and one sample hero, rendered straight from the design tokens. No extra model call.
+- **Structure checkpoint** — the planned modules as an editable outline. Reorder, rename, cut, or add sections before a single module is built.
+
+Each card shows the estimated cost of the build it gates. **Approve** to continue, **steer** with a note to redo just that stage, **skip** to build now, or **cancel** to write nothing. In a hurry? The one-tap **one-shot** button next to send skips every gate — the old one-call behaviour.
+
+**Plan mode** is the heaviest checkpoint variant. Toggle it on for a vague brief and vibeSpot asks the questions a senior designer would — audience, primary CTA, sections, voice — and builds a markdown plan in the right pane. Generation is hard-gated until you approve. Pre-canned templates skip the cold start for common page types.
 
 ### 3. Translate Figma 1:1
 
@@ -103,6 +113,16 @@ Every model produced valid, complete pages — 100% validator pass and section c
 3. **Run it** — `npx vibespot`. The browser opens.
 4. **Connect HubSpot** — Settings → HubSpot → add a Personal Access Key. vibeSpot connects via the HubSpot API directly. No CLI install.
 
+### Access from another device (LAN / Tailscale)
+
+For security, vibeSpot binds to `127.0.0.1` only — other devices can't reach it out of the box. To use it from an iPad or another machine:
+
+```bash
+VIBESPOT_HOST=0.0.0.0 npx vibespot
+```
+
+The terminal prints a URL containing a one-time access token (`?token=...`). Open **that exact URL** on the other device — it's the auth secret, and it's exchanged for a session cookie on first load. Pin a stable token with `VIBESPOT_AUTH_TOKEN`, e.g. `openssl rand -hex 24`. Behind `tailscale serve` (which keeps the loopback bind), set `VIBESPOT_AUTH_TOKEN` and open the tokenized URL the same way.
+
 ## Commands
 
 Most users only need `npx vibespot`. The web UI handles everything else.
@@ -118,6 +138,7 @@ vibespot doctor       # Diagnose environment issues
 
 ## What's new in v1.3
 
+- **Release highlights on upgrade** — open the builder on a new version and a dialog shows what changed, with a link to the full changelog. Dismiss it and it stays gone until the next release.
 - **Email template generation** — full pipeline for HubSpot emails: table layouts, MSO/VML compatibility, email validator auto-fix, 3 email starters.
 - **Multi-page sites** — single prompt → full site with shared header/footer, page tree, navigation validation.
 - **Inline WYSIWYG editing** — edit text, images, and links directly in the live preview with per-section visual controls.

package/assets/whats-new.json

@@ -0,0 +1,27 @@
+{
+  "version": "1.8.0",
+  "date": "2026-07-06",
+  "changelogUrl": "https://github.com/borismichel/vibespot/blob/main/CHANGELOG.md",
+  "highlights": [
+    {
+      "title": "Dead Postgres storage backend removed",
+      "body": "the never-wired pg adapter, its deps, and the unused compose Postgres service are gone; Docker/compose docs now consistently describe filesystem-only persistence ; non-runtime screenshot/readme image…"
+    },
+    {
+      "title": "server.ts split into router + WebSocket modules",
+      "body": "internal refactor, no behavior change. The ~78-case /api/ switch is now a declarative route table + dispatcher (src/server/routes/api-router.ts, exact paths with per-verb 405s plus the two pattern…"
+    },
+    {
+      "title": "Consolidated drifting duplication",
+      "body": "four byte-duplicated code paths that had already produced real drift bugs are collapsed onto single implementations:"
+    },
+    {
+      "title": "Live preview no longer fails silently after an in-place upgrade",
+      "body": "when /api/preview-origin can't be resolved (a stale cached ui/preview.js hitting a moved route after an upgrade, the preview-origin process not running, or its port blocked), refreshPreview used to…"
+    },
+    {
+      "title": "Editor URL reload no longer discards inline field edits",
+      "body": "reloading the tab (or navigating to #/app/<theme>) hits POST /api/setup/open, which always rebuilt a fresh session from the theme folder on disk."
+    }
+  ]
+}