posthorn 0.2.9 → 0.2.11

package/README.md

@@ -80,9 +80,9 @@ Step 3. Google Workspace. Ask: "Do you have a Google Workspace you can add new
 domains and mailboxes to, or do you want to set up a new one?"
 - Existing Workspace: delegation browser step (below), then
   `posthorn accounts workspace <admin-email>`.
-- New Workspace: they create one at workspace.google.com using the domain from
-  step 2, then delegation as above. Tell the user the org signup is also
-  one-time; it gets reused for every future domain and mailbox.
+- New Workspace: walk them through the signup (browser step below: "Creating
+  a new Google Workspace org"), then delegation. Tell the user the org signup
+  is also one-time; it gets reused for every future domain and mailbox.
 (Delegation is per org, not per domain, so with an existing org this step can
 happen any time, even before the domain exists. The domain pipeline auto-adds
 and verifies the new domain inside their org.)
@@ -133,6 +133,27 @@ to do this again." The repetition model, so you can answer follow-ups:
 - For domain PURCHASES, the user also needs a payment method on their Cloudflare
   account (they pay Cloudflare directly; Posthorn never bills for domains).
 
+### Creating a new Google Workspace org (only when the user has none)
+Tell the user: one-time, about 5 minutes, needs a credit card (Business
+Starter is ~$7/user/month with a free trial).
+Walk them through workspace.google.com → Get started:
+1. Business name, employee count, region. Any values are fine.
+2. Current email: any email they already read (personal Gmail is fine; it's
+   just the contact for signup).
+3. When asked about a domain, choose the option saying they ALREADY HAVE a
+   domain, and enter the sending domain from step 2 of the flow. Do NOT buy
+   a domain from Google here, even if offered: the domain must stay at their
+   registrar/Cloudflare so Posthorn can manage its DNS.
+4. Create the admin user, e.g. admin@<their-domain>. This account is the
+   org's SUPER-ADMIN: they should save the password, and this is the email
+   for `posthorn accounts workspace <admin-email>` later.
+5. Pick Business Starter, add payment, finish signup.
+6. If Google prompts to VERIFY the domain or set up MX records, skip it
+   ("I'll do this later" / close the wizard). Posthorn does domain
+   verification and MX automatically once delegation is set up.
+7. Continue to domain-wide delegation (next section), signed in as that new
+   super-admin.
+
 ### Google Workspace domain-wide delegation (one-time per Workspace org)
 - Tell the user: "This is a one-time setup for your Workspace; you won't need
   to do this again."

package/dist/index.js

@@ -362,6 +362,7 @@ async function checkDomains(domains2, options) {
     const icon = r.available ? chalk3.green("  \u2713") : chalk3.red("  \u2717");
     const price = r.price ? chalk3.dim(`$${r.price}/yr`) : "";
     console.log(`${icon} ${String(r.domain).padEnd(30)}${price}`);
+    if (r.note) console.log(chalk3.yellow(`      ${r.note}`));
   }
   console.log(chalk3.dim("\n  Vet a domain before buying: posthorn domains reputation <domain>"));
 }
@@ -580,7 +581,7 @@ function guide() {
 
 // src/index.ts
 var program = new Command();
-program.name("posthorn").description("Posthorn: domain setup, mailbox creation, and email warmup").version("0.2.9");
+program.name("posthorn").description("Posthorn: domain setup, mailbox creation, and email warmup").version("0.2.11");
 program.addHelpText("after", `
 Agents: run 'posthorn guide' first for the full workflow playbook.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posthorn",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "Domain setup, mailbox creation, and email warmup from the command line",
   "type": "module",
   "bin": {