htmlhost-cli 2.13.0 → 2.14.0

package/README.md

@@ -174,7 +174,7 @@ htmlhost agents --no-claude  # don't touch CLAUDE.md
 The same guide is at https://htmlhost.co/agents.md.
 
 ### `htmlhost list`
-List all your sites with titles, sizes, TTL, and expiry. Multi-page sites are marked with 📄. Sites shared with you as a collaborator follow under **Shared with you**, with their owner: `clone`, `deploy` and `versions` work on them with your own sign-in; only the owner can delete them.
+List all your sites with titles, sizes, TTL, and expiry. Multi-page sites are marked with 📄. Sites shared with you follow under **Shared with you**, with their owner and your role. Admins and Editors can `clone`, `deploy` and roll them back with their own sign-in; Contributors can `clone` and `deploy --draft`, then ask someone who can publish; Viewers only look. Only the owner can delete a site.
 
 ### `htmlhost open <slug>`
 Open a deployed site in the default browser.
@@ -227,7 +227,7 @@ Free publishing is limited. Subscribe to Pro to continue creating unlimited site
 
 ## Unpublished sites and drafts
 
-Unpublished websites remain private until publishing is explicitly confirmed. Collaborators can publish with confirmation; only owners can unpublish. The server also cancels deployments still running when someone unpublishes.
+Unpublished websites remain private until publishing is explicitly confirmed. Admins and Editors on a shared site can publish with confirmation and unpublish; Contributors save drafts only. The server also cancels deployments still running when someone unpublishes.
 
 - `htmlhost deploy --draft` saves files without changing publication.
 - `htmlhost deploy --publish` explicitly makes an unpublished website public. The same flag applies to `rollback`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "htmlhost-cli",
-  "version": "2.13.0",
-  "description": "Deploy HTML files from the terminal \u2014 htmlhost.co CLI",
+  "version": "2.14.0",
+  "description": "Deploy HTML files from the terminal — htmlhost.co CLI",
   "type": "module",
   "bin": {
     "htmlhost": "bin/htmlhost.mjs"

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.13.0";
+const VERSION = "2.14.0";
 
 const HELP = `
   ${bold("htmlhost")} ${dim(`v${VERSION}`)} — deploy HTML from the terminal
@@ -17,10 +17,10 @@ const HELP = `
     ${cyan("htmlhost pull")} [slug] [opts]        Pull remote changes to local
     ${cyan("htmlhost clone")} <slug> [dir]        Clone a site to a local directory
     ${cyan("htmlhost agents")} [dir]             Teach your AI coding tool htmlhost (AGENTS.md)
-    ${cyan("htmlhost recipients")} [slug] [cmd]  Manage form notification recipients (owner)
+    ${cyan("htmlhost recipients")} [slug] [cmd]  Manage form notification recipients (owner, Admin)
     ${cyan("htmlhost list")}                     List your sites and ones shared with you
     ${cyan("htmlhost versions")} [slug]         List a site's published versions
-    ${cyan("htmlhost unpublish")} [slug]       Take a site offline (owner only)
+    ${cyan("htmlhost unpublish")} [slug]       Take a site offline (owner, Admin, Editor)
     ${cyan("htmlhost rollback")} [slug] [ver]    Make an earlier version live again (Pro)
     ${cyan("htmlhost delete")} <slug>            Delete a site (owner)
     ${cyan("htmlhost login")}                    Sign in (approve in your browser)

package/src/commands/list.mjs

@@ -2,8 +2,8 @@ import { get } from "../api.mjs";
 import { dim, cyan, bold, formatBytes, yellow } from "../ui.mjs";
 
 /**
- * htmlhost list — show all sites: your own, then the ones shared with you
- * (you can clone, deploy and restore those, not delete them).
+ * htmlhost list — show all sites: your own, then the ones shared with you,
+ * with your role on each (what you can do follows it; only owners delete).
  */
 export async function list({ json = false } = {}) {
   const data = await get("/api/sites");
@@ -54,11 +54,14 @@ export async function list({ json = false } = {}) {
   if (shared.length) {
     const sharedSlugW = Math.max(14, ...shared.map((s) => s.slug.length)) + 2;
     console.log("");
-    console.log(`  ${bold("Shared with you")} ${dim("(clone, deploy and restore; only the owner can delete)")}`);
-    console.log(`  ${dim(pad("SLUG", sharedSlugW) + pad("TITLE", 30) + pad("STATUS", 12) + "OWNER")}`);
+    console.log(`  ${bold("Shared with you")} ${dim("(what you can do follows your role; only the owner can delete)")}`);
+    console.log(`  ${dim(pad("SLUG", sharedSlugW) + pad("TITLE", 30) + pad("STATUS", 12) + pad("ROLE", 13) + "OWNER")}`);
     for (const s of shared) {
       const title = truncate(s.title && s.title !== s.slug ? s.title : "", 28);
-      console.log(`  ${pad(cyan(s.slug), sharedSlugW)}${pad(dim(title), 30)}${pad(s.isPublished === false ? "Draft" : "Published", 12)}${dim(s.owner || "")}`);
+      console.log(`  ${pad(cyan(s.slug), sharedSlugW)}${pad(dim(title), 30)}${pad(s.isPublished === false ? "Draft" : "Published", 12)}${pad(roleLabel(s.role), 13)}${dim(s.owner || "")}`);
+    }
+    if (shared.some((s) => s.canPublish === false && s.canEdit !== false)) {
+      console.log(`  ${dim("Contributors save drafts (htmlhost deploy --draft) and ask an Owner, Admin or Editor to publish.")}`);
     }
   }
 
@@ -91,3 +94,8 @@ function relTime(iso) {
   if (days === 1) return "tomorrow";
   return `${days}d`;
 }
+
+/** The server's role name, as people read it ("contributor" → "Contributor"). Older servers send "editor". */
+function roleLabel(role) {
+  return typeof role === "string" && role ? role[0].toUpperCase() + role.slice(1) : "Editor";
+}