frontpage-host 0.1.21 → 0.1.22

package/dist/modules/commands.js

@@ -7,9 +7,6 @@ export const DOCUMENTED_MODULE_KEYS = [
     "forms",
     "booking",
     "signups",
-    "payments",
-    "shop",
-    "ordering",
     "articles",
     "google_reviews",
 ];
@@ -130,85 +127,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 +199,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 +218,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 +229,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 +284,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/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,12 @@ 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 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 +348,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 +412,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 +444,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 +463,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",
             "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. 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 +720,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 +757,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 +772,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 +782,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 +820,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.`);
+}

package/llms.txt

@@ -9,7 +9,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: wizard modules (payments/shop/ordering): frontpage modules <key> connect [--no-open] opens Frontpage (logged-in browser) then Stripe/Square; already-connected stays live. payments/shop connect = admin key; ordering = editor. payments disconnect 409s if shop still uses the shared Stripe account. request-setup remains valid for the editor amber bar. 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). Form destinations: frontpage modules forms destinations|connect-destination|attach-destination|detach-destination|remove-destination --yes|request-destination-setup (token = admin; request-destination-setup lights the editor bar; request-setup forms is a no-op; connect does not attach every form). Privyr: paste Incoming Webhook URL (https://www.privyr.com/api/v1/incoming-leads/…), not a token. HubSpot: Development → Keys → Service keys or Legacy apps → Auth → Show token. Pipedrive: profile → Company settings → Personal preferences → API. Docs: https://frontpage.host/developers/modules#forms-destinations. 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.
+- Modules setup: Store Stripe connect is frontpage store connect. payments disconnect 409s if the store still uses the shared Stripe account. request-setup remains valid for the editor amber bar. 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). Form destinations: frontpage modules forms destinations|connect-destination|attach-destination|detach-destination|remove-destination --yes|request-destination-setup (token = admin; request-destination-setup lights the editor bar; request-setup forms is a no-op; connect does not attach every form). Privyr: paste Incoming Webhook URL (https://www.privyr.com/api/v1/incoming-leads/…), not a token. HubSpot: Development → Keys → Service keys or Legacy apps → Auth → Show token. Pipedrive: profile → Company settings → Personal preferences → API. Docs: https://frontpage.host/developers/modules#forms-destinations. 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)
@@ -17,7 +17,8 @@
 - 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 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|connect|status|disconnect. 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. frontpage shop connect [--no-open] opens Frontpage then Stripe; disconnect keeps the shared account on payments. frontpage modules shop|payments connect still works. Not Square ordering. Guide: https://frontpage.host/developers/shop
+- Routines: frontpage routines list|get|add|set|pause|resume|rm|run|runs. Several hours and several days are one routine. 8am,12pm,4pm and tue,thu,fri store hours [8, 12, 16] and weekdays [2, 4, 5]. Timezone is IANA. Do not guess UTC. Guide: https://frontpage.host/developers/routines
+- Store catalog: frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect. Integer cents only ($49.99 is 4999). --price-cents is the usual cost. Optional --discount-cents is the sale the buyer pays (must be lower). Create a category before assigning it. Photos are /__media/uploads/<this-slug>/… or an HTTPS URL already saved on this site. frontpage store connect [--no-open] opens Frontpage then Stripe. Checkout is store-wide (settings set-checkout); do not use leftover items --checkout to pick cart vs Pay now. Service fee is settings set-checkout-fee. The cart starts hidden. 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; product-page bind is <div data-fp-store-bind="description">. Every store control carries data-fp-requires="store". Leave data-fp-store-variants empty. Do not bake titles or prices. Guide: https://frontpage.host/developers/store
 - 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.21",
+  "version": "0.1.22",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {