frontpage-host 0.3.0 → 0.3.2

package/AGENTS.md

@@ -285,3 +285,11 @@ See [MAIL.md](./MAIL.md) for the complete save contract, reusable people picker
 Rule placement: read a rule revision, then use `people workspace rules.place` with `id`, `owner` and `expectedRevision`. This only organizes the rule; it does not change its trigger or execution. New UI rules/attachments save paused. Generic attachment calls still need explicit `enabled:false` for paused creation. Saved optional conditions and exact duration minutes remain supported through CLI and agent calls.
 
 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.
+
+### People workspace navigation and selection
+
+People CRM has People and Groups tabs. Group details has Group details, Stages and Rules tabs. Group-entry emails remain rules with the same IDs. Stage Manage rules supports creating, placing, or attaching email without changing execution when placement changes. New attachments save paused.
+
+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.

package/PEOPLE.md

@@ -72,11 +72,13 @@ frontpage people groups archive --id GROUP_ID --site YOUR_SITE --json
 frontpage people groups restore --id GROUP_ID --site YOUR_SITE --json
 ```
 
+For a reviewed group edit, read `groups.list` and pass the saved `emailVersion` as `expectedGroup` through `--data` or `--file` with `groups.update`. The workspace does this automatically. A changed name, color, mode, conditions or archive state returns 409 before writing. Membership counts do not invalidate the version. Read the latest group and review the change before trying again; do not replace the version and silently overwrite another edit. The check is optional for existing API callers.
+
 ### Select people from a manual group
 
 The group header offers **Add people** for manual groups and **View matching people** for conditional groups. Membership selection includes visible phone-only contacts and people without marketing permission. Current members are marked **Already in this group** and cannot be selected.
 
-Use `groups.people` with `groupId`, optional `q`, `source`, `sort` (`newest`, `oldest`, `name`), `page`, `selectedOnly` and `selected` IDs. It returns 20 people per page, a full filtered `total`, the actual `page`, phone/email contact details and `member`. It rejects conditional or archived groups and never records consent.
+Use `groups.people` with `groupId`, optional `q`, `source`, `sort` (`newest`, `oldest`, `name`), `page`, `selectedOnly`, `selected` IDs and `availability` (`all`, `available`, `member`; default `all`). Availability checks current group membership, not email permission, and filters the full directory before counting and paging. It returns 20 people per page, a full filtered `total`, the actual `page`, phone/email contact details and `member`. It rejects conditional or archived groups and never records consent.
 
 Use `membership.addMany` with `groupId` and 1 to 20 `personIds` per request. The UI can select up to 100 and submits batches of 20. Results include `added`, `alreadyMember`, `skipped`, `failed` and per-person `results` with `personId`, `status` and an optional message. Retry unconfirmed or failed IDs: current members are skipped without resetting their stage or repeating join events. Hidden people are skipped; a group that changed to conditional or archived cannot receive new additions through this operation. Successful additions save immediately and keep the normal entry rules. This does not grant email permission or change other groups.
 
@@ -470,6 +472,8 @@ Use a saved CSV import for a new historical cohort. Its list-wide permission cho
 
 CSV imports accept up to 5 MB and 10,000 contact rows. Quoted commas, quoted newlines, UTF-8 BOM, and CRLF are supported. Larger lists need separate files; the UI does not render an unbounded list of failures.
 
+The UI offers only Add people groups as import destinations and sends `manualGroupsOnly:true`. CLI and agent callers can pass the same option to `import.start`. The saved job retains it: if a selected group changes to Match conditions before processing, affected rows report an error instead of gaining an include exception. Completed rows stay saved. Restore Add people mode and retry the saved job, or preview a new import without that group. Omit this option only when deliberately using the existing advanced conditional-group include contract. Existing accepted jobs and saved exceptions keep their policy.
+
 ### 1. Upload and map columns
 
 ```
@@ -625,10 +629,10 @@ The agent can create and edit saved templates and series with the existing Email
 | groups.list                                | archived?                                                           | List groups; archived:true includes archived groups.                                     |
 | groups.get                                 | id                                                                  | One group with its stages.                                                               |
 | groups.create                              | label, color?, mode?, conditions?                                   | Create a group.                                                                          |
-| groups.update                              | id, changed fields                                                  | Edit a group without changing its ID.                                                    |
+| groups.update                              | id, changed fields, expectedGroup?                                   | Edit a group; compare its saved emailVersion to reject a stale form before writes.        |
 | groups.archive / groups.restore            | id                                                                  | Archive or restore a group. Related rules remain paused on restore.                      |
 | groups.preview                             | id or conditions; personId? or cursor?                              | Check conditions without changing membership.                                            |
-| groups.people | groupId; q?, source?, sort?, page?, selectedOnly?, selected? | Read the manual-group picker, including phone-only contacts and current membership. |
+| groups.people | groupId; q?, source?, sort?, page?, selectedOnly?, selected?, availability? | Read the manual-group picker, including phone-only contacts and current membership. |
 | stages.create                              | groupId, label, color?, position?, terminal?                        | Create a stage in a saved group.                                                         |
 | stages.update                              | id, groupId, changed fields                                         | Edit a stage.                                                                            |
 | stages.reorder                             | groupId, stageIds                                                   | Save every active stage ID in order, once each.                                          |
@@ -655,7 +659,7 @@ The agent can create and edit saved templates and series with the existing Email
 | person.permission | personId, allowed; backfill?, expectedEmail?, evidence?, requestKey?; or backfill batch with people (1–25) | Record a decision or repair reviewed missing permission without automation. Unsubscribe and suppression still win. |
 | audience.preview                           | audience                                                            | Preview matched and eligible People for a campaign.                                      |
 | import.preview                             | csv, mapping?, headersOnly?                                         | Validate a CSV and match existing contacts; sends nothing.                               |
-| import.start                               | csv, mapping?, groupIds?, requestKey                                | Start a saved import.                                                                    |
+| import.start                               | csv, mapping?, groupIds?, requestKey, emailPermission?, manualGroupsOnly? | Start a saved import with frozen permission and optional manual-group policy.             |
 | import.get                                 | id                                                                  | Read the import cursor, outcomes, and errors.                                            |
 | import.retry                               | id                                                                  | Retry failed rows after correcting saved identity conflicts.                             |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {