vibespot 0.4.0 → 0.4.3

package/README.md

@@ -6,6 +6,10 @@ AI-powered HubSpot CMS landing page builder — vibe coding & React converter.
   ≋ vibeSpot — Build HubSpot Landing Pages with AI
 ```
 
+> **Before you start:** vibeSpot's in-app setup will walk you through configuration, but for the smoothest experience, install your preferred AI engine and the HubSpot CLI **before** running vibeSpot. The onboarding flow is still being refined — having these tools ready avoids extra back-and-forth.
+>
+> **Requirements:** Node.js 18+, HubSpot CLI 8+ (`npm install -g @hubspot/cli@latest`). HubSpot CLI versions below 8 are **not supported** — deprecated commands like `hs create website-theme` were removed in v8.
+
 ## What It Does
 
 vibeSpot lets you build HubSpot landing pages by chatting with AI. Describe what you want, and it generates native HubSpot CMS modules — fully editable in the HubSpot page editor. No coding knowledge required.
@@ -115,4 +119,4 @@ Settings are saved in `~/.vibespot/config.json`:
 
 ## License
 
-MIT
+Personal use only — see [LICENSE](LICENSE) for details. Commercial licensing available on request.

package/assets/conversion-guide.md

@@ -222,7 +222,7 @@ This is where React props become HubSpot-editable fields. Every piece of text, i
 | `"name": "name"` | `missing field name` | `name` is reserved — use `item_name`, `link_label`, etc. |
 | `{% module %}` in module.html | `'module' is disabled in this context` | Cannot nest modules — use `{% form %}` for forms |
 | `{{ now() }}` | `Could not resolve function 'now'` | Use `{{ local_dt }}` for current date/time |
-| Partially uploaded module | Re-upload still fails | Run `hs remove <path>` first, then re-upload |
+| Partially uploaded module | Re-upload still fails | Run `hs cms remove <path>` first, then re-upload |
 | SVG in text field | SVG renders as escaped text | SVG markup in text fields is auto-escaped by HubL |
 
 ### Image Fields
@@ -618,7 +618,7 @@ For backgrounds with transparency (e.g., glassmorphism cards):
 
 **Cause**: Partially uploaded module with invalid `fields.json` is cached on HubSpot.
 
-**Fix**: `hs remove my-theme/modules/MyModule.module` then re-upload.
+**Fix**: `hs cms remove my-theme/modules/MyModule.module` then re-upload.
 
 ### 5. Repeater Group Content Missing
 

package/dist/index.js

@@ -162,13 +162,14 @@ function saveConfig(config) {
 }
 
 // src/utils/detect.ts
+var whichCmd = process.platform === "win32" ? "where" : "which";
 function detectNode() {
   const result = run("node --version");
   return {
     name: "Node.js",
     found: result.success,
     version: result.stdout.replace(/^v/, ""),
-    path: run("which node").stdout
+    path: run(`${whichCmd} node`).stdout
   };
 }
 function detectGit() {
@@ -177,7 +178,7 @@ function detectGit() {
     name: "Git",
     found: result.success,
     version: result.stdout.replace("git version ", ""),
-    path: run("which git").stdout
+    path: run(`${whichCmd} git`).stdout
   };
 }
 function detectHubSpotCLI() {
@@ -186,7 +187,7 @@ function detectHubSpotCLI() {
     name: "HubSpot CLI",
     found: result.success,
     version: result.stdout,
-    path: run("which hs").stdout
+    path: run(`${whichCmd} hs`).stdout
   };
 }
 function detectClaudeCode() {
@@ -214,7 +215,7 @@ function detectClaudeCode() {
     name: "Claude Code",
     found: true,
     version: result.stdout,
-    path: run("which claude").stdout,
+    path: run(`${whichCmd} claude`).stdout,
     authenticated,
     authDetail
   };
@@ -300,7 +301,7 @@ function detectGeminiCLI() {
     name: "Gemini CLI",
     found: true,
     version: result.stdout,
-    path: run("which gemini").stdout,
+    path: run(`${whichCmd} gemini`).stdout,
     authenticated,
     authDetail: authenticated ? "Authenticated" : "Run `gemini` to sign in with Google"
   };
@@ -326,7 +327,7 @@ function detectCodexCLI() {
     name: "OpenAI Codex CLI",
     found: true,
     version: result.stdout,
-    path: run("which codex").stdout,
+    path: run(`${whichCmd} codex`).stdout,
     authenticated,
     authDetail: detail
   };
@@ -337,7 +338,7 @@ function detectGitHubCLI() {
     name: "GitHub CLI",
     found: result.success,
     version: result.stdout.split("\n")[0]?.replace("gh version ", "").split(" ")[0] || "",
-    path: run("which gh").stdout
+    path: run(`${whichCmd} gh`).stdout
   };
 }
 function detectGitHubAuth() {
@@ -363,6 +364,10 @@ function nodeVersionOk(version) {
   const major = parseInt(version.split(".")[0], 10);
   return major >= 18;
 }
+function hsCliVersionOk(version) {
+  const major = parseInt(version.split(".")[0], 10);
+  return !isNaN(major) && major >= 8;
+}
 function detectEnvironment() {
   const config = loadConfig();
   const node = detectNode();
@@ -960,13 +965,13 @@ async function setupTheme() {
     themePath = join5(workspaceDir, themeName);
     const s = await spinner2();
     s.start("Fetching theme from HubSpot...");
-    const result = run(`hs fetch "${themeName}" "${themePath}"`);
+    const result = run(`hs cms fetch "${themeName}" "${themePath}"`);
     if (!result.success) {
       s.stop("Fetch failed");
       logError(
         `Could not fetch theme "${themeName}". Check the name in HubSpot Design Manager.`
       );
-      logError("Run `hs list /` to see available themes.");
+      logError("Run `hs cms list /` to see available themes.");
       process.exit(1);
     }
     s.stop(`Theme fetched: ${theme.dim(themePath)}`);
@@ -980,7 +985,7 @@ async function setupTheme() {
     const s = await spinner2();
     s.start("Creating theme from boilerplate...");
     const cwdBefore = new Set(readdirSync3(process.cwd()));
-    const result = run(`hs create website-theme "${themeName}"`);
+    const result = run(`hs cms create website-theme "${themeName}"`);
     let createdAt = join5(process.cwd(), themeName);
     if (!fileExists(createdAt)) {
       const cwdAfter = readdirSync3(process.cwd());
@@ -994,7 +999,7 @@ async function setupTheme() {
       const errMsg = result.stderr || result.stdout || "";
       logError(
         `Could not create theme "${themeName}".` + (errMsg ? `
-${errMsg.slice(0, 300)}` : "") + "\nTry running manually: hs create website-theme my-theme"
+${errMsg.slice(0, 300)}` : "") + "\nTry running manually: hs cms create website-theme my-theme"
       );
       process.exit(1);
     }
@@ -2996,6 +3001,10 @@ async function doctorCommand() {
   if (!hs.found) {
     logWarn("HubSpot CLI \u2014 not installed (only needed for deployment)");
     log2("  Install: npm install -g @hubspot/cli");
+  } else if (!hsCliVersionOk(hs.version)) {
+    logWarn(`HubSpot CLI v${hs.version} \u2014 too old (need v8+)`);
+    log2("  Update: npm install -g @hubspot/cli@latest");
+    issues++;
   } else {
     logSuccess(`HubSpot CLI v${hs.version}`);
     const auth = detectHubSpotAuth();
@@ -5438,7 +5447,7 @@ function handleSetupCreateRoute(req, res) {
         rmSync5(themePath, { recursive: true, force: true });
       }
       const cwdBefore = new Set(readdirSync11(process.cwd()));
-      execSync4(`hs create website-theme "${themeName}"`, {
+      execSync4(`hs cms create website-theme "${themeName}"`, {
         encoding: "utf-8",
         stdio: "pipe"
       });
@@ -5479,7 +5488,7 @@ function handleSetupFetchRoute(req, res) {
       }
       const themePath = join15(WORKSPACE_DIR, name);
       ensureDir(WORKSPACE_DIR);
-      execSync4(`hs fetch "${name}" "${themePath}"`, {
+      execSync4(`hs cms fetch "${name}" "${themePath}"`, {
         encoding: "utf-8",
         stdio: "pipe"
       });