frontpage-host 0.1.12 → 0.1.14

package/AGENTS.md

@@ -109,7 +109,8 @@ Sites are Astro 6 + Tailwind v4. More detail: `frontpage help site-building` or
 ## Modules & articles
 
 - Forms: `data-fp-form` markup in pages + `frontpage modules` for enable/config. No submit JS / honeypot / `action`.
-- Wizard modules (payments/shop/ordering/instagram): after building gated markup, `frontpage modules request-setup <key> --reason "…"` once — owner finishes in the **editor status bar** (CLI cannot show it). Auto-active modules (forms/callbar/…) need markup, not request-setup.
+- Wizard / connect-once modules (payments/shop/ordering/google_reviews): after building gated markup, `frontpage modules request-setup <key> --reason "…"` once — owner finishes in the **editor status bar** (CLI cannot show it). Auto-active modules (forms/callbar/…) need markup, not request-setup. Typed settings: `frontpage modules callbar|forms|booking|signups get|set` (forms set needs `--instance`; do not target `default`). `frontpage modules <key>` prints that key's CLI usage (exit 2). Index: https://frontpage.host/developers/modules
+- Google reviews: platform nodes only (`data-fp-google-reviews` / `data-fp-google-ask` + required `data-fp-requires="google_reviews"`). `data-layout` is `feed` (default), `badge`, or `link`. Never invent stars, quotes, a 1–10, or a Maps URL. Do not pick a Place ID via Autocomplete and do not write `placeId` through `modules config`. Owner-supplied Place ID / Maps URL: `frontpage modules google_reviews connect --place-id …` or `--maps-url …` (server resolves + seeds). Curation: `list-reviews`, `hide --id`, `show --id`, `set-stars`, `set-sort`, `set-weight`, `reset-weights`, `refresh`, `disconnect`. Usage: `frontpage modules google_reviews`. Docs: https://frontpage.host/developers/modules/google-reviews. Ask-widget scores: `frontpage inbox google_reviews`.
 - Articles: `frontpage articles …` for lifecycle; bodies via sync under `content/` or `articles content get|set`. Section landing is an owned `src/pages/<section>/index.astro`.
 - Migrate a folder into Articles: prefer `frontpage prompt "migrate … into articles"` — do not invent a mass delete+write migration.
 - Extensions: `frontpage extensions`; if LOCKED on plan, do not fake charts/etc.

package/dist/commands/help.js

@@ -1,4 +1,5 @@
 import { COMMANDS, TOPIC_NAMES, TOPICS, findCommand } from "../registry.js";
+import { MODULE_COMMANDS, formatModulesIndex } from "../modules/commands.js";
 import { isJson, emitOk } from "../runtime.js";
 function printCommandHelp(cmd) {
     console.log(`${cmd.name} — ${cmd.summary}`);
@@ -41,6 +42,7 @@ export function runHelp(args) {
                 })),
                 topics: TOPIC_NAMES,
                 topicBodies: TOPICS,
+                moduleCommands: MODULE_COMMANDS,
             });
             return 0;
         }
@@ -50,7 +52,10 @@ export function runHelp(args) {
         }
         const cmd = findCommand(topic);
         if (cmd) {
-            emitOk("help", { command: cmd });
+            emitOk("help", {
+                command: cmd,
+                ...(cmd.name === "modules" ? { moduleCommands: MODULE_COMMANDS } : {}),
+            });
             return 0;
         }
         console.log(JSON.stringify({
@@ -81,6 +86,9 @@ export function runHelp(args) {
     const cmd = findCommand(topic);
     if (cmd) {
         printCommandHelp(cmd);
+        if (cmd.name === "modules") {
+            console.log(`\n${formatModulesIndex()}`);
+        }
         return 0;
     }
     console.error(`Unknown help topic: ${topic}`);

package/dist/commands/modules.js

@@ -1,9 +1,59 @@
 import { resolveSlug } from "../site.js";
-import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Get, v1Post } from "../http/client.js";
+import { EXIT_OK, exitCodeForError, v1Get, v1Post } from "../http/client.js";
 import { takeFlag } from "../argv.js";
+import { emitUsage } from "../runtime.js";
+import { formatModuleUsage, formatModulesIndex, isCliModuleAction, isDocumentedModuleKey, isGenericModuleVerb, } from "../modules/commands.js";
+import { runGoogleReviews } from "../modules/google_reviews.js";
+import { isTypedConfigCliKey, runTypedConfig } from "../modules/typed_config.js";
+/** Drop --site so we can print local usage without resolving a checkout. */
+function positionalArgs(args) {
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--site" || a === "-s") {
+            i += 1;
+            continue;
+        }
+        if (a.startsWith("--site="))
+            continue;
+        rest.push(a);
+    }
+    return rest;
+}
+function rewriteKeyFirst(rest) {
+    const key = rest[0];
+    const action = rest[1];
+    if (key && action && isDocumentedModuleKey(key) && isGenericModuleVerb(action)) {
+        return [action, key, ...rest.slice(2)];
+    }
+    return rest;
+}
 export async function runModules(args) {
     try {
-        const { slug, rest } = await resolveSlug(args);
+        const peeked = positionalArgs(args);
+        const peekedKey = peeked[0];
+        const peekedAction = peeked[1];
+        if (peekedKey && isDocumentedModuleKey(peekedKey)) {
+            if (!peekedAction) {
+                return emitUsage("modules", formatModuleUsage(peekedKey));
+            }
+            if (isCliModuleAction(peekedKey, peekedAction)) {
+                const { slug } = await resolveSlug(args);
+                const extraFlags = positionalArgs(args).slice(2);
+                if (peekedKey === "google_reviews") {
+                    return await runGoogleReviews(slug, peekedAction, extraFlags);
+                }
+                if (isTypedConfigCliKey(peekedKey)) {
+                    return await runTypedConfig(peekedKey, slug, peekedAction, extraFlags);
+                }
+            }
+            if (!isGenericModuleVerb(peekedAction)) {
+                return emitUsage("modules", `${formatModuleUsage(peekedKey)}\n\nUnknown action "${peekedAction}". Not in this CLI yet — use Modules or the editor.`);
+            }
+        }
+        const resolved = await resolveSlug(args);
+        const slug = resolved.slug;
+        const rest = rewriteKeyFirst(resolved.rest);
         const sub = rest[0];
         if (!sub || sub === "list" || sub === "ls") {
             const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/modules`);
@@ -16,12 +66,16 @@ export async function runModules(args) {
             const key = rest[1];
             if (!key) {
                 const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/modules`);
-                console.error("Usage: frontpage modules docs <key> [--instance <id>] [--site <slug>]");
-                console.error("Known modules (run: frontpage modules docs <key>):");
-                for (const m of data.modules) {
-                    console.error(`  ${m.key.padEnd(16)}  ${m.name}`);
-                }
-                return EXIT_USAGE;
+                const known = data.modules
+                    .map((m) => `  ${m.key.padEnd(16)}  ${m.name}`)
+                    .join("\n");
+                return emitUsage("modules", [
+                    "Usage: frontpage modules docs <key> [--instance <id>] [--site <slug>]",
+                    "Known modules (run: frontpage modules docs <key>):",
+                    known,
+                    "",
+                    formatModulesIndex(),
+                ].join("\n"));
             }
             const work = rest.slice(2);
             const instanceId = takeFlag(work, "--instance");
@@ -37,16 +91,14 @@ export async function runModules(args) {
         if (sub === "request-setup" || sub === "request_setup") {
             const key = rest[1];
             if (!key) {
-                console.error("Usage: frontpage modules request-setup <key> --reason \"…\" [--prefill '{…}'] [--instance <id>] [--site <slug>]");
-                return EXIT_USAGE;
+                return emitUsage("modules", 'Usage: frontpage modules request-setup <key> --reason "…" [--prefill \'{…}\'] [--instance <id>] [--site <slug>]');
             }
             const work = rest.slice(2);
             const instanceId = takeFlag(work, "--instance");
             const reason = takeFlag(work, "--reason");
             const prefillRaw = takeFlag(work, "--prefill");
             if (!reason) {
-                console.error("Usage: frontpage modules request-setup <key> --reason \"…\" [--prefill '{…}']");
-                return EXIT_USAGE;
+                return emitUsage("modules", 'Usage: frontpage modules request-setup <key> --reason "…" [--prefill \'{…}\']');
             }
             let prefill;
             if (prefillRaw) {
@@ -54,8 +106,7 @@ export async function runModules(args) {
                     prefill = JSON.parse(prefillRaw);
                 }
                 catch {
-                    console.error("--prefill must be valid JSON");
-                    return EXIT_USAGE;
+                    return emitUsage("modules", "--prefill must be valid JSON");
                 }
             }
             const data = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/modules/${encodeURIComponent(key)}`, { action: "request-setup", reason, prefill, instanceId });
@@ -65,8 +116,7 @@ export async function runModules(args) {
         if (sub === "enable" || sub === "disable" || sub === "archive" || sub === "config") {
             const key = rest[1];
             if (!key) {
-                console.error(`Usage: frontpage modules ${sub} <key> [--instance <id>] [--config '{…}']`);
-                return EXIT_USAGE;
+                return emitUsage("modules", `Usage: frontpage modules ${sub} <key> [--instance <id>] [--config '{…}']`);
             }
             const work = rest.slice(2);
             const instanceId = takeFlag(work, "--instance");
@@ -74,23 +124,25 @@ export async function runModules(args) {
             if (sub === "config") {
                 const raw = takeFlag(work, "--config") ?? work[0];
                 if (!raw) {
-                    console.error("Usage: frontpage modules config <key> --config '{…json…}'");
-                    return EXIT_USAGE;
+                    return emitUsage("modules", "Usage: frontpage modules config <key> --config '{…json…}'");
                 }
                 try {
                     config = JSON.parse(raw);
                 }
                 catch {
-                    console.error("--config must be valid JSON");
-                    return EXIT_USAGE;
+                    return emitUsage("modules", "--config must be valid JSON");
                 }
             }
             const data = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/modules/${encodeURIComponent(key)}`, { action: sub, config, instanceId });
             console.log(JSON.stringify(data, null, 2));
             return EXIT_OK;
         }
-        console.error("Usage: frontpage modules [list|docs|request-setup|enable|disable|archive|config] …");
-        return EXIT_USAGE;
+        return emitUsage("modules", [
+            "Usage: frontpage modules [list|docs|request-setup|enable|disable|archive|config] …",
+            "       frontpage modules <key>                 # that key's CLI usage",
+            "",
+            formatModulesIndex(),
+        ].join("\n"));
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : String(err));

package/dist/completions/generate.js

@@ -24,7 +24,15 @@ _frontpage_completions() {
     seo|settings) COMPREPLY=( $(compgen -W "get set" -- "\${cur}") ) ;;
     articles) COMPREPLY=( $(compgen -W "list content create-section create-article set-draft" -- "\${cur}") ) ;;
     analytics) COMPREPLY=( $(compgen -W "dashboard summary query funnel timeseries compare sql" -- "\${cur}") ) ;;
-    modules) COMPREPLY=( $(compgen -W "list docs request-setup enable disable archive config" -- "\${cur}") ) ;;
+    modules)
+      if [[ \${COMP_CWORD} -ge 3 && \${COMP_WORDS[2]} == google_reviews ]]; then
+        COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config connect resolve status list-reviews hide show set-stars set-sort set-weight reset-weights write-review-url refresh disconnect" -- "\${cur}") )
+      elif [[ \${COMP_CWORD} -ge 3 && (\${COMP_WORDS[2]} == callbar || \${COMP_WORDS[2]} == forms || \${COMP_WORDS[2]} == booking || \${COMP_WORDS[2]} == signups) ]]; then
+        COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config get set" -- "\${cur}") )
+      else
+        COMPREPLY=( $(compgen -W "list docs request-setup enable disable archive config callbar forms booking signups payments shop ordering articles google_reviews" -- "\${cur}") )
+      fi
+      ;;
     extensions) COMPREPLY=( $(compgen -W "list docs enable disable config" -- "\${cur}") ) ;;
     prompt) COMPREPLY=( $(compgen -W "--path --attach --asset-url --site --json --help" -- "\${cur}") ) ;;
     *) COMPREPLY=( $(compgen -W "--site --help --json --quiet --yes" -- "\${cur}") ) ;;
@@ -53,7 +61,15 @@ _frontpage() {
         tokens) _values 'subcommand' set ;;
         seo|settings) _values 'subcommand' get set ;;
         analytics) _values 'subcommand' dashboard summary query funnel timeseries compare sql ;;
-        modules) _values 'subcommand' list docs request-setup enable disable archive config ;;
+        modules)
+          if [[ $words[2] == google_reviews ]]; then
+            _values 'subcommand' docs request-setup enable disable archive config connect resolve status list-reviews hide show set-stars set-sort set-weight reset-weights write-review-url refresh disconnect
+          elif [[ $words[2] == callbar || $words[2] == forms || $words[2] == booking || $words[2] == signups ]]; then
+            _values 'subcommand' docs request-setup enable disable archive config get set
+          else
+            _values 'subcommand' list docs request-setup enable disable archive config callbar forms booking signups payments shop ordering articles google_reviews
+          fi
+          ;;
         extensions) _values 'subcommand' list docs enable disable config ;;
       esac
       ;;
@@ -75,7 +91,9 @@ export function generateFishCompletion() {
         `complete -c frontpage -n "__fish_seen_subcommand_from tokens" -a "set"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from seo settings" -a "get set"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from analytics" -a "dashboard summary query funnel timeseries compare sql"`,
-        `complete -c frontpage -n "__fish_seen_subcommand_from modules" -a "list docs request-setup enable disable archive config"`,
+        `complete -c frontpage -n "__fish_seen_subcommand_from modules" -a "list docs request-setup enable disable archive config callbar forms booking signups payments shop ordering articles google_reviews"`,
+        `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from google_reviews" -a "connect resolve status list-reviews hide show set-stars set-sort set-weight reset-weights write-review-url refresh disconnect"`,
+        `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from callbar forms booking signups" -a "get set"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from extensions" -a "list docs enable disable config"`,
         `complete -c frontpage -l site -d "Site subdomain slug"`,
     ];

package/dist/http/client.d.ts

@@ -23,8 +23,14 @@ export declare function httpErrorFromV1(status: number, parsed: V1Envelope, fall
 export declare function apiBase(): string;
 /** Bearer header for raw fetch (e.g. Blob client-token exchange). */
 export declare function getBearerAuthHeader(): Promise<Record<string, string>>;
-export declare function v1Get<T>(path: string): Promise<T>;
-export declare function v1Post<T>(path: string, body?: unknown): Promise<T>;
+/** Connect / refresh can seed up to ~300s. Other calls stay on the default fetch timeout. */
+export declare const LONG_MODULE_TIMEOUT_MS = 310000;
+export declare function v1Get<T>(path: string, opts?: {
+    timeoutMs?: number;
+}): Promise<T>;
+export declare function v1Post<T>(path: string, body?: unknown, opts?: {
+    timeoutMs?: number;
+}): Promise<T>;
 export declare function v1Put<T>(path: string, body?: unknown): Promise<T>;
 export declare function v1Delete<T>(path: string): Promise<T>;
 export declare function v1Patch<T>(path: string, body?: unknown): Promise<T>;

package/dist/http/client.js

@@ -69,7 +69,9 @@ export async function getBearerAuthHeader() {
     }
     return { Authorization: `Bearer ${key}` };
 }
-async function v1Request(method, path, body) {
+/** Connect / refresh can seed up to ~300s. Other calls stay on the default fetch timeout. */
+export const LONG_MODULE_TIMEOUT_MS = 310_000;
+async function v1Request(method, path, body, opts) {
     const key = await getApiKey();
     if (!key) {
         throw new CliHttpError("Not logged in. Run: frontpage login", EXIT_AUTH, 401);
@@ -84,11 +86,19 @@ async function v1Request(method, path, body) {
         headers["Content-Type"] = "application/json";
         payload = JSON.stringify(body);
     }
+    const init = { method, headers, body: payload };
+    if (opts?.timeoutMs && opts.timeoutMs > 0) {
+        init.signal = AbortSignal.timeout(opts.timeoutMs);
+    }
     let res;
     try {
-        res = await fetch(url, { method, headers, body: payload });
+        res = await fetch(url, init);
     }
     catch (err) {
+        const name = err instanceof Error ? err.name : "";
+        if (name === "TimeoutError" || name === "AbortError") {
+            throw new CliHttpError("Request timed out.", EXIT_UNEXPECTED, 0);
+        }
         throw new CliHttpError(`Network error: ${err instanceof Error ? err.message : String(err)}`, EXIT_UNEXPECTED, 0);
     }
     const text = await res.text();
@@ -103,11 +113,11 @@ async function v1Request(method, path, body) {
         return parsed;
     throw httpErrorFromV1(res.status, parsed);
 }
-export async function v1Get(path) {
-    return v1Request("GET", path);
+export async function v1Get(path, opts) {
+    return v1Request("GET", path, undefined, opts);
 }
-export async function v1Post(path, body) {
-    return v1Request("POST", path, body ?? {});
+export async function v1Post(path, body, opts) {
+    return v1Request("POST", path, body ?? {}, opts);
 }
 export async function v1Put(path, body) {
     return v1Request("PUT", path, body ?? {});

package/dist/modules/commands.d.ts

@@ -0,0 +1,26 @@
+/**
+ * §CLI-MOD-FW — per-key CLI registry (usage printer + help --json).
+ * Instagram is not documented here. Google reviews extras ship in Phase 1.
+ */
+export declare const DOCUMENTED_MODULE_KEYS: readonly ["callbar", "forms", "booking", "signups", "payments", "shop", "ordering", "articles", "google_reviews"];
+export type DocumentedModuleKey = (typeof DOCUMENTED_MODULE_KEYS)[number];
+export declare const GENERIC_MODULE_VERBS: readonly ["list", "ls", "docs", "doc", "request-setup", "request_setup", "enable", "disable", "archive", "config"];
+export type ModuleCommandDef = {
+    key: DocumentedModuleKey;
+    name: string;
+    summary: string;
+    genericActions: readonly string[];
+    extraActions: readonly string[];
+    notYet: readonly string[];
+    examples: readonly string[];
+    notes: readonly string[];
+};
+export declare const MODULE_COMMANDS: readonly ModuleCommandDef[];
+export declare const GOOGLE_REVIEWS_CLI_ACTIONS: readonly ["connect", "resolve", "status", "list-reviews", "hide", "show", "set-stars", "set-sort", "set-weight", "reset-weights", "write-review-url", "refresh", "disconnect"];
+export declare const TYPED_CONFIG_CLI_ACTIONS: readonly ["get", "set"];
+export declare function isCliModuleAction(key: DocumentedModuleKey, action: string): boolean;
+export declare function isDocumentedModuleKey(raw: string): raw is DocumentedModuleKey;
+export declare function isGenericModuleVerb(raw: string): boolean;
+export declare function moduleCommand(key: DocumentedModuleKey): ModuleCommandDef;
+export declare function formatModuleUsage(key: DocumentedModuleKey): string;
+export declare function formatModulesIndex(): string;

package/dist/modules/commands.js

@@ -0,0 +1,299 @@
+/**
+ * §CLI-MOD-FW — per-key CLI registry (usage printer + help --json).
+ * Instagram is not documented here. Google reviews extras ship in Phase 1.
+ */
+export const DOCUMENTED_MODULE_KEYS = [
+    "callbar",
+    "forms",
+    "booking",
+    "signups",
+    "payments",
+    "shop",
+    "ordering",
+    "articles",
+    "google_reviews",
+];
+export const GENERIC_MODULE_VERBS = [
+    "list",
+    "ls",
+    "docs",
+    "doc",
+    "request-setup",
+    "request_setup",
+    "enable",
+    "disable",
+    "archive",
+    "config",
+];
+const GENERIC_ACTIONS = [
+    "docs",
+    "request-setup",
+    "enable",
+    "disable",
+    "archive",
+    "config",
+];
+export const MODULE_COMMANDS = [
+    {
+        key: "callbar",
+        name: "Call bar",
+        summary: "Phone / SMS bar. Typed get/set for phone, sms, and label.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [
+            "get",
+            "set --phone +1… [--sms yes|no] [--label \"Call\"]",
+        ],
+        notYet: [],
+        examples: [
+            "frontpage modules callbar",
+            "frontpage modules callbar get",
+            "frontpage modules callbar set --phone +14085551234 --sms no",
+            "frontpage modules callbar docs",
+            `frontpage modules config callbar --config '{"phone":"+1…"}'`,
+        ],
+        notes: [
+            "Typed flags write the same whitelist as `modules config`. Generic JSON config still works.",
+        ],
+    },
+    {
+        key: "forms",
+        name: "Forms",
+        summary: "Lead forms. Get lists instances; set requires --instance.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [
+            "get [--instance <slug>]",
+            "set --instance <slug> [--notify-email] [--confirm yes|no]",
+        ],
+        notYet: [],
+        examples: [
+            "frontpage modules forms",
+            "frontpage modules forms get",
+            "frontpage modules forms get --instance lead-gen",
+            "frontpage modules forms set --instance lead-gen --notify-email hi@example.com",
+            "frontpage modules forms docs",
+            `frontpage modules config forms --instance lead-gen --config '{"notifyEmail":"hi@example.com"}'`,
+        ],
+        notes: [
+            "Without --instance, get lists each form (id, status, notifyEmail). Do not target `default`.",
+            "Confirmation emails require a paid plan (same as Modules).",
+        ],
+    },
+    {
+        key: "booking",
+        name: "Booking",
+        summary: "Booking requests. Typed get/set for notify email and hours.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [
+            "get",
+            "set [--notify-email] [--hours \"…\"]",
+        ],
+        notYet: [],
+        examples: [
+            "frontpage modules booking",
+            "frontpage modules booking get",
+            "frontpage modules booking set --notify-email book@example.com --hours \"Mon–Fri 9–5\"",
+            "frontpage modules booking docs",
+        ],
+        notes: [
+            "Typed flags write the same whitelist as `modules config`. Generic JSON config still works.",
+        ],
+    },
+    {
+        key: "signups",
+        name: "Mailing list",
+        summary: "Email signups. Typed get/set for notify email and confirmations.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [
+            "get",
+            "set [--notify-email] [--confirm yes|no]",
+        ],
+        notYet: [],
+        examples: [
+            "frontpage modules signups",
+            "frontpage modules signups get",
+            "frontpage modules signups set --notify-email hello@example.com --confirm no",
+            "frontpage modules signups docs",
+        ],
+        notes: [
+            "Confirmation emails require a paid plan (same as Modules).",
+            "Typed flags write the same whitelist as `modules config`. Generic JSON config still works.",
+        ],
+    },
+    {
+        key: "payments",
+        name: "Payments",
+        summary: "Stripe payments. Connect finishes in the browser, not the terminal.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [],
+        notYet: ["connect", "disconnect", "status"],
+        examples: [
+            "frontpage modules payments",
+            "frontpage modules payments docs",
+            'frontpage modules payments request-setup --reason "Deposit button needs Stripe"',
+        ],
+        notes: [
+            "OAuth cannot finish in this CLI. Use request-setup (editor amber bar) or the Modules hub.",
+            "payments and shop share one Stripe account.",
+        ],
+    },
+    {
+        key: "shop",
+        name: "Online store",
+        summary: "Stripe shop. Shares the payments Stripe account.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [],
+        notYet: ["connect", "disconnect", "status"],
+        examples: [
+            "frontpage modules shop",
+            "frontpage modules shop docs",
+            'frontpage modules shop request-setup --reason "You asked for a store — Stripe setup makes checkout live"',
+        ],
+        notes: [
+            "OAuth cannot finish in this CLI. Use request-setup (editor amber bar) or the Modules hub.",
+            "payments and shop share one Stripe account.",
+        ],
+    },
+    {
+        key: "ordering",
+        name: "Online ordering",
+        summary: "Square ordering. Connect finishes in the browser, not the terminal.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [],
+        notYet: ["connect", "disconnect", "sync", "status"],
+        examples: [
+            "frontpage modules ordering",
+            "frontpage modules ordering docs",
+            'frontpage modules ordering request-setup --reason "You asked for online ordering — Square setup makes it live"',
+        ],
+        notes: [
+            "OAuth cannot finish in this CLI. Use request-setup (editor amber bar) or the Modules hub.",
+        ],
+    },
+    {
+        key: "articles",
+        name: "Articles",
+        summary: "Content hub. Lifecycle lives on `frontpage articles`, not under modules.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [],
+        notYet: [],
+        examples: [
+            "frontpage modules articles",
+            "frontpage modules docs articles",
+            "frontpage articles list",
+        ],
+        notes: [
+            "Do not fold article create/edit under `modules articles`. Use `frontpage articles …`.",
+        ],
+    },
+    {
+        key: "google_reviews",
+        name: "Google reviews",
+        summary: "Connect a listing, list cached reviews, and curate what the site shows.",
+        genericActions: GENERIC_ACTIONS,
+        extraActions: [
+            "connect --place-id <id> | --maps-url <url>",
+            "resolve --place-id <id> | --maps-url <url>",
+            "status",
+            "list-reviews [--limit 20] [--offset 0] [--stars 4,5] [--hidden]",
+            "hide --id <reviewId>",
+            "show --id <reviewId>",
+            "set-stars 4,5",
+            "set-sort newest|highest|lowest",
+            "set-weight --id <reviewId> --weight 1-1000",
+            "reset-weights",
+            "write-review-url",
+            "refresh",
+            "disconnect [--yes]",
+        ],
+        notYet: [],
+        examples: [
+            "frontpage modules google_reviews",
+            "frontpage modules google_reviews connect --place-id ChIJ…",
+            "frontpage modules google_reviews list-reviews --stars 4,5",
+            "frontpage modules google_reviews hide --id author:123",
+            "frontpage modules google_reviews set-stars 4,5",
+            "frontpage modules google_reviews docs",
+            'frontpage modules google_reviews request-setup --reason "You asked for Google reviews — pick your listing so we show the right ones"',
+            "frontpage inbox google_reviews",
+        ],
+        notes: [
+            "Owner supplies a Place ID or Maps URL. The server resolves it. No Autocomplete, no Places key in the CLI.",
+            "Do not write placeId through `modules config` — that skips resolve + seed.",
+            "Disconnect deletes the listing connection, not the review cache.",
+            "Ask-widget scores: frontpage inbox google_reviews.",
+        ],
+    },
+];
+export const GOOGLE_REVIEWS_CLI_ACTIONS = [
+    "connect",
+    "resolve",
+    "status",
+    "list-reviews",
+    "hide",
+    "show",
+    "set-stars",
+    "set-sort",
+    "set-weight",
+    "reset-weights",
+    "write-review-url",
+    "refresh",
+    "disconnect",
+];
+export const TYPED_CONFIG_CLI_ACTIONS = ["get", "set"];
+export function isCliModuleAction(key, action) {
+    if (key === "google_reviews") {
+        return GOOGLE_REVIEWS_CLI_ACTIONS.includes(action);
+    }
+    if (key === "callbar" || key === "forms" || key === "booking" || key === "signups") {
+        return TYPED_CONFIG_CLI_ACTIONS.includes(action);
+    }
+    return false;
+}
+export function isDocumentedModuleKey(raw) {
+    return DOCUMENTED_MODULE_KEYS.includes(raw);
+}
+export function isGenericModuleVerb(raw) {
+    return GENERIC_MODULE_VERBS.includes(raw);
+}
+export function moduleCommand(key) {
+    return MODULE_COMMANDS.find((c) => c.key === key);
+}
+export function formatModuleUsage(key) {
+    const def = moduleCommand(key);
+    const lines = [
+        `${def.key} — ${def.name}`,
+        def.summary,
+        "",
+        `Usage: frontpage modules ${def.key} <action> [flags] [--site <slug>] [--json]`,
+        `       frontpage modules <generic> ${def.key} …`,
+        "",
+        "Actions (generic):",
+        "  docs                 Markup / agent how-to",
+        "  request-setup        Amber bar in the editor (CLI cannot show it)",
+        "  enable|disable|archive",
+        "  config --config '{…}'  Whitelisted JSON only",
+    ];
+    if (def.extraActions.length) {
+        lines.push("", "Actions (this module):", ...def.extraActions.map((a) => `  ${a}`));
+    }
+    if (def.notYet.length) {
+        lines.push("", "Not in this CLI yet (use Modules or the editor):", `  ${def.notYet.join(", ")}`);
+    }
+    if (def.notes.length) {
+        lines.push("", ...def.notes);
+    }
+    lines.push("", "Examples:", ...def.examples.map((e) => `  ${e}`));
+    lines.push("", "See also: https://frontpage.host/developers/modules");
+    return lines.join("\n");
+}
+export function formatModulesIndex() {
+    const rows = MODULE_COMMANDS.map((c) => `  ${c.key.padEnd(16)}  ${c.summary}`);
+    return [
+        "Module keys (see `frontpage modules <key>` for that key's CLI usage):",
+        ...rows,
+        "",
+        "Generic: frontpage modules list|docs|request-setup|enable|disable|archive|config …",
+        "Articles content: frontpage articles …",
+        "Index: https://frontpage.host/developers/modules",
+    ].join("\n");
+}

package/dist/modules/google_reviews.d.ts

@@ -0,0 +1 @@
+export declare function runGoogleReviews(slug: string, action: string, flags: string[]): Promise<number>;

package/dist/modules/google_reviews.js

@@ -0,0 +1,228 @@
+/**
+ * §CLI-MOD-GR — google_reviews extra verbs.
+ */
+import { assertNoUnknownFlags, hasFlag, takeFlag } from "../argv.js";
+import { EXIT_OK, LONG_MODULE_TIMEOUT_MS, v1Get, v1Post, } from "../http/client.js";
+import { emitOk, emitUsage, isJson, requireYesOrTty } from "../runtime.js";
+import { formatModuleUsage } from "./commands.js";
+const USAGE = formatModuleUsage("google_reviews");
+function pathFor(slug) {
+    return `/api/v1/sites/${encodeURIComponent(slug)}/modules/google_reviews`;
+}
+function takePlaceBody(work) {
+    const placeId = takeFlag(work, "--place-id");
+    const mapsUrl = takeFlag(work, "--maps-url");
+    assertNoUnknownFlags(work, "modules");
+    if (placeId && mapsUrl) {
+        return emitUsage("modules", "Pass --place-id or --maps-url, not both.\n\n" + USAGE);
+    }
+    if (!placeId && !mapsUrl) {
+        return emitUsage("modules", "Usage: frontpage modules google_reviews connect|resolve --place-id <id> | --maps-url <url>\n\n" + USAGE);
+    }
+    return { ...(placeId ? { placeId } : {}), ...(mapsUrl ? { mapsUrl } : {}) };
+}
+function clip(text, max = 80) {
+    const one = text.replace(/\s+/g, " ").trim();
+    if (one.length <= max)
+        return one;
+    return `${one.slice(0, max - 1)}…`;
+}
+function printReviews(rows) {
+    if (!rows.length) {
+        console.log("(no reviews)");
+        return;
+    }
+    for (const r of rows) {
+        const vis = r.visibility.padEnd(12);
+        const stars = `${Math.round(r.rating)}★`;
+        const quote = r.text ? `  “${clip(r.text)}”` : "";
+        console.log(`${vis}  ${stars}  ${r.authorName}${quote}`);
+    }
+}
+export async function runGoogleReviews(slug, action, flags) {
+    const work = [...flags];
+    if (action === "status" || action === "write-review-url") {
+        assertNoUnknownFlags(work, "modules");
+        const data = await v1Get(pathFor(slug));
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        const url = data.listing?.writeReviewUrl;
+        if (action === "write-review-url") {
+            if (!url)
+                return emitUsage("modules", "Connect a Google listing first.");
+            console.log(url);
+            return EXIT_OK;
+        }
+        const name = String(data.connection?.display?.businessName ?? "(not connected)");
+        const address = data.connection?.display?.address;
+        console.log(name);
+        if (address)
+            console.log(String(address));
+        console.log(`ready     ${data.connection?.ready ? "yes" : "no"}`);
+        if (data.listing) {
+            console.log(`rating    ${data.listing.rating ?? "—"}  (${data.listing.reviewCount ?? 0} listing)`);
+            console.log(`cached    ${data.listing.cachedCount ?? 0}`);
+            if (data.listing.newestReviewAt)
+                console.log(`newest    ${data.listing.newestReviewAt}`);
+        }
+        if (data.curation) {
+            console.log(`stars     ${(data.curation.stars ?? []).join(",")}`);
+            console.log(`sort      ${data.curation.sort ?? "newest"}`);
+            console.log(`hidden    ${data.curation.hiddenCount ?? 0}`);
+        }
+        if (url)
+            console.log(`write     ${url}`);
+        return EXIT_OK;
+    }
+    if (action === "list-reviews") {
+        const limit = takeFlag(work, "--limit");
+        const offset = takeFlag(work, "--offset");
+        const stars = takeFlag(work, "--stars");
+        const hidden = hasFlag(work, "--hidden");
+        assertNoUnknownFlags(work, "modules");
+        const q = new URLSearchParams();
+        if (limit)
+            q.set("limit", limit);
+        if (offset)
+            q.set("offset", offset);
+        if (stars)
+            q.set("stars", stars);
+        if (hidden)
+            q.set("hidden", "1");
+        const qs = q.toString() ? `?${q.toString()}` : "";
+        const data = await v1Get(`${pathFor(slug)}/reviews${qs}`);
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log(`${data.reviews.length} of ${data.total}  (offset ${data.offset})`);
+        printReviews(data.reviews);
+        return EXIT_OK;
+    }
+    if (action === "connect" || action === "resolve") {
+        const body = takePlaceBody(work);
+        if (typeof body === "number")
+            return body;
+        const data = await v1Post(pathFor(slug), { action, ...body }, action === "connect" ? { timeoutMs: LONG_MODULE_TIMEOUT_MS } : undefined);
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        if (action === "resolve") {
+            console.log(`${data.businessName} — ${data.address} — ${data.placeId}`);
+            return EXIT_OK;
+        }
+        const name = String(data.businessName ?? "listing");
+        const n = data.reviewCountCached ?? 0;
+        const url = data.writeReviewUrl ? ` Write-a-review: ${data.writeReviewUrl}` : "";
+        console.log(`Connected ${name} — ${n} reviews cached.${url}`);
+        return EXIT_OK;
+    }
+    if (action === "refresh") {
+        assertNoUnknownFlags(work, "modules");
+        const data = await v1Post(pathFor(slug), { action: "refresh" }, { timeoutMs: LONG_MODULE_TIMEOUT_MS });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log(`Refreshed — ${data.reviewCount ?? 0} reviews cached.`);
+        return EXIT_OK;
+    }
+    if (action === "disconnect") {
+        assertNoUnknownFlags(work, "modules");
+        const refuse = requireYesOrTty("disconnect Google reviews");
+        if (refuse)
+            return emitUsage("modules", refuse);
+        const data = await v1Post(pathFor(slug), { action: "disconnect" });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log("Disconnected. Cached reviews were kept.");
+        return EXIT_OK;
+    }
+    if (action === "hide" || action === "show") {
+        const id = takeFlag(work, "--id");
+        assertNoUnknownFlags(work, "modules");
+        if (!id)
+            return emitUsage("modules", `Usage: frontpage modules google_reviews ${action} --id <reviewId>\n\n${USAGE}`);
+        const data = await v1Post(pathFor(slug), {
+            action: action === "hide" ? "hide_review" : "show_review",
+            reviewId: id,
+        });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log(action === "hide" ? `Hidden ${id}.` : `Shown ${id}.`);
+        return EXIT_OK;
+    }
+    if (action === "set-stars") {
+        const fromFlag = takeFlag(work, "--stars");
+        const raw = fromFlag ?? work.shift();
+        assertNoUnknownFlags(work, "modules");
+        if (!raw)
+            return emitUsage("modules", `Usage: frontpage modules google_reviews set-stars 4,5\n\n${USAGE}`);
+        const stars = raw.split(",").map((s) => Number(s.trim())).filter((n) => Number.isInteger(n));
+        const data = await v1Post(pathFor(slug), {
+            action: "set_star_filter",
+            stars,
+        });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log(`Star filter: ${stars.join(",")}`);
+        return EXIT_OK;
+    }
+    if (action === "set-sort") {
+        const sort = takeFlag(work, "--sort") ?? work.shift();
+        assertNoUnknownFlags(work, "modules");
+        if (!sort || !["newest", "highest", "lowest"].includes(sort)) {
+            return emitUsage("modules", `Usage: frontpage modules google_reviews set-sort newest|highest|lowest\n\n${USAGE}`);
+        }
+        const data = await v1Post(pathFor(slug), {
+            action: "set_review_sort",
+            sort,
+        });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log(`Sort: ${sort}`);
+        return EXIT_OK;
+    }
+    if (action === "set-weight") {
+        const id = takeFlag(work, "--id");
+        const weightRaw = takeFlag(work, "--weight");
+        assertNoUnknownFlags(work, "modules");
+        if (!id || weightRaw == null) {
+            return emitUsage("modules", `Usage: frontpage modules google_reviews set-weight --id <reviewId> --weight 1-1000\n\n${USAGE}`);
+        }
+        const weight = Number(weightRaw);
+        const data = await v1Post(pathFor(slug), {
+            action: "set_review_weight",
+            reviewId: id,
+            weight,
+        });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log(weight === 1 ? `Weight cleared for ${id}.` : `Weight ${weight} for ${id}.`);
+        return EXIT_OK;
+    }
+    if (action === "reset-weights") {
+        assertNoUnknownFlags(work, "modules");
+        const data = await v1Post(pathFor(slug), { action: "reset_review_weights" });
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        console.log("Weights reset.");
+        return EXIT_OK;
+    }
+    return emitUsage("modules", `${USAGE}\n\nUnknown action "${action}".`);
+}

package/dist/modules/typed_config.d.ts

@@ -0,0 +1,4 @@
+export declare const TYPED_CONFIG_CLI_KEYS: readonly ["callbar", "forms", "booking", "signups"];
+export type TypedConfigCliKey = (typeof TYPED_CONFIG_CLI_KEYS)[number];
+export declare function isTypedConfigCliKey(key: string): key is TypedConfigCliKey;
+export declare function runTypedConfig(key: TypedConfigCliKey, slug: string, action: string, flags: string[]): Promise<number>;

package/dist/modules/typed_config.js

@@ -0,0 +1,146 @@
+/**
+ * §CLI-MOD-CFG — typed get/set for callbar, forms, booking, signups.
+ */
+import { assertNoUnknownFlags, takeFlag } from "../argv.js";
+import { EXIT_OK, v1Get, v1Post } from "../http/client.js";
+import { emitOk, emitUsage, isJson } from "../runtime.js";
+import { formatModuleUsage } from "./commands.js";
+export const TYPED_CONFIG_CLI_KEYS = ["callbar", "forms", "booking", "signups"];
+export function isTypedConfigCliKey(key) {
+    return TYPED_CONFIG_CLI_KEYS.includes(key);
+}
+function pathFor(slug, key) {
+    return `/api/v1/sites/${encodeURIComponent(slug)}/modules/${encodeURIComponent(key)}`;
+}
+function dash(v) {
+    if (v == null || v === "")
+        return "—";
+    return String(v);
+}
+function yesNo(v) {
+    if (v === true || v === "yes" || v === "true")
+        return "yes";
+    if (v === false || v === "no" || v === "false")
+        return "no";
+    return "—";
+}
+function printLine(label, value) {
+    console.log(`${label.padEnd(10)} ${value}`);
+}
+function printCallbar(config) {
+    printLine("phone", dash(config.phone));
+    printLine("sms", yesNo(config.sms));
+    printLine("label", dash(config.label));
+}
+function printBooking(config) {
+    printLine("notify", dash(config.notifyEmail));
+    printLine("hours", dash(config.hours));
+}
+function printConfirmable(config, confirmations) {
+    printLine("notify", dash(config.notifyEmail));
+    const on = config.confirmEnabled === true;
+    if (confirmations && !confirmations.available)
+        printLine("confirm", `${yesNo(on)}  (coming soon)`);
+    else if (confirmations && !confirmations.paid)
+        printLine("confirm", `${yesNo(on)}  (paid plan required)`);
+    else
+        printLine("confirm", yesNo(on));
+}
+function printFormsList(instances) {
+    if (!instances.length) {
+        console.log("(no forms)");
+        return;
+    }
+    for (const i of instances) {
+        const id = i.instance ?? "";
+        const label = i.label && i.label !== id ? i.label : "";
+        const status = String(i.status ?? "—");
+        const email = typeof i.config?.notifyEmail === "string" ? i.config.notifyEmail : "(account email)";
+        console.log(`${id.padEnd(20)}  ${status.padEnd(12)}  ${label ? `${label}  ` : ""}${email}`);
+    }
+}
+function parseYesNoFlag(raw, flag) {
+    if (raw == null)
+        return undefined;
+    if (raw === "yes" || raw === "true")
+        return true;
+    if (raw === "no" || raw === "false")
+        return false;
+    throw Object.assign(new Error(`${flag} must be yes or no.`), { exitCode: 2 });
+}
+export async function runTypedConfig(key, slug, action, flags) {
+    const usage = formatModuleUsage(key);
+    const work = [...flags];
+    if (action === "get") {
+        const instanceId = takeFlag(work, "--instance");
+        assertNoUnknownFlags(work, "modules");
+        const q = instanceId ? `?instanceId=${encodeURIComponent(instanceId)}` : "";
+        const data = await v1Get(`${pathFor(slug, key)}${q}`);
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        if (key === "forms" && !instanceId) {
+            printFormsList(data.instances ?? []);
+            return EXIT_OK;
+        }
+        if (key === "callbar")
+            printCallbar(data.config ?? {});
+        else if (key === "booking")
+            printBooking(data.config ?? {});
+        else
+            printConfirmable(data.config ?? {}, data.confirmations);
+        return EXIT_OK;
+    }
+    if (action === "set") {
+        const instanceId = takeFlag(work, "--instance");
+        const phone = takeFlag(work, "--phone");
+        const sms = takeFlag(work, "--sms");
+        const label = takeFlag(work, "--label");
+        const notifyEmail = takeFlag(work, "--notify-email");
+        const hours = takeFlag(work, "--hours");
+        const confirmRaw = takeFlag(work, "--confirm");
+        assertNoUnknownFlags(work, "modules");
+        let confirmEnabled;
+        try {
+            confirmEnabled = parseYesNoFlag(confirmRaw, "--confirm");
+        }
+        catch (err) {
+            return emitUsage("modules", `${err instanceof Error ? err.message : String(err)}\n\n${usage}`);
+        }
+        const body = { action: "set" };
+        if (instanceId)
+            body.instanceId = instanceId;
+        if (phone !== undefined)
+            body.phone = phone;
+        if (sms !== undefined)
+            body.sms = sms;
+        if (label !== undefined)
+            body.label = label;
+        if (notifyEmail !== undefined)
+            body.notifyEmail = notifyEmail;
+        if (hours !== undefined)
+            body.hours = hours;
+        if (confirmEnabled !== undefined)
+            body.confirmEnabled = confirmEnabled;
+        if (key === "forms" && !instanceId) {
+            return emitUsage("modules", `Usage: frontpage modules forms set --instance <slug> [--notify-email] [--confirm yes|no]\n\n${usage}`);
+        }
+        const data = await v1Post(pathFor(slug, key), body);
+        if (isJson()) {
+            emitOk("modules", data);
+            return EXIT_OK;
+        }
+        const updated = Array.isArray(data.updated) ? data.updated.join(", ") : "settings";
+        console.log(`Updated ${key}${instanceId ? ` ${instanceId}` : ""} — ${updated}.`);
+        const cfg = data.config ?? {};
+        if (key === "callbar")
+            printCallbar(cfg);
+        else if (key === "booking")
+            printBooking(cfg);
+        else
+            printConfirmable(cfg);
+        return EXIT_OK;
+    }
+    return emitUsage("modules", `${usage}\n\nUnknown action "${action}".`);
+}

package/dist/registry.js

@@ -317,18 +317,37 @@ export const COMMANDS = [
     {
         name: "modules",
         summary: "List, read docs, or mutate modules (secret masks only)",
-        usage: "frontpage modules [list|docs|request-setup|enable|disable|archive|config] <key> [--instance <id>] [--config '{…}'] [--site <slug>]",
+        usage: "frontpage modules [list|docs|request-setup|enable|disable|archive|config] <key> | frontpage modules <key> [action] [--instance <id>] [--config '{…}'] [--site <slug>]",
         topics: ["agent", "content"],
         examples: [
+            "frontpage modules google_reviews",
+            "frontpage modules google_reviews connect --place-id ChIJ…",
+            "frontpage modules google_reviews list-reviews --stars 4,5",
+            "frontpage modules google_reviews enable",
+            "frontpage modules callbar get",
+            "frontpage modules callbar set --phone +14085551234 --sms no",
+            "frontpage modules forms get",
+            "frontpage modules forms set --instance lead-gen --notify-email hi@example.com",
             "frontpage modules docs forms",
+            "frontpage modules docs google_reviews",
             "frontpage modules docs signups",
             "frontpage modules list",
             'frontpage modules request-setup payments --reason "You asked for a $50 deposit button — Stripe setup makes it live"',
+            'frontpage modules request-setup google_reviews --reason "You asked for Google reviews — pick your listing so we show the right ones"',
+        ],
+        flags: [
+            "Bare `frontpage modules <key>` prints that key's CLI usage (exit 2) — not agentDocs",
+            "Key-first and verb-first both work: `modules google_reviews enable` = `modules enable google_reviews`",
+            "google_reviews extras: connect / resolve / status / list-reviews / hide / show / set-stars / set-sort / set-weight / reset-weights / refresh / disconnect / write-review-url",
+            "callbar/forms/booking/signups: typed get / set (same whitelist as `modules config`)",
+            "See https://frontpage.host/developers/modules and /developers/modules/google-reviews",
         ],
         dangers: [
             "Secret values are never returned — masks only",
             "request-setup surfaces an owner prompt in the editor status bar (CLI cannot show it)",
+            "Do not write placeId through generic config — that skips listing resolve + seed",
         ],
+        seeAlso: ["articles", "inbox"],
     },
     {
         name: "extensions",
@@ -360,7 +379,7 @@ export const COMMANDS = [
     {
         name: "inbox",
         summary: "List leads / subscribers / orders",
-        usage: "frontpage inbox [leads|subscribers|orders|…] [--mark-read] [--csv] [--site <slug>]",
+        usage: "frontpage inbox [leads|subscribers|orders|google_reviews|…] [--mark-read] [--csv] [--site <slug>]",
         topics: ["content"],
         dangers: ["--mark-read is side-effecting with no confirm"],
     },
@@ -552,6 +571,7 @@ export const TOPICS = {
   frontpage analytics summary|query|funnel|timeseries|compare|sql …
   frontpage pages
   frontpage modules
+  frontpage modules <key>            # that key's CLI usage
   frontpage modules request-setup <key> --reason "…"
   frontpage extensions
 
@@ -564,12 +584,14 @@ export const TOPICS = {
   Do not publish unless asked.`,
     content: `Content
   frontpage media list|upload <file>   # images/PDF/video; text/CSV = inline not library; sitePath first when stored
-  frontpage inbox [leads|subscribers|orders|…] [--mark-read] [--csv]
+  frontpage inbox [leads|subscribers|orders|google_reviews|…] [--mark-read] [--csv]
   frontpage seo get [/path|--path /path] | seo set --path /
   frontpage articles list|content|create-section|create-article|set-draft|…
   frontpage fonts [list|search] [--slot …] [--query …]
   frontpage tokens set --group … --key … --value …
-  frontpage modules list|docs|request-setup|enable|disable|archive|config <key>  # mailing list key: signups
+  frontpage modules list|docs|request-setup|enable|disable|archive|config <key>
+  frontpage modules <key>            # that key's CLI usage (generic only in this phase)
+  # mailing list key: signups. Index: https://frontpage.host/developers/modules
   frontpage extensions list|docs|enable|disable|config <key>
   frontpage settings get|set
   frontpage edit --path / --old "…" --new "…"

package/llms.txt

@@ -8,7 +8,7 @@
 - Fonts: frontpage fonts [--slot] [--query] → exact value → tokens set fonts.<role> → APPLY font-sans|serif|mono|display. Build bundles catalog faces from tokens.ts and/or CSS font-family contexts (not prose). Inline-only without tokens works for catalog faces after rebuild; prefer tokens+utilities for brand roles.
 - Module/extension docs: frontpage modules docs <key> | frontpage extensions docs <key>
 - Search flags: --regex --case-sensitive --whole-word --files-only --context-lines --max-results
-- Modules setup: frontpage modules request-setup <key> --reason "…" (owner status bar; CLI cannot show it)
+- Modules setup: frontpage modules request-setup <key> --reason "…" (owner status bar; CLI cannot show it). frontpage modules <key> prints that key's CLI usage. Index: https://frontpage.host/developers/modules. Typed config: frontpage modules callbar|forms|booking|signups get|set (forms set needs --instance; confirm emails paid-plan only). google_reviews: frontpage modules google_reviews connect --place-id | --maps-url (server resolve + seed; no Autocomplete; do not write placeId via config). Also status, list-reviews, hide/show, set-stars, set-sort, set-weight, reset-weights, refresh, disconnect. Docs: https://frontpage.host/developers/modules/google-reviews. Markup: data-fp-google-reviews / data-fp-google-ask + required data-fp-requires="google_reviews". Ask scores: frontpage inbox google_reviews.
 - Analytics ops: frontpage analytics summary|query|funnel|timeseries|compare|sql (bare analytics = dashboard)
 - Media: frontpage media upload <file> (images/PDF ≤25 MB, video ≤50 MB, SVG/text ≤4 MB); human prints sitePath first — use /__media/uploads/<slug>/… in markup. Text/CSV is inline only (not media library; --json omits full content).
 - Prompt attachments: frontpage prompt "…" --attach <file|/__media/…|https://…> [--asset-url https://…] (same media caps as media upload)

package/package.json

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