recess-cli 3.10.0 → 3.12.0

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.
package/dist/help.js CHANGED
@@ -13,8 +13,10 @@ Usage:
13
13
  [--node <node-id>] [--confirm]
14
14
  recess [--json] mastery unlink <link-id> [--confirm]
15
15
  recess [--json] --version
16
- recess [--json] help [noun] [verb]
17
- recess [--json] agent-context
16
+ recess [--json] help [noun] [verb] [--all]
17
+ recess [--json] agent-context [noun] [verb] [--full]
18
+ recess [--json] confirm <operation-key>
19
+ [--confirm-destructive-changes --destructive-change-token TOKEN]
18
20
  recess [--json] setup [--skill-only]
19
21
  recess [--json] doctor
20
22
  recess [--json] update [--confirm]
@@ -59,7 +61,7 @@ Usage:
59
61
  recess [--json] users tier preview <kid-id> --tier social|academics|lite|complete|platform
60
62
  [--slots N]
61
63
  recess [--json] users tier set <kid-id> --tier social|academics|lite|complete|platform
62
- [--slots N] --expected-updated-at <iso> [--allow-strand] [--confirm]
64
+ [--slots N] [--expected-updated-at <iso>] [--allow-strand] [--confirm]
63
65
  recess [--json] guides create --email <email> --first-name TEXT
64
66
  [--last-name TEXT] [--no-invite] [--confirm]
65
67
  recess [--json] guides invite --user <user-id> [--confirm]
@@ -74,6 +76,7 @@ Usage:
74
76
  recess [--json] students upload-map-scores --student <kid-id>
75
77
  --file </path/to/map-report.pdf> [--confirm]
76
78
  recess [--json] students issue-email --student <kid-id> [--confirm]
79
+ recess [--json] students notes add --student <kid-id> --text TEXT [--confirm]
77
80
  recess [--json] chat-logs list --student <user-id> [--limit 100] [--cursor <cursor>]
78
81
  recess [--json] chat-logs get <conversation-id>
79
82
  recess [--json] chat-logs by-todo <todo-id>
@@ -95,7 +98,7 @@ Usage:
95
98
  recess [--json] billing resume --subscription <id> [--confirm]
96
99
  recess [--json] invoices refund --invoice <id> --line-item <id>
97
100
  --method refund|credit|tokens [--full | --amount-cents N]
98
- [--who-pays guide|recess] [--reason TEXT] [--confirm]
101
+ [--who-pays guide|recess] [--refund-reason TEXT] [--confirm]
99
102
  recess [--json] apps init <dir> [--for-todo <todo-id>] [--force]
100
103
  recess [--json] apps scaffold [--for-todo <todo-id>]
101
104
  recess [--json] apps preview [dir] [--port N]
@@ -120,14 +123,14 @@ Usage:
120
123
  recess [--json] applications disposition <application-id>
121
124
  --data-file <disposition.json> [--confirm]
122
125
  recess [--json] applications qualify <application-id>
123
- --quality QUALIFIED|NEEDS_NURTURE|UNKNOWN --reason TEXT [--confirm]
126
+ --quality QUALIFIED|NEEDS_NURTURE|UNKNOWN [--override-reason TEXT] [--confirm]
124
127
  recess [--json] applications update-contact <application-id>
125
128
  --data-file <contact.json> [--confirm]
126
129
  recess [--json] applications claim-email|claim-link <application-id>
127
130
  --intent-key <uuid> [--supersede] [--confirm]
128
131
  recess [--json] applications revoke-claim <application-id> [--confirm]
129
132
  recess [--json] applications link-family <application-id> --family <family-id> [--confirm]
130
- recess [--json] applications close <application-id> --reason TEXT [--confirm]
133
+ recess [--json] applications close <application-id> [--close-reason TEXT] [--confirm]
131
134
  recess [--json] applications add-call-note <application-id>
132
135
  --data-file <call-note.json> [--confirm]
133
136
  recess [--json] applications edit-call-note <application-id>
@@ -154,17 +157,17 @@ Usage:
154
157
  recess [--json] billing extend-trial --subscription <id>
155
158
  --trial-end ISO_DATE [--confirm]
156
159
  recess [--json] billing cancel-subscription --subscription <id>
157
- [--immediate] [--reason TEXT] [--restore] [--confirm]
160
+ [--immediate] [--cancel-reason TEXT] [--restore] [--confirm]
158
161
  recess [--json] payout payruns list [--status A,B] [--schedule <id>]
159
162
  recess [--json] payout recipients list [--search <name>] [--user <id>] [--id <id>] [--include-archived]
160
163
  [--limit 20] [--cursor <id>]
161
164
  recess [--json] payout invoices list [--payrun <id>] [--recipient <account-id>]
162
165
  [--user <id>] [--status A,B] (at least one filter)
163
- recess [--json] payout recipients archive <account-id> [--zero-balance] [--confirm]
166
+ recess [--json] payout recipients archive <account-id> [--zero-balance [--zero-balance-reason TEXT]] [--confirm]
164
167
  recess [--json] payout recipients unarchive <account-id> [--confirm]
165
- recess [--json] payout recipients remove-schedule <account-id> --schedule <id> [--zero-balance] [--confirm]
168
+ recess [--json] payout recipients remove-schedule <account-id> --schedule <id> [--zero-balance [--zero-balance-reason TEXT]] [--confirm]
166
169
  recess [--json] payout recipients add-schedule <account-id> --schedule <id> [--confirm]
167
- recess [--json] payout payruns remove-account <payrun-id> --recipient <account-id> [--zero-balance] [--confirm]
170
+ recess [--json] payout payruns remove-account <payrun-id> --recipient <account-id> [--zero-balance [--zero-balance-reason TEXT]] [--confirm]
168
171
  recess [--json] payout invoices get <invoice-id>
169
172
  recess [--json] payout invoices set-status <invoice-id>
170
173
  --status IN_REVIEW|OPEN|PAID|CANCELED [--send-email] [--confirm]
@@ -177,21 +180,42 @@ Usage:
177
180
  recess [--json] channels list [<query>...] [--type <channel-type>] [--audience KID|PARENT]
178
181
  [--status ACTIVE|HIDDEN|ARCHIVED] [--limit 1..200]
179
182
  recess [--json] channels create --name TEXT [--type <channel-type>]
180
- [--audience KID|PARENT|NONE] [--description TEXT] [--image <path>] [--no-join] [--confirm]
183
+ [--audience KID|PARENT|NONE] [--description TEXT] [--image <path>] [--no-join] [--staff-only] [--confirm]
181
184
  recess [--json] channels set-image <channel-id> [path] [--clear] [--confirm]
185
+ recess [--json] channels staff-only <channel-id> on|off [--confirm]
182
186
  recess [--json] channels join <channel-id> [--confirm]
183
187
  recess [--json] channels members list <channel-id> [--include-left]
184
188
  recess [--json] channels members add <channel-id> <user-id...> [--role MEMBER|MODERATOR|ADMIN] [--confirm]
185
189
  recess [--json] channels members set-role <channel-id> <user-id...> --role MEMBER|MODERATOR|ADMIN [--confirm]
186
190
  recess [--json] channels members remove <channel-id> <user-id...> [--confirm]
187
191
  recess [--json] tuition-plans generate --parent TEXT --student TEXT [--dob YYYY-MM-DD]
188
- --state XX --start YYYY-MM-DD --annual DOLLARS --enrollment direct|partner-school
189
- [--partner-school <slug|id>] [--state-funding] [--elective-price DOLLARS]
192
+ --state XX --start YYYY-MM-DD --annual DOLLARS --enrollment direct|partner-school|program
193
+ [--partner-school <slug|id>] [--force-direct] [--state-funding] [--elective-price DOLLARS]
190
194
  [--one-on-one-price DOLLARS] [--one-on-one-sessions N] [--end YYYY-MM-DD]
191
195
  [--terms full-year,school-year,custom] [--payments upfront,installments]
192
- [--note TEXT]... [--bill-date upfront|N=YYYY-MM-DD]... [--even-installments]
193
- [--pdf <path>] [--open]
196
+ [--note TEXT]... [--bill-date upfront|N=YYYY-MM-DD]... [--amount N=DOLLARS]... [--even-installments]
197
+ [--esa-award-unknown [--esa-scenarios DOLLARS,...]] [--pdf <path>] [--open]
194
198
  recess [--json] tuition-plans states
199
+ recess [--json] admissions create --school <institution-slug> --enrollment direct|partner-school|program
200
+ [--partner-school <slug|id>] --parent "First Last" --email EMAIL [--phone TEXT] --state XX
201
+ --kid "First Last:YYYY-MM-DD[:grade]" (repeat per child) [--application <application-id>]
202
+ [--financial-aid <financial-aid-application-id>|none]
203
+ [--tier complete] [--paywall DOLLARS] [--staff-note TEXT]... [--no-email]
204
+ --start YYYY-MM-DD --annual DOLLARS [--state-funding] [--end YYYY-MM-DD]
205
+ [--terms full-year,school-year,custom] [--payments upfront,installments] [--note TEXT]...
206
+ [--bill-date upfront|N=YYYY-MM-DD]... [--amount N=DOLLARS]... [--even-installments] [--force-direct]
207
+ [--esa-award-unknown [--esa-scenarios DOLLARS,...]] [--elective-price DOLLARS]
208
+ [--one-on-one-price DOLLARS] [--one-on-one-sessions N] [--confirm]
209
+ recess [--json] admissions get <packet-id>
210
+ recess [--json] admissions list [--status SENT|ACCOUNT_CREATED|SIGNED|CONSENTED|QUESTIONS_DONE|COMPLETE|VOIDED] [--email TEXT] [--limit N]
211
+ recess [--json] admissions resend <packet-id> [--no-email] [--confirm]
212
+ recess [--json] admissions void <packet-id> --reason TEXT [--confirm]
213
+ recess [--json] admissions mark-signed <packet-id> --option <term:payment> [--note TEXT] [--confirm]
214
+ recess [--json] admissions requote <packet-id> (--keep-plan | --start YYYY-MM-DD --annual DOLLARS [plan flags as in create])
215
+ [--paywall DOLLARS|--no-paywall] [--note TEXT] [--confirm]
216
+ recess [--json] admissions archive-agreement <packet-id> [--confirm]
217
+ recess [--json] reports activity [--partner-school <slug|id>] [--guide <name|email|id>]
218
+ [--cohort <cohort-id>] [--week YYYY-MM-DD] [--no-ai] [--out <dir>]
195
219
  recess [--json] cohorts get <cohort-id> [--events-tab ACTIVE|ENDED|CANCELED|ARCHIVED]
196
220
  recess [--json] cohorts schedule get <cohort-id>
197
221
  recess [--json] cohorts schedule set <cohort-id> --days <MO,WE> --time <09:30> [--timezone <zone>] --effective-date <YYYY-MM-DD> --notify none|parents [--confirm] [--approval-token <token>]
@@ -208,7 +232,7 @@ Usage:
208
232
  recess [--json] events list --date YYYY-MM-DD [--timezone <iana>] [--search TEXT]
209
233
  recess [--json] events take-attendance <event-id> --attended <id,id,...>
210
234
  [--absent <id,id,...>] [--excused <id,id,...>] [--confirm]
211
- recess [--json] events cancel <event-id> --reason TEXT [--confirm]
235
+ recess [--json] events cancel <event-id> --message TEXT [--confirm]
212
236
  recess [--json] events set-status <event-id> --status ACTIVE|ENDED|CANCELED [--confirm]
213
237
  recess [--json] events reschedule --cohort <id> --event <event-id>
214
238
  --starts-at "YYYY-MM-DDTHH:MM" [--timezone <iana>] [--length-mins N] [--confirm]
@@ -287,7 +311,7 @@ Usage:
287
311
  --family <family-id> --attended true|false [--confirm]
288
312
  recess [--json] onboarding meeting-reschedule <meeting-id>
289
313
  --starts-at <iso> [--note TEXT] [--confirm]
290
- recess [--json] onboarding meeting-cancel <meeting-id> --reason TEXT [--confirm]
314
+ recess [--json] onboarding meeting-cancel <meeting-id> --message TEXT [--confirm]
291
315
  recess [--json] onboarding set-intake <family-id> --session <id>
292
316
  --data <json> [--expected-updated-at <iso>] [--confirm]
293
317
  recess [--json] onboarding extract <family-id> --session <id>
@@ -397,7 +421,7 @@ Usage:
397
421
  recess [--json] goal-templates get <template-id|slug> [--spec-only]
398
422
  recess [--json] goal-templates policy <template-id|slug>
399
423
  recess [--json] goal-templates set-policy <template-id|slug> --recipe KEY
400
- [--target-modules N] [--required-modules N|all] --expected-version N
424
+ [--target-modules N] [--required-modules N|all] [--expected-version N]
401
425
  [--confirm --approval-token TOKEN]
402
426
  recess [--json] goal-templates migrate-policy <template-id|slug> --students ID,ID
403
427
  [--confirm --approval-token TOKEN]
@@ -422,16 +446,16 @@ Usage:
422
446
  recess [--json] goal-templates validate-spec --file <path/template.json>
423
447
  recess [--json] goal-templates create --file <path/template.json>
424
448
  [--coin-amount N] [--confirm]
425
- recess [--json] goal-templates patch-spec <template-id|slug> --expected-version N
449
+ recess [--json] goal-templates patch-spec <template-id|slug> [--expected-version N]
426
450
  --patches-file <path/patches.json> [--confirm --approval-token TOKEN]
427
451
  [--confirm-destructive-changes --destructive-change-token TOKEN]
428
- recess [--json] goal-templates set-metadata <template-id> --expected-version N
452
+ recess [--json] goal-templates set-metadata <template-id> [--expected-version N]
429
453
  [--title TEXT] [--description TEXT] [--emoji X] [--category TEXT] [--tags A,B]
430
454
  [--image-url URL] [--coin-amount N] [--sort-order N] [--is-starter true|false]
431
455
  [--setup-audience KID_FRIENDLY|PARENT_SETUP] [--kind SIMPLE|BLUEPRINT]
432
456
  [--visibility PUBLIC|PRIVATE|STAFF_ONLY] [--target-platform ANY|MOBILE|DESKTOP]
433
457
  [--agent-instructions-file <path>] [--output-template-file <path>] [--confirm]
434
- recess [--json] goal-templates delete <template-id> --expected-version N [--confirm]
458
+ recess [--json] goal-templates delete <template-id> [--expected-version N] [--confirm]
435
459
  recess [--json] goal-templates generate-image <template-id|slug>
436
460
  [--prompt TEXT] [--confirm]
437
461
  recess [--json] goal-templates snapshot-files <template-id> [--path P]
@@ -439,8 +463,10 @@ Usage:
439
463
  (--source-goal <goal-id> | --source-draft <draft-slug> --student <goal-owner-id>
440
464
  | --source-dir <local-checkout>)
441
465
  [--dry-run] [--confirm --approval-token TOKEN]
442
- recess [--json] goal-templates apply <template-id> --answers-file <path>
443
- [--dry-run] [--confirm --approval-token TOKEN]
466
+ recess [--json] goal-templates answers-template <template-id|slug>
467
+ [--student <kid-id-or-name>]
468
+ recess [--json] goal-templates apply <template-id> [--student <kid-id-or-name>]
469
+ [--answers-file <path>] [--dry-run] [--confirm --approval-token TOKEN]
444
470
  recess [--json] goal-templates apply-starter <template-id> --student <kid-id>
445
471
  [--answers-file <path>] [--confirm]
446
472
  recess [--json] goals list --student <kid-id> [--query <text>] [--include-archived]
@@ -463,6 +489,8 @@ Usage:
463
489
  [--confirm --approval-token TOKEN]
464
490
  recess [--json] goals move-module <module-ref> --student <kid-id> --goal <goal-id>
465
491
  (--to-end | --position <n>) [--confirm --approval-token TOKEN]
492
+ recess [--json] goals launch-todo <goal-id> --student <kid-id> [--module <module-ref>]
493
+ [--due-date YYYY-MM-DD] [--confirm --approval-token TOKEN]
466
494
  recess [--json] goals queue get <goal-id> --student <kid-id>
467
495
  recess [--json] goals queue set <goal-id> --student <kid-id>
468
496
  --entries-file <path.json> --delta TEXT [--replace-description-pointer]
@@ -492,7 +520,7 @@ Usage:
492
520
  recess [--json] memories log --student <kid-id> --date YYYY-MM-DD
493
521
  recess [--json] rocky get --student <kid-id>
494
522
  recess [--json] rocky set --student <kid-id> --patch-file <path/patch.json>
495
- --expected-updated-at ISO|none [--confirm]
523
+ [--expected-updated-at ISO|none] [--confirm]
496
524
  recess [--json] tutor-templates list [--q TEXT] [--subject TEXT] [--grade N]
497
525
  recess [--json] tutor-templates get <slug>
498
526
  recess [--json] tutor-templates assign <slug> [--student <kid-id>] [--confirm]
@@ -512,7 +540,7 @@ Usage:
512
540
  recess [--json] goals files list --student <goal-owner-id> --goal <goal-id>
513
541
  recess [--json] goals files read --student <goal-owner-id> --goal <goal-id> --path P
514
542
  recess [--json] goals files init --student <goal-owner-id> --draft <draft-slug>
515
- --output-dir <local-dir>
543
+ --output-dir <local-dir> [--scaffold [--title TEXT] [--modules N]]
516
544
  recess [--json] goals files checkout --student <goal-owner-id>
517
545
  (--goal <goal-id> | --draft <draft-slug>)
518
546
  --output-dir <local-dir>
@@ -557,8 +585,11 @@ converted back, so "validate-spec" against the same file until it passes, then
557
585
  "create". "create" runs a real server-side validation before its gate, so the
558
586
  preview shows the handler/goalShape/step keys the SERVER resolved. "apply" runs
559
587
  the backend's own dryRun before the gate and previews the per-student outcome.
560
- "set-metadata" and "delete" require --expected-version (from "get"); a stale one
561
- 409s STALE_WRITE and writes nothing. The spec is unreachable from "set-metadata"
588
+ "set-metadata", "delete", "patch-spec" and "set-policy" take an optional
589
+ --expected-version; omitted, the current version is read and pinned into the
590
+ preview, so a change before confirm is refused. A stale one 409s STALE_WRITE.
591
+ --student on goal, todo, goal-file and template-apply commands takes an ID or an
592
+ exact roster name. "answers-template" prints a fillable answers file for "apply". The spec is unreachable from "set-metadata"
562
593
  by design — an existing spec is edited only through the guarded /ai patch path.
563
594
 
564
595
  School-onboarding workflow notes: "onboarding family" is the one-screen view
@@ -637,8 +668,8 @@ current token at confirm time and warns that post-preview edits are unprotected.
637
668
  server-side.
638
669
 
639
670
  Class-ops notes: "events cancel" notifies families (chat + parent email blast +
640
- credit notes + Slack); "events set-status --status CANCELED" is a silent status
641
- change. Reschedule times are cohort-local wall-clock (zoneless).
671
+ credit notes + Slack) with its --message text verbatim (--reason stays in the
672
+ audit log); "events set-status --status CANCELED" is a silent status change. Reschedule times are cohort-local wall-clock (zoneless).
642
673
 
643
674
  Channel notes: channel types are COMMUNITY (default), SYSTEM_GENERATED,
644
675
  COHORT_PARENT, DIRECT_MESSAGE, GROUP_MESSAGE, COURSE_REQUEST, RECESS_EVENT,
@@ -649,7 +680,9 @@ and COHORT_PARENT to PARENT (--audience NONE clears it). Non-community types
649
680
  created here stand alone: nothing links them to a cohort, event, challenge, or
650
681
  course. "members add" also rejoins past members and applies --role to everyone
651
682
  named; kids are refused from PARENT-audience and COHORT_PARENT channels.
652
- "members remove" is soft (sets leftAt) and posts a LEFT notice. Images
683
+ "members remove" is soft (sets leftAt) and posts a LEFT notice. Staff-only
684
+ channels (--staff-only, staff-only on|off) let only staff send: admins, guides,
685
+ program staff, moderators, and channel admins/moderators. Images
653
686
  (--image, set-image) are .png/.jpg/.gif/.webp, 10MB max.
654
687
 
655
688
  Family address notes: "families set-addresses --file" takes a JSON array of
@@ -659,28 +692,87 @@ omitted for US; US ZIPs must be 12345 or 12345-6789. Each entry replaces the
659
692
  family's whole address. The preview is the server's dry run: before and after
660
693
  for every family that changes.
661
694
 
695
+ Activity-report notes: "reports activity" builds a weekly student activity report
696
+ on the server for exactly one audience: a partner school's enrolled kids
697
+ (--partner-school), a guide's academy roster grouped by core-academics cohort
698
+ (--guide takes a first name, full name, email, or id; an ambiguous name lists the
699
+ matches), or one cohort's registered kids (--cohort). --week is the Monday of the
700
+ week (default: the last full Mon-Sun week, US Eastern). It writes the summary PDF,
701
+ the CSVs, and the per-student AI summaries JSON to --out (default
702
+ ./<report>_<week>/). --no-ai skips the per-student summaries. Generation takes
703
+ 10-30 seconds; AI summaries name the student and quote their work, so review
704
+ them before sending a report outside Recess.
705
+
662
706
  Tuition-plan notes: "generate" computes a Recess Academy tuition plan (nothing is
663
707
  stored): a 180-instructional-day term at --annual (tuition net of Recess aid) and
664
708
  a term through the state's typical school-year end. Each is paid in full upfront
665
709
  (5% off, per /school/tuition) or quarterly; Florida is instead cash upfront or
666
- monthly in arrears (Step Up pays only in arrears). --state-funding (family pays
710
+ monthly (invoiced mid-month, due at month end, the final payment due on the last
711
+ day of school; Step Up pays only in arrears), in fixed monthly amounts
712
+ only: --annual in Florida must be 8000, 9000, 11000, 14500, or 18000. --state-funding (family pays
667
713
  with ESA funds) makes quarters follow the state's ESA funding dates where Recess
668
714
  has them (AZ). It returns the /admin/tuition-plans web URL (--open opens it)
669
715
  and, with --pdf, writes the letterhead PDF to that path. "states" lists the
670
716
  supported states and their year-end dates. --enrollment partner-school
671
- (with --partner-school, e.g. wonder-ed) marks the plan an estimate: the partner
672
- school of record makes the final determination. Add-on prices default to
717
+ (with --partner-school, e.g. wonder-ed) names the partner as the school of record
718
+ and says tuition payments go to it, on the tuition page and the signing page. --enrollment program
719
+ is the online learning program (main or supplemental): the agreement says Recess is not the
720
+ school of record and satisfies no attendance or reporting requirement. Florida students enroll through a
721
+ partner institution or the program: a direct Florida plan is refused unless --force-direct. Add-on prices default to
673
722
  $160/month per extra elective and $400 per 4 tutoring sessions; --elective-price,
674
723
  --one-on-one-price, and --one-on-one-sessions override them on this sheet.
675
724
  --end YYYY-MM-DD adds a custom term through that date (priced by school days).
676
725
  --terms and --payments pick a subset of the matrix (default: every term ×
677
726
  upfront + installments). Full-year and custom terms may not end after July 1:
678
727
  a full year that would is left out of the default and refused if asked for.
679
- --note TEXT (repeatable) prints a note on the sheet. --bill-date (repeatable)
728
+ --amount N=DOLLARS (repeatable) sets installment N's amount; the installments must
729
+ still add up to the plan total, and it cannot combine with --even-installments or
730
+ --esa-award-unknown. --note TEXT (repeatable) prints a note on the sheet. --bill-date (repeatable)
680
731
  moves an invoice date: upfront=YYYY-MM-DD for pay in full, N=YYYY-MM-DD for
681
732
  installment N in every term; due dates follow and dates must stay in order.
682
733
  --even-installments splits each installment plan evenly in whole dollars (any
683
734
  remainder on the first payment) instead of pricing each by its school days.
735
+ --esa-award-unknown is for a family with no ESA award yet: --annual is their
736
+ income-based price with no award, and the sheet opens with two pages (PDF pages
737
+ 1-2) before any price: who pays tuition (the award first, then Recess aid, then
738
+ the family) with the aid ground rules, then a chart of example awards. The
739
+ examples and wording follow the state: Arizona charts $7,300 (universal ESA),
740
+ $14,000, and $34,000; Florida says "scholarship" and charts $8,000, $10,000,
741
+ and $23,000; other states chart their typical award where one is on file.
742
+ --esa-scenarios replaces the examples (up to
743
+ six, comma-separated). Tuition is not final until the award is confirmed, so the
744
+ tuition page lists installments on the ESA funding quarters (no pay in full): a
745
+ start too late for approval (~30 days) to land in its quarter bills that quarter
746
+ now with no award; every other payment shows "up to" its no-award amount. The
747
+ agreement adds a clause that the plan is re-issued once the award is confirmed.
748
+
749
+ Admissions notes: an admission packet is the one link a school family gets to go
750
+ from "yes" to enrolled: create account, sign the tuition plan (and the partner
751
+ school's agreement) in the dashboard, give parental consent, answer the
752
+ enrollment questions per child, and pay if a paywall is set. "create" takes the
753
+ family (--parent, --email, --state, one --kid per child), how they enroll
754
+ (--school is the SCHOOL institution slug as in "applications enroll";
755
+ --enrollment partner-school needs --partner-school), and the tuition plan as the
756
+ same flags "tuition-plans generate" takes (--annual, --start, --state-funding,
757
+ --esa-award-unknown, ...; --note prints on the plan, --staff-note stays on the
758
+ packet). The plan is built once on create, so a bad spec fails there. --paywall
759
+ DOLLARS adds a card step at the end for that family share; leave it off for
760
+ partner-school and ESA-funded families (the CLI warns). --no-email returns the
761
+ link without sending it. The envelope opens with the family's financial aid answers
762
+ for them to initial as true; they come from --financial-aid, else the application's
763
+ aid form, else the newest aid form under the parent's email ("none" leaves it out). "resend" mints a new link (the old one dies) and emails
764
+ it. "get" prints the agreed plan as signed (each child's option, term and every
765
+ installment) and whether the signed agreement is archived in our storage; the
766
+ copy is taken when the envelope completes, and "archive-agreement" retries it.
767
+ "requote" replaces the tuition plan on a packet that has not been paid (same
768
+ plan flags as create, or --keep-plan to reopen the payment choice on the plan
769
+ as it is; --paywall/--no-paywall changes the family share): the Documenso
770
+ envelope is cancelled, the family signs again from the same link, and their
771
+ account, consent and answers stand (a completed packet completes again on its
772
+ own); paid packets need a refund first and voided ones a new packet. "mark-signed" records a signature taken outside the dashboard (or local
773
+ testing without Documenso) so the parent can continue. Status moves on its own:
774
+ the Documenso webhook marks SIGNED, each parent step advances it, and a packet
775
+ with no paywall completes when the questions are in.
684
776
 
685
777
  Payout notes: amounts are integer cents. "payout items add" without --date
686
778
  defaults the item date to the penultimate day of the invoice's cycle (its
@@ -703,13 +795,421 @@ server when the served bundle's minCliVersion allows — an older binary keeps t
703
795
  bundled copy, and an unreachable server is not an error. "doctor" reports whether
704
796
  a newer skill exists and names the command; it never writes.
705
797
 
706
- Writes preview and exit 2 unless --confirm is supplied after explicit human approval.
707
- Every preview includes an operationKey; confirmed writes must echo it with
708
- --operation-key so an interrupted invocation can be retried without duplicating the write.
798
+ Writes preview and exit 2 until confirmed after explicit human approval. Every
799
+ preview includes an operationKey. Simplest confirm: "recess confirm <operation-key>"
800
+ replays the stored preview. Equivalently, rerun the same command with --confirm
801
+ --operation-key KEY; either way an interrupted invocation can be retried without
802
+ duplicating the write.
803
+ Output is a JSON envelope by default when stdout is not a terminal or
804
+ RECESS_CLI_JSON=1; --json forces it, --pretty (or --no-json) forces human output.
709
805
  Environment overrides: RECESS_CLI_API_ORIGIN, RECESS_CLI_WEB_ORIGIN,
710
806
  RECESS_CLI_OAUTH_CLIENT_ID, RECESS_CLI_COOKIE, RECESS_CLI_CONFIG,
711
807
  RECESS_CLI_PROFILE, RECESS_CLI_FEEDBACK_ENDPOINT.
712
808
 
713
- Every command that calls the Recess API, except auth commands, requires
714
- --reason TEXT: a non-empty human-readable purpose of at most 1024 characters.`;
809
+ --reason TEXT is the audit-log purpose (non-empty, at most 1024 characters) and
810
+ is never sent to families. Writes require it; reads default it to
811
+ "Read: <command>". Family- or record-facing text has its own flag (--message,
812
+ --refund-reason, --cancel-reason, --override-reason, --close-reason,
813
+ --zero-balance-reason).`;
814
+ /**
815
+ * One line per command path: what it does / when to reach for it. Shown under
816
+ * the usage in `help` and as `summary` in `agent-context`. Keyed by the exact
817
+ * command path (`buildCommandSchema` splits `a|b` variants into two paths).
818
+ */
819
+ export const COMMAND_SUMMARIES = {
820
+ "mastery graphs": "List mastery graphs, optionally for one domain.",
821
+ "mastery get": "Read a mastery graph (seed, draft, or release).",
822
+ "mastery edit": "Edit a mastery graph from a JSON file or an LLM instruction into a draft.",
823
+ "mastery publish": "Publish a draft as the active release (CAS on the current release).",
824
+ "mastery delete-draft": "Delete an unpublished mastery-graph draft.",
825
+ "mastery archive": "Archive a mastery-graph release.",
826
+ "mastery links": "List content linked to a mastery graph (or one node).",
827
+ "mastery link": "Link an applet or goal to a mastery-graph node.",
828
+ "mastery unlink": "Remove a mastery-graph content link.",
829
+ "--version": "Print the CLI and bundled skill versions.",
830
+ help: "Show usage, summaries, and notes for a noun (--all: every command).",
831
+ "agent-context": "Machine-readable command catalog for agents (compact; --full for every flag).",
832
+ confirm: "Execute a previewed write by replaying its stored preview (simplest confirm path).",
833
+ setup: "Install the CLI's agent skill (and upgrade it from the server).",
834
+ doctor: "Check config, session, and skill freshness; never writes.",
835
+ update: "Update the recess CLI to the latest release.",
836
+ "profile list": "List saved API/web origin profiles.",
837
+ "profile show": "Show one saved profile.",
838
+ "profile save": "Save a named profile of API/web origins.",
839
+ "profile use": "Make a saved profile the active one.",
840
+ "profile delete": "Delete a saved profile.",
841
+ "jobs list": "List locally recorded write operations (by operation key).",
842
+ "jobs get": "Show one recorded write operation and its result.",
843
+ "jobs prune": "Delete old local operation records.",
844
+ "feedback list": "List feedback you have submitted about the CLI.",
845
+ "feedback submit": "Send feedback about the CLI to the Recess team.",
846
+ "auth login": "Sign in through the browser (loopback flow).",
847
+ "auth request": "Headless sign-in: print an approval URL a signed-in human opens.",
848
+ "auth poll": "Collect the session after an auth request is approved.",
849
+ "auth status": "Show the current session's user, role, and CLI scope.",
850
+ "auth logout": "Sign out and delete the stored session.",
851
+ "users search": "Find users by name, email, or id.",
852
+ "users get": "Read a user's account, family, roles, and flags.",
853
+ "users school complete-action": "Mark a school-enrollment action done.",
854
+ "users school status": "Show a kid's school-enrollment status and actions.",
855
+ "users school history": "List a kid's school-enrollment history.",
856
+ "users school withdraw": "Withdraw a kid from school enrollment.",
857
+ "users school restore": "Restore a withdrawn kid's school enrollment.",
858
+ "users enrollment history": "List a kid's enrollment-entity changes.",
859
+ "users enrollment set-partner-school-cc": "Set or clear the CC email for a partner school.",
860
+ "users enrollment list-partner-schools": "List partner schools.",
861
+ "users enrollment set": "Set which entity a kid is enrolled through (program/school/partner).",
862
+ "users phone get": "Read a user's phone number and verification.",
863
+ "users phone set": "Set a user's phone number (stored E.164, unverified).",
864
+ "users phone clear": "Remove a user's phone number.",
865
+ "users lock": "Lock a kid's account (with their family's guardians).",
866
+ "users unlock": "Unlock a kid's account with their guardians; rerun = Refresh Unlock.",
867
+ "users disable": "Soft-disable an account or whole family (reversible; refuses live billing).",
868
+ "users restore": "Restore a disabled account to a named role.",
869
+ "users tier list-tiers": "List membership tiers and their slots.",
870
+ "users tier get": "Show a kid's membership tier and slots.",
871
+ "users tier preview": "Preview the effect of a tier change (no write).",
872
+ "users tier set": "Change a kid's membership tier and slots.",
873
+ "guides create": "Create a guide account (and send the invite).",
874
+ "guides invite": "Re-send a guide's account invite.",
875
+ "guardians invite": "Add a guardian to a family (and send the invite).",
876
+ "students texts get": "Show a kid's parent SMS summary settings.",
877
+ "students texts set": "Change a kid's SMS summary switch or send hour.",
878
+ "students texts set-guardian": "Change one adult's SMS frequency, focus, or on/off.",
879
+ "students upload-map-scores": "Upload a NWEA MAP score report PDF for a kid.",
880
+ "students issue-email": "Issue a Recess email address for a kid.",
881
+ "students notes add": "Add a staff-visible guide note to a kid's profile (Rocky reads it).",
882
+ "chat-logs list": "List a student's AI chat conversations.",
883
+ "chat-logs get": "Read one AI chat conversation.",
884
+ "chat-logs by-todo": "Read the AI chat conversations behind a todo.",
885
+ "rooms transcripts search": "Search live-room meeting transcripts.",
886
+ "rooms transcripts get": "Read one meeting transcript (optionally a breakout).",
887
+ "students list": "List the kids you can manage.",
888
+ "students today": "Show a kid's day: todos, XP, and schedule.",
889
+ "students schedule": "Show a kid's upcoming schedule.",
890
+ "students todos": "List a student's todos for a date (or recent), with statuses.",
891
+ "students analysis": "Read the learning analysis for a completed todo.",
892
+ "students xp-history": "Show a kid's XP history over a range.",
893
+ "enrollments list": "List a user's enrollments.",
894
+ "subscriptions list": "List a family's Stripe subscriptions.",
895
+ "invoices list": "List a subscription's invoices.",
896
+ "billing pause": "Pause a subscription's billing (optionally until a date).",
897
+ "billing resume": "Resume a paused subscription's billing.",
898
+ "invoices refund": "Refund or credit an invoice line item.",
899
+ "apps init": "Scaffold a Studio app project in a local directory.",
900
+ "apps scaffold": "Fetch the Studio app scaffold (optionally for a todo).",
901
+ "apps preview": "Preview a Studio app locally.",
902
+ "apps primitives list": "List shared Studio app primitives.",
903
+ "apps primitives publish": "Publish a shared Studio app primitive.",
904
+ "apps standards": "Search learning standards for a Studio app.",
905
+ "apps list": "List your Studio app projects.",
906
+ "apps pull": "Download a Studio app project into a directory.",
907
+ "apps validate": "Upload a Studio app and run a dry build.",
908
+ "apps publish": "Build and publish a Studio app (optionally assign it to a kid).",
909
+ "apps assign": "Assign a published Studio app to a kid as a todo.",
910
+ "apps status": "Check a Studio build's status.",
911
+ "applications list": "List enrollment applications with filters.",
912
+ "applications get": "Read one enrollment application.",
913
+ "applications quotes": "List an application's tuition quotes.",
914
+ "applications meetings": "List an application's meetings.",
915
+ "applications call-notes": "List an application's call notes.",
916
+ "applications create": "Create an enrollment application from JSON.",
917
+ "applications disposition": "Set an application's disposition from JSON.",
918
+ "applications qualify": "Set an application's lead quality.",
919
+ "applications update-contact": "Update an application's contact details.",
920
+ "applications claim-email": "Email the family a link to claim the application.",
921
+ "applications claim-link": "Mint a claim link for the application.",
922
+ "applications revoke-claim": "Revoke an outstanding application claim.",
923
+ "applications link-family": "Link an application to an existing family.",
924
+ "applications close": "Close an application with a reason.",
925
+ "applications add-call-note": "Add a call note to an application.",
926
+ "applications edit-call-note": "Edit an application's call note.",
927
+ "applications enroll": "Enroll an application's kids from an accepted quote.",
928
+ "quotes get": "Read one tuition quote.",
929
+ "quotes preview": "Price a quote from JSON without saving it.",
930
+ "quotes create": "Create a tuition quote from JSON.",
931
+ "quotes update": "Replace a tuition quote's contents from JSON.",
932
+ "quotes send": "Send a quote to the family.",
933
+ "quotes accept": "Mark a quote accepted.",
934
+ "quotes decline": "Mark a quote declined.",
935
+ "cohorts search": "Find cohorts by name.",
936
+ "enrollments create": "Enroll a kid in a cohort (creates billing).",
937
+ "enrollments register-cohort": "Register an existing enrollment's kid into a cohort.",
938
+ "enrollments unregister-cohort": "Remove a kid from a cohort.",
939
+ "enrollments get-for-subscription": "Find the enrollment behind a subscription.",
940
+ "billing extend-trial": "Move a subscription's trial end date.",
941
+ "billing cancel-subscription": "Cancel a subscription (at period end or --immediate); --restore undoes.",
942
+ "payout payruns list": "List payout runs.",
943
+ "payout recipients list": "List payout recipients.",
944
+ "payout invoices list": "List payout invoices (needs a filter).",
945
+ "payout recipients archive": "Archive a payout recipient.",
946
+ "payout recipients unarchive": "Unarchive a payout recipient.",
947
+ "payout recipients remove-schedule": "Remove a recipient from a payout schedule.",
948
+ "payout recipients add-schedule": "Add a recipient to a payout schedule.",
949
+ "payout payruns remove-account": "Remove a recipient from a payout run.",
950
+ "payout invoices get": "Read one payout invoice and its items.",
951
+ "payout invoices set-status": "Change a payout invoice's status.",
952
+ "payout items add": "Add a line item to a payout invoice (cents).",
953
+ "payout items edit": "Edit a payout line item.",
954
+ "payout items delete": "Delete a payout line item.",
955
+ "families set-addresses": "Replace family mailing addresses from JSON.",
956
+ "channels list": "List community channels with filters.",
957
+ "channels create": "Create a community channel.",
958
+ "channels set-image": "Set or clear a channel's image.",
959
+ "channels join": "Join a channel yourself.",
960
+ "channels members list": "List a channel's members.",
961
+ "channels members add": "Add (or rejoin) members to a channel.",
962
+ "channels members set-role": "Change channel members' roles.",
963
+ "channels members remove": "Remove members from a channel (soft).",
964
+ "tuition-plans generate": "Compute a tuition plan sheet (web URL, optional PDF); stores nothing.",
965
+ "tuition-plans states": "List states supported by tuition plans.",
966
+ "cohorts get": "Read a cohort and its events.",
967
+ "cohorts schedule get": "Read a cohort's recurring schedule.",
968
+ "cohorts schedule set": "Change a cohort's recurring schedule from a date.",
969
+ "cohorts schedule changes": "List a cohort's schedule changes.",
970
+ "cohorts schedule change": "Read one cohort schedule change.",
971
+ "cohorts parent-emails": "List parent emails for a cohort.",
972
+ "cohorts end": "End a cohort (optionally cancel its subscriptions).",
973
+ "cohorts pause-billing": "Pause billing for every enrollment in a cohort.",
974
+ "cohorts resume-billing": "Resume billing for a cohort.",
975
+ "cohorts email": "Email a cohort's parents (and guides).",
976
+ "feed post": "Post a message to users' feeds (optionally email).",
977
+ "events get": "Read one class event.",
978
+ "events list": "List class events on a date.",
979
+ "events take-attendance": "Record attendance for an event.",
980
+ "events cancel": "Cancel an event AND notify families (chat, email, Slack).",
981
+ "events set-status": "Silently change an event's status (no notifications).",
982
+ "events reschedule": "Move one cohort event to a new start time.",
983
+ "events add": "Add a one-off event to a cohort.",
984
+ "registrations approve": "Approve a cohort registration request.",
985
+ "registrations deny": "Deny a kid's cohort registration.",
986
+ "request get": "Raw authenticated GET of any API path (read-only escape hatch).",
987
+ "onboarding status": "Show a family's onboarding stage and trackers.",
988
+ "onboarding queue": "List families waiting on onboarding actions.",
989
+ "onboarding kids": "List onboarding kids by funnel stage.",
990
+ "onboarding rearm-kid-first-run": "Make a kid see the first-run onboarding again.",
991
+ "onboarding timeline": "Show a family's onboarding event timeline.",
992
+ "onboarding readiness": "Show a family's readiness checklist.",
993
+ "onboarding family": "One-screen family view: status, readiness, next action.",
994
+ "onboarding next": "The family's next action plus the exact commands to do it.",
995
+ "onboarding doctor": "Explain who sees school onboarding and why (flags, gates).",
996
+ "onboarding starter-coverage": "Pre-flip gate: are starter goals covered?",
997
+ "onboarding backfill-trackers": "Census of tracker backfill; --apply stamps it.",
998
+ "onboarding active-tutors": "List a family's active tutors.",
999
+ "onboarding meetings": "List a family's onboarding meetings.",
1000
+ "onboarding cohort-options": "List cohorts a family's kid can join.",
1001
+ "onboarding comms": "List onboarding emails/texts sent or queued.",
1002
+ "onboarding lifecycle-prompts": "List lifecycle prompt settings.",
1003
+ "onboarding orientation-sessions": "List orientation sessions.",
1004
+ "onboarding ixl-preview": "Preview IXL provisioning for a kid.",
1005
+ "onboarding intake-session": "Read the family's in-progress intake session.",
1006
+ "onboarding reviews": "List a family's intake reviews.",
1007
+ "onboarding review": "Read one intake review session.",
1008
+ "onboarding intake-session-create": "Create a blank intake session.",
1009
+ "onboarding set-stage": "Move a family's onboarding stage.",
1010
+ "onboarding set-account-state": "Set a family's account state (pause/boot).",
1011
+ "onboarding set-primary-tutor": "Set or clear a family's primary tutor.",
1012
+ "onboarding attest": "Attest (or revoke) an onboarding condition.",
1013
+ "onboarding clear-for-cohort": "Clear a family for cohort registration.",
1014
+ "onboarding register-cohort": "Register a family's kid in a cohort.",
1015
+ "onboarding set-kid-grade": "Set or clear a kid's grade.",
1016
+ "onboarding seed-feed": "Seed a kid's feed interests from the family intake.",
1017
+ "onboarding generate-summaries": "Generate a family's narrative summaries (LLM).",
1018
+ "onboarding provision-math-academy": "Create a Math Academy account for a kid.",
1019
+ "onboarding link-math-academy": "Link a kid to an existing Math Academy student.",
1020
+ "onboarding provision-ixl": "Provision an IXL account for a kid.",
1021
+ "onboarding remove-ixl": "Remove a kid's IXL account link.",
1022
+ "onboarding ixl-sync": "Preview the IXL roster sync; --apply uploads the full roster.",
1023
+ "onboarding contracts": "List enrollment contracts.",
1024
+ "onboarding send-contract": "Send a kid's enrollment contract for signature.",
1025
+ "onboarding send-comms": "Send one onboarding email/text by kind.",
1026
+ "onboarding send-welcome": "Send the family welcome email.",
1027
+ "onboarding send-payment-email": "Send the family payment email.",
1028
+ "onboarding send-recommendations": "Email course recommendations to a family.",
1029
+ "onboarding set-lifecycle-prompt": "Change a lifecycle prompt's settings.",
1030
+ "onboarding override-lifecycle-prompt": "Delay, skip, or clear a lifecycle prompt for one family.",
1031
+ "onboarding orientation-create": "Create an orientation session.",
1032
+ "onboarding orientation-set-status": "Cancel or complete an orientation session.",
1033
+ "onboarding orientation-attendance": "Record a family's orientation attendance.",
1034
+ "onboarding meeting-reschedule": "Reschedule an onboarding meeting.",
1035
+ "onboarding meeting-cancel": "Cancel an onboarding meeting; --message is emailed to the family.",
1036
+ "onboarding set-intake": "Write intake-session data (JSON, CAS-protected).",
1037
+ "onboarding extract": "Extract intake data from a transcript (LLM, ~30s).",
1038
+ "onboarding mark-reviewed": "Mark an intake session reviewed.",
1039
+ "onboarding pairing-code": "Mint a device pairing code for a kid.",
1040
+ "school list": "List partner schools/institutions.",
1041
+ "school families": "List a school's families.",
1042
+ "school family-search": "Search a school's families.",
1043
+ "school convert": "Convert a family to a school's membership.",
1044
+ "school revert": "Revert a family's school conversion.",
1045
+ "school start-memberships": "Start school memberships for kids.",
1046
+ "school resolve-payment": "Waive or cancel a school payment.",
1047
+ "school close-reconciliation": "Close a school payment reconciliation.",
1048
+ "school codes list": "List a school's invite codes.",
1049
+ "school codes get": "Read one school invite code.",
1050
+ "school codes create": "Create school invite codes.",
1051
+ "school codes set-kids": "Set a code's preconfigured kid roster.",
1052
+ "school codes replace": "Replace a school invite with new contents.",
1053
+ "school codes resend": "Re-send a school invite.",
1054
+ "school codes revoke": "Revoke a school invite code.",
1055
+ "school create": "Create a school (credit grant spends real money).",
1056
+ "school update": "Update a school (money levers are exact-ADMIN).",
1057
+ "school representatives list": "List a school's representatives.",
1058
+ "school representatives search": "Find users to make school representatives.",
1059
+ "school representatives add": "Make a user a school representative.",
1060
+ "school representatives remove": "Remove a school representative.",
1061
+ "school credit-transactions": "List a school's credit transactions.",
1062
+ "school kid-slots": "Override a kid's school slot counts.",
1063
+ "school partner-family": "Attach or detach a family to a PARTNER program.",
1064
+ "school logo-upload": "Upload a school logo image.",
1065
+ "village models list": "List Village voxel models.",
1066
+ "village models upload": "Upload a .glb model to the Village.",
1067
+ "village models publish": "Publish a Village model to the store library.",
1068
+ "village models archive": "Archive a Village model.",
1069
+ "village models place": "Place a model in a Village world.",
1070
+ "village models move": "Move a placed Village model.",
1071
+ "village models remove": "Remove a placed Village model.",
1072
+ "village render": "Render a top-down view of a Village region.",
1073
+ "village library search": "Search the Village model library.",
1074
+ "village library get": "Read one Village library model.",
1075
+ "village objects list": "List objects in a Village region.",
1076
+ "village objects get": "Read one Village object.",
1077
+ "village build cmd '<command-json>'": "Run one Village build command (inline JSON).",
1078
+ "village build cmd": "Run one Village build command.",
1079
+ "village worlds export": "Export a Village world bundle.",
1080
+ "village worlds import": "Import a Village world bundle.",
1081
+ "village worlds promote": "Promote a mirror/archive world to live.",
1082
+ "village events": "List event templates and their Village rooms.",
1083
+ "village link-event": "Link (or unlink) an event template to a Village room.",
1084
+ "store-items list": "List Village store items.",
1085
+ "store-items set-status": "Change a Village store item's status.",
1086
+ "db query": "Run a read-only SQL query against the API's database.",
1087
+ "db access list": "List users with db query access.",
1088
+ "db access grant": "Grant a user db query access.",
1089
+ "db access revoke": "Revoke a user's db query access.",
1090
+ "content-library search": "Search the curated content-library gems.",
1091
+ "content-library status": "Show a gem's admission status.",
1092
+ "content-library set-stage": "Move gems to a review/polishing/live/archived stage.",
1093
+ "content-library submit": "Submit URLs as content-library gems.",
1094
+ "skills guardian list": "List authoring skills for guardians/guides.",
1095
+ "skills guardian get": "Read an authoring skill (load before authoring).",
1096
+ "skills admin list": "List admin-only tutor skills.",
1097
+ "skills admin get": "Read an admin-only tutor skill.",
1098
+ "goal-templates list": "List goal templates you can see.",
1099
+ "goal-templates get": "Read a goal template (or just its spec).",
1100
+ "goal-templates policy": "Read a template's live goal policy.",
1101
+ "goal-templates set-policy": "Set a template's goal policy recipe.",
1102
+ "goal-templates migrate-policy": "Migrate students' goals to the template policy.",
1103
+ "goal-templates student-policy": "Edit one student's goal policy.",
1104
+ "goal-templates retire-assignments": "Retire a goal's open assignments.",
1105
+ "goal-templates curriculum backlog": "Show goals' curriculum backlog.",
1106
+ "goal-templates curriculum preview": "Preview a curriculum version upgrade.",
1107
+ "goal-templates curriculum validate-resolutions": "Validate curriculum-upgrade conflict resolutions.",
1108
+ "goal-templates curriculum apply": "Apply a curriculum version to goals.",
1109
+ "goal-templates curriculum reverse": "Reverse a curriculum upgrade on goals.",
1110
+ "goal-templates curriculum status": "Check a curriculum job's status.",
1111
+ "goal-templates curriculum retry": "Retry a failed curriculum job.",
1112
+ "goal-templates versions": "List a template's version history.",
1113
+ "goal-templates validate-spec": "Validate a template file (no write).",
1114
+ "goal-templates create": "Create a goal template from a file.",
1115
+ "goal-templates patch-spec": "Patch a template's setup-workflow spec (own PRIVATE ones for guardians).",
1116
+ "goal-templates set-metadata": "Edit a template's title, art, tags, visibility (own PRIVATE ones for guardians).",
1117
+ "goal-templates delete": "Delete a goal template (own PRIVATE ones for guardians).",
1118
+ "goal-templates generate-image": "Generate a template's cover art.",
1119
+ "goal-templates snapshot-files": "List or read a template's snapshot files.",
1120
+ "goal-templates capture-snapshot": "Capture a goal/draft/checkout into a template snapshot.",
1121
+ "goal-templates answers-template": "Print a fillable answers file for a template's wizard.",
1122
+ "goal-templates apply": "Apply a template for a student from answers.",
1123
+ "goal-templates apply-starter": "Apply a starter template for a kid.",
1124
+ "goals list": "List a kid's goals.",
1125
+ "goals create": "Create a goal (or materialize a draft checkout).",
1126
+ "goals edit": "Patch a goal's fields.",
1127
+ "goals delete": "Delete a goal (soft).",
1128
+ "goals restore": "Restore a deleted goal.",
1129
+ "goals complete": "Mark a goal complete.",
1130
+ "goals undo-completion": "Reopen a completed goal.",
1131
+ "goals archive": "Archive a goal.",
1132
+ "goals unarchive": "Unarchive a goal.",
1133
+ "goals move-module": "Reorder a module in a goal's queue.",
1134
+ "goals launch-todo": "Create a goal module's todo now.",
1135
+ "goals queue get": "Read a goal's module queue.",
1136
+ "goals queue set": "Replace a goal's module queue from JSON.",
1137
+ "todos create": "Create a todo for a kid.",
1138
+ "todos edit": "Patch a todo's fields.",
1139
+ "todos complete": "Complete a todo with XP.",
1140
+ "todos delete": "Delete a todo (soft).",
1141
+ "todos restore": "Restore a deleted todo.",
1142
+ "todos generate-learning-analysis": "Generate a todo's learning analysis (LLM).",
1143
+ "todos generate-applet": "Generate a practice applet todo from a todo.",
1144
+ "memories files": "List a kid's memory files.",
1145
+ "memories read": "Read one kid memory file.",
1146
+ "memories edit": "Edit a kid memory file (publication disabled).",
1147
+ "memories history": "List a memory file's revisions.",
1148
+ "memories revision": "Read one memory file revision.",
1149
+ "memories restore": "Restore a memory file revision (publication disabled).",
1150
+ "memories context": "Read the memory context Rocky sees for a kid.",
1151
+ "memories log": "Read a kid's memory log for a date.",
1152
+ "rocky get": "Read a kid's Rocky personality settings.",
1153
+ "rocky set": "Patch a kid's Rocky personality settings.",
1154
+ "tutor-templates list": "List tutor templates.",
1155
+ "tutor-templates get": "Read one tutor template.",
1156
+ "tutor-templates assign": "Assign a tutor template to a kid.",
1157
+ "tutor-templates unassign": "Unassign a tutor template from a kid.",
1158
+ "tutor-templates create": "Create a tutor template.",
1159
+ "tutor-templates update": "Update a tutor template.",
1160
+ "tutor-templates delete": "Delete a tutor template.",
1161
+ "goals adaptations list": "List a goal's adaptation runs.",
1162
+ "goals adaptations diff": "Diff the files an adaptation run changed.",
1163
+ "goals files list": "List a goal workspace's files.",
1164
+ "goals files read": "Read one goal workspace file.",
1165
+ "goals files init": "Start a new draft goal workspace locally.",
1166
+ "goals files checkout": "Check out a goal or draft workspace locally.",
1167
+ "goals files push": "Push a local goal checkout's commits.",
1168
+ "goals files write": "Write files into a goal or draft workspace.",
1169
+ "goals pdf upload": "Upload a PDF into a goal or draft workspace.",
1170
+ "goals video upload": "Upload an mp4 for goal content.",
1171
+ };
1172
+ /** What each noun covers — one line per noun in the compact root `help`. */
1173
+ export const NOUN_SUMMARIES = {
1174
+ profile: "Saved API/web origin profiles.",
1175
+ jobs: "Local ledger of write operations by operation key.",
1176
+ feedback: "Send or list feedback about this CLI.",
1177
+ auth: "Sign in (browser or headless), session status, sign out.",
1178
+ users: "Accounts: search/get, lock/unlock, disable/restore, phone, tier, school status.",
1179
+ guides: "Create and invite guide accounts.",
1180
+ guardians: "Invite guardians into a family.",
1181
+ students: "Kids: roster, today, schedule, todos, analysis, XP, SMS summaries, notes.",
1182
+ "chat-logs": "Read kids' AI chat conversations.",
1183
+ rooms: "Search and read live-room meeting transcripts.",
1184
+ enrollments: "Cohort enrollments and registrations.",
1185
+ subscriptions: "List a family's Stripe subscriptions.",
1186
+ invoices: "List invoices; refund or credit a line item.",
1187
+ billing: "Pause/resume, extend trial, cancel subscriptions.",
1188
+ apps: "Studio apps: scaffold, validate, publish, assign to kids.",
1189
+ applications: "Enrollment applications: triage, claim, quote, enroll.",
1190
+ quotes: "Tuition quotes: preview, create, send, accept/decline.",
1191
+ cohorts: "Cohorts: search, schedule, parent emails, end, billing, email.",
1192
+ payout: "Guide payouts: payruns, recipients, invoices, line items.",
1193
+ families: "Bulk-set family mailing addresses.",
1194
+ channels: "Community channels and their members.",
1195
+ "tuition-plans": "Compute tuition plan sheets (stores nothing).",
1196
+ feed: "Post messages to users' feeds.",
1197
+ events: "Class events: list, attendance, cancel, reschedule, add.",
1198
+ registrations: "Approve or deny cohort registrations.",
1199
+ request: "Raw read-only GET of any API path.",
1200
+ onboarding: "Family onboarding: status, next action, intake, provisioning, comms.",
1201
+ school: "Partner schools: families, conversion, invite codes, reps, credits.",
1202
+ village: "Recess Village: models, worlds, building, objects, events.",
1203
+ "store-items": "Village store items and their status.",
1204
+ db: "Read-only SQL queries and who may run them.",
1205
+ "content-library": "Curated gem library: search, submit, admission stage.",
1206
+ skills: "Authoring skills to load before writing templates/goals.",
1207
+ "goal-templates": "Goal templates: browse, author, apply, policy, curriculum.",
1208
+ goals: "Kids' goals: create/edit, queue, workspace files, PDFs, videos.",
1209
+ todos: "Kids' todos: create, edit, complete, analysis, applets.",
1210
+ memories: "Kid memory files and the context Rocky sees.",
1211
+ rocky: "A kid's Rocky personality settings.",
1212
+ "tutor-templates": "Tutor templates and their assignment to kids.",
1213
+ mastery: "Mastery graphs and the content linked to them.",
1214
+ };
715
1215
  //# sourceMappingURL=help.js.map