frontpage-host 0.1.22 → 0.1.24

package/AGENTS.md

@@ -251,3 +251,8 @@ frontpage help site-building
 frontpage help agent
 frontpage doctor --json
 ```
+
+
+## People groups, stages, rules, and imports
+
+Use `frontpage people overview`, `groups`, `stages`, `membership`, `rules`, `attachments`, `import`, and `company`. Use `frontpage mail campaign` for one-off group/stage/list audiences in Emails. Every editor action is available through these commands or `frontpage people workspace OPERATION --file payload.json`. Full operations and examples: [PEOPLE.md](./PEOPLE.md); public guide: https://frontpage.host/developers/people. Automated emails select a saved template or series. Campaigns use their own drafts.

package/PEOPLE.md

@@ -0,0 +1,169 @@
+# People: groups, stages, rules, imports, and campaigns
+
+Start with manage_people {operation:"overview"} and {operation:"sources"}. Results provide stable IDs. Do not invent IDs or identify a form by its display name. A form keeps its slug when renamed; a removed form needs a new rule source.
+
+Call manage_people with {operation, payload:{...fields}}. For campaign operations add area:"campaign". The tool binds this site's identity and permission; never pass siteId or slug. All examples below are payloads. CLI equivalents: frontpage people workspace OPERATION --data 'JSON' --site SLUG --json, or --file payload.json. All operations also have named commands: frontpage people groups create, rules update, membership move, etc. Run frontpage help people for flags.
+
+## Groups and stages
+A person can belong to many groups and one stage per group. Manual groups keep membership until an action changes it. Conditions groups reevaluate saved facts, including time. Unknown facts do not remove people. Manual include/exclude overrides conditions; override:null returns to automatic membership. hold:true stops this person's automatic changes for that group. Hidden people are excluded from campaign audiences and automated emails.
+
+- groups.list {archived:false}; groups.get {id}; groups.create {label:"Customers",color:"emerald",mode:"manual"}; groups.update {id,label,color,mode,conditions}; groups.archive/restore {id}.
+- Conditions example: groups.create {label:"Repeat buyers",mode:"conditions",conditions:{field:"purchaseCount",op:"gte",value:2}}.
+- groups.preview {id,personId} or {conditions,cursor}. Preview sends nothing. Page through nextCursor.
+- stages.create {groupId,label:"New",position:0,color:"sky",terminal:false}; stages.update {id,groupId,label,position,color,terminal}; stages.archive/restore {id,groupId}.
+- membership.get {personId}; membership.add/remove {personId,groupId}; membership.move {personId,fromGroupId,groupId}; membership.stage {personId,groupId,stageId}; membership.advance {personId,groupId}; membership.override {personId,groupId,override:"include"|"exclude"|null}; membership.hold {personId,groupId,hold:true|false}. reset:true starts again at the first stage when adding/moving. Otherwise prior stage is retained on reentry. Advance follows ordered nonterminal stages and stops at a terminal stage; select a terminal stage explicitly.
+- person.permission {personId,allowed:true|false} records the owner's email-permission decision. A saved unsubscribe or suppression still wins. Membership or platform signup never grants permission.
+
+Existing tags become manual groups. Existing statuses become stages in Customer progress. Migration keeps person IDs, history, notes, follow-ups, and hidden state, and sends no email.
+
+## When / If / Then
+rules.create/update {id?,name,trigger,conditions:null|CONDITION,actions:[ACTION],enabled:false|true}. Draft first, validate/preview, then enable. rules.list/get/enable/pause/archive {id}; rules.runs {ruleId?,cursor?,limit}; rules.retry {runId} or {ruleId}. Changed or paused rules cannot replay old runs. Temporary failures retry with backoff; permanent failures stay visible until corrected. Durable action receipts prevent duplicate sends on retries. Rule edits create a new version and do not replay past events. Membership cycles and conflicting stage targets are rejected.
+
+WHEN events: person.added, person.updated, form.submitted (optional formSlug), booking.requested, signup.subscribed/resubscribed/unsubscribed, payment.paid/refunded, order.paid/refunded/fulfilled (order.paid accepts productId), square_order.paid, group.joined/left (groupId), stage.entered (groupId,stageId), group.elapsed (groupId,delayMinutes), stage.elapsed (groupId,stageId,delayMinutes). Use sources for available forms/products. The stored form slug and product itemId survive display-name changes. Missing sources fail validation instead of silently selecting something else.
+
+IF accepts {all:[CONDITION,...]} or {any:[CONDITION,...]}, up to four levels/100 clauses. Leaf forms:
+- {field:"email"|"phone"|"name",op:"is"|"is_not"|"contains"|"present",value?:text}
+- {field:"lastSeenDays"|"purchaseCount"|"spentCents"|"lastPurchaseDays",op:"is"|"is_not"|"gte"|"lte"|"present",value?:integer}
+- {field:"subscribed",op:"is"|"is_not",value:boolean}
+- {groupId,stageId?,member:boolean}; {formSlug,submitted:boolean}.
+
+THEN supports 1–10 ordered actions:
+{type:"add_group"|"remove_group",groupId}; {type:"move_group",fromGroupId,groupId}; {type:"set_stage",groupId,stageId,fromStageIds?:[ids]}; {type:"advance_stage",groupId,fromStageIds?:[ids]}; {type:"set_follow_up",minutes}; {type:"clear_follow_up"}; {type:"send_template",templateId}; {type:"start_series",seriesId}; {type:"cancel_series",seriesId}.
+Use fromStageIds to prevent late payment/form events from resetting later progress. Cancel series requires a group/stage trigger and affects only enrollments started for that group. Existing series enrollments remain once per email/series; starting again does not reset them.
+
+Example: rules.create {name:"Contact leads",trigger:{event:"form.submitted",formSlug:"contact"},conditions:null,actions:[{type:"add_group",groupId:LEADS},{type:"set_follow_up",minutes:1440}],enabled:true}.
+Example: rules.create {name:"Paid customers",trigger:{event:"order.paid"},conditions:{groupId:LEADS,member:true},actions:[{type:"move_group",fromGroupId:LEADS,groupId:CUSTOMERS}],enabled:true}.
+Example: rules.create {name:"Follow up after two days",trigger:{event:"stage.elapsed",groupId:LEADS,stageId:NEW,delayMinutes:2880},conditions:{field:"subscribed",op:"is",value:true},actions:[{type:"send_template",templateId:TEMPLATE}],enabled:true}.
+
+## Attach an email
+attachments.create {groupId,stageId?,emailKind:"template"|"series",emailId,name?,conditions?,enabled?}. This creates an ordinary editable rule on group.joined or stage.entered. Use one action label: Attach an email to this group/stage. Choose a saved email template or active series. Automated emails never use campaigns or inline content. Create/edit templates and series through the existing mail commands/tools. Pause/archive the returned rule to detach it.
+
+## CSV
+import.preview {csv,mapping?,headersOnly?:true}; mapping maps email/phone/name/emailPermission to exact CSV headers. Example mapping:{email:"Email address",name:"Full name"}. RFC 4180 quoted commas/newlines, BOM and CRLF are supported. Files up to 5 MB and 10,000 people. Provide email and/or phone. Duplicate contacts collapse; conflicting email/phone matches are rejected rather than merged. Preview includes row errors and duplicates and sends nothing.
+import.start {csv,mapping,groupIds?:[ids],requestKey:UUID}; import.get {id}; import.retry {id}. Reuse requestKey for the same import after a network error; never change its contents. The worker retains its row cursor, outcomes and errors. Retry only failed rows after fixing the identity conflict. Imports send no email. Optional emailPermission column must represent existing permission; it never reverses a saved withdrawal.
+
+## One-off campaigns in Emails
+People selects the audience; Emails owns drafting and sending. No template-to-campaign action exists. Create a one_off draft with mail, then use manage_people area:"campaign":
+preview {audience}; audience {documentId,audience}; send {documentId,requestKey}; get {documentId}.
+Audience: {personIds:[ids]} OR {groupIds:[ids]} OR {stageIds:[ids]} OR {filters:{q?,source?,formSlug?,followUp?,lastSeenDays?}}. Combine ID lists as a union, filters narrow the result. {filters:{}} selects all eligible visible people. Preview returns matched/eligible/noEmail/suppressed/permissionMissing counts. Send freezes the eligible recipients and content. It deduplicates email addresses; missing email, hidden contacts, missing permission, and unsubscribe/suppression are excluded. Delivery rechecks permission. Queuing and delivery use the existing email worker, shared provider pacing and site/platform caps. Reuse the same requestKey after an ambiguous send response to prevent sending twice.
+CLI: frontpage mail campaign preview --file audience.json; campaign audience --id DRAFT --file audience.json; campaign send --id DRAFT --request-key UUID; campaign get --id DRAFT.
+
+## Company account sync
+company.get/set {enabled:true,groupId?} is restricted to a platform admin on landing. It backfills Frontpage accounts and adds later signups through a bounded saved cursor, with user ID deduplication. Backfill never fires rules; new accounts after sync activation can fire group entry rules, subject to email permission. It preserves owner edits and does not grant marketing permission. Ordinary tenants cannot query platform users. Pause with enabled:false. Existing contacts remain.
+
+## CLI recipes
+
+Run `frontpage people overview --site demo --json` first. Copy the returned group, stage, person, email, and series IDs into the examples below. IDs are UUIDs, except a form slug or product item ID. Quotes around a JSON body are shell quotes; the JSON itself uses double quotes.
+
+```bash
+frontpage people groups create --label Leads --color sky --site demo --json
+frontpage people groups list --site demo --json
+frontpage people stages create --group GROUP_ID --label New --position 0 --site demo --json
+frontpage people stages create --group GROUP_ID --label Working --position 1 --site demo --json
+frontpage people stages create --group GROUP_ID --label Won --position 2 --terminal true --site demo --json
+frontpage people membership add --person PERSON_ID --group GROUP_ID --site demo --json
+frontpage people membership stage --person PERSON_ID --group GROUP_ID --stage STAGE_ID --site demo --json
+frontpage people membership hold --person PERSON_ID --group GROUP_ID --hold true --site demo --json
+frontpage people membership move --person PERSON_ID --from-group OLD_GROUP_ID --group NEW_GROUP_ID --site demo --json
+frontpage people membership remove --person PERSON_ID --group GROUP_ID --site demo --json
+frontpage people membership override --person PERSON_ID --group GROUP_ID --override auto --site demo --json
+frontpage people list --group GROUP_ID --stage STAGE_ID --site demo --json
+frontpage people export --group GROUP_ID --out leads.csv --site demo
+frontpage people attachments create --group GROUP_ID --email-kind template --email-id TEMPLATE_ID --enabled true --site demo --json
+frontpage people attachments create --group GROUP_ID --stage STAGE_ID --email-kind series --email-id SERIES_ID --enabled true --site demo --json
+frontpage people sources --site demo --json
+frontpage people rules create --file rule.json --site demo --json
+frontpage people rules preview --file rule.json --person PERSON_ID --site demo --json
+frontpage people rules update --id RULE_ID --file rule.json --site demo --json
+frontpage people rules enable --id RULE_ID --site demo --json
+frontpage people rules pause --id RULE_ID --site demo --json
+frontpage people rules runs --rule RULE_ID --site demo --json
+frontpage people rules retry --run RUN_ID --site demo --json
+frontpage people person permission --person PERSON_ID --allowed true --site demo --json
+```
+
+Use this `rule.json`, replacing IDs and the form slug with values from `overview` and `sources`:
+
+```json
+{
+  "name": "New contact leads",
+  "trigger": {"event": "form.submitted", "formSlug": "contact"},
+  "conditions": {"field": "email", "op": "present"},
+  "actions": [
+    {"type": "add_group", "groupId": "GROUP_ID"},
+    {"type": "set_follow_up", "minutes": 1440}
+  ],
+  "enabled": false
+}
+```
+
+A condition group example (`group.json`):
+
+```json
+{"label":"Repeat buyers","mode":"conditions","conditions":{"all":[{"field":"purchaseCount","op":"gte","value":2},{"field":"lastPurchaseDays","op":"lte","value":90}]}}
+```
+
+```bash
+frontpage people groups create --file group.json --site demo --json
+frontpage people groups preview --file group.json --site demo --json
+frontpage people groups update --id GROUP_ID --file group.json --site demo --json
+frontpage people groups archive --id GROUP_ID --site demo --json
+frontpage people groups restore --id GROUP_ID --site demo --json
+```
+
+CSV mapping file (`mapping.json`):
+
+```json
+{"mapping":{"email":"Email address","name":"Full name","phone":"Phone","emailPermission":"Permission"},"groupIds":["GROUP_ID"]}
+```
+
+```bash
+frontpage people import preview --csv customers.csv --file mapping.json --site demo --json
+frontpage people import start --csv customers.csv --file mapping.json --request-key REQUEST_UUID --site demo --json
+frontpage people import get --id IMPORT_ID --site demo --json
+frontpage people import retry --id IMPORT_ID --site demo --json
+```
+
+Permission values are true/false or yes/no. Leave permission blank when unknown. Phone-only contacts can enter groups but cannot receive email. CSV import runs in saved batches; inspect the result for row errors before assuming every record was accepted. Fix an existing identity conflict, then retry failed rows. To correct the CSV itself, preview and start a new import with a new request key. A retry never changes the original file.
+
+Campaign audience file (`audience.json`):
+
+```json
+{"audience":{"groupIds":["GROUP_ID"]}}
+```
+
+Use `stageIds` instead for one stage, or `personIds` for selected people. To select the whole visible People list use `{"audience":{"filters":{}}}`. Create an email draft using the existing email builder/CLI; campaigns do not start from templates.
+
+```bash
+frontpage mail email create --file draft.json --name "Customer update" --site demo --json
+frontpage mail campaign preview --file audience.json --site demo --json
+frontpage mail campaign audience --id DRAFT_ID --file audience.json --site demo --json
+frontpage mail campaign send --id DRAFT_ID --request-key REQUEST_UUID --site demo --json
+frontpage mail campaign get --id DRAFT_ID --site demo --json
+```
+
+Company sync is available only to a platform admin in the landing workspace:
+
+```bash
+frontpage people company get --site landing --json
+frontpage people company set --enabled true --site landing --json
+frontpage people company set --enabled false --site landing --json
+```
+
+## API and agent parity
+
+The same application service handles editor actions, the public CLI, and the site agent. Use POST `/api/v1/sites/SLUG/people/workspace` with an API key and body `{"operation":"groups.create","label":"Leads"}`. Campaign operations use POST `/api/v1/sites/SLUG/mail/campaign` with `operation: preview|audience|send|get`. Read actions require viewer access; writes require editor access. Public CLI access still requires Scale, Enterprise, or Internal. People and Emails keep their existing plan checks. Tenant IDs come from authenticated access, never the JSON body.
+
+The agent uses `get_people_docs` for the complete reference and `manage_people` for every workspace action. For example `{"operation":"membership.add","payload":{"personId":"PERSON_ID","groupId":"GROUP_ID"}}`; a campaign uses `{"area":"campaign","operation":"preview","payload":{"audience":{"groupIds":["GROUP_ID"]}}}`. The agent can create templates and series with existing Email tools, then attach their IDs. No step requires opening the UI.
+
+## Timing, limits, and safe changes
+
+The existing minute worker evaluates new events, saved imports, company account sync, dynamic membership, timed rules, and pending actions. A busy queue can take longer than one minute. Form labels can change without breaking rules: the saved form slug is the identity. Changing/removing that slug creates a different source; choose it explicitly and update the rule. Product titles can change; rules keep the product item ID. Rename groups/stages freely; rules keep their IDs. Archive rather than deleting history.
+
+Rules act on events after activation, not historical submissions. Every real group entry or stage entry can start its attached email; a duplicate event or retry cannot send it twice. An existing series enrollment does not restart on reentry. A hold stops automatic group changes and its attachment; lifting it does not replay failed work automatically. Review the run and retry deliberately. A queued series continues unless a rule explicitly stops that group's series. Missing permission, unsubscribe, and suppression always stop automated delivery.
+
+Temporary database/provider failures retry up to eight attempts with delays from one minute to one hour. Permanent errors remain visible with the failed action and a manual retry. Earlier completed actions retain their receipts. Paused, archived, or changed rules do not replay old work. Condition previews and import previews send nothing. Conditions groups reevaluate all contacts in rotating batches; they do not require browser listeners.
+
+Campaign queuing uses batches of 100. Sending uses the existing send window, hourly/monthly/site caps, platform daily cap, kill switch, and a shared provider slot across workers. Status `queued` means messages reached the existing send queue, not that every email was delivered. `campaign get` reports the accepted, sent, pending, failed, and skipped work. An unsubscribe after audience selection still prevents delivery.
+
+Legacy tag/status commands remain compatible with converted groups/stages. New integrations should use group/stage IDs; historical fields remain for older callers and exports. All existing person IDs, notes, follow-ups, hidden state, source events, and external CRM destination behavior remain intact.

package/README.md

@@ -55,3 +55,8 @@ Machine-readable: `frontpage help --json` and global `--json` / `--quiet` on com
 ## Agents
 
 See [AGENTS.md](./AGENTS.md) and [llms.txt](./llms.txt) in this package.
+
+
+## People groups, stages, rules, and imports
+
+Use `frontpage people overview`, `groups`, `stages`, `membership`, `rules`, `attachments`, `import`, and `company`. Use `frontpage mail campaign` for one-off group/stage/list audiences in Emails. Every editor action is available through these commands or `frontpage people workspace OPERATION --file payload.json`. Full operations and examples: [PEOPLE.md](./PEOPLE.md); public guide: https://frontpage.host/developers/people. Automated emails select a saved template or series. Campaigns use their own drafts.

package/dist/commands/mail.js

@@ -1,3 +1,4 @@
+import { runCampaign } from "./people-workspace.js";
 import { readFile } from "node:fs/promises";
 import { resolveSlug } from "../site.js";
 import { CliHttpError, EXIT_OK, EXIT_USAGE, exitCodeForError, v1Delete, v1Get, v1Patch, v1Post, v1Put, } from "../http/client.js";
@@ -79,6 +80,8 @@ export async function runMail(args) {
     try {
         const { slug, rest } = await resolveSlug(args);
         const group = rest[0];
+        if (group === "campaign")
+            return await runCampaign(slug, rest.slice(1));
         const base = `/api/v1/sites/${encodeURIComponent(slug)}/mail`;
         if (group === "settings") {
             const sub = rest[1] ?? "get";

package/dist/commands/people-workspace.d.ts

@@ -0,0 +1,3 @@
+export declare function isPeopleWorkspaceCommand(sub: string | undefined): boolean;
+export declare function runPeopleWorkspace(slug: string, args: string[]): Promise<number>;
+export declare function runCampaign(slug: string, args: string[]): Promise<number>;

package/dist/commands/people-workspace.js

@@ -0,0 +1,137 @@
+import { readFile } from "node:fs/promises";
+import { assertNoUnknownFlags, takeFlag } from "../argv.js";
+import { CliHttpError, EXIT_OK, EXIT_USAGE, v1Post } from "../http/client.js";
+import { emitOk, isJson } from "../runtime.js";
+const AREAS = [
+    "groups",
+    "stages",
+    "membership",
+    "rules",
+    "import",
+    "attachments",
+    "person",
+    "company",
+];
+export function isPeopleWorkspaceCommand(sub) {
+    return (!!sub &&
+        (AREAS.includes(sub) ||
+            ["overview", "sources", "audience", "workspace"].includes(sub)));
+}
+export async function runPeopleWorkspace(slug, args) {
+    const work = [...args], area = work.shift();
+    const operation = area === "workspace"
+        ? work.shift()
+        : area === "overview" || area === "sources"
+            ? area
+            : `${area}.${work.shift() ?? (area === "company" ? "get" : area === "audience" ? "preview" : "list")}`;
+    const file = takeFlag(work, "--file"), json = takeFlag(work, "--data");
+    if (file && json)
+        throw new CliHttpError("Use --file or --data, not both.", EXIT_USAGE, 0, "bad_request");
+    let payload = {};
+    if (file || json) {
+        try {
+            const parsed = JSON.parse(file ? await readFile(file, "utf8") : json);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                throw Error();
+            payload = parsed;
+        }
+        catch {
+            throw new CliHttpError("Provide a JSON object through --file or --data.", EXIT_USAGE, 0, "bad_request");
+        }
+    }
+    for (const [flag, key] of Object.entries({
+        "--id": "id",
+        "--name": "name",
+        "--label": "label",
+        "--group": "groupId",
+        "--stage": "stageId",
+        "--person": "personId",
+        "--from-group": "fromGroupId",
+        "--mode": "mode",
+        "--color": "color",
+        "--run": "runId",
+        "--rule": "ruleId",
+        "--email-id": "emailId",
+        "--email-kind": "emailKind",
+        "--override": "override",
+        "--cursor": "cursor",
+        "--request-key": "requestKey",
+    })) {
+        const v = takeFlag(work, flag);
+        if (v !== undefined)
+            payload[key] = key === "override" && v === "auto" ? null : v;
+    }
+    for (const [flag, key] of Object.entries({
+        "--position": "position",
+        "--limit": "limit",
+    })) {
+        const v = takeFlag(work, flag);
+        if (v !== undefined) {
+            const n = Number(v);
+            if (!Number.isInteger(n))
+                throw new CliHttpError(`${flag} requires an integer.`, EXIT_USAGE, 0, "bad_request");
+            payload[key] = n;
+        }
+    }
+    for (const [flag, key] of Object.entries({
+        "--enabled": "enabled",
+        "--hold": "hold",
+        "--terminal": "terminal",
+        "--allowed": "allowed",
+        "--archived": "archived",
+        "--reset": "reset",
+    })) {
+        const v = takeFlag(work, flag);
+        if (v !== undefined) {
+            if (v !== "true" && v !== "false")
+                throw new CliHttpError(`${flag} is true or false.`, EXIT_USAGE, 0, "bad_request");
+            payload[key] = v === "true";
+        }
+    }
+    const csv = takeFlag(work, "--csv");
+    if (csv)
+        payload.csv = await readFile(csv, "utf8");
+    if (operation === "import.start" && !payload.requestKey)
+        throw new CliHttpError("Provide --request-key with a stable UUID so retries reuse this import.", EXIT_USAGE, 0, "bad_request");
+    assertNoUnknownFlags(work, "people");
+    if (work.length || !operation)
+        throw new CliHttpError("Unexpected arguments. Run frontpage help people.", EXIT_USAGE, 0, "bad_request");
+    const result = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/people/workspace`, { ...payload, operation });
+    if (isJson())
+        emitOk("people", result);
+    else
+        console.log(JSON.stringify(result, null, 2));
+    return EXIT_OK;
+}
+export async function runCampaign(slug, args) {
+    const work = [...args], operation = work.shift() ?? "get", file = takeFlag(work, "--file"), data = takeFlag(work, "--data"), documentId = takeFlag(work, "--id"), requestKey = takeFlag(work, "--request-key");
+    if (file && data)
+        throw new CliHttpError("Use --file or --data.", EXIT_USAGE, 0, "bad_request");
+    let payload = {};
+    if (file || data) {
+        try {
+            payload = JSON.parse(file ? await readFile(file, "utf8") : data);
+            if (!payload || Array.isArray(payload) || typeof payload !== "object")
+                throw Error();
+        }
+        catch {
+            throw new CliHttpError("Provide a JSON object.", EXIT_USAGE, 0, "bad_request");
+        }
+    }
+    assertNoUnknownFlags(work, "mail");
+    if (work.length)
+        throw new CliHttpError("Unexpected campaign arguments.", EXIT_USAGE, 0, "bad_request");
+    const result = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/mail/campaign`, {
+        ...payload,
+        operation,
+        ...(documentId ? { documentId } : {}),
+        ...(operation === "send"
+            ? { requestKey: requestKey ?? payload.requestKey }
+            : {}),
+    });
+    if (isJson())
+        emitOk("mail", result);
+    else
+        console.log(JSON.stringify(result, null, 2));
+    return EXIT_OK;
+}

package/dist/commands/people.js

@@ -1,3 +1,4 @@
+import { isPeopleWorkspaceCommand, runPeopleWorkspace } from "./people-workspace.js";
 import { writeFile } from "node:fs/promises";
 import { resolveSlug } from "../site.js";
 import { CliHttpError, EXIT_OK, EXIT_USAGE, apiBase, exitCodeForError, getBearerAuthHeader, httpErrorFromV1, v1Delete, v1Get, v1Patch, v1Post, } from "../http/client.js";
@@ -73,11 +74,15 @@ export async function runPeople(args) {
     try {
         const { slug, rest } = await resolveSlug(args);
         const sub = rest[0];
+        if (isPeopleWorkspaceCommand(sub))
+            return await runPeopleWorkspace(slug, rest);
         const base = `/api/v1/sites/${encodeURIComponent(slug)}/people`;
         if (!sub || sub === "list") {
             const work = sub === "list" ? rest.slice(1) : [...rest];
             const q = takeFlag(work, "--q") ?? takeFlag(work, "--query");
             const status = takeFlag(work, "--status");
+            const groupId = takeFlag(work, "--group");
+            const stageId = takeFlag(work, "--stage");
             const source = takeFlag(work, "--source");
             const formSlug = takeFlag(work, "--form-slug");
             const followUp = takeFlag(work, "--follow-up");
@@ -91,6 +96,10 @@ export async function runPeople(args) {
             const params = new URLSearchParams();
             if (q)
                 params.set("q", q);
+            if (groupId)
+                params.set("groupId", groupId);
+            if (stageId)
+                params.set("stageId", stageId);
             if (status)
                 params.set("status", status);
             if (source)
@@ -313,6 +322,8 @@ export async function runPeople(args) {
             const work = rest.slice(1);
             const q = takeFlag(work, "--q") ?? takeFlag(work, "--query");
             const status = takeFlag(work, "--status");
+            const groupId = takeFlag(work, "--group");
+            const stageId = takeFlag(work, "--stage");
             const source = takeFlag(work, "--source");
             const formSlug = takeFlag(work, "--form-slug");
             const followUp = takeFlag(work, "--follow-up");
@@ -325,6 +336,10 @@ export async function runPeople(args) {
             const params = new URLSearchParams();
             if (q)
                 params.set("q", q);
+            if (groupId)
+                params.set("groupId", groupId);
+            if (stageId)
+                params.set("stageId", stageId);
             if (status)
                 params.set("status", status);
             if (source)

package/dist/commands/settings.js

@@ -32,7 +32,7 @@ export async function runSettings(args) {
             }
             const buildModel = takeFlag(work, "--build-model");
             if (buildModel !== undefined)
-                body.buildModel = buildModel;
+                body.buildModel = buildModel === "default" ? null : buildModel;
             const brandName = takeFlag(work, "--brand-name");
             const brandLogo = takeFlag(work, "--brand-logo");
             if (work.includes("--brand-reset")) {

package/dist/commands/shop.js

@@ -164,7 +164,7 @@ export async function runShop(args) {
         const group = rest[0];
         const base = `/api/v1/sites/${encodeURIComponent(slug)}/shop`;
         if (!group)
-            return emitUsage("shop", USAGE);
+            return emitUsage("store", USAGE);
         if (group === "items") {
             const sub = rest[1];
             const work = rest.slice(2);
@@ -181,7 +181,7 @@ export async function runShop(args) {
                 const suffix = qs.toString() ? `?${qs.toString()}` : "";
                 const data = await v1Get(`${base}/items${suffix}`);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 const rows = data.items ?? [];
@@ -198,7 +198,7 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/items/${encodeURIComponent(itemId)}`);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -271,7 +271,7 @@ export async function runShop(args) {
                 }
                 const data = await v1Post(`${base}/items`, body);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -313,7 +313,7 @@ export async function runShop(args) {
                 }
                 const data = await v1Patch(`${base}/items/${encodeURIComponent(itemId)}`, body);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -324,7 +324,7 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/archive`, {});
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -337,7 +337,7 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/activate`, { active: active ?? true });
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -349,7 +349,7 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Put(`${base}/items/${encodeURIComponent(itemId)}/images`, { images: urls });
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -396,13 +396,13 @@ export async function runShop(args) {
                 }
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/stock`, body);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printStock(data);
                 return EXIT_OK;
             }
-            return emitUsage("shop", USAGE);
+            return emitUsage("store", USAGE);
         }
         if (group === "variants") {
             const sub = rest[1];
@@ -429,7 +429,7 @@ export async function runShop(args) {
                     active,
                 });
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -460,7 +460,7 @@ export async function runShop(args) {
                 }
                 const data = await v1Patch(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}`, body);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
@@ -472,13 +472,13 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}/archive`, {});
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 printItem(data.item);
                 return EXIT_OK;
             }
-            return emitUsage("shop", USAGE);
+            return emitUsage("store", USAGE);
         }
         if (group === "categories") {
             const sub = rest[1];
@@ -490,7 +490,7 @@ export async function runShop(args) {
                 const qs = archived ? "?archived=1" : "";
                 const data = await v1Get(`${base}/categories${qs}`);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 const rows = data.categories ?? [];
@@ -517,7 +517,7 @@ export async function runShop(args) {
                     label,
                 });
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 console.log(`${data.category.slug}  ${data.category.label}`);
@@ -532,7 +532,7 @@ export async function runShop(args) {
                 }
                 const data = await v1Patch(`${base}/categories/${encodeURIComponent(slug)}`, { label });
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 console.log(`${data.category.slug}  ${data.category.label}`);
@@ -543,13 +543,13 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/categories/${encodeURIComponent(slug)}/archive`, {});
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 console.log(`${data.category.slug}  archived`);
                 return EXIT_OK;
             }
-            return emitUsage("shop", USAGE);
+            return emitUsage("store", USAGE);
         }
         if (group === "settings") {
             const sub = rest[1] ?? "get";
@@ -558,7 +558,7 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/settings`);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 const s = data.settings ?? {};
@@ -614,7 +614,7 @@ export async function runShop(args) {
                     freeShippingOverCents: freeCents,
                 });
                 if (isJson())
-                    emitOk("shop", data);
+                    emitOk("store", data);
                 else
                     console.log("Fulfillment saved.");
                 return EXIT_OK;
@@ -627,7 +627,7 @@ export async function runShop(args) {
                 }
                 const data = await v1Post(`${base}/settings/currency`, { currency });
                 if (isJson())
-                    emitOk("shop", data);
+                    emitOk("store", data);
                 else
                     console.log("Currency saved.");
                 return EXIT_OK;
@@ -640,7 +640,7 @@ export async function runShop(args) {
                 }
                 const data = await v1Post(`${base}/settings/checkout`, { checkout });
                 if (isJson())
-                    emitOk("shop", data);
+                    emitOk("store", data);
                 else
                     console.log(checkout === "instant" ? "Checkout is Pay now." : "Checkout is add to cart.");
                 return EXIT_OK;
@@ -654,12 +654,12 @@ export async function runShop(args) {
                     cents,
                 });
                 if (isJson())
-                    emitOk("shop", data);
+                    emitOk("store", data);
                 else
                     console.log(off ? "Service fee off." : "Service fee saved.");
                 return EXIT_OK;
             }
-            return emitUsage("shop", USAGE);
+            return emitUsage("store", USAGE);
         }
         if (group === "connect") {
             const work = rest.slice(1);
@@ -668,7 +668,7 @@ export async function runShop(args) {
             const data = await v1Post(`${base}/connect`, { action: "connect" });
             const already = data.alreadyConnected === true;
             if (isJson()) {
-                emitOk("shop", data);
+                emitOk("store", data);
             }
             else {
                 const url = resolveOpenUrl(data.connectUrl);
@@ -688,7 +688,7 @@ export async function runShop(args) {
             assertNoUnknownFlags(work, "store");
             const data = await v1Get(`${base}/connect`);
             if (isJson()) {
-                emitOk("shop", data);
+                emitOk("store", data);
                 return EXIT_OK;
             }
             const connection = (data.connection ?? {});
@@ -707,10 +707,10 @@ export async function runShop(args) {
             assertNoUnknownFlags(work, "store");
             const refuse = requireYesOrTty("disconnect the store (shared Stripe account with payments)");
             if (refuse)
-                return emitUsage("shop", refuse);
+                return emitUsage("store", refuse);
             const data = await v1Post(`${base}/connect`, { action: "disconnect" });
             if (isJson()) {
-                emitOk("shop", data);
+                emitOk("store", data);
                 return EXIT_OK;
             }
             console.log(typeof data.message === "string" ? data.message : "Disconnected.");
@@ -721,7 +721,7 @@ export async function runShop(args) {
             assertNoUnknownFlags(work, "store");
             const data = await v1Post(`${base}/import`, {});
             if (isJson()) {
-                emitOk("shop", data);
+                emitOk("store", data);
                 return EXIT_OK;
             }
             const imported = data.imported ?? [];
@@ -748,7 +748,7 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/${noun}`);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 const rows = data[noun] ?? [];
@@ -766,17 +766,17 @@ export async function runShop(args) {
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/${noun}/${encodeURIComponent(id)}`);
                 if (isJson()) {
-                    emitOk("shop", data);
+                    emitOk("store", data);
                     return EXIT_OK;
                 }
                 console.log(JSON.stringify(data[noun === "orders" ? "order" : "payment"], null, 2));
                 return EXIT_OK;
             }
-            return emitUsage("shop", USAGE);
+            return emitUsage("store", USAGE);
         }
-        return emitUsage("shop", USAGE);
+        return emitUsage("store", USAGE);
     }
     catch (err) {
-        return emitErr("shop", err);
+        return emitErr("store", err);
     }
 }

package/dist/modules/commands.js

@@ -34,17 +34,18 @@ export const MODULE_COMMANDS = [
     {
         key: "callbar",
         name: "Call bar",
-        summary: "Phone / SMS bar. Typed get/set for phone, sms, and label.",
+        summary: "Phone / SMS bar. Typed get/set for phone, sms, call, and label.",
         genericActions: GENERIC_ACTIONS,
         extraActions: [
             "get",
-            "set --phone +1… [--sms yes|no] [--label \"Call\"]",
+            "set --phone +1… [--sms yes|no] [--call yes|no] [--label \"Call\"]",
         ],
         notYet: [],
         examples: [
             "frontpage modules callbar",
             "frontpage modules callbar get",
             "frontpage modules callbar set --phone +14085551234 --sms no",
+            "frontpage modules callbar set --call no --sms yes",
             "frontpage modules callbar docs",
             `frontpage modules config callbar --config '{"phone":"+1…"}'`,
         ],
@@ -59,7 +60,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>",
@@ -74,6 +75,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",
@@ -83,6 +85,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",
         ],
     },

package/dist/modules/typed_config.js

@@ -29,6 +29,7 @@ function printLine(label, value) {
 }
 function printCallbar(config) {
     printLine("phone", dash(config.phone));
+    printLine("call", yesNo(config.call));
     printLine("sms", yesNo(config.sms));
     printLine("label", dash(config.label));
 }
@@ -45,6 +46,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) {
@@ -108,10 +112,12 @@ export async function runTypedConfig(key, slug, action, flags) {
         const instanceId = takeFlag(work, "--instance");
         const phone = takeFlag(work, "--phone");
         const sms = takeFlag(work, "--sms");
+        const call = takeFlag(work, "--call");
         const label = takeFlag(work, "--label");
         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 {
@@ -127,6 +133,8 @@ export async function runTypedConfig(key, slug, action, flags) {
             body.phone = phone;
         if (sms !== undefined)
             body.sms = sms;
+        if (call !== undefined)
+            body.call = call;
         if (label !== undefined)
             body.label = label;
         if (notifyEmail !== undefined)
@@ -135,8 +143,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.js

@@ -333,8 +333,10 @@ export const COMMANDS = [
             "frontpage modules google_reviews enable",
             "frontpage modules callbar get",
             "frontpage modules callbar set --phone +14085551234 --sms no",
+            "frontpage modules callbar set --call no --sms yes",
             "frontpage modules forms get",
             "frontpage modules forms set --instance lead-gen --notify-email hi@example.com",
+            "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",
@@ -437,10 +439,16 @@ export const COMMANDS = [
     },
     {
         name: "people",
-        summary: "List and manage site People (not inbox, not a module)",
-        usage: "frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export [--site <slug>] [--json]",
+        summary: "People, groups, stages, rules, imports, and campaign audiences",
+        usage: "frontpage people overview|sources|groups|stages|membership|rules|attachments|import|company|person|audience|workspace … [--site <slug>] [--json]; list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export remain available",
         topics: ["content"],
         examples: [
+            "frontpage people overview --json",
+            "frontpage people groups create --label Leads",
+            "frontpage people stages create --group GROUP_ID --label New --position 0",
+            "frontpage people membership add --person PERSON_ID --group GROUP_ID",
+            "frontpage people rules create --file rule.json",
+            "frontpage people import start --csv customers.csv --file mapping.json --request-key REQUEST_UUID",
             "frontpage people list",
             "frontpage people add --email alex@example.com --name Alex",
             "frontpage people set <id> --status working",
@@ -453,6 +461,10 @@ export const COMMANDS = [
             "frontpage people export",
         ],
         flags: [
+            "Workspace: groups list|get|create|update|archive|restore|preview; stages create|update|archive|restore; membership get|add|remove|move|stage|advance|override|hold; rules list|get|create|update|enable|pause|archive|validate|preview|runs|retry; attachments create; import preview|start|get|retry; person permission; company get|set; audience preview; overview; sources",
+            "All workspace operations accept --file JSON or --data JSON. Named flags: --id --label --name --group --stage --person --from-group --mode --color --position --terminal --enabled --hold --allowed --archived --reset --override include|exclude|auto --email-kind template|series --email-id --rule --run --cursor --limit --request-key. Boolean flags take true|false. Complex conditions/actions/mappings use JSON.",
+            "CSV: --csv PATH plus --file mapping.json. import start requires a stable --request-key. Retry the same import with the same key and contents.",
+            "list/export: --group GROUP_ID --stage STAGE_ID. See package PEOPLE.md for full examples and every JSON shape.",
             "list: --q --status --source --form-slug --follow-up due|upcoming|none --hidden --sort --last-seen-days --tag --limit --cursor",
             "add requires --email and/or --phone (never name alone)",
             "tag: --add <label> | --remove <slug>",
@@ -489,11 +501,11 @@ export const COMMANDS = [
             "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|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",
+            "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)",
@@ -502,8 +514,8 @@ export const COMMANDS = [
     },
     {
         name: "mail",
-        summary: "Site mailings: drafts, templates, series, and sends (not People, not inbox)",
-        usage: "frontpage mail settings|email|template|series|send|sends|enrolments|suppress … [--site <slug>] [--json]",
+        summary: "Emails: campaign drafts, People audiences, templates, series, and sends",
+        usage: "frontpage mail settings|email|template|series|campaign|send|sends|enrolments|suppress … [--site <slug>] [--json]",
         topics: ["content"],
         examples: [
             "frontpage mail settings set --postal \"100 Main St\" --reply-to you@example.com",
@@ -514,6 +526,7 @@ export const COMMANDS = [
             "frontpage mail suppress add --email bounce@example.com",
         ],
         flags: [
+            "campaign preview|audience|send|get. --id DRAFT_ID, --file audience.json ({audience:{groupIds|stageIds|personIds|filters}}). send requires --request-key; reuse it after a network error. Templates/series are for automation; campaigns have separate drafts. See PEOPLE.md.",
             "email list is unsent drafts only. Sent one-offs are mail sends list",
             "send --file is an inline one-off (no saved document)",
             "Blocks and series steps are JSON (--file). Unknown leftover flags fail closed (exit 2)",

package/llms.txt

@@ -30,3 +30,8 @@
 - Machine: global --json / --quiet; exit 0/2/3/4/5 (see help exit-codes)
 - deploy wait = agent-run idle (if any) + tip compile ready; it is NOT go-live / publish
 - No runs continue, domains, billing, members, MCP, or git remotes in v1
+
+
+## People groups, stages, rules, and imports
+
+Use `frontpage people overview`, `groups`, `stages`, `membership`, `rules`, `attachments`, `import`, and `company`. Use `frontpage mail campaign` for one-off group/stage/list audiences in Emails. Every editor action is available through these commands or `frontpage people workspace OPERATION --file payload.json`. Full operations and examples: [PEOPLE.md](./PEOPLE.md); public guide: https://frontpage.host/developers/people. Automated emails select a saved template or series. Campaigns use their own drafts.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.22",
-  "description": "Frontpage CLI — manage your site from the terminal",
+  "version": "0.1.24",
+  "description": "Frontpage CLI \u2014 manage your site from the terminal",
   "type": "module",
   "bin": {
     "frontpage": "dist/bin.js"
@@ -10,7 +10,8 @@
     "dist",
     "README.md",
     "AGENTS.md",
-    "llms.txt"
+    "llms.txt",
+    "PEOPLE.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/dist/bin-path.d.ts

@@ -1,21 +0,0 @@
-export type PathFrontpageVerdict = {
-    stale: boolean;
-    path: string | null;
-    pathVersion: string | null;
-    reason: "older-than-compile-wait" | "older-than-this-package" | "unreadable" | null;
-};
-export declare function resolveRealPath(path: string): string;
-export declare function interpretPathFrontpage(args: {
-    thisVersion: string;
-    thisBin: string | null;
-    pathBin: string | null;
-    pathVersionLine: string | null;
-    minVersion?: string;
-}): PathFrontpageVerdict;
-export declare function whichFrontpage(): string | null;
-export declare function frontpageVersionAt(bin: string): string | null;
-export declare function inspectPathFrontpage(opts?: {
-    thisBin?: string | null;
-    thisVersion?: string;
-}): PathFrontpageVerdict;
-export declare function stalePathUpgradeMessage(v: PathFrontpageVerdict): string;

package/dist/bin-path.js

@@ -1,65 +0,0 @@
-/**
- * Detect a stale `frontpage` on PATH (global 0.1.9 vs this package).
- * Does not uninstall anything — doctor prints the uninstall command.
- */
-import { spawnSync } from "node:child_process";
-import { realpathSync } from "node:fs";
-import { COMPILE_WAIT_MIN_VERSION, isOlderThan, packageIdentity, parseVersionLine, } from "./version.js";
-export function resolveRealPath(path) {
-    try {
-        return realpathSync(path);
-    }
-    catch {
-        return path;
-    }
-}
-export function interpretPathFrontpage(args) {
-    if (!args.pathBin) {
-        return { stale: false, path: null, pathVersion: null, reason: null };
-    }
-    if (args.thisBin && resolveRealPath(args.pathBin) === resolveRealPath(args.thisBin)) {
-        return { stale: false, path: args.pathBin, pathVersion: args.thisVersion, reason: null };
-    }
-    const pathVersion = parseVersionLine(args.pathVersionLine ?? "");
-    if (!pathVersion) {
-        return { stale: true, path: args.pathBin, pathVersion: null, reason: "unreadable" };
-    }
-    const floor = args.minVersion ?? COMPILE_WAIT_MIN_VERSION;
-    if (isOlderThan(pathVersion, floor)) {
-        return { stale: true, path: args.pathBin, pathVersion, reason: "older-than-compile-wait" };
-    }
-    if (isOlderThan(pathVersion, args.thisVersion)) {
-        return { stale: true, path: args.pathBin, pathVersion, reason: "older-than-this-package" };
-    }
-    return { stale: false, path: args.pathBin, pathVersion, reason: null };
-}
-export function whichFrontpage() {
-    const r = spawnSync("sh", ["-c", "command -v frontpage"], { encoding: "utf8" });
-    const line = (r.stdout ?? "").trim().split("\n")[0]?.trim();
-    return line || null;
-}
-export function frontpageVersionAt(bin) {
-    const r = spawnSync(bin, ["--version"], { encoding: "utf8" });
-    const text = `${r.stdout ?? ""}\n${r.stderr ?? ""}`;
-    return parseVersionLine(text);
-}
-export function inspectPathFrontpage(opts) {
-    const thisVersion = opts?.thisVersion ?? packageIdentity().version;
-    const thisBin = opts?.thisBin ?? process.argv[1] ?? null;
-    const pathBin = whichFrontpage();
-    const pathVersionLine = pathBin ? frontpageVersionAt(pathBin) : null;
-    return interpretPathFrontpage({
-        thisVersion,
-        thisBin,
-        pathBin,
-        pathVersionLine,
-    });
-}
-export function stalePathUpgradeMessage(v) {
-    const found = v.pathVersion ? `frontpage-host ${v.pathVersion}` : "an unknown frontpage-host";
-    const where = v.path ? ` at ${v.path}` : "";
-    return (`PATH frontpage is ${found}${where}. Compile-wait needs frontpage-host ${COMPILE_WAIT_MIN_VERSION} or newer. ` +
-        `Uninstall the stale global (npm uninstall -g frontpage-host) and install ` +
-        `npm i -g frontpage-host@${COMPILE_WAIT_MIN_VERSION} (or npx frontpage-host@${COMPILE_WAIT_MIN_VERSION}). ` +
-        `In the Frontpage repo, run node <repo>/cli/dist/bin.js instead of a global binary.`);
-}