frontpage-host 0.1.21 → 0.1.23

package/dist/modules/commands.js

@@ -7,9 +7,6 @@ export const DOCUMENTED_MODULE_KEYS = [
     "forms",
     "booking",
     "signups",
-    "payments",
-    "shop",
-    "ordering",
     "articles",
     "google_reviews",
 ];
@@ -62,7 +59,7 @@ export const MODULE_COMMANDS = [
         genericActions: GENERIC_ACTIONS,
         extraActions: [
             "get [--instance <slug>]",
-            "set --instance <slug> [--notify-email] [--confirm yes|no]",
+            "set --instance <slug> [--notify-email] [--confirm yes|no] [--confirm-template <id>]",
             "destinations [--instance <slug>]",
             "connect-destination <privyr|hubspot|pipedrive> --token \"…\" [--lead-source \"…\"]",
             "attach-destination --instance <slug> --provider <id>",
@@ -77,6 +74,7 @@ export const MODULE_COMMANDS = [
             "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 set --instance lead-gen --confirm-template <template-id>",
             "frontpage modules forms destinations",
             "frontpage modules forms connect-destination privyr --token \"…\"",
             "frontpage modules forms attach-destination --instance lead-gen --provider privyr",
@@ -86,6 +84,7 @@ export const MODULE_COMMANDS = [
         notes: [
             "Without --instance, get lists each form (id, status, notifyEmail). Do not target `default`.",
             "Confirmation emails require a paid plan (same as Modules).",
+            "--confirm-template sets that form's saved template id. Every token must be one of the form's input names. An empty value clears it. A series is not attached to a form.",
             "Destinations copy leads to HubSpot, Pipedrive, or Privyr. Connect once, then attach each form. Token write is admin (Privyr: paste the Incoming Webhook URL, not a token). request-destination-setup lights the editor amber bar (editor key). remove-destination requires --yes. Locations: https://frontpage.host/developers/modules#forms-destinations",
         ],
     },
@@ -130,85 +129,6 @@ export const MODULE_COMMANDS = [
             "Typed flags write the same whitelist as `modules config`. Generic JSON config still works.",
         ],
     },
-    {
-        key: "payments",
-        name: "Pay buttons",
-        summary: "One-click Stripe pay buttons. No cart. Connect finishes in the browser, not the terminal.",
-        genericActions: GENERIC_ACTIONS,
-        extraActions: [
-            "status",
-            "connect [--no-open]",
-            "disconnect [--yes]",
-        ],
-        notYet: [],
-        examples: [
-            "frontpage modules payments",
-            "frontpage modules payments status",
-            "frontpage modules payments connect --no-open",
-            "frontpage modules payments disconnect --yes",
-            "frontpage modules payments docs",
-            'frontpage modules payments request-setup --reason "Deposit button needs Stripe"',
-        ],
-        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.",
-            "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: "Catalog, cart, and Stripe checkout. Shares the Pay buttons Stripe account.",
-        genericActions: GENERIC_ACTIONS,
-        extraActions: [
-            "status",
-            "connect [--no-open]",
-            "disconnect [--yes]",
-        ],
-        notYet: [],
-        examples: [
-            "frontpage modules shop",
-            "frontpage modules shop status",
-            "frontpage modules shop connect --no-open",
-            "frontpage modules shop disconnect --yes",
-            "frontpage modules shop docs",
-            'frontpage modules shop request-setup --reason "You asked for a store — Stripe setup makes checkout live"',
-        ],
-        notes: [
-            "Connect needs an admin API key. It opens Frontpage (you must be logged in there), then Stripe. Already-connected sites stay live.",
-            "payments and shop share one Stripe account. Shop disconnect keeps the account on payments.",
-            "Shop still needs the shipping step in Modules if you have not set it.",
-            "request-setup still lights the editor amber bar when you want the owner to finish there.",
-        ],
-    },
-    {
-        key: "ordering",
-        name: "Online ordering",
-        summary: "Square ordering. Connect finishes in the browser, not the terminal.",
-        genericActions: GENERIC_ACTIONS,
-        extraActions: [
-            "status",
-            "connect [--no-open]",
-            "disconnect [--yes]",
-            "sync",
-        ],
-        notYet: ["fulfillment get|set"],
-        examples: [
-            "frontpage modules ordering",
-            "frontpage modules ordering status",
-            "frontpage modules ordering connect --no-open",
-            "frontpage modules ordering sync",
-            "frontpage modules ordering disconnect --yes",
-            "frontpage modules ordering docs",
-            'frontpage modules ordering request-setup --reason "You asked for online ordering — Square setup makes it live"',
-        ],
-        notes: [
-            "Connect needs an editor API key. It opens Frontpage (you must be logged in there), then Square. Already-connected sites stay live.",
-            "sync refreshes the Square catalog (same as the hub Sync button).",
-            "request-setup still lights the editor amber bar when you want the owner to finish there.",
-            "Fulfillment (pickup/delivery) is not in this CLI yet — use Modules or the editor.",
-        ],
-    },
     {
         key: "articles",
         name: "Articles",
@@ -281,7 +201,6 @@ export const GOOGLE_REVIEWS_CLI_ACTIONS = [
 ];
 export const TYPED_CONFIG_CLI_ACTIONS = ["get", "set"];
 export const STRIPE_OAUTH_CLI_ACTIONS = ["status", "connect", "disconnect"];
-export const ORDERING_OAUTH_CLI_ACTIONS = ["status", "connect", "disconnect", "sync"];
 export function isCliModuleAction(key, action) {
     if (key === "google_reviews") {
         return GOOGLE_REVIEWS_CLI_ACTIONS.includes(action);
@@ -301,12 +220,6 @@ export function isCliModuleAction(key, action) {
     if (key === "callbar" || key === "booking" || key === "signups") {
         return TYPED_CONFIG_CLI_ACTIONS.includes(action);
     }
-    if (key === "payments" || key === "shop") {
-        return STRIPE_OAUTH_CLI_ACTIONS.includes(action);
-    }
-    if (key === "ordering") {
-        return ORDERING_OAUTH_CLI_ACTIONS.includes(action);
-    }
     return false;
 }
 export function isDocumentedModuleKey(raw) {
@@ -318,6 +231,26 @@ export function isGenericModuleVerb(raw) {
 export function moduleCommand(key) {
     return MODULE_COMMANDS.find((c) => c.key === key);
 }
+export function formatShopIsNotAModule() {
+    return [
+        "shop is not a module. Use frontpage store.",
+        "",
+        "Catalog, fulfillment, pay buttons, and Stripe connect:",
+        "  frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect",
+        "",
+        "See also: https://frontpage.host/developers/store",
+    ].join("\n");
+}
+export function formatPaymentsIsNotAModule() {
+    return [
+        "payments is not a module. Use frontpage store.",
+        "",
+        "Stripe connect lives on Store:",
+        "  frontpage store connect|status|disconnect|payments",
+        "",
+        "See also: https://frontpage.host/developers/store",
+    ].join("\n");
+}
 export function formatModuleUsage(key) {
     const def = moduleCommand(key);
     const lines = [
@@ -353,6 +286,7 @@ export function formatModulesIndex() {
         ...rows,
         "",
         "Generic: frontpage modules list|docs|request-setup|enable|disable|archive|config …",
+        "Store: frontpage store …",
         "Articles content: frontpage articles …",
         "Index: https://frontpage.host/developers/modules",
     ].join("\n");

package/dist/modules/oauth.d.ts

@@ -1,4 +1,4 @@
-export declare const OAUTH_CLI_KEYS: readonly ["payments", "shop", "ordering"];
+export declare const OAUTH_CLI_KEYS: readonly [];
 export type OauthCliKey = (typeof OAUTH_CLI_KEYS)[number];
 export declare function isOauthCliKey(key: string): key is OauthCliKey;
 export declare function resolveOpenUrl(raw: unknown): string | null;
@@ -9,4 +9,4 @@ export declare function browserOpenCommand(url: string, platform?: NodeJS.Platfo
     windowsVerbatimArguments?: boolean;
 };
 export declare function openBrowser(url: string): void;
-export declare function runOauthHandoff(key: OauthCliKey, slug: string, action: string, flags: string[]): Promise<number>;
+export declare function runOauthHandoff(_key: OauthCliKey, _slug: string, _action: string, _flags: string[]): Promise<number>;

package/dist/modules/oauth.js

@@ -1,19 +1,14 @@
 /**
- * §CLI-MOD-OAUTH / §CLI-MOD-HARD — payments / shop / ordering connect, status, disconnect, sync.
+ * Browser helpers for Store Stripe connect (`frontpage store connect`).
+ * Leftover-order module OAuth is gone.
  */
 import { spawn } from "node:child_process";
-import { assertNoUnknownFlags, hasFlag } from "../argv.js";
-import { apiBase, EXIT_OK, v1Get, v1Post } from "../http/client.js";
-import { emitOk, emitUsage, isJson, requireYesOrTty } from "../runtime.js";
-import { formatModuleUsage } from "./commands.js";
-export const OAUTH_CLI_KEYS = ["payments", "shop", "ordering"];
+import { apiBase } from "../http/client.js";
+import { emitUsage } from "../runtime.js";
+export const OAUTH_CLI_KEYS = [];
 export function isOauthCliKey(key) {
     return OAUTH_CLI_KEYS.includes(key);
 }
-const FINISH = "Open the Frontpage URL while logged in, finish Stripe or Square in the browser, then re-run status. This CLI cannot complete OAuth.";
-function pathFor(slug, key) {
-    return `/api/v1/sites/${encodeURIComponent(slug)}/modules/${encodeURIComponent(key)}`;
-}
 export function resolveOpenUrl(raw) {
     if (typeof raw !== "string" || !raw.trim())
         return null;
@@ -44,95 +39,6 @@ export function openBrowser(url) {
         ...(spec.windowsVerbatimArguments ? { windowsVerbatimArguments: true } : {}),
     }).unref();
 }
-function printStatus(key, data) {
-    const connection = (data.connection ?? {});
-    const display = connection.display ?? {};
-    console.log(`connected  ${connection.ready ? "yes" : "no"}`);
-    if (key === "ordering") {
-        console.log(`merchant   ${display.merchantName ?? "—"}`);
-        if (display.locationCount != null)
-            console.log(`locations  ${display.locationCount}`);
-        if (display.cardProcessing != null)
-            console.log(`cards      ${display.cardProcessing ? "yes" : "no"}`);
-        if (display.menuSyncedAt)
-            console.log(`menu sync  ${display.menuSyncedAt}`);
-    }
-    else {
-        console.log(`charges    ${display.chargesEnabled == null ? "—" : display.chargesEnabled ? "yes" : "no"}`);
-        console.log(`account    ${display.accountPresent ? "present" : "none"}`);
-        if (typeof data.sharedStripe === "string")
-            console.log(`note       ${data.sharedStripe}`);
-    }
-    if (typeof data.connectUrl === "string")
-        console.log(`connect    ${data.connectUrl}`);
-}
-export async function runOauthHandoff(key, slug, action, flags) {
-    const work = [...flags];
-    const usage = formatModuleUsage(key);
-    if (action === "status") {
-        assertNoUnknownFlags(work, "modules");
-        const data = await v1Get(pathFor(slug, key));
-        if (isJson()) {
-            emitOk("modules", data);
-            return EXIT_OK;
-        }
-        printStatus(key, data);
-        return EXIT_OK;
-    }
-    if (action === "connect") {
-        const noOpen = hasFlag(work, "--no-open");
-        assertNoUnknownFlags(work, "modules");
-        const data = await v1Post(pathFor(slug, key), { action: "connect" });
-        const already = data.alreadyConnected === true;
-        if (isJson()) {
-            emitOk("modules", data);
-        }
-        else {
-            const url = resolveOpenUrl(data.connectUrl);
-            if (url)
-                console.log(url);
-            console.log(typeof data.message === "string" ? data.message : already ? "Already connected." : FINISH);
-            if (typeof data.warning === "string")
-                console.log(data.warning);
-        }
-        const url = resolveOpenUrl(data.connectUrl);
-        if (url && !noOpen && !already)
-            openBrowser(url);
-        return EXIT_OK;
-    }
-    if (action === "disconnect") {
-        assertNoUnknownFlags(work, "modules");
-        const label = key === "ordering"
-            ? "disconnect Square"
-            : key === "payments"
-                ? "disconnect payments (shared Stripe account with the store)"
-                : "disconnect the store (shared Stripe account with payments)";
-        const refuse = requireYesOrTty(label);
-        if (refuse)
-            return emitUsage("modules", refuse);
-        const data = await v1Post(pathFor(slug, key), { action: "disconnect" });
-        if (isJson()) {
-            emitOk("modules", data);
-            return EXIT_OK;
-        }
-        console.log(typeof data.message === "string" ? data.message : "Disconnected.");
-        if (typeof data.warning === "string" && data.warning !== data.message) {
-            console.log(data.warning);
-        }
-        return EXIT_OK;
-    }
-    if (action === "sync") {
-        if (key !== "ordering") {
-            return emitUsage("modules", `sync is only available for ordering.\n\n${usage}`);
-        }
-        assertNoUnknownFlags(work, "modules");
-        const data = await v1Post(pathFor(slug, key), { action: "sync" });
-        if (isJson()) {
-            emitOk("modules", data);
-            return EXIT_OK;
-        }
-        console.log(`Synced — ${data.itemCount ?? 0} items, ${data.locationCount ?? 0} locations.`);
-        return EXIT_OK;
-    }
-    return emitUsage("modules", `${usage}\n\nUnknown action "${action}".`);
+export async function runOauthHandoff(_key, _slug, _action, _flags) {
+    return emitUsage("modules", "Unknown module.");
 }

package/dist/modules/typed_config.js

@@ -45,6 +45,9 @@ function printConfirmable(config, confirmations) {
         printLine("confirm", `${yesNo(on)}  (paid plan required)`);
     else
         printLine("confirm", yesNo(on));
+    if (typeof config.confirmTemplateId === "string") {
+        printLine("template", config.confirmTemplateId.trim() || "—");
+    }
 }
 function printFormsList(instances, destinations) {
     if (!instances.length) {
@@ -112,6 +115,7 @@ export async function runTypedConfig(key, slug, action, flags) {
         const notifyEmail = takeFlag(work, "--notify-email");
         const hours = takeFlag(work, "--hours");
         const confirmRaw = takeFlag(work, "--confirm");
+        const confirmTemplate = takeFlag(work, "--confirm-template");
         assertNoUnknownFlags(work, "modules");
         let confirmEnabled;
         try {
@@ -135,8 +139,14 @@ export async function runTypedConfig(key, slug, action, flags) {
             body.hours = hours;
         if (confirmEnabled !== undefined)
             body.confirmEnabled = confirmEnabled;
+        if (confirmTemplate !== undefined) {
+            if (key !== "forms") {
+                return emitUsage("modules", `--confirm-template is only for forms.\n\n${usage}`);
+            }
+            body.confirmTemplateId = confirmTemplate.trim();
+        }
         if (key === "forms" && !instanceId) {
-            return emitUsage("modules", `Usage: frontpage modules forms set --instance <slug> [--notify-email] [--confirm yes|no]\n\n${usage}`);
+            return emitUsage("modules", `Usage: frontpage modules forms set --instance <slug> [--notify-email] [--confirm yes|no] [--confirm-template <id>]\n\n${usage}`);
         }
         const data = await v1Post(pathFor(slug, key), body);
         if (isJson()) {

package/dist/registry.d.ts

@@ -6,6 +6,8 @@ export type CommandDef = {
     name: string;
     summary: string;
     usage?: string;
+    /** Unpublished leftover names that still dispatch. Help does not list these. */
+    aliases?: readonly string[];
     /** Topic tags for `help <topic>`. */
     topics?: string[];
     examples?: string[];

package/dist/registry.js

@@ -335,13 +335,13 @@ export const COMMANDS = [
             "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 ordering connect --no-open",
-            "frontpage modules payments status",
+            "frontpage modules forms set --instance lead-gen --confirm-template <template-id>",
+            "frontpage store connect --no-open",
             "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 store connect --no-open',
             'frontpage modules request-setup google_reviews --reason "You asked for Google reviews — pick your listing so we show the right ones"',
         ],
         flags: [
@@ -349,13 +349,13 @@ export const COMMANDS = [
             "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`)",
-            "payments/shop/ordering: connect opens the browser; finish there, then status. --no-open for CI. request-setup still lights the editor amber bar.",
+            "Store Stripe connect is frontpage store connect. request-setup still lights the editor amber bar.",
             "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)",
-            "payments and shop share one Stripe account — payments disconnect 409s if the store still uses it",
+            "payments and the store share one Stripe account — payments disconnect 409s if the store still uses it",
             "OAuth cannot finish in the terminal; connect only opens the vendor URL",
             "Do not write placeId through generic config — that skips listing resolve + seed",
         ],
@@ -413,6 +413,29 @@ export const COMMANDS = [
         topics: ["content"],
         dangers: ["--mark-read is side-effecting with no confirm"],
     },
+    {
+        name: "routines",
+        summary: "Schedule a prompt for the site agent (not a module)",
+        usage: "frontpage routines list|get|add|set|pause|resume|rm|run|runs [--site <slug>] [--json]",
+        topics: ["content"],
+        examples: [
+            "frontpage routines list",
+            "frontpage routines add --cadence weekly --weekdays tue,thu,fri --hours 8am,12pm,4pm --timezone America/Chicago --name \"Weekday check\" --prompt \"Review new form submissions and reply to each customer.\"",
+            "frontpage routines pause <id>",
+            "frontpage routines resume <id>",
+            "frontpage routines run <id>",
+        ],
+        flags: [
+            "add requires --name, --prompt, --cadence hourly|daily|weekly|monthly, and --timezone (IANA, such as America/Chicago)",
+            "--hours accepts 8, 8am, 12pm, 4pm. Several hours: 8am,12pm,4pm stores [8, 12, 16]",
+            "--weekdays accepts tue,thu,fri or 2,4,5. Sunday is 0. Weekly only",
+            "--month-days accepts 1,15. Days are 1 through 28. Monthly only",
+            "add starts the clock. pause stops it. run fires once and does not move the next time",
+            "That Tuesday example stores hours [8, 12, 16] and weekdays [2, 4, 5] on one routine",
+            "Unknown leftover flags fail closed (exit 2)",
+        ],
+        seeAlso: ["people", "https://frontpage.host/developers/routines"],
+    },
     {
         name: "people",
         summary: "List and manage site People (not inbox, not a module)",
@@ -422,6 +445,7 @@ export const COMMANDS = [
             "frontpage people list",
             "frontpage people add --email alex@example.com --name Alex",
             "frontpage people set <id> --status working",
+            "frontpage people set <id> --line1 \"12 Main\" --city Austin --region TX --postal 78701 --country US",
             "frontpage people note <id> --body \"Called them\"",
             "frontpage people follow-up <id> --at 2026-09-12T00:00:00Z",
             "frontpage people hide <id>",
@@ -440,36 +464,42 @@ export const COMMANDS = [
         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|connect|status|disconnect … [--site <slug>] [--json]",
+        name: "store",
+        summary: "Store catalog: items, variants, stock, and store settings (not inbox)",
+        usage: "frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect|import … [--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",
-            "frontpage shop connect --no-open",
-            "frontpage shop status",
+            "frontpage store items list",
+            "frontpage store categories create hats --label Hats",
+            "frontpage store items create camp-hat --title \"Camp hat\" --price-cents 4999 --categories hats --stock 20",
+            "frontpage store settings set-checkout --mode cart",
+            "frontpage store items list --category hats",
+            "frontpage store variants add camp-hat --id m --option Size=M --price-cents 4999 --stock 8",
+            "frontpage store items stock camp-hat --variant m --add 5",
+            "frontpage store items stock camp-hat --variant m --remove 5",
+            "frontpage store items stock camp-hat --variant m --set 20",
+            "frontpage store settings set-fulfillment --mode pickup",
+            "frontpage store settings set-fulfillment --pickup --delivery --mode flat-rate --flat-cents 500 --pickup-location \"The shop\"",
+            "frontpage store settings set-currency --currency usd",
+            "frontpage store settings set-currency --currency jpy",
+            "frontpage store connect --no-open",
+            "frontpage store status",
+            "frontpage store import",
         ],
         flags: [
-            "Integer cents only. $49.99 is 4999. Do not send 49.99 or a dollar string.",
+            "Integer cents only. $49.99 is 4999. Do not send 49.99 or a dollar string. --price-cents is the usual cost. Optional --discount-cents is the sale the buyer pays (strictly less than price). Omit --discount-cents when there is no sale. Checkout charges the sale; the site strikes through the usual price.",
             "--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",
+            "items: list|get|create|update|archive|activate [--off] | images --urls … | stock [--variant m] --add|--remove|--set. list --category hats. items list --json returns every product and every variant — do not paste that into a model. The editor manage_store list_items call is one page of 25 slim rows plus total; get_item is one product. 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: frontpage shop connect|status|disconnect. connect opens Frontpage then Stripe; --no-open for CI. disconnect keeps the shared Stripe account on payments.",
+            "settings: get|set-fulfillment|set-currency|set-checkout|set-checkout-fee. Currency is any Stripe presentment code such as usd or jpy. Checkout is store-wide (cart or instant). Do not use leftover items --checkout to pick cart vs Pay now. Gift cards still use --amount open --min-cents. Service fee applies to Add to cart and Pay now. Connect: frontpage store connect|status|disconnect. connect opens Frontpage then Stripe; --no-open for CI. disconnect keeps the shared Stripe account on payments.",
+            "Page markup is yours: data-fp-store-grid + data-fp-cart (cart starts hidden), every store control data-fp-requires=store. The public catalog pages with offset, limit, total, and truncated (default 24). list_items is the same shape with a max of 25. Product pages are the default: unless they said they do not want product pages, write one src/pages/products/item.astro (or shop) with data-fp-store-product. If they said no, skip that file and do not bind href or url. Description is a small markdown subset. PDP bind is <div data-fp-store-bind=description>. Do not bake titles or prices. Guide: https://frontpage.host/developers/store",
+            "import reads src/content/products/*.json from the site store into Store. One default variant each. Skip if that itemId already exists. Does not invent categories or change fulfillment.",
             "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"],
+        seeAlso: ["inbox", "https://frontpage.host/developers/store"],
     },
     {
         name: "mail",
@@ -691,6 +721,7 @@ export const TOPICS = {
   - Forms: <form data-fp-form="slug"> with named inputs; no action/onsubmit/honeypot.
   - Articles: frontpage articles …; migrate folders via frontpage prompt (don't invent mass delete+write).
   - Media: frontpage media upload (images/PDF ≤25 MB, video ≤50 MB). frontpage images generate --prompt "…" [--count N] for 1–4 AI variations of one invented picture (AI $ + storage). Use sitePath /__media/uploads/<slug>/… in markup (not raw blob URLs). Optional ?w= on rasters only.
+  - Store: frontpage store for catalog, settings set-checkout / set-fulfillment / set-checkout-fee, and connect. Write data-fp-store-grid + data-fp-cart (data-fp-requires=store; cart starts hidden). Unless they said they do not want product pages, write one src/pages/products/item.astro with data-fp-store-product. If they said no, skip that file and do not bind href or url. Guide: https://frontpage.host/developers/store
 
   Full guide: https://frontpage.host/developers/site-building
   See also: frontpage help sync | content | AGENTS.md`,
@@ -727,9 +758,13 @@ export const TOPICS = {
   frontpage inbox [leads|subscribers|orders|google_reviews|…] [--mark-read] [--csv]
   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|connect|status|disconnect
-  # Store catalog: https://frontpage.host/developers/shop
+  frontpage routines list|get|add|set|pause|resume|rm|run|runs
+  # Routines guide: https://frontpage.host/developers/routines
+  # 8am,12pm,4pm and tue,thu,fri store hours [8, 12, 16] and weekdays [2, 4, 5] on one routine. Timezone is IANA.
+  frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect
+  # Store catalog + live storefront: https://frontpage.host/developers/store
   # Integer cents only. $49.99 is 4999. stock --add/--remove are signed delta.
+  # Markup: data-fp-store-grid / data-fp-store-product / data-fp-cart. One item.astro, not one file per product.
   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
@@ -738,8 +773,7 @@ export const TOPICS = {
   frontpage tokens set --group … --key … --value …
   frontpage modules list|docs|request-setup|enable|disable|archive|config <key>
   frontpage modules <key>            # that key's CLI usage
-  frontpage modules payments|shop|ordering connect [--no-open]   # opens Frontpage then Stripe/Square; then status
-  frontpage modules ordering sync
+  frontpage store connect [--no-open]                        # Store Stripe connect
   # mailing list key: signups. Index: https://frontpage.host/developers/modules
   frontpage extensions list|docs|enable|disable|config <key>
   frontpage settings get|set
@@ -749,7 +783,7 @@ export const TOPICS = {
   Do not fake payments/checkout. LOCKED extensions → do not fake; say plan required.
   Migrate pages → articles: prefer frontpage prompt "migrate …" over mass delete+write.
   edit uses click-edit (exact single occurrence), not push / gated-write.
-  Connect opens Frontpage (logged-in), then Stripe/Square; never accepts or returns OAuth secrets. payments/shop connect is admin.
+  Connect opens Frontpage (logged-in), then Stripe; never accepts or returns OAuth secrets. Store connect is frontpage store connect.
   Site contract: frontpage help site-building · https://frontpage.host/developers/site-building
   Domains, billing, members, and site delete are out of v1.`,
     history: `History
@@ -787,5 +821,5 @@ export const TOPICS = {
   Prefer requestId from API error envelopes when filing support issues.`,
 };
 export function findCommand(name) {
-    return COMMANDS.find((c) => c.name === name);
+    return COMMANDS.find((c) => c.name === name || c.aliases?.includes(name));
 }

package/dist/routines-parse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI schedule words → the numbers the API stores.
+ * tue,thu,fri and 8am,12pm,4pm become weekdays [2, 4, 5] and hours [8, 12, 16].
+ */
+export declare function parseHourList(raw: string | undefined): number[];
+export declare function parseWeekdayList(raw: string | undefined): number[];
+export declare function parseMonthDayList(raw: string | undefined): number[];

package/dist/routines-parse.js

@@ -0,0 +1,78 @@
+/**
+ * CLI schedule words → the numbers the API stores.
+ * tue,thu,fri and 8am,12pm,4pm become weekdays [2, 4, 5] and hours [8, 12, 16].
+ */
+const WEEKDAYS = {
+    sun: 0,
+    sunday: 0,
+    mon: 1,
+    monday: 1,
+    tue: 2,
+    tues: 2,
+    tuesday: 2,
+    wed: 3,
+    wednesday: 3,
+    thu: 4,
+    thur: 4,
+    thurs: 4,
+    thursday: 4,
+    fri: 5,
+    friday: 5,
+    sat: 6,
+    saturday: 6,
+};
+export function parseHourList(raw) {
+    if (!raw || !raw.trim())
+        return [];
+    return unique(raw.split(",").map((part) => parseHour(part.trim())));
+}
+export function parseWeekdayList(raw) {
+    if (!raw || !raw.trim())
+        return [];
+    return unique(raw.split(",").map((part) => parseWeekday(part.trim())));
+}
+export function parseMonthDayList(raw) {
+    if (!raw || !raw.trim())
+        return [];
+    return unique(raw.split(",").map((part) => {
+        const n = Number(part.trim());
+        if (!Number.isInteger(n) || n < 1 || n > 28) {
+            throw new Error(`Month day must be 1 through 28. Got "${part.trim()}".`);
+        }
+        return n;
+    }));
+}
+function unique(values) {
+    return [...new Set(values)].sort((a, b) => a - b);
+}
+function parseHour(raw) {
+    const ampm = raw.toLowerCase().match(/^(\d{1,2})(?::(\d{2}))?\s*(am|pm)$/);
+    if (ampm) {
+        if (ampm[2] && ampm[2] !== "00") {
+            throw new Error(`Routines fire at minute 0. Got "${raw}".`);
+        }
+        let hour = Number(ampm[1]);
+        if (hour < 1 || hour > 12)
+            throw new Error(`Hour "${raw}" is not valid.`);
+        if (ampm[3] === "am")
+            hour = hour === 12 ? 0 : hour;
+        else
+            hour = hour === 12 ? 12 : hour + 12;
+        return hour;
+    }
+    if (/^\d{1,2}$/.test(raw)) {
+        const hour = Number(raw);
+        if (hour < 0 || hour > 23)
+            throw new Error(`Hour must be 0 through 23. Got "${raw}".`);
+        return hour;
+    }
+    throw new Error(`Hour "${raw}" is not valid. Use 8, 8am, or 4pm.`);
+}
+function parseWeekday(raw) {
+    const named = WEEKDAYS[raw.toLowerCase()];
+    if (named !== undefined)
+        return named;
+    if (/^[0-6]$/.test(raw))
+        return Number(raw);
+    throw new Error(`Weekday "${raw}" is not valid. Use tue or 2. Sunday is 0.`);
+}