htmlhost-cli 2.8.0 → 2.9.0

package/README.md

@@ -1,7 +1,11 @@
 # htmlhost
 
+[![npm](https://img.shields.io/npm/v/htmlhost-cli)](https://www.npmjs.com/package/htmlhost-cli) [![MCP compatible](https://img.shields.io/badge/MCP-compatible-8A2BE2)](https://htmlhost.co/docs/mcp)
+
 Deploy HTML projects from the terminal. [htmlhost.co](https://htmlhost.co)
 
+Want your AI assistant to deploy for you? The [htmlhost MCP server](https://www.npmjs.com/package/htmlhost-mcp) uses the same login as this CLI and works with Claude, Cursor, VS Code, Windsurf and Codex. [Setup guide →](https://htmlhost.co/docs/mcp)
+
 ## Install
 
 ```bash
@@ -162,6 +166,18 @@ Open a deployed site in the default browser.
 ### `htmlhost delete <slug>`
 Delete a site. Use `--force` to skip confirmation.
 
+### `htmlhost versions [slug]`
+List a site's published versions, newest first: when, who, how it was published, and what changed. Every deploy and every save in the web editor is a version. Without a slug, uses the linked site. Add `--json` for machine-readable output.
+
+### `htmlhost rollback [slug] [version]`
+Make an earlier version live again. Without a version number, goes back to the version before the live one. The old version is published again as a new version, so you can switch back the same way. Needs the site owner to be on Pro. Use `--force` to skip confirmation, then `htmlhost pull` so your local files match.
+
+```bash
+htmlhost versions            # linked site
+htmlhost rollback            # back one version
+htmlhost rollback my-site 12 # make v12 live again
+```
+
 ### `htmlhost whoami`
 Show current authenticated user and plan.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlhost-cli",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Deploy HTML files from the terminal — htmlhost.co CLI",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -49,6 +49,7 @@ function headers(extra = {}) {
   if (!token) throw new ApiError("Not logged in. Run: htmlhost login", 0);
   return {
     Authorization: `Bearer ${token}`,
+    "X-HTMLHost-Client": "cli",
     ...extra,
   };
 }

package/src/cli.mjs

@@ -5,7 +5,7 @@ import { bold, dim, cyan, err } from "./ui.mjs";
 import { ApiError } from "./api.mjs";
 import { startUpdateCheck, applyUpdate } from "./update.mjs";
 
-const VERSION = "2.8.0";
+const VERSION = "2.9.0";
 
 const HELP = `
   ${bold("htmlhost")} ${dim(`v${VERSION}`)} — deploy HTML from the terminal
@@ -19,6 +19,8 @@ const HELP = `
     ${cyan("htmlhost agents")} [dir]             Teach your AI coding tool htmlhost (AGENTS.md)
     ${cyan("htmlhost recipients")} [slug] [cmd]  Manage form notification recipients
     ${cyan("htmlhost list")}                     List your sites
+    ${cyan("htmlhost versions")} [slug]         List a site's published versions
+    ${cyan("htmlhost rollback")} [slug] [ver]    Make an earlier version live again (Pro)
     ${cyan("htmlhost delete")} <slug>            Delete a site
     ${cyan("htmlhost login")}                    Authenticate with an API token
     ${cyan("htmlhost whoami")}                   Show current user
@@ -59,6 +61,11 @@ const HELP = `
   ${bold("Delete options:")}
     --force, -f       Skip confirmation prompt
 
+  ${bold("Rollback:")}
+    No version:       goes back to the version before the live one
+    --force, -f       Skip confirmation prompt
+    Restoring publishes the old version again as a new version
+
   ${bold("How deploy works:")}
     No args or dir: deploys entire folder as a multi-page site
     Single file:    deploys just that file (assets auto-inlined)
@@ -177,6 +184,18 @@ export async function run(argv) {
         await deleteSite(args);
         break;
       }
+      case "versions":
+      case "history": {
+        const { versions } = await import("./commands/versions.mjs");
+        await versions(args, { json: jsonMode });
+        break;
+      }
+      case "rollback":
+      case "restore": {
+        const { rollback } = await import("./commands/versions.mjs");
+        await rollback(args, { json: jsonMode });
+        break;
+      }
       case "open": {
         const { open } = await import("./commands/open.mjs");
         await open(args);

package/src/commands/versions.mjs

@@ -0,0 +1,130 @@
+import { get, post } from "../api.mjs";
+import { ok, err, info, warn, dim, cyan, bold, confirm, formatBytes } from "../ui.mjs";
+import { readLink } from "../link.mjs";
+
+/** Explicit slug argument first, then the folder's .htmlhost link. */
+function resolveSlug(positional) {
+  return positional[0] || readLink(process.cwd())?.site?.slug || null;
+}
+
+function when(iso) {
+  const d = new Date(iso);
+  return d.toLocaleString("en-GB", { day: "numeric", month: "short", year: "numeric", hour: "2-digit", minute: "2-digit" });
+}
+
+function pad(str, width) {
+  const s = String(str);
+  const visible = s.replace(/\x1b\[[0-9;]*m/g, "");
+  return s + " ".repeat(Math.max(0, width - visible.length));
+}
+
+/**
+ * htmlhost versions [slug] [--json]
+ * Lists a site's published versions, newest first.
+ */
+export async function versions(args, { json = false } = {}) {
+  const positional = args.filter((a) => !a.startsWith("-"));
+  const slug = resolveSlug(positional);
+  if (!slug) {
+    err("No site given and no .htmlhost link here.");
+    console.log(`  Usage: ${cyan("htmlhost versions")} [slug]`);
+    process.exit(1);
+  }
+
+  const data = await get(`/api/sites/${encodeURIComponent(slug)}/versions`);
+  if (json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  console.log();
+  console.log(`  ${bold("Versions of")} ${cyan(`${data.slug}.htmlhost.co`)}`);
+  console.log();
+  if (!data.versions.length) {
+    console.log(dim("  No versions yet. Your next deploy will be the first."));
+    return;
+  }
+  for (const v of data.versions) {
+    const tag = v.live ? cyan(" live") : "";
+    const name = v.label ? bold(v.label) : v.summary;
+    const by = v.createdBy ? ` · ${v.createdBy}` : "";
+    console.log(`  ${pad(bold(`v${v.version}`), 6)}${tag} ${name}`);
+    console.log(dim(`        ${when(v.createdAt)} · ${v.source}${by} · ${v.pageCount} page${v.pageCount === 1 ? "" : "s"}, ${formatBytes(v.totalBytes)}`));
+  }
+  console.log();
+  if (data.usable) {
+    console.log(dim(`  Restore one with: htmlhost rollback ${data.slug} <version>`));
+  } else {
+    warn("Restoring earlier versions needs Pro: https://htmlhost.co/pricing");
+  }
+}
+
+/**
+ * htmlhost rollback [slug] [version] [--force]
+ * Publishes an earlier version again. Without a version, goes back to the one
+ * before the live version.
+ */
+export async function rollback(args, { json = false } = {}) {
+  const positional = args.filter((a) => !a.startsWith("-"));
+  const force = args.includes("--force") || args.includes("-f");
+  const isVersion = (s) => /^v?\d+$/i.test(s ?? "");
+
+  // `rollback 4`, `rollback my-site`, `rollback my-site 4`
+  let slugArg = null;
+  let versionArg = null;
+  if (positional.length >= 2) [slugArg, versionArg] = positional;
+  else if (isVersion(positional[0])) versionArg = positional[0];
+  else slugArg = positional[0] ?? null;
+
+  const slug = resolveSlug(slugArg ? [slugArg] : []);
+  if (!slug) {
+    err("No site given and no .htmlhost link here.");
+    console.log(`  Usage: ${cyan("htmlhost rollback")} [slug] [version]`);
+    process.exit(1);
+  }
+
+  const data = await get(`/api/sites/${encodeURIComponent(slug)}/versions`);
+  if (!data.usable) {
+    err("Restoring earlier versions needs Pro: https://htmlhost.co/pricing");
+    process.exit(1);
+  }
+  const live = data.versions.find((v) => v.live);
+  let target;
+  if (versionArg) {
+    const n = Number(String(versionArg).replace(/^v/i, ""));
+    target = data.versions.find((v) => v.version === n);
+    if (!target) {
+      err(`Version ${n} isn't in this site's history.`);
+      process.exit(1);
+    }
+  } else {
+    target = data.versions.find((v) => !v.live && (!live || v.version < live.version));
+    if (!target) {
+      err("There's no earlier version to go back to.");
+      process.exit(1);
+    }
+  }
+  if (target.live) {
+    info(`v${target.version} is already live.`);
+    return;
+  }
+
+  if (!force && !json) {
+    const yes = await confirm(`  Make v${target.version} (${when(target.createdAt)}) live again on ${cyan(bold(`${data.slug}.htmlhost.co`))}?`);
+    if (!yes) {
+      console.log("  Cancelled.");
+      return;
+    }
+  }
+
+  const result = await post(`/api/sites/${encodeURIComponent(data.slug)}/versions/${target.version}/restore`, {});
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const url = result.url ? (String(result.url).startsWith("http") ? result.url : `https://${result.url}`) : `https://${data.slug}.htmlhost.co`;
+  ok(`Restored v${target.version} → ${cyan(url)}`);
+  if (readLink(process.cwd())?.site?.slug === data.slug) {
+    console.log(dim(`  Your local files still have the newer version. Run ${cyan("htmlhost pull")} to match the site.`));
+  }
+}