recess-cli 3.29.0 → 3.35.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/README.md +1 -1
- package/dist/args.js +2 -0
- package/dist/cli.js +36 -3
- package/dist/command-schema.js +131 -3
- package/dist/commands/family.js +1278 -16
- package/dist/help.js +169 -12
- package/dist/jobs.js +32 -0
- package/package.json +2 -3
package/dist/help.js
CHANGED
|
@@ -79,7 +79,8 @@ Usage:
|
|
|
79
79
|
recess [--json] students upload-map-scores --student <kid-id>
|
|
80
80
|
--file </path/to/map-report.pdf> [--confirm]
|
|
81
81
|
recess [--json] students issue-email --student <kid-id> [--confirm]
|
|
82
|
-
recess [--json] students goblins --student <kid-id> [--course <slug>] [--
|
|
82
|
+
recess [--json] students goblins --student <kid-id> [--course <slug>] [--search TEXT]
|
|
83
|
+
[--confirm]
|
|
83
84
|
recess [--json] students web-todos --student <kid-id> [--on|--off] [--confirm]
|
|
84
85
|
recess [--json] students flashcards --student <kid-id> [--on|--off] [--confirm]
|
|
85
86
|
recess [--json] students notes add --student <kid-id> --text TEXT [--confirm]
|
|
@@ -203,6 +204,8 @@ Usage:
|
|
|
203
204
|
recess [--json] family set-phone --phone <+E.164> [--confirm]
|
|
204
205
|
recess [--json] family set-timezone --timezone <IANA-zone> [--confirm]
|
|
205
206
|
recess [--json] family guardians
|
|
207
|
+
recess [--json] family changes [--student <kid>]
|
|
208
|
+
recess [--json] family undo [--change <change-id>] [--confirm]
|
|
206
209
|
recess [--json] family school-classes
|
|
207
210
|
recess [--json] family school-class-options --student <kid>
|
|
208
211
|
recess [--json] family drop-class --student <kid> --cohort <cohort-id> [--confirm]
|
|
@@ -210,6 +213,28 @@ Usage:
|
|
|
210
213
|
recess [--json] family swap-class --student <kid> --from <cohort-id>
|
|
211
214
|
--to <cohort-id-or-none> [--confirm]
|
|
212
215
|
recess [--json] family register-class --student <kid> --cohort <cohort-id> [--confirm]
|
|
216
|
+
recess [--json] family remind --at "YYYY-MM-DD HH:mm" --body TEXT [--student <kid>] [--confirm]
|
|
217
|
+
recess [--json] family reminders
|
|
218
|
+
recess [--json] family cancel-reminder --reminder <reminder-id> [--confirm]
|
|
219
|
+
recess [--json] family config
|
|
220
|
+
recess [--json] family set --path <path> --value <value> [--confirm]
|
|
221
|
+
recess [--json] family feedback --kind wrong|too-much|wanted|loved|cant-do|other --quote TEXT
|
|
222
|
+
[--about TEXT] [--student <kid>] [--confirm]
|
|
223
|
+
recess [--json] family pause --student <kid> --weeks N [--enrollment <enrollment-id>] [--confirm]
|
|
224
|
+
recess [--json] family add-guardian --first-name TEXT [--last-name TEXT] --email EMAIL [--confirm]
|
|
225
|
+
recess [--json] family billing
|
|
226
|
+
recess [--json] family billing-link
|
|
227
|
+
recess [--json] family calendar
|
|
228
|
+
recess [--json] family login-link [--confirm]
|
|
229
|
+
recess [--json] family context [--student <kid>]
|
|
230
|
+
recess [--json] family memory [--query TEXT] [--date YYYY-MM-DD]
|
|
231
|
+
recess [--json] family memory save --text TEXT [--in journal|family|me] [--confirm]
|
|
232
|
+
recess [--json] family memory rewrite --in family|me --text TEXT [--confirm]
|
|
233
|
+
recess [--json] family memory forget --in journal|family|me --line TEXT
|
|
234
|
+
[--date YYYY-MM-DD] [--confirm]
|
|
235
|
+
recess [--json] family message-guide --text TEXT [--student <kid>] [--confirm]
|
|
236
|
+
recess [--json] family report-bug --text TEXT [--summary TEXT] [--student <kid>]
|
|
237
|
+
[--todo <todo-id>] [--confirm]
|
|
213
238
|
recess [--json] kid today --student <kid> [--date YYYY-MM-DD]
|
|
214
239
|
recess [--json] kid goals --student <kid>
|
|
215
240
|
recess [--json] kid xp --student <kid> [--range week|month|quarter|year]
|
|
@@ -234,7 +259,8 @@ Usage:
|
|
|
234
259
|
recess [--json] kid edit-login --student <kid> --login <login-id> [--platform TEXT]
|
|
235
260
|
[--url <site-url>] [--username TEXT] [--password TEXT] [--notes TEXT] [--confirm]
|
|
236
261
|
recess [--json] kid remove-login --student <kid> --login <login-id> [--confirm]
|
|
237
|
-
recess [--json] kid excuse --student <kid> --event <event-id> [--note TEXT] [--confirm]
|
|
262
|
+
recess [--json] kid excuse --student <kid> --event <event-id> [--note TEXT] [--weekly] [--confirm]
|
|
263
|
+
recess [--json] kid unexcuse-weekly --student <kid> --event <event-id> [--confirm]
|
|
238
264
|
recess [--json] kid cowork --student <kid>
|
|
239
265
|
recess [--json] kid switch-cowork --student <kid> --to <cohort-id> [--confirm]
|
|
240
266
|
recess [--json] kid friends --student <kid>
|
|
@@ -246,11 +272,63 @@ Usage:
|
|
|
246
272
|
recess [--json] kid goal-note --student <kid> --goal <goal-id>
|
|
247
273
|
recess [--json] kid set-goal-note --student <kid> --goal <goal-id>
|
|
248
274
|
(--note TEXT | --clear) [--confirm]
|
|
249
|
-
recess [--json] kid add-todo --student <kid> --title TEXT [--due-date YYYY-MM-DD]
|
|
275
|
+
recess [--json] kid add-todo --student <kid> --title TEXT [--due-date YYYY-MM-DD (defaults to today)]
|
|
250
276
|
[--url URL] [--minutes N] [--confirm]
|
|
251
277
|
recess [--json] kid todo --student <kid> --todo <todo-id>
|
|
252
278
|
recess [--json] kid move-todo --student <kid> --todo <todo-id> --due-date YYYY-MM-DD [--confirm]
|
|
253
279
|
recess [--json] kid end-session --student <kid> --todo <todo-id> [--confirm]
|
|
280
|
+
recess [--json] kid remove-todo --student <kid> --todo <todo-id> [--allow-started] [--confirm]
|
|
281
|
+
recess [--json] kid edit-todo --student <kid> --todo <todo-id> [--title TEXT] [--minutes N]
|
|
282
|
+
[--url URL] [--confirm]
|
|
283
|
+
recess [--json] kid join-challenge --student <kid> --challenge <template-id> [--answers JSON]
|
|
284
|
+
[--confirm]
|
|
285
|
+
recess [--json] kid leave-challenge --student <kid> --goal <goal-id> [--confirm]
|
|
286
|
+
recess [--json] kid set-goal-games --student <kid> --goal <goal-id> --value on|off [--confirm]
|
|
287
|
+
recess [--json] kid set-goal-required --student <kid> --goal <goal-id> --value on|off [--confirm]
|
|
288
|
+
recess [--json] kid set-goal-days --student <kid> --goal <goal-id>
|
|
289
|
+
--days <"Tue, Thu"|Mon-Fri|weekdays|daily> [--confirm]
|
|
290
|
+
recess [--json] kid help --student <kid> [--date YYYY-MM-DD]
|
|
291
|
+
recess [--json] kid help-done --student <kid> --item <help-item-id> [--date YYYY-MM-DD] [--confirm]
|
|
292
|
+
recess [--json] kid excuse-days --student <kid> --from YYYY-MM-DD [--to YYYY-MM-DD]
|
|
293
|
+
--reason SICK|VACATION|PAUSE|OTHER [--note TEXT] [--confirm]
|
|
294
|
+
recess [--json] kid excused-days --student <kid> [--from YYYY-MM-DD] [--to YYYY-MM-DD]
|
|
295
|
+
recess [--json] kid unexcuse-days --student <kid> --from YYYY-MM-DD [--to YYYY-MM-DD] [--confirm]
|
|
296
|
+
recess [--json] kid moments --student <kid> [--since YYYY-MM-DD]
|
|
297
|
+
recess [--json] kid config --student <kid>
|
|
298
|
+
recess [--json] kid set --student <kid> --path <path> --value <value> [--confirm]
|
|
299
|
+
recess [--json] kid repeat-todo --student <kid> --title TEXT --days <weekdays|daily|Mon,Wed,Fri>
|
|
300
|
+
[--weeks N] [--start YYYY-MM-DD] [--minutes N] [--url URL] [--confirm]
|
|
301
|
+
recess [--json] kid complete-challenge --student <kid> --goal <goal-id> [--confirm]
|
|
302
|
+
recess [--json] kid set-todo-reward --student <kid> --todo <todo-id> [--xp N] [--coins N]
|
|
303
|
+
--reason TEXT [--confirm]
|
|
304
|
+
recess [--json] kid progress --student <kid>
|
|
305
|
+
recess [--json] kid schedule --student <kid> [--days 1-31]
|
|
306
|
+
recess [--json] kid attendance --student <kid> [--days 1-60]
|
|
307
|
+
recess [--json] kid browse-challenges --student <kid> [--query TEXT]
|
|
308
|
+
recess [--json] kid sign-in-code --student <kid> [--confirm]
|
|
309
|
+
recess [--json] kid todos --student <kid> [--date YYYY-MM-DD] [--from YYYY-MM-DD]
|
|
310
|
+
[--to YYYY-MM-DD] [--completed-since YYYY-MM-DD] [--status TEXT] [--subject TEXT]
|
|
311
|
+
[--search TEXT] [--goal <goal-id>] [--limit 1-100]
|
|
312
|
+
recess [--json] kid goal --student <kid> --goal <goal-id>
|
|
313
|
+
recess [--json] kid conversations --student <kid> [--query TEXT] [--from YYYY-MM-DD]
|
|
314
|
+
[--to YYYY-MM-DD] [--limit 1-10]
|
|
315
|
+
recess [--json] kid social --student <kid> [--view overview|friends|activity]
|
|
316
|
+
[--section TEXT] [--days 1-90]
|
|
317
|
+
recess [--json] kid enrollments --student <kid>
|
|
318
|
+
recess [--json] kid math-progress --student <kid> [--view overview|activity]
|
|
319
|
+
[--since YYYY-MM-DD]
|
|
320
|
+
recess [--json] kid memory ls|cat|grep --student <kid> [--path TEXT] [--pattern TEXT]
|
|
321
|
+
recess [--json] kid observe --student <kid> --note TEXT [--confirm]
|
|
322
|
+
recess [--json] kid send-note --student <kid> --note TEXT [--confirm]
|
|
323
|
+
recess [--json] me today [--date YYYY-MM-DD]
|
|
324
|
+
recess [--json] me goals
|
|
325
|
+
recess [--json] me add-todo --title TEXT [--due-date YYYY-MM-DD] [--minutes N] [--url URL] [--confirm]
|
|
326
|
+
recess [--json] me remove-todo --todo <todo-id> [--confirm]
|
|
327
|
+
recess [--json] me repeat-todo --title TEXT --days <weekdays|daily|Mon,Wed,Fri>
|
|
328
|
+
[--weeks N] [--start YYYY-MM-DD] [--minutes N] [--url URL] [--confirm]
|
|
329
|
+
recess [--json] me browse-challenges [--query TEXT]
|
|
330
|
+
recess [--json] me join-challenge --challenge <template-id> [--answers JSON] [--confirm]
|
|
331
|
+
recess [--json] me leave-challenge --goal <goal-id> [--confirm]
|
|
254
332
|
recess [--json] channels list [<query>...] [--type <channel-type>] [--audience KID|PARENT]
|
|
255
333
|
[--status ACTIVE|HIDDEN|ARCHIVED] [--limit 1..200]
|
|
256
334
|
recess [--json] channels create --name TEXT [--type <channel-type>]
|
|
@@ -814,7 +892,11 @@ usa-algebra-2 or pre-calculus; without it the kid's profile grade picks one. A
|
|
|
814
892
|
new kid takes a Goblins seat and keeps it. status eligible means a todo whose
|
|
815
893
|
url is https://app.goblins.com/?skill=<topic> signs them straight into problems
|
|
816
894
|
on that topic; unlicensed means no seat is free yet (rerun later). Never paste a
|
|
817
|
-
/handoff/ link into a todo: it works once and expires.
|
|
895
|
+
/handoff/ link into a todo: it works once and expires. --search TEXT only reads:
|
|
896
|
+
it lists Goblins problems (id and text) for a topic. To hand-pick a ramp, add
|
|
897
|
+
&problems=<id>,<id>,... to the todo url (todos create --url) and the kid gets
|
|
898
|
+
exactly those problems, in that order, e.g.
|
|
899
|
+
https://app.goblins.com/?skill=quadratic%20formula&problems=25867,25857,26068
|
|
818
900
|
|
|
819
901
|
Onboarding notes: "status" and "intake-session" are reads — "intake-session"
|
|
820
902
|
looks up the current IN_PROGRESS session without creating one (prints a "none
|
|
@@ -860,17 +942,28 @@ Family dashboard notes: "family" is a guardian's own parent dashboard: kids,
|
|
|
860
942
|
today, the family schedule, tutor, account and reminder settings, guardians, and
|
|
861
943
|
school classes (drop/restore/swap/register). --student takes one of your kids'
|
|
862
944
|
ids, full name, or a unique first name; ambiguous or unknown names list your
|
|
863
|
-
kids.
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
945
|
+
kids. Undoable writes apply at once (undo: family undo, or family undo
|
|
946
|
+
--change ID for an older one); the rest preview first, then need --confirm
|
|
947
|
+
after a human approves; messages to a person (family message-guide, kid
|
|
948
|
+
send-note) always do. "me" is your own to-dos and challenges, only when you
|
|
949
|
+
mean yourself. Dashboard-only, never
|
|
950
|
+
commands: removing a kid or a co-guardian, password/PIN, payment cards,
|
|
951
|
+
membership changes (pausing a weekly class is family pause), profile photo
|
|
952
|
+
and screen time. Send the guardian to https://recess.gg/settings (account, security,
|
|
867
953
|
guardians) or https://recess.gg/family?tab=billing (billing).
|
|
868
954
|
|
|
869
955
|
Kid dashboard notes: "kid" reads and manages one of your kids (--student takes
|
|
870
956
|
an id, full name, or unique first name): today, goals, XP, MAP scores, classes,
|
|
871
957
|
profile, the texts you get about them, live rooms, feed lock, saved site logins,
|
|
872
958
|
excusing an absence, the daily coworking pod, friends' parents, and pairing a
|
|
873
|
-
new device.
|
|
959
|
+
new device. Plan changes apply at once with no confirm step and are logged
|
|
960
|
+
(undo: family undo, or family undo --change ID): excuse, unexcuse-weekly,
|
|
961
|
+
goal-schedule, pause-goal, resume-goal, set-goal-note, add-todo, move-todo,
|
|
962
|
+
remove-todo, edit-todo, repeat-todo, join-challenge, set-goal-games,
|
|
963
|
+
set-goal-required, help-done, excuse-days, unexcuse-days, and "set" fields
|
|
964
|
+
that apply at once. --confirm on them changes nothing: a rerun with it returns
|
|
965
|
+
the first result (alreadyApplied) instead of applying twice. Every other write
|
|
966
|
+
previews first, then needs --confirm. Passwords are
|
|
874
967
|
never echoed in previews (redacted plus a sha256 prefix); "kid reveal-login" is
|
|
875
968
|
an audited read. --interests replaces the whole list. The daily summary is opt-in
|
|
876
969
|
per kid and shared by every guardian: "kid set-texts --summary true|false" turns
|
|
@@ -886,7 +979,7 @@ judged routine. Neither caps texts at one a day; the daily todo nudge and
|
|
|
886
979
|
recaps ignore it. --enabled false is the only way to stop every text about a
|
|
887
980
|
kid. Plan controls (any guardian): a goal's cadence ("goal-schedule": daily,
|
|
888
981
|
weekly, Mon,Wed,Fri or 3x/week), pausing/resuming a goal, the goal's note
|
|
889
|
-
("set-goal-note"), one-off todos ("add-todo"; no bonus/optional kind exists),
|
|
982
|
+
("set-goal-note"), one-off todos ("add-todo"; due today in the kid's timezone unless --due-date; no bonus/optional kind exists),
|
|
890
983
|
moving a not-started todo ("move-todo"), and ending a stuck session so started
|
|
891
984
|
work can be removed ("end-session"; never completes it or awards XP). The goal note
|
|
892
985
|
is how a parent changes how Rocky behaves on that goal ("ask fewer follow-ups",
|
|
@@ -1245,6 +1338,27 @@ export const COMMAND_SUMMARIES = {
|
|
|
1245
1338
|
"family set-phone": "Change your own phone number.",
|
|
1246
1339
|
"family set-timezone": "Set the whole family's timezone.",
|
|
1247
1340
|
"family guardians": "List the guardians in your family.",
|
|
1341
|
+
"family changes": "Recent changes for your family (anyone, any channel), with undo ids.",
|
|
1342
|
+
"family undo": "Undo one change from family changes, or your latest (at once).",
|
|
1343
|
+
"family billing": "Subscriptions, next charges, failed payments, plans, what can pause.",
|
|
1344
|
+
"family billing-link": "The billing page link (cards, plan, receipts).",
|
|
1345
|
+
"family calendar": "School-wide days off ahead this school year.",
|
|
1346
|
+
"family login-link": "Email yourself a fresh sign-in link and code (at once; not a change).",
|
|
1347
|
+
"family context": "Who's on the account: family, each kid's tutor and guide, school tier.",
|
|
1348
|
+
"family memory": "What Rocky remembers about the family: family, yours, recent journal, --query.",
|
|
1349
|
+
"family memory save": "Save one line to Rocky's family notes, with your name (at once).",
|
|
1350
|
+
"family memory rewrite": "Replace family.md or your own notes whole, tidied (at once).",
|
|
1351
|
+
"family memory forget": "Forget one exact line of the family notes (at once).",
|
|
1352
|
+
"family message-guide": "Message your kid's guide (Slack + the app chat); the person for anything.",
|
|
1353
|
+
"family report-bug": "Report something broken in Recess to the team (at once; not a change).",
|
|
1354
|
+
"family remind": "Have Rocky text you a reminder (applies at once).",
|
|
1355
|
+
"family reminders": "Your upcoming text-me reminders.",
|
|
1356
|
+
"family cancel-reminder": "Cancel an upcoming reminder (applies at once).",
|
|
1357
|
+
"family config": "The family's settings, one line each, with paths.",
|
|
1358
|
+
"family set": "Change one family setting by path (at once, or confirm when marked).",
|
|
1359
|
+
"family feedback": "Pass on what you think of Rocky's texts or abilities (at once; not a change).",
|
|
1360
|
+
"family pause": "Pause a kid's weekly class billing 1-6 weeks from Sunday (family undo resumes).",
|
|
1361
|
+
"family add-guardian": "Add a co-guardian with full parent access; they get an invite email.",
|
|
1248
1362
|
"family school-classes": "Your kids' school classes, slots, queued switches.",
|
|
1249
1363
|
"family school-class-options": "Classes a kid can switch to or join.",
|
|
1250
1364
|
"family drop-class": "Drop a kid's school class (at period end).",
|
|
@@ -1268,7 +1382,8 @@ export const COMMAND_SUMMARIES = {
|
|
|
1268
1382
|
"kid add-login": "Save a site login for a kid.",
|
|
1269
1383
|
"kid edit-login": "Edit a kid's saved site login.",
|
|
1270
1384
|
"kid remove-login": "Delete a kid's saved site login.",
|
|
1271
|
-
"kid excuse": "Excuse a
|
|
1385
|
+
"kid excuse": "Excuse a class session, upcoming or up to 14 days back; --weekly: that weekday every week (at once).",
|
|
1386
|
+
"kid unexcuse-weekly": "Stop a standing weekly class excuse for that class's weekday (at once).",
|
|
1272
1387
|
"kid cowork": "A kid's daily coworking pod and the options.",
|
|
1273
1388
|
"kid switch-cowork": "Move a kid to another coworking pod.",
|
|
1274
1389
|
"kid friends": "A kid's friends and their parents.",
|
|
@@ -1279,10 +1394,51 @@ export const COMMAND_SUMMARIES = {
|
|
|
1279
1394
|
"kid resume-goal": "Resume a paused goal.",
|
|
1280
1395
|
"kid goal-note": "Read the note that steers how Rocky works a goal.",
|
|
1281
1396
|
"kid set-goal-note": "Change how Rocky works a goal: replace or clear its note.",
|
|
1282
|
-
"kid add-todo": "Add a one-off todo for a kid.",
|
|
1397
|
+
"kid add-todo": "Add a one-off todo for a kid (due today unless --due-date).",
|
|
1283
1398
|
"kid todo": "One todo: status, due day, live session.",
|
|
1284
1399
|
"kid move-todo": "Move a not-started todo to another day.",
|
|
1285
1400
|
"kid end-session": "End a stuck todo session (no XP, not completed).",
|
|
1401
|
+
"kid remove-todo": "Remove a kid's todo (applies at once; family undo).",
|
|
1402
|
+
"kid edit-todo": "Rename, re-time or re-link a not-started todo (applies at once).",
|
|
1403
|
+
"kid join-challenge": "Join a kid to a challenge from the library (applies at once).",
|
|
1404
|
+
"kid leave-challenge": "Take a kid off a challenge; progress is kept.",
|
|
1405
|
+
"kid set-goal-games": "Practice games on/off after one challenge's lessons (at once).",
|
|
1406
|
+
"kid set-goal-required": "Whether a kid may drop one challenge themselves (at once).",
|
|
1407
|
+
"kid help": "The day's ways to help (from the daily summary).",
|
|
1408
|
+
"kid help-done": "Mark a help item done; the kid's Rocky hears (at once).",
|
|
1409
|
+
"kid excuse-days": "Give a kid days off; their todos move (at once).",
|
|
1410
|
+
"kid excused-days": "A kid's days off (sick, vacation, pause).",
|
|
1411
|
+
"kid unexcuse-days": "Make days off regular school days again (at once).",
|
|
1412
|
+
"kid moments": "A kid's recent moments (clips) with share links.",
|
|
1413
|
+
"kid config": "Every setting for a kid, one line each, with paths.",
|
|
1414
|
+
"kid set": "Change one kid setting by path (at once, or confirm when marked).",
|
|
1415
|
+
"kid repeat-todo": "Put a to-do on a kid's list on chosen weekdays for 1-4 weeks (at once).",
|
|
1416
|
+
"kid complete-challenge": "Mark a kid's challenge finished: no coins or badge (family undo reopens).",
|
|
1417
|
+
"kid set-todo-reward": "Set a to-do's XP and/or coins to new totals (family undo reverses).",
|
|
1418
|
+
"kid progress": "A kid's on-track progress per subject from the skill map.",
|
|
1419
|
+
"kid schedule": "A kid's upcoming class sessions in your timezone, with event ids and plan.",
|
|
1420
|
+
"kid attendance": "A kid's recent class sessions: attended, missed, excused.",
|
|
1421
|
+
"kid browse-challenges": "Library challenges a kid can join here (picked for them, or --query).",
|
|
1422
|
+
"kid sign-in-code": "The app link and a one-time sign-in code for a kid (at once; not a change).",
|
|
1423
|
+
"kid todos": "A kid's to-dos over any window, with status, XP and how each went.",
|
|
1424
|
+
"kid goal": "One of a kid's challenges in full.",
|
|
1425
|
+
"kid conversations": "Search or browse a kid's chats with Rocky (short excerpts).",
|
|
1426
|
+
"kid social": "A kid's friends, events, comments, chat counts, safety (view only).",
|
|
1427
|
+
"kid enrollments": "A kid's active enrollments: plan, price, pauses.",
|
|
1428
|
+
"kid math-progress": "A kid's Math Academy course, progress and activity.",
|
|
1429
|
+
"kid memory ls": "List the files in what Rocky knows about a kid.",
|
|
1430
|
+
"kid memory cat": "Read one file of what Rocky knows about a kid.",
|
|
1431
|
+
"kid memory grep": "Find lines in what Rocky knows about a kid.",
|
|
1432
|
+
"kid observe": "Tell a kid's Rocky something about them (at once; logged, no undo).",
|
|
1433
|
+
"kid send-note": "A note Rocky passes the kid next session, in his words (needs YES).",
|
|
1434
|
+
"me today": "Your OWN to-dos for a day (only about your own learning).",
|
|
1435
|
+
"me goals": "Your own challenges.",
|
|
1436
|
+
"me add-todo": "Add a to-do to your own list (at once; family undo).",
|
|
1437
|
+
"me remove-todo": "Remove a to-do from your own list (at once; family undo).",
|
|
1438
|
+
"me repeat-todo": "Put a to-do on your own list on chosen weekdays for 1-4 weeks (at once).",
|
|
1439
|
+
"me browse-challenges": "Library challenges you can join yourself.",
|
|
1440
|
+
"me join-challenge": "Join a challenge yourself (at once; family undo).",
|
|
1441
|
+
"me leave-challenge": "Leave one of your own challenges; progress is kept.",
|
|
1286
1442
|
"channels list": "List community channels with filters.",
|
|
1287
1443
|
"channels create": "Create a community channel.",
|
|
1288
1444
|
"channels set-image": "Set or clear a channel's image.",
|
|
@@ -1560,6 +1716,7 @@ export const NOUN_SUMMARIES = {
|
|
|
1560
1716
|
families: "Bulk-set family mailing addresses.",
|
|
1561
1717
|
family: "Your parent dashboard: kids, schedule, account, school classes.",
|
|
1562
1718
|
kid: "One of your kids: today, goals, profile, texts, logins, pods.",
|
|
1719
|
+
me: "Your own to-dos and challenges (a parent learning too).",
|
|
1563
1720
|
channels: "Community channels and their members.",
|
|
1564
1721
|
"tuition-plans": "Compute tuition plan sheets (stores nothing).",
|
|
1565
1722
|
placement: "Give placement quests, one kid's results, results vs MAP, question bank, mastery sync.",
|
package/dist/jobs.js
CHANGED
|
@@ -59,6 +59,38 @@ export async function listJobs(limit = 20) {
|
|
|
59
59
|
total: jobs.length,
|
|
60
60
|
};
|
|
61
61
|
}
|
|
62
|
+
/** Change-log ids a write's result reports (`change` or `changes`). */
|
|
63
|
+
function resultChangeIds(result) {
|
|
64
|
+
const r = result;
|
|
65
|
+
const changes = [r?.change, ...(Array.isArray(r?.changes) ? r.changes : [])];
|
|
66
|
+
return changes.flatMap((c) => {
|
|
67
|
+
const id = c?.id;
|
|
68
|
+
return typeof id === "string" ? [id] : [];
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The newest completed immediate write of this intent since `sinceMs`, unless
|
|
73
|
+
* a later `family undo` undid it (then it may apply again).
|
|
74
|
+
*/
|
|
75
|
+
export async function findCompletedIntent(intent, sinceMs) {
|
|
76
|
+
const events = await readEvents();
|
|
77
|
+
const undone = new Set();
|
|
78
|
+
for (let i = events.length - 1; i >= 0; i--) {
|
|
79
|
+
const event = events[i];
|
|
80
|
+
if (Date.parse(event.timestamp) < sinceMs)
|
|
81
|
+
break;
|
|
82
|
+
if (event.status !== "completed")
|
|
83
|
+
continue;
|
|
84
|
+
if (event.undoneChangeId)
|
|
85
|
+
undone.add(event.undoneChangeId);
|
|
86
|
+
if (event.intent === intent) {
|
|
87
|
+
return resultChangeIds(event.result).some((id) => undone.has(id))
|
|
88
|
+
? null
|
|
89
|
+
: event;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return null;
|
|
93
|
+
}
|
|
62
94
|
export async function getJob(jobId) {
|
|
63
95
|
const history = (await readEvents()).filter((event) => event.jobId === jobId);
|
|
64
96
|
return { job: foldJobs(history)[0] ?? null, history };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "recess-cli",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.35.0",
|
|
4
4
|
"description": "Safe Recess administration and family AI tools from the command line.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"repository": {
|
|
@@ -42,16 +42,15 @@
|
|
|
42
42
|
"@types/react": "^19.2.18",
|
|
43
43
|
"@typescript/native-preview": "7.0.0-dev.20260707.2",
|
|
44
44
|
"esbuild": "^0.28.2",
|
|
45
|
-
"openapi-typescript": "^7.8.0",
|
|
46
45
|
"oxlint": "^1.28.0",
|
|
47
46
|
"oxlint-tsgolint": "^0.6.0",
|
|
48
47
|
"typescript": "^5.9.2",
|
|
49
48
|
"vitest": "^1.6.0",
|
|
49
|
+
"@tryrecess/api-types": "0.0.0",
|
|
50
50
|
"@tryrecess/typescript-config": "0.0.0"
|
|
51
51
|
},
|
|
52
52
|
"scripts": {
|
|
53
53
|
"build": "node node_modules/@tryrecess/typescript-config/bin/tsc-fast.mjs",
|
|
54
|
-
"client:generate": "node scripts/generate-api-types.mjs",
|
|
55
54
|
"typecheck": "node node_modules/@tryrecess/typescript-config/bin/tsc-fast.mjs --noEmit",
|
|
56
55
|
"format": "oxfmt --ignore-path .oxfmtignore --check",
|
|
57
56
|
"format:fix": "oxfmt --ignore-path .oxfmtignore",
|