frontpage-host 0.1.25 → 0.1.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/PEOPLE.md +6 -5
  2. package/package.json +1 -1
package/PEOPLE.md CHANGED
@@ -102,11 +102,12 @@ frontpage people groups create --file repeat-buyers.json --site YOUR_SITE --json
102
102
  frontpage people membership override --person PERSON_ID --group GROUP_ID --override include --site YOUR_SITE --json
103
103
  frontpage people membership override --person PERSON_ID --group GROUP_ID --override exclude --site YOUR_SITE --json
104
104
  frontpage people membership override --person PERSON_ID --group GROUP_ID --override auto --site YOUR_SITE --json
105
- frontpage people membership hold --person PERSON_ID --group GROUP_ID --hold true --site YOUR_SITE --json
106
105
  frontpage people membership hold --person PERSON_ID --group GROUP_ID --hold false --site YOUR_SITE --json
107
106
  ```
108
107
 
109
- `include` keeps one person in an automatic group; `exclude` keeps them out. `auto` clears the exception. A hold pauses automatic changes and that group’s attached email for this person. It does not prevent an owner from making an explicit change.
108
+ `include` keeps one person in an automatic group; `exclude` keeps them out. `auto` clears the exception and applies that group’s conditions immediately when the needed facts are available. It can add or remove membership and run the group’s normal rules. It does not change other groups or email permission. An earlier saved pause still prevents automatic changes.
109
+
110
+ **Earlier pauses.** New `--hold true` requests fail unless the person already has that pause; an existing pause remains unchanged. Use `--hold false` to resume a saved pause. This keeps membership, stage and exception, restarts the time-rule clock, and skips earlier pending work for this person/group. It fails with HTTP 409 while a group rule is running; try again after it finishes. Archived groups must be restored first. No saved pause is cleared automatically. Failed runs remain available for an explicit review and retry; resuming does not retry them.
110
111
 
111
112
  **Preserve existing records.**
112
113
 
@@ -528,12 +529,12 @@ The agent can create and edit saved templates and series with the existing Email
528
529
  | stages.reorder | groupId, stageIds | Save every active stage ID in order, once each. |
529
530
  | stages.archive / stages.restore | id, groupId | Keep assignments and history while archiving or restoring. |
530
531
  | membership.get | personId | Memberships and email eligibility. |
531
- | membership.add / membership.remove | personId, groupId; reset? on add | Join or leave a manual group. |
532
+ | membership.add / membership.remove | personId, groupId; reset? on add | Join or leave a group; a conditions group stores an include or exclude exception. |
532
533
  | membership.move | personId, fromGroupId, groupId, reset? | Leave one manual group and join another. |
533
534
  | membership.stage | personId, groupId, stageId | Set a stage; null clears it without leaving the group. |
534
535
  | membership.advance | personId, groupId | Move to the next nonterminal stage. |
535
536
  | membership.override | personId, groupId, override | Use include, exclude, or null for automatic membership. |
536
- | membership.hold | personId, groupId, hold | Pause or resume automatic changes for this person/group. |
537
+ | membership.hold | personId, groupId, hold | Resume an earlier saved pause; creating a new pause is no longer supported. |
537
538
  | rules.list | archived? | List rules; archived:true includes archived rules. |
538
539
  | rules.get | id | Read the saved rule and version. |
539
540
  | rules.create | name, trigger, conditions?, actions, enabled? | Create a rule. Pass enabled:false to review it first. |
@@ -555,7 +556,7 @@ The agent can create and edit saved templates and series with the existing Email
555
556
 
556
557
  ## Limits, timing, and recovery
557
558
 
558
- - **Worker timing:** the existing minute worker handles saved imports, account sync, condition groups, timed rules, and pending actions. A busy queue can take longer than one minute.
559
+ - **Worker timing:** the existing People worker runs every five minutes and handles saved imports, account sync, condition groups, timed rules, and pending actions. Work starts on a later scheduled pass; a busy queue or retries can take longer than five minutes.
559
560
  - **Temporary failures:** eligible rule actions retry with bounded backoff, up to eight attempts. Permanent errors stay visible until corrected. Completed actions retain their receipts.
560
561
  - **Safe activation:** new UI rules and attachments start paused. Enabling applies to future events. Updating a rule changes its version and does not replay old events.
561
562
  - **Safe membership:** cycle checks reject rules that would repeatedly add/remove or move people in a loop. Stage guards prevent late events from resetting later progress.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "frontpage-host",
3
- "version": "0.1.25",
3
+ "version": "0.1.27",
4
4
  "description": "Frontpage CLI — manage your site from the terminal",
5
5
  "type": "module",
6
6
  "bin": {