frontpage-host 0.1.23 → 0.1.25

package/dist/registry.js

@@ -333,6 +333,7 @@ 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>",
@@ -438,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",
@@ -454,6 +461,10 @@ export const COMMANDS = [
             "frontpage people export",
         ],
         flags: [
+            "Workspace: groups list|get|create|update|archive|restore|preview; stages create|update|reorder|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>",
@@ -503,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",
@@ -515,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,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {
@@ -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.`);
-}