frontpage-host 0.3.4 → 0.3.5

package/AGENTS.md

@@ -293,3 +293,5 @@ People CRM has People and Groups tabs. Group details has Group details, Stages a
 For a manual group, `groups.people` accepts `availability: "all" | "available" | "member"` through `--data`. The server applies saved membership before counts and paging. This filter never grants or requires email permission. In the UI, conditional groups use condition preview instead of manual additions. Existing explicit owner-exception operations stay available through the advanced service.
 
 Before a reviewed `groups.update`, read `groups.list` and pass its `emailVersion` as optional `expectedGroup`. A 409 means the saved settings changed; read and review again before writing. Membership counts do not change this version. For the UI's Add people CSV behavior, pass `manualGroupsOnly:true` to `import.start`. The job keeps this choice and reports rows if a destination becomes conditional before processing; it never creates an include exception from that request. Retry with the same accepted key/payload, and inspect the saved job. Existing explicit advanced imports keep their prior contract when the option is omitted.
+
+Complete Store edits: use existing items update --file with changed fields and variantUpdates. stock requires expectedStock from a fresh items get. One transaction saves all changes or none. On 409 review current stock; never silently substitute it. firstVariant plus optionNames enables versions. Keep explicit stock/variant commands for single operations. Routines add accepts --request-id UUID; reuse that ID and exact schedule after a lost response. Ordinary form edits live only in the active task; Cancel keeps input, Discard loses unfinished input. Submitted payments, imports, builds, and API-key status are separate operations.

package/README.md

@@ -81,7 +81,7 @@ frontpage store items get camp-hat --site my-site --json
 
 ### Store inventory and product options
 
-CLI 0.2.9 adds `items update --file`; explicit flags override file values.
+`items update --file` accepts product changes; explicit flags override file values.
 
 ```bash
 frontpage store variants update camp-hat --id default --stock unlimited --site my-site
@@ -96,3 +96,17 @@ A whole stock count of `0` means sold out; `unlimited` sends JSON null. Omit sto
 See [MAIL.md](./MAIL.md) for the complete save contract, reusable people picker directory, saved campaign recipients, Off-series enrollment and resume timing, all sender settings/null resets, suppression rules, Sent queries and details, and retry-safe examples. `frontpage mail save --file save.json` saves template and pending series together; it never sends. `frontpage mail people` reads the same site-scoped directory as the workspace. Use `frontpage help mail --json` for current commands and flags. No new CLI binary, API namespace or migration command is required. Hosted guides and article help must be updated through the Frontpage CLI.
 
 The workspace validates and saves unfinished group settings before opening email setup. CLI and agent callers use `groups.create` / `groups.update` with a stable `requestKey` before attaching; `groups.count` reads the full visible match count. Group details Email and stage email tasks use the existing `frontpage mail save` / `save_mail_editor` completion. `attachment` checks saved group/stage emailVersion, creates paused rules, supports shared-template edits with rule revisions, and recovers identical retries. Read MAIL.md, Group and stage email tasks. Template get includes ruleUsage; deletion protects paused and active rule dependencies. Creating or saving never activates, enrolls or sends.
+
+### Complete product edits
+
+`frontpage store items update ITEM_ID --file edit.json` uses the existing `/shop/items/ITEM_ID` PATCH. Send only changed fields. Product details and `variantUpdates` save in one transaction: all changes save or none do. Ordinary fields use the last successful save. Unchanged fields stay untouched.
+
+```json
+{"title":"Camp hat","variantUpdates":[{"variantId":"default","priceCents":1300,"stock":3,"expectedStock":5}]}
+```
+
+Read `items get` first. Include `expectedStock` only when changing stock; copy the current count or null for unlimited. If stock changed before Save, the whole edit fails with 409 and nothing saves. Read the product and review that stock change before retrying. Do not silently replace the expected count. Omitted stock stays untouched. `discountPriceCents:null` clears a sale. Prices use integer cents.
+
+To turn versions on in the same edit, send `optionNames` and `firstVariant` using the normal variant fields. Do not combine `firstVariant` with `variantUpdates`. To turn versions off, send `optionNames:[]`; optional changes then address the `default` variant. Existing stock and variant commands remain available for explicit individual operations. IDs, order history, site/role/plan gates, and provider ownership stay unchanged. Browser forms use the same service. A successful save returns the saved product; a later list refresh cannot undo it.
+
+An explicit stock target already equal to the current count is a no-op. Repeating that same target after a lost response does not fail merely because the earlier save applied it. A different current count still requires review; never automatically replace expectedStock.

package/dist/commands/routines.js

@@ -99,7 +99,13 @@ export async function runRoutines(args) {
         }
         if (sub === "add") {
             const work = rest.slice(1);
-            const body = scheduleBody(work, true);
+            const requestId = takeFlag(work, "--request-id");
+            if (requestId && !ID_RE.test(requestId))
+                throw new CliHttpError("request-id must be a UUID.", EXIT_USAGE, 0, "bad_request");
+            const body = {
+                ...scheduleBody(work, true),
+                ...(requestId ? { requestId } : {}),
+            };
             assertNoUnknownFlags(work, "routines");
             const data = await v1Post(base, body);
             if (isJson())

package/dist/commands/shop.js

@@ -287,7 +287,23 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const body = file ? await readJsonFile(file) : {};
                 if (file) {
-                    const allowed = new Set(["title", "description", "images", "checkout", "amount", "minCents", "requiresShipping", "extraShippingCents", "active", "optionNames", "categories", "categorySlugs", "customizations"]);
+                    const allowed = new Set([
+                        "title",
+                        "description",
+                        "images",
+                        "checkout",
+                        "amount",
+                        "minCents",
+                        "requiresShipping",
+                        "extraShippingCents",
+                        "active",
+                        "optionNames",
+                        "categories",
+                        "categorySlugs",
+                        "customizations",
+                        "variantUpdates",
+                        "firstVariant",
+                    ]);
                     const unknown = Object.keys(body).filter(key => !allowed.has(key));
                     if (unknown.length)
                         throw new CliHttpError(`Unsupported items update file field: ${unknown.join(", ")}. Use variant commands for SKU changes.`, EXIT_USAGE, 0, "bad_request");

package/dist/registry.js

@@ -456,6 +456,7 @@ export const COMMANDS = [
         ],
         flags: [
             "add requires --name, --prompt, --cadence hourly|daily|weekly|monthly, and --timezone (IANA, such as America/Chicago)",
+            "routines add --request-id UUID may identify a create attempt. Reuse it with the exact schedule after a lost response; a repeat returns the saved routine without creating another.",
             "--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",
@@ -519,6 +520,7 @@ export const COMMANDS = [
             "variants update <itemId> --id <variantId> --clear-discount ends a sale and preserves the regular price. --discount-cents sets a sale; omit both on update to preserve it. The flags cannot be combined. 0 means free, not removal. Verify with items get. Prices update live.",
             "Descriptions use a small markdown subset. Bind data-fp-store-bind=description for the full product story; do not bake titles, prices or images into the page. Store is cart-only; use Payments for explicit Pay now.",
             "items stock uses --add/--remove as a signed delta, or --set/--unlimited. Never combine these verbs. Product pages use data-fp-store-product and the platform cart templates. Store prices read the shared currency owned by Payments.",
+            "items update --file accepts variantUpdates:[{variantId,priceCents?,discountPriceCents?,options?,stock?,expectedStock?}] and firstVariant with optionNames to enable versions. Send only changed fields. Explicit stock changes require expectedStock from items get; a conflict saves nothing. Complete edits commit together. Existing single-variant and stock commands stay available.",
             "variants update --stock unlimited or items stock --set unlimited restores unlimited stock; 0 means sold out; omit stock on update to preserve it. items update --file supports optionNames: same-length rename or [] to return to one SKU, preserving the first live variant price/sale/stock. Read items get before and after.",
             "variants add|update|archive|restore; categories list|create|rename|archive. Create categories before assigning their slugs.",
             "settings get|set-fulfillment|set-checkout-fee|set-receipt|availability get|on|off. Fee mode flat uses --cents; percent uses --bps (250 is 2.5%). Receipt takes --template <id> or --stock. Availability requires admin and --yes in scripts.",

package/llms.txt

@@ -55,3 +55,5 @@ Customer Inbox: Frontpage website chat uses one settings toggle, no website edit
 See [MAIL.md](./MAIL.md) for the complete save contract, reusable people picker directory, saved campaign recipients, Off-series enrollment and resume timing, all sender settings/null resets, suppression rules, Sent queries and details, and retry-safe examples. `frontpage mail save --file save.json` saves template and pending series together; it never sends. `frontpage mail people` reads the same site-scoped directory as the workspace. Use `frontpage help mail --json` for current commands and flags. No new CLI binary, API namespace or migration command is required. Hosted guides and article help must be updated through the Frontpage CLI.
 
 The workspace validates and saves unfinished group settings before opening email setup. CLI and agent callers use `groups.create` / `groups.update` with a stable `requestKey` before attaching; `groups.count` reads the full visible match count. Group details Email and stage email tasks use the existing `frontpage mail save` / `save_mail_editor` completion. `attachment` checks saved group/stage emailVersion, creates paused rules, supports shared-template edits with rule revisions, and recovers identical retries. Read MAIL.md, Group and stage email tasks. Template get includes ruleUsage; deletion protects paused and active rule dependencies. Creating or saving never activates, enrolls or sends.
+
+Complete Store edits: use existing items update --file with changed fields and variantUpdates. stock requires expectedStock from a fresh items get. One transaction saves all changes or none. On 409 review current stock; never silently substitute it. firstVariant plus optionNames enables versions. Keep explicit stock/variant commands for single operations. Routines add accepts --request-id UUID; reuse that ID and exact schedule after a lost response. Ordinary form edits live only in the active task; Cancel keeps input, Discard loses unfinished input. Submitted payments, imports, builds, and API-key status are separate operations.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontpage-host",
-  "version": "0.3.4",
-  "description": "Frontpage CLI — manage your site from the terminal",
+  "version": "0.3.5",
+  "description": "Frontpage CLI \u2014 manage your site from the terminal",
   "type": "module",
   "bin": {
     "frontpage": "dist/bin.js"