frontpage-host 0.1.18 → 0.1.20

package/dist/modules/commands.js

@@ -132,8 +132,8 @@ export const MODULE_COMMANDS = [
     },
     {
         key: "payments",
-        name: "Payments",
-        summary: "Stripe payments. Connect finishes in the browser, not the terminal.",
+        name: "Pay buttons",
+        summary: "One-click Stripe pay buttons. No cart. Connect finishes in the browser, not the terminal.",
         genericActions: GENERIC_ACTIONS,
         extraActions: [
             "status",
@@ -151,14 +151,14 @@ export const MODULE_COMMANDS = [
         ],
         notes: [
             "Connect needs an admin API key. It opens Frontpage (you must be logged in there), then Stripe. Already-connected sites stay live — disconnect first to switch accounts.",
-            "payments and shop share one Stripe account. Disconnecting payments fails if the store still uses that account.",
+            "Pay buttons and the Online store share one Stripe account. Disconnecting Pay buttons fails if the store still uses that account.",
             "request-setup still lights the editor amber bar when you want the owner to finish there.",
         ],
     },
     {
         key: "shop",
         name: "Online store",
-        summary: "Stripe shop. Shares the payments Stripe account.",
+        summary: "Catalog, cart, and Stripe checkout. Shares the Pay buttons Stripe account.",
         genericActions: GENERIC_ACTIONS,
         extraActions: [
             "status",

package/dist/registry.js

@@ -416,7 +416,7 @@ export const COMMANDS = [
     {
         name: "people",
         summary: "List and manage site People (not inbox, not a module)",
-        usage: "frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide [--site <slug>] [--json]",
+        usage: "frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export [--site <slug>] [--json]",
         topics: ["content"],
         examples: [
             "frontpage people list",
@@ -425,14 +425,69 @@ export const COMMANDS = [
             "frontpage people note <id> --body \"Called them\"",
             "frontpage people follow-up <id> --at 2026-09-12T00:00:00Z",
             "frontpage people hide <id>",
+            "frontpage people tag <id> --add vip",
+            "frontpage people list --tag vip",
+            "frontpage people export",
         ],
         flags: [
-            "list: --q --status --source --form-slug --follow-up due|upcoming|none --hidden --sort --last-seen-days --limit --cursor",
+            "list: --q --status --source --form-slug --follow-up due|upcoming|none --hidden --sort --last-seen-days --tag --limit --cursor",
             "add requires --email and/or --phone (never name alone)",
-            "Hide is not forget — unique email/phone stay; later ingest un-hides",
+            "tag: --add <label> | --remove <slug>",
+            "export writes UTF-8 CSV (same filters as list). Optional --out <file>",
+            "Hide is not forget. Unique email/phone stay; later ingest un-hides",
             "Unknown leftover flags fail closed (exit 2)",
         ],
-        seeAlso: ["inbox", "help content"],
+        seeAlso: ["inbox", "https://frontpage.host/developers/people"],
+    },
+    {
+        name: "shop",
+        summary: "Store catalog: items, variants, stock, and store settings (not Square, not inbox)",
+        usage: "frontpage shop items|variants|categories|settings|orders|payments … [--site <slug>] [--json]",
+        topics: ["content"],
+        examples: [
+            "frontpage shop items list",
+            "frontpage shop categories create hats --label Hats",
+            "frontpage shop items create camp-hat --title \"Camp hat\" --price-cents 4999 --checkout cart --categories hats --stock 20",
+            "frontpage shop items list --category hats",
+            "frontpage shop variants add camp-hat --id m --option Size=M --price-cents 4999 --stock 8",
+            "frontpage shop items stock camp-hat --variant m --add 5",
+            "frontpage shop items stock camp-hat --variant m --remove 5",
+            "frontpage shop items stock camp-hat --variant m --set 20",
+            "frontpage shop settings set-fulfillment --mode pickup",
+            "frontpage shop settings set-currency --currency usd",
+        ],
+        flags: [
+            "Integer cents only. $49.99 is 4999. Do not send 49.99 or a dollar string.",
+            "--add / --remove become signed delta. 5 adds 5. --remove 5 removes 5. Result copy is added 5 / removed 5 / set to 20 / stockNow.",
+            "Pass either --add, --remove, or --set. Never two together. --set unlimited returns counted stock to unlimited.",
+            "items: list|get|create|update|archive|activate [--off] | images --urls … | stock [--variant m] --add|--remove|--set. list --category hats. create/update --categories hats,summer",
+            "categories: list|create|rename|archive. Create the category first. Assigning an unknown slug fails.",
+            "variants: add|update|archive <itemId> --id m --price-cents … [--option Size=M] [--stock]",
+            "settings: get|set-fulfillment|set-currency|set-checkout-fee. Connect stays frontpage modules shop|payments connect.",
+            "orders / payments list|get read the same ledgers as frontpage inbox orders|payments",
+            "Unknown leftover flags fail closed (exit 2)",
+        ],
+        seeAlso: ["inbox", "https://frontpage.host/developers/shop"],
+    },
+    {
+        name: "mail",
+        summary: "Site mailings: drafts, templates, series, and sends (not People, not inbox)",
+        usage: "frontpage mail settings|email|template|series|send|sends|enrolments|suppress … [--site <slug>] [--json]",
+        topics: ["content"],
+        examples: [
+            "frontpage mail settings set --postal \"100 Main St\" --reply-to you@example.com",
+            "frontpage mail email create --file draft.json --name Hours",
+            "frontpage mail send --file email.json --to ada@example.com --wait",
+            "frontpage mail send template <id> --to ada@example.com --var first_name=Ada",
+            "frontpage mail series steps set <id> --file steps.json",
+            "frontpage mail suppress add --email bounce@example.com",
+        ],
+        flags: [
+            "email list is unsent drafts only. Sent one-offs are mail sends list",
+            "send --file is an inline one-off (no saved document)",
+            "Blocks and series steps are JSON (--file). Unknown leftover flags fail closed (exit 2)",
+        ],
+        seeAlso: ["people", "inbox"],
     },
     {
         name: "redirects",
@@ -668,7 +723,12 @@ export const TOPICS = {
   frontpage media list|upload <file>   # images/PDF/video; text/CSV = inline not library; sitePath first when stored
   frontpage images generate --prompt "…" [--count N]  # 1–4 AI variations of one prompt; sitePath first; AI $ + storage
   frontpage inbox [leads|subscribers|orders|google_reviews|…] [--mark-read] [--csv]
-  frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide
+  frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export
+  # People CRM guide: https://frontpage.host/developers/people
+  frontpage shop items|variants|categories|settings|orders|payments
+  # Store catalog: https://frontpage.host/developers/shop
+  # Integer cents only. $49.99 is 4999. stock --add/--remove are signed delta.
+  frontpage mail settings|email|template|series|send|sends|enrolments|suppress
   frontpage seo get [/path|--path /path] | seo set --path /
   frontpage redirects list|set|rm --from /old --to /new
   frontpage articles list|content|create-section|create-article|set-draft|…

package/llms.txt

@@ -16,7 +16,8 @@
 - Version: frontpage --version | -V | version
 - SEO get: frontpage seo get [/path|--path /path]; search path filter: [path|--path <path>]; open [/path|--path /path]
 - Redirects: frontpage redirects list|set|rm — HTTP 301/308, instant, not a file; revert does not undo; do not fake with Astro.redirect / meta refresh
-- People: frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide — site-scoped person graph (email or phone). Inbox stays the raw ledger. Hide is not forget. Unknown leftover flags fail closed.
+- People CRM: frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export. Site-scoped person graph (email or phone). Inbox stays the raw ledger. Hide is not forget. List export is CSV. Unknown leftover flags fail closed. Guide: https://frontpage.host/developers/people
+- Store catalog: frontpage shop items|variants|categories|settings|orders|payments. Integer cents only ($49.99 is 4999). stock --add/--remove are signed delta (added 5 / removed 5 / set to 20 / stockNow). Create a category before assigning it. Connect stays frontpage modules shop|payments connect. Not Square ordering. Guide: https://frontpage.host/developers/shop
 - Analytics funnel: --steps JSON array or comma paths (/, /pricing); bad JSON → Invalid JSON for --steps
 - Modules: unknown key errors list Known: …; mailing list module key is signups (not subscribe)
 - Errors: --json API envelopes include requestId when the server returned one; local validation omits requestId/httpStatus; runs wait failed/canceled → ok:false + run.error (exit 2); deploy wait = agent idle + tip compile ready (fail-closed / compile timeout → exit 2); push --wait and publish --wait wait for GET /deploy ready

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {