frontpage-host 0.3.0 → 0.3.1

package/AGENTS.md

@@ -285,3 +285,9 @@ 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. Conditional groups use condition preview and do not accept manual additions.

package/PEOPLE.md

@@ -76,7 +76,7 @@ frontpage people groups restore --id GROUP_ID --site YOUR_SITE --json
 
 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.
 
@@ -628,7 +628,7 @@ The agent can create and edit saved templates and series with the existing Email
 | groups.update                              | id, changed fields                                                  | Edit a group without changing its ID.                                                    |
 | 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.                                          |

package/package.json

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