@woodsportal/hubspot-kit 1.0.30 → 1.0.31

package/dist/cli.js

@@ -4,9 +4,11 @@ import {
   WpHsError,
   isWpHsError,
   runCommand,
+  runCommandAsync,
   runNodeScript,
+  runNodeScriptAsync,
   runNodeScriptLongRunning
-} from "./chunk-GTTIJVAR.js";
+} from "./chunk-4GOJPOW3.js";
 
 // src/cli/program.ts
 import { readFileSync as readFileSync15 } from "fs";
@@ -248,34 +250,41 @@ import pc from "picocolors";
 function shouldUseColor() {
   if (process.env.NO_COLOR !== void 0) return false;
   if (process.env.CI === "true") return false;
-  return process.stdout.isTTY === true;
+  return process.stderr.isTTY === true;
 }
 function createLogger(options = {}) {
   const useColor = shouldUseColor();
   const { verbose = false, quiet = false, json = false } = options;
-  const emit = (level, message, meta) => {
+  const write = (line) => {
+    process.stderr.write(`${line}
+`);
+  };
+  const emit = (level, message) => {
     if (json) return;
     if (quiet && level !== "error" && level !== "warn") return;
     if (level === "debug" && !verbose) return;
     const prefix = level === "error" ? useColor ? pc.red("error") : "error" : level === "warn" ? useColor ? pc.yellow("warn") : "warn" : level === "debug" ? useColor ? pc.dim("debug") : "debug" : useColor ? pc.cyan("info") : "info";
-    const line = meta ? `${message} ${JSON.stringify(meta)}` : message;
-    const stream = level === "error" || level === "warn" ? process.stderr : process.stdout;
-    stream.write(`[${prefix}] ${line}
-`);
+    write(`[${prefix}] ${message}`);
   };
   return {
-    debug: (message, meta) => emit("debug", message, meta),
-    info: (message, meta) => emit("info", message, meta),
-    warn: (message, meta) => emit("warn", message, meta),
-    error: (message, meta) => emit("error", message, meta),
-    success: (message, meta) => {
-      if (json) return;
-      if (quiet) return;
+    debug: (message) => emit("debug", message),
+    info: (message) => emit("info", message),
+    warn: (message) => emit("warn", message),
+    error: (message) => emit("error", message),
+    success: (message) => {
+      if (json || quiet) return;
       const prefix = useColor ? pc.green("ok") : "ok";
-      process.stdout.write(`[${prefix}] ${message}
-`);
-      if (meta) process.stdout.write(`${JSON.stringify(meta)}
-`);
+      write(`[${prefix}] ${message}`);
+    },
+    step: (message) => {
+      if (json || quiet) return;
+      const bullet = useColor ? pc.cyan("\u2192") : "\u2192";
+      write(`${bullet} ${message}`);
+    },
+    stepDone: (message) => {
+      if (json || quiet) return;
+      const mark = useColor ? pc.green("\u2713") : "\u2713";
+      write(`  ${mark} ${message}`);
     },
     json: (payload) => {
       if (!json) return;
@@ -305,16 +314,73 @@ function isInteractiveCli(ctx) {
 }
 function shouldShowProgress(ctx, override) {
   if (override === false) return false;
+  if (ctx.global.verbose) return false;
   return isInteractiveCli(ctx);
 }
-async function runCliTasks(ctx, tasks2, options = {}) {
+function isVerboseStepLog(ctx) {
+  return ctx.global.verbose === true && !ctx.global.quiet && !ctx.global.json;
+}
+async function yieldForSpinnerPaint() {
+  await new Promise((resolve24) => {
+    setImmediate(resolve24);
+  });
+  await new Promise((resolve24) => {
+    setTimeout(resolve24, 48);
+  });
+}
+async function runCliTasks(ctx, tasks, options = {}) {
   if (!shouldShowProgress(ctx, options.progress)) {
-    for (const step of tasks2) {
-      await step.task();
+    const verbose = isVerboseStepLog(ctx);
+    if (verbose && options.intro) {
+      ctx.logger.info(options.intro);
     }
+    for (const step of tasks) {
+      if (verbose) {
+        ctx.logger.step(step.title);
+      }
+      try {
+        await step.task();
+        if (verbose) {
+          ctx.logger.stepDone(step.title);
+        }
+      } catch (error) {
+        if (verbose) {
+          ctx.logger.error(step.title);
+        }
+        throw error;
+      }
+    }
+    return;
+  }
+  if (tasks.length === 0) {
     return;
   }
-  await p.tasks(tasks2);
+  const spinner2 = p.spinner();
+  const firstTitle = tasks[0].title;
+  spinner2.start(options.intro ?? firstTitle);
+  await yieldForSpinnerPaint();
+  for (let i = 0; i < tasks.length; i++) {
+    const step = tasks[i];
+    if (i > 0) {
+      spinner2.start(step.title);
+      await yieldForSpinnerPaint();
+    } else if (options.intro) {
+      spinner2.message(firstTitle);
+      await yieldForSpinnerPaint();
+    }
+    try {
+      await step.task();
+      spinner2.stop(step.title);
+    } catch (error) {
+      spinner2.stop(pc2.red(step.title));
+      throw error;
+    }
+  }
+}
+function shouldQuietSubprocess(ctx, options = {}) {
+  if (ctx.global.verbose) return false;
+  if (options.quietSubprocess === true || options.quietVite === true) return true;
+  return shouldShowProgress(ctx, options.progress);
 }
 function printCommandDone(ctx, message) {
   if (isInteractiveCli(ctx)) {
@@ -533,6 +599,91 @@ function templateDevDependencies() {
   };
 }
 
+// src/lib/hubspot-fields-json.ts
+var HUBSPOT_MODULE_FIELD_TYPES = /* @__PURE__ */ new Set([
+  "boolean",
+  "choice",
+  "color",
+  "cta",
+  "date",
+  "datetime",
+  "email",
+  "embed",
+  "file",
+  "followup_email",
+  "font",
+  "form",
+  "group",
+  "html",
+  "hubdb_row",
+  "hubdb_table",
+  "icon",
+  "image",
+  "link",
+  "logo",
+  "meeting",
+  "menu",
+  "number",
+  "page",
+  "payment",
+  "richtext",
+  "salesforce_campaign",
+  "simple_menu",
+  "spacing",
+  "tag",
+  "text",
+  "url",
+  "video",
+  "workflow"
+]);
+function isFieldRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function validateFieldNode(node, path, issues) {
+  if (!isFieldRecord(node)) {
+    issues.push({ path, message: "expected a field object" });
+    return;
+  }
+  const type = node.type;
+  if (typeof type !== "string" || type.length === 0) {
+    issues.push({ path: `${path}.type`, message: "missing field type" });
+  } else if (!HUBSPOT_MODULE_FIELD_TYPES.has(type)) {
+    issues.push({
+      path: `${path}.type`,
+      message: type === "textarea" ? `'textarea' is not a HubSpot field type \u2014 use "type": "text" with "display": "textarea"` : `'${type}' is not a valid HubSpot field type`
+    });
+  }
+  if (type !== "group") {
+    const name = node.name;
+    if (typeof name !== "string" || name.trim().length === 0) {
+      issues.push({ path: `${path}.name`, message: "missing field name" });
+    }
+    const label = node.label;
+    if (typeof label !== "string" || label.trim().length === 0) {
+      issues.push({ path: `${path}.label`, message: "missing field label" });
+    }
+  } else {
+    const children = node.children;
+    if (!Array.isArray(children)) {
+      issues.push({ path: `${path}.children`, message: "group fields require a children array" });
+    } else {
+      children.forEach((child, index) => {
+        validateFieldNode(child, `${path}.children[${index}]`, issues);
+      });
+    }
+  }
+}
+function validateHubSpotFieldsJson(fields) {
+  if (!Array.isArray(fields)) {
+    return [{ path: "$", message: "fields.json must be a top-level array" }];
+  }
+  const issues = [];
+  fields.forEach((field, index) => {
+    validateFieldNode(field, `[${index}]`, issues);
+  });
+  return issues;
+}
+
 // src/lib/upload-only-module.ts
 import { existsSync as existsSync4 } from "fs";
 import { resolve as resolve5 } from "path";
@@ -656,6 +807,89 @@ function checkDevViteConfig(ctx) {
     severity: "error"
   };
 }
+function checkFieldsJson(ctx) {
+  if (isThemeProject(ctx.config)) return null;
+  const path = resolve6(ctx.projectRoot, "public/fields.json");
+  if (!existsSync5(path)) {
+    return {
+      name: "fields-json",
+      ok: false,
+      message: "public/fields.json missing",
+      remediation: "Copy fields.json from @woodsportal/hubspot-kit templates for your project type",
+      severity: "error"
+    };
+  }
+  try {
+    const fields = JSON.parse(readFileSync4(path, "utf8"));
+    const issues = validateHubSpotFieldsJson(fields);
+    if (issues.length === 0) {
+      return {
+        name: "fields-json",
+        ok: true,
+        message: "public/fields.json uses valid HubSpot field types",
+        severity: "error"
+      };
+    }
+    const preview = issues.slice(0, 3).map((issue) => `${issue.path}: ${issue.message}`).join("; ");
+    return {
+      name: "fields-json",
+      ok: false,
+      message: `public/fields.json has ${issues.length} issue(s) \u2014 ${preview}`,
+      remediation: 'Use HubSpot field types (e.g. "text" + "display": "textarea", not type "textarea"). See templates/module-hybrid-cdn/public/fields.json',
+      severity: "error"
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      name: "fields-json",
+      ok: false,
+      message: `public/fields.json is invalid JSON \u2014 ${message}`,
+      remediation: "Fix JSON syntax in public/fields.json",
+      severity: "error"
+    };
+  }
+}
+function checkHybridModuleHtml(ctx) {
+  if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return null;
+  const path = resolve6(ctx.projectRoot, "public/module.html");
+  if (!existsSync5(path)) {
+    return {
+      name: "module-html",
+      ok: false,
+      message: "public/module.html missing",
+      remediation: "Copy module.html from @woodsportal/hubspot-kit templates/module-hybrid-cdn",
+      severity: "error"
+    };
+  }
+  const html = readFileSync4(path, "utf8");
+  const needs = ["__PORTAL_CDN_BASE__", "require_js", "require_css", "hubSpotData", 'id="app"'];
+  const missing = needs.filter((token) => !html.includes(token));
+  const usesUndeclaredCdnFields = /module\.portal_(cdn_base_url|vendor_script|app_script|app_css)/.test(
+    html
+  );
+  const ok = missing.length === 0 && !usesUndeclaredCdnFields;
+  return {
+    name: "module-html-hybrid",
+    ok,
+    message: ok ? "public/module.html includes CDN require_js + hubSpotData" : usesUndeclaredCdnFields ? "public/module.html references undeclared module.portal_cdn_* fields" : `public/module.html missing hybrid CDN markers: ${missing.join(", ")}`,
+    remediation: ok ? void 0 : usesUndeclaredCdnFields ? "Use __PORTAL_CDN_BASE__ placeholders in module.html (see templates/module-hybrid-cdn) \u2014 CDN URLs are injected at build time" : "Update public/module.html from templates/module-hybrid-cdn (hybrid loads app from jsDelivr)",
+    severity: "error"
+  };
+}
+function checkCdnViteConfigs(ctx) {
+  if (isThemeProject(ctx.config) || !usesCdnPipeline(ctx.config)) return [];
+  return ["vite.config.cdn-vendor.mjs", "vite.config.cdn-app.mjs"].map((file) => {
+    const path = resolve6(ctx.projectRoot, file);
+    const ok = existsSync5(path);
+    return {
+      name: file.replace(/\./g, "-"),
+      ok,
+      message: ok ? `${file} present` : `${file} missing`,
+      remediation: ok ? void 0 : `Add ${file} that re-exports @woodsportal/hubspot-kit/vite/${file}`,
+      severity: "error"
+    };
+  });
+}
 function checkDevEntry(ctx) {
   const checks = [];
   const indexHtml = resolve6(ctx.projectRoot, "index.html");
@@ -825,7 +1059,9 @@ async function gatherDoctorChecks(ctx) {
         if (uploadOnlyNote) {
           checks.push(uploadOnlyNote);
         } else {
-          checks.push(checkDevViteConfig(ctx), ...checkDevEntry(ctx));
+          checks.push(checkDevViteConfig(ctx), ...checkCdnViteConfigs(ctx), ...checkDevEntry(ctx));
+          const hybridHtml = checkHybridModuleHtml(ctx);
+          if (hybridHtml) checks.push(hybridHtml);
           const viteCheck = checkViteInstalled(ctx);
           if (viteCheck) checks.push(viteCheck);
           checks.push(...checkModuleConfigUiDeps(ctx));
@@ -836,6 +1072,8 @@ async function gatherDoctorChecks(ctx) {
       title: "Checking woodscli.json and project layout",
       task: async () => {
         checks.push(...checkConfig(ctx), ...checkWphsWorkspace(ctx));
+        const fieldsCheck = checkFieldsJson(ctx);
+        if (fieldsCheck) checks.push(fieldsCheck);
         const adapterCheck = checkAdapter(ctx);
         if (adapterCheck) checks.push(adapterCheck);
       }
@@ -930,148 +1168,21 @@ async function runConfigValidate(ctx) {
 }
 
 // src/cli/commands/build.ts
-import { resolve as resolve7 } from "path";
-
-// src/lib/build-tier.ts
-var DEFAULT_BUILD_TIER = "dev";
-function parseBuildTier(value) {
-  if (value === "dev" || value === "stg" || value === "prod") return value;
-  return DEFAULT_BUILD_TIER;
-}
-
-// src/cli/commands/build.ts
-function tierToStgFlag(tier) {
-  return tier === "dev" || tier === "stg" ? ["--stg"] : [];
-}
-function buildTasks(ctx, options, run) {
-  const tier = options.tier ?? DEFAULT_BUILD_TIER;
-  const isTheme = isThemeProject(ctx.config);
-  const useCdn = usesCdnPipeline(ctx.config) && !isTheme;
-  const tasks2 = [];
-  if (isTheme && !options.cdnOnly) {
-    return tasks2;
-  }
-  if (ctx.config.projectType === "module-monolith" && !options.cdnOnly) {
-    tasks2.push({
-      title: `Building monolith module (${tier})`,
-      task: async () => {
-        run("run-vite-build.mjs", [
-          resolve7(ctx.projectRoot, "vite.config.monolith.mjs"),
-          ...tierToStgFlag(tier)
-        ]);
-        run("run-hubspot-module-postbuild.mjs");
-      }
-    });
-    return tasks2;
-  }
-  if (!options.hubspotOnly && useCdn) {
-    tasks2.push({
-      title: `Building CDN (${tier})`,
-      task: async () => {
-        if (options.cdnEsm) {
-          run("run-vite-build.mjs", [
-            resolve7(ctx.projectRoot, "vite.config.cdn-esm.mjs"),
-            ...tierToStgFlag(tier)
-          ]);
-        } else {
-          run("build-cdn.mjs", tierToStgFlag(tier));
-        }
-        run("generate-cdn-manifest.mjs");
-      }
-    });
-  }
-  if (!options.cdnOnly) {
-    tasks2.push({
-      title: `Building HubSpot module (${tier})`,
-      task: async () => {
-        run("run-vite-build.mjs", [
-          resolve7(ctx.projectRoot, "vite.config.hubspot.mjs"),
-          ...tierToStgFlag(tier)
-        ]);
-        run("run-hubspot-module-postbuild.mjs");
-      }
-    });
-  }
-  if (!options.cdnOnly && !options.hubspotOnly) {
-    tasks2.push({
-      title: "Running bundle checks",
-      task: async () => {
-        run("check-hubspot-bundle-size.mjs");
-        run("write-audit-artifacts.mjs");
-      }
-    });
-  }
-  return tasks2;
-}
-async function runBuild(ctx, options) {
-  const tier = options.tier ?? DEFAULT_BUILD_TIER;
-  const env = { ...process.env, WP_HS_PROJECT_ROOT: ctx.projectRoot };
-  const isTheme = isThemeProject(ctx.config);
-  const execOpts = {
-    cwd: ctx.projectRoot,
-    env,
-    logger: ctx.logger,
-    dryRun: ctx.global.dryRun
-  };
-  const run = (script, args = []) => {
-    runNodeScript(kitPath("scripts", script), args, execOpts);
-  };
-  try {
-    if (isTheme && !options.cdnOnly) {
-      if (ctx.global.json) {
-        ctx.logger.json({ command: "build", tier, ok: true, projectType: ctx.config.projectType });
-      } else if (!options.progress) {
-        ctx.logger.info("Theme project \u2014 skipping CDN/module.js build (use wp upload for theme assets)");
-        printCommandDone(ctx, "Theme build complete (no-op)");
-      } else {
-        await runCliTasks(
-          ctx,
-          [{ title: "Theme project (no module build)", task: async () => {
-          } }],
-          options
-        );
-        printCommandDone(ctx, "Theme build complete (no-op)");
-      }
-      return ExitCode.SUCCESS;
-    }
-    const tasks2 = buildTasks(ctx, options, run);
-    await runCliTasks(ctx, tasks2, options);
-    if (ctx.global.json) {
-      ctx.logger.json({
-        command: "build",
-        tier,
-        ok: true,
-        outDir: resolve7(ctx.projectRoot, ctx.config.module.outDir)
-      });
-    } else {
-      printCommandDone(ctx, "Build complete");
-    }
-    return ExitCode.SUCCESS;
-  } catch (error) {
-    throw new WpHsError(error instanceof Error ? error.message : String(error), {
-      exitCode: ExitCode.BUILD_FAILED
-    });
-  }
-}
-
-// src/cli/commands/dev.ts
-import { existsSync as existsSync7 } from "fs";
-import { resolve as resolve10 } from "path";
-import { spawn } from "child_process";
+import { resolve as resolve8 } from "path";
 
 // src/lib/cli-banner.ts
 import pc3 from "picocolors";
 
 // src/lib/kit-version.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { resolve as resolve8 } from "path";
+import { resolve as resolve7 } from "path";
 var cachedVersion = null;
 function readKitVersion() {
   if (cachedVersion) {
     return cachedVersion;
   }
   try {
-    const pkg = JSON.parse(readFileSync5(resolve8(getKitRoot(), "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync5(resolve7(getKitRoot(), "package.json"), "utf8"));
     cachedVersion = pkg.version ?? "0.0.0";
   } catch {
     cachedVersion = "0.0.0";
@@ -1179,6 +1290,153 @@ ${tips}
 `);
 }
 
+// src/lib/build-tier.ts
+var DEFAULT_BUILD_TIER = "dev";
+function parseBuildTier(value) {
+  if (value === "dev" || value === "stg" || value === "prod") return value;
+  return DEFAULT_BUILD_TIER;
+}
+
+// src/cli/commands/build.ts
+function tierToStgFlag(tier) {
+  return tier === "dev" || tier === "stg" ? ["--stg"] : [];
+}
+function buildTasks(ctx, options, run) {
+  const tier = options.tier ?? DEFAULT_BUILD_TIER;
+  const isTheme = isThemeProject(ctx.config);
+  const useCdn = usesCdnPipeline(ctx.config) && !isTheme;
+  const tasks = [];
+  if (isTheme && !options.cdnOnly) {
+    return tasks;
+  }
+  if (ctx.config.projectType === "module-monolith" && !options.cdnOnly) {
+    tasks.push({
+      title: `Building monolith module (${tier})`,
+      task: async () => {
+        await run("run-vite-build.mjs", [
+          resolve8(ctx.projectRoot, "vite.config.monolith.mjs"),
+          ...tierToStgFlag(tier)
+        ]);
+        await run("run-hubspot-module-postbuild.mjs");
+      }
+    });
+    return tasks;
+  }
+  if (!options.hubspotOnly && useCdn) {
+    tasks.push({
+      title: `Building CDN (${tier})`,
+      task: async () => {
+        if (options.cdnEsm) {
+          await run("run-vite-build.mjs", [
+            resolve8(ctx.projectRoot, "vite.config.cdn-esm.mjs"),
+            ...tierToStgFlag(tier)
+          ]);
+        } else {
+          await run("build-cdn.mjs", tierToStgFlag(tier));
+        }
+        await run("generate-cdn-manifest.mjs");
+      }
+    });
+  }
+  if (!options.cdnOnly) {
+    tasks.push({
+      title: `Building HubSpot module (${tier})`,
+      task: async () => {
+        await run("run-vite-build.mjs", [
+          resolve8(ctx.projectRoot, "vite.config.hubspot.mjs"),
+          ...tierToStgFlag(tier)
+        ]);
+        await run("run-hubspot-module-postbuild.mjs");
+      }
+    });
+  }
+  if (!options.cdnOnly && !options.hubspotOnly) {
+    tasks.push({
+      title: "Running bundle checks",
+      task: async () => {
+        await run("check-hubspot-bundle-size.mjs");
+        await run("write-audit-artifacts.mjs");
+      }
+    });
+  }
+  return tasks;
+}
+function buildIntroLine(ctx, tier, options) {
+  const isTheme = isThemeProject(ctx.config);
+  const useCdn = usesCdnPipeline(ctx.config) && !isTheme;
+  const parts = [];
+  if (!options.hubspotOnly && useCdn) parts.push("CDN");
+  if (!options.cdnOnly) parts.push("HubSpot module");
+  if (!options.cdnOnly && !options.hubspotOnly && !isTheme) parts.push("bundle checks");
+  if (parts.length === 0) return void 0;
+  return `${formatProjectLabel(ctx.config)} \xB7 ${parts.join(" + ")} (${tier})`;
+}
+async function runBuild(ctx, options) {
+  const tier = options.tier ?? DEFAULT_BUILD_TIER;
+  const quietSubprocess = shouldQuietSubprocess(ctx, options);
+  const env = {
+    ...process.env,
+    WP_HS_PROJECT_ROOT: ctx.projectRoot,
+    ...quietSubprocess ? { WP_HS_QUIET_BUILD: "1" } : {}
+  };
+  const isTheme = isThemeProject(ctx.config);
+  const execOpts = {
+    cwd: ctx.projectRoot,
+    projectRoot: ctx.projectRoot,
+    env,
+    logger: ctx.logger,
+    dryRun: ctx.global.dryRun,
+    streamOutput: ctx.global.verbose
+  };
+  const run = (script, args = []) => {
+    return runNodeScriptAsync(kitPath("scripts", script), args, execOpts);
+  };
+  try {
+    if (isTheme && !options.cdnOnly) {
+      if (ctx.global.json) {
+        ctx.logger.json({ command: "build", tier, ok: true, projectType: ctx.config.projectType });
+      } else if (!options.progress) {
+        ctx.logger.info("Theme project \u2014 skipping CDN/module.js build (use wp upload for theme assets)");
+        printCommandDone(ctx, "Theme build complete (no-op)");
+      } else {
+        await runCliTasks(
+          ctx,
+          [{ title: "Theme project (no module build)", task: async () => {
+          } }],
+          options
+        );
+        printCommandDone(ctx, "Theme build complete (no-op)");
+      }
+      return ExitCode.SUCCESS;
+    }
+    const tasks = buildTasks(ctx, options, run);
+    await runCliTasks(ctx, tasks, {
+      ...options,
+      intro: buildIntroLine(ctx, tier, options)
+    });
+    if (ctx.global.json) {
+      ctx.logger.json({
+        command: "build",
+        tier,
+        ok: true,
+        outDir: resolve8(ctx.projectRoot, ctx.config.module.outDir)
+      });
+    } else if (!options.quiet) {
+      printCommandDone(ctx, "Build complete");
+    }
+    return ExitCode.SUCCESS;
+  } catch (error) {
+    throw new WpHsError(error instanceof Error ? error.message : String(error), {
+      exitCode: ExitCode.BUILD_FAILED
+    });
+  }
+}
+
+// src/cli/commands/dev.ts
+import { existsSync as existsSync7 } from "fs";
+import { resolve as resolve10 } from "path";
+import { spawn } from "child_process";
+
 // src/vite/resolve-dev-config.ts
 import { existsSync as existsSync6 } from "fs";
 import { resolve as resolve9 } from "path";
@@ -1318,64 +1576,6 @@ ${toAppend}
 `);
 }
 
-// src/cli/commands/publish.ts
-async function runPublish(ctx, options) {
-  if (!usesCdnPipeline(ctx.config)) {
-    throw new WpHsError("This project does not use the CDN pipeline.", {
-      exitCode: ExitCode.USER_ERROR,
-      remediation: "module-monolith / cdn.mode none: use wp build && wp upload (or wp deploy without CDN publish)."
-    });
-  }
-  const tier = options.tier ?? DEFAULT_BUILD_TIER;
-  const env = mergeProjectEnv(ctx.projectRoot, {
-    ...process.env,
-    WP_HS_PROJECT_ROOT: ctx.projectRoot
-  });
-  const execOpts = {
-    cwd: ctx.projectRoot,
-    env,
-    logger: ctx.logger,
-    dryRun: ctx.global.dryRun || options.dryRun
-  };
-  const verifyFlag = tier === "prod" ? ["--prod"] : ["--stg"];
-  const publishArgs = options.dryRun ? ["--dry-run"] : [];
-  try {
-    await runCliTasks(
-      ctx,
-      [
-        {
-          title: `Verifying CDN API endpoint (${tier})`,
-          task: async () => {
-            if (options.dryRun) return;
-            runNodeScript(kitPath("scripts", "verify-cdn-api-endpoint.mjs"), verifyFlag, execOpts);
-          }
-        },
-        {
-          title: options.dryRun ? `CDN publish dry-run (${tier})` : `Publishing CDN (${tier})`,
-          task: async () => {
-            runNodeScript(kitPath("scripts", "publish-cdn-github.mjs"), publishArgs, execOpts);
-          }
-        }
-      ],
-      options
-    );
-    if (ctx.global.json) {
-      ctx.logger.json({ command: "publish", tier, dryRun: Boolean(options.dryRun), ok: true });
-    } else {
-      printCommandDone(
-        ctx,
-        options.dryRun ? "CDN publish dry-run complete" : "CDN publish complete"
-      );
-    }
-    return ExitCode.SUCCESS;
-  } catch (error) {
-    throw new WpHsError(error instanceof Error ? error.message : String(error), {
-      exitCode: ExitCode.PUBLISH_FAILED,
-      remediation: "Check CDN PAT, portal.cdn.json, and verify-cdn-api-endpoint."
-    });
-  }
-}
-
 // src/cli/commands/upload.ts
 import { resolve as resolve12 } from "path";
 async function uploadModuleOrTheme(ctx) {
@@ -1385,19 +1585,23 @@ async function uploadModuleOrTheme(ctx) {
       throw new WpHsError("theme block missing in woodscli.json", { exitCode: ExitCode.USER_ERROR });
     }
     const srcDir = resolve12(ctx.projectRoot, theme.srcDir);
-    runCommand("hs", ["cms", "upload", srcDir, theme.uploadPath], {
+    await runCommandAsync("hs", ["cms", "upload", srcDir, theme.uploadPath], {
       cwd: ctx.projectRoot,
+      projectRoot: ctx.projectRoot,
       logger: ctx.logger,
-      dryRun: ctx.global.dryRun
+      dryRun: ctx.global.dryRun,
+      streamOutput: ctx.global.verbose
     });
     return `Uploaded theme ${srcDir} \u2192 ${theme.uploadPath}`;
   }
   const outDir = resolve12(ctx.projectRoot, ctx.config.module.outDir);
   const uploadPath = ctx.config.module.uploadPath;
-  runCommand("hs", ["cms", "upload", outDir, uploadPath], {
+  await runCommandAsync("hs", ["cms", "upload", outDir, uploadPath], {
     cwd: ctx.projectRoot,
+    projectRoot: ctx.projectRoot,
     logger: ctx.logger,
-    dryRun: ctx.global.dryRun
+    dryRun: ctx.global.dryRun,
+    streamOutput: ctx.global.verbose
   });
   return `Uploaded ${outDir} \u2192 ${uploadPath}`;
 }
@@ -1434,73 +1638,110 @@ async function runUpload(ctx, options = {}) {
     }
     return ExitCode.SUCCESS;
   } catch (error) {
-    throw new WpHsError("HubSpot upload failed", {
-      exitCode: ExitCode.PUBLISH_FAILED,
-      cause: error,
-      remediation: "Run wp auth, then build the module before upload."
-    });
+    const detail = error instanceof WpHsError ? error.message : error instanceof Error ? error.message : String(error);
+    throw new WpHsError(
+      detail.includes("HubSpot upload failed") ? detail : `HubSpot upload failed
+${detail}`,
+      {
+        exitCode: ExitCode.PUBLISH_FAILED,
+        cause: error,
+        remediation: "Run wp auth, then build the module before upload."
+      }
+    );
   }
 }
 
 // src/cli/commands/deploy.ts
 async function runDeploy(ctx, options) {
-  ensureHubSpotCliSetup(ctx, "cms");
   const tier = options.tier ?? DEFAULT_BUILD_TIER;
-  const env = { ...process.env, WP_HS_PROJECT_ROOT: ctx.projectRoot };
+  const intro = `${formatProjectLabel(ctx.config)} \xB7 deploy (${tier})`;
+  const quietSubprocess = shouldQuietSubprocess(ctx, options);
+  const nested = {
+    progress: false,
+    quiet: true,
+    quietSubprocess: true
+  };
+  const baseEnv = mergeProjectEnv(ctx.projectRoot, {
+    ...process.env,
+    WP_HS_PROJECT_ROOT: ctx.projectRoot,
+    ...quietSubprocess ? { WP_HS_QUIET_BUILD: "1" } : {}
+  });
   const execOpts = {
     cwd: ctx.projectRoot,
-    env,
+    projectRoot: ctx.projectRoot,
+    env: baseEnv,
     logger: ctx.logger,
-    dryRun: ctx.global.dryRun
+    dryRun: ctx.global.dryRun,
+    streamOutput: ctx.global.verbose
   };
   const useCdn = usesCdnPipeline(ctx.config) && !isThemeProject(ctx.config);
-  const nested = { progress: false };
-  const tasks2 = [];
+  const verifyFlag = tier === "prod" ? ["--prod"] : ["--stg"];
+  const tasks = [
+    {
+      title: "Checking HubSpot CLI",
+      task: async () => {
+        ensureHubSpotCliSetup(ctx, "cms");
+      }
+    }
+  ];
   if (useCdn) {
-    tasks2.push({
+    tasks.push({
       title: `Building CDN (${tier})`,
       task: async () => {
         await runBuild(ctx, { tier, cdnOnly: true, ...nested });
       }
     });
     if (!options.skipPublish) {
-      tasks2.push({
-        title: `Publishing CDN (${tier})`,
+      tasks.push({
+        title: `Verifying CDN API (${tier})`,
+        task: async () => {
+          await runNodeScriptAsync(kitPath("scripts", "verify-cdn-api-endpoint.mjs"), verifyFlag, execOpts);
+        }
+      });
+      tasks.push({
+        title: `Publishing CDN to GitHub (${tier})`,
         task: async () => {
-          await runPublish(ctx, { tier, ...nested });
+          await runNodeScriptAsync(kitPath("scripts", "publish-cdn-github.mjs"), [], execOpts);
         }
       });
     }
-    tasks2.push({
+    tasks.push({
       title: `Building HubSpot module (${tier})`,
       task: async () => {
         await runBuild(ctx, { tier, hubspotOnly: true, ...nested });
       }
     });
   } else {
-    tasks2.push({
+    tasks.push({
       title: `Building module (${tier})`,
       task: async () => {
         await runBuild(ctx, { tier, ...nested });
       }
     });
   }
-  tasks2.push(
+  tasks.push(
     {
       title: "Running bundle checks",
       task: async () => {
-        runNodeScript(kitPath("scripts", "check-hubspot-bundle-size.mjs"), [], execOpts);
-        runNodeScript(kitPath("scripts", "write-audit-artifacts.mjs"), [], execOpts);
+        await runNodeScriptAsync(kitPath("scripts", "check-hubspot-bundle-size.mjs"), [], execOpts);
+        await runNodeScriptAsync(kitPath("scripts", "write-audit-artifacts.mjs"), [], execOpts);
       }
     },
     {
       title: "Uploading to HubSpot",
       task: async () => {
-        await runUpload(ctx, { tier, ...nested, quiet: true, skipPrereqCheck: true });
+        await runUpload(ctx, {
+          tier,
+          ...nested,
+          skipPrereqCheck: true
+        });
       }
     }
   );
-  await runCliTasks(ctx, tasks2, options);
+  await runCliTasks(ctx, tasks, {
+    ...options,
+    intro
+  });
   if (!ctx.global.json) {
     printCommandDone(
       ctx,
@@ -1510,6 +1751,71 @@ async function runDeploy(ctx, options) {
   return ExitCode.SUCCESS;
 }
 
+// src/cli/commands/publish.ts
+async function runPublish(ctx, options) {
+  if (!usesCdnPipeline(ctx.config)) {
+    throw new WpHsError("This project does not use the CDN pipeline.", {
+      exitCode: ExitCode.USER_ERROR,
+      remediation: "module-monolith / cdn.mode none: use wp build && wp upload (or wp deploy without CDN publish)."
+    });
+  }
+  const tier = options.tier ?? DEFAULT_BUILD_TIER;
+  const quietSubprocess = shouldQuietSubprocess(ctx, options);
+  const env = mergeProjectEnv(ctx.projectRoot, {
+    ...process.env,
+    WP_HS_PROJECT_ROOT: ctx.projectRoot,
+    ...quietSubprocess ? { WP_HS_QUIET_BUILD: "1" } : {}
+  });
+  const execOpts = {
+    cwd: ctx.projectRoot,
+    projectRoot: ctx.projectRoot,
+    env,
+    logger: ctx.logger,
+    dryRun: ctx.global.dryRun || options.dryRun,
+    streamOutput: ctx.global.verbose
+  };
+  const verifyFlag = tier === "prod" ? ["--prod"] : ["--stg"];
+  const publishArgs = options.dryRun ? ["--dry-run"] : [];
+  try {
+    await runCliTasks(
+      ctx,
+      [
+        {
+          title: `Verifying CDN API endpoint (${tier})`,
+          task: async () => {
+            if (options.dryRun) return;
+            await runNodeScriptAsync(kitPath("scripts", "verify-cdn-api-endpoint.mjs"), verifyFlag, execOpts);
+          }
+        },
+        {
+          title: options.dryRun ? `CDN publish dry-run (${tier})` : `Publishing CDN to GitHub (${tier})`,
+          task: async () => {
+            await runNodeScriptAsync(kitPath("scripts", "publish-cdn-github.mjs"), publishArgs, execOpts);
+          }
+        }
+      ],
+      {
+        ...options,
+        intro: options.quiet ? void 0 : `${formatProjectLabel(ctx.config)} \xB7 CDN publish (${tier})`
+      }
+    );
+    if (ctx.global.json) {
+      ctx.logger.json({ command: "publish", tier, dryRun: Boolean(options.dryRun), ok: true });
+    } else if (!options.quiet) {
+      printCommandDone(
+        ctx,
+        options.dryRun ? "CDN publish dry-run complete" : "CDN publish complete"
+      );
+    }
+    return ExitCode.SUCCESS;
+  } catch (error) {
+    throw new WpHsError(error instanceof Error ? error.message : String(error), {
+      exitCode: ExitCode.PUBLISH_FAILED,
+      remediation: "Check CDN PAT, portal.cdn.json, and verify-cdn-api-endpoint."
+    });
+  }
+}
+
 // src/cli/commands/audit.ts
 import { createHash } from "crypto";
 import { cpSync, existsSync as existsSync9, mkdirSync, readFileSync as readFileSync7, readdirSync, rmSync, statSync } from "fs";
@@ -2519,7 +2825,7 @@ async function runExamplesSmoke(ctx, options = {}) {
   const tier = options.tier ?? "static";
   const args = ["--tier", tier];
   if (options.scenario) args.push("--scenario", options.scenario);
-  const { runNodeScript: runNodeScript2 } = await import("./exec-U2OJATR3.js");
+  const { runNodeScript: runNodeScript2 } = await import("./exec-VY6BGWF3.js");
   runNodeScript2(kitPath("examples", "smoke", "run-matrix.mjs"), args, {
     cwd: ctx.projectRoot,
     logger: ctx.logger,
@@ -2910,7 +3216,7 @@ function buildContext(global) {
   return { projectRoot, config, logger, global };
 }
 function attachGlobals(command) {
-  command.option("--project <path>", "Project root (woodscli.json)").option("--ci", "Non-interactive CI mode", false).option("--json", "Machine-readable JSON output", false).option("--verbose", "Verbose logging", false).option("--quiet", "Errors only", false).option("--dry-run", "Print planned actions without executing", false).option("-y, --yes", "Assume yes (non-interactive)", false);
+  command.option("--project <path>", "Project root (woodscli.json)").option("--ci", "Non-interactive CI mode", false).option("--json", "Machine-readable JSON output", false).option("--verbose", "Step-by-step logs and child-process output (disables spinners)", false).option("--quiet", "Errors only", false).option("--dry-run", "Print planned actions without executing", false).option("-y, --yes", "Assume yes (non-interactive)", false);
 }
 async function handle(fn) {
   try {
@@ -3090,7 +3396,7 @@ function createProgram() {
   program2.command("auth").description("Authenticate HubSpot CLI (hs auth)").action(async () => {
     const global = program2.opts();
     const ctx = buildContext(global);
-    const { runCommand: runCommand2 } = await import("./exec-U2OJATR3.js");
+    const { runCommand: runCommand2 } = await import("./exec-VY6BGWF3.js");
     runCommand2("hs", ["auth"], {
       cwd: ctx.projectRoot,
       logger: ctx.logger,