recess-cli 3.7.0 → 3.9.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/args.js CHANGED
@@ -4,7 +4,12 @@ import { CliError } from "./errors.js";
4
4
  * `flagString` still yields the LAST value, which is why every consumer of a
5
5
  * repeatable flag must use `flagList` instead.
6
6
  */
7
- export const REPEATABLE_FLAGS = new Set(["kid", "unassign"]);
7
+ export const REPEATABLE_FLAGS = new Set([
8
+ "bill-date",
9
+ "kid",
10
+ "note",
11
+ "unassign",
12
+ ]);
8
13
  const BOOLEAN_FLAGS = new Set([
9
14
  "clear",
10
15
  "zero-balance",
package/dist/auth.js CHANGED
@@ -12,7 +12,7 @@ function publicSession(session) {
12
12
  user: session.user,
13
13
  };
14
14
  }
15
- function openBrowser(url) {
15
+ export function openBrowser(url) {
16
16
  // Windows goes through rundll32, not `cmd /c start`: cmd treats `&` (and the
17
17
  // `%`-encoded redirect_uri) as metacharacters and chops the URL at the first
18
18
  // `&`, so the browser only ever received `?client_id=…` and the OAuth page
package/dist/cli.js CHANGED
@@ -16,6 +16,7 @@ import { runDbCommand } from "./commands/db.js";
16
16
  import { runRoomsCommand } from "./commands/rooms.js";
17
17
  import { runFamiliesCommand } from "./commands/families.js";
18
18
  import { runStudentsTextsCommand, runUsersPhoneCommand, } from "./commands/phone-and-texts.js";
19
+ import { runTuitionPlansCommand } from "./commands/tuition-plans.js";
19
20
  import { runMasteryCommand } from "./commands/mastery.js";
20
21
  import { runOnboardingCommand } from "./commands/onboarding.js";
21
22
  import { runScheduleCommand, runMemoryFilesCommand, } from "./commands/safe-staff-operations.js";
@@ -1456,13 +1457,13 @@ function parseGoalTemplateDocument(doc) {
1456
1457
  * author types and what the skill's prose uses; the routes take a UUID only.
1457
1458
  */
1458
1459
  /**
1459
- * `/challenges-v2/{id}/preview` on the web app: the template as the card a
1460
- * kid would see, with no chat around it. Returned by `goal-templates get`
1460
+ * `/challenges-v2/{id}` on the web app: the challenge page, where the
1461
+ * template shows as the card a kid would see. Returned by `goal-templates get`
1461
1462
  * and `create` so an agent can open it, or hand it to the human, right after
1462
1463
  * authoring.
1463
1464
  */
1464
1465
  function goalTemplatePreviewUrl(webOrigin, templateId) {
1465
- return new URL(`/challenges-v2/${encodeURIComponent(templateId)}/preview`, webOrigin).toString();
1466
+ return new URL(`/challenges-v2/${encodeURIComponent(templateId)}`, webOrigin).toString();
1466
1467
  }
1467
1468
  /** Runs the template with Rocky as a kid would (staff only; ephemeral, never touches real todos). */
1468
1469
  function goalTemplatePlayTestUrl(webOrigin, templateId) {
@@ -4014,6 +4015,7 @@ export async function executeRecessCommand(argv, options = {}) {
4014
4015
  tags: document.tags,
4015
4016
  isStarter: document.isStarter ?? false,
4016
4017
  coinAmount: document.coinAmount ?? null,
4018
+ visibility: "PRIVATE",
4017
4019
  },
4018
4020
  details: {
4019
4021
  resolvedSetupHandler: validation.setupHandler,
@@ -4025,7 +4027,9 @@ export async function executeRecessCommand(argv, options = {}) {
4025
4027
  },
4026
4028
  }, async () => {
4027
4029
  const created = unwrap(await api.client.POST("/ai/goal-templates/", {
4028
- body: document,
4030
+ // Agent-authored templates start private; the author publishes
4031
+ // from the challenge page once it plays right.
4032
+ body: { ...document, visibility: "PRIVATE" },
4029
4033
  }));
4030
4034
  return {
4031
4035
  ...created,
@@ -5128,6 +5132,9 @@ export async function executeRecessCommand(argv, options = {}) {
5128
5132
  if (noun === "students" && verb === "texts") {
5129
5133
  return runStudentsTextsCommand({ parsed, api, writeCommand });
5130
5134
  }
5135
+ if (noun === "tuition-plans") {
5136
+ return runTuitionPlansCommand({ parsed, api, writeCommand });
5137
+ }
5131
5138
  if (noun === "students") {
5132
5139
  if (verb === "list") {
5133
5140
  const requestedScope = flagString(parsed, "scope");
@@ -5242,13 +5249,21 @@ export async function executeRecessCommand(argv, options = {}) {
5242
5249
  },
5243
5250
  }));
5244
5251
  }
5245
- throw new CliError("invalid_arguments", "Use students list|today|schedule|todos|analysis|xp-history|upload-map-scores.");
5252
+ if (verb === "issue-email") {
5253
+ const studentId = flagString(parsed, "student", { required: true });
5254
+ return writeCommand(parsed, {
5255
+ action: "issue a receive-only email address to a managed student (no change if one exists)",
5256
+ target: { studentUserId: studentId },
5257
+ request: {},
5258
+ }, async () => unwrap(await api.client.POST("/admin/browser/students/{userId}/issued-email/", { params: { path: { userId: studentId } } })));
5259
+ }
5260
+ throw new CliError("invalid_arguments", "Use students list|today|schedule|todos|analysis|xp-history|upload-map-scores|issue-email.");
5246
5261
  }
5247
5262
  if (noun === "todos") {
5248
5263
  if (verb === "create") {
5249
5264
  const studentId = flagString(parsed, "student", { required: true });
5250
5265
  const title = flagString(parsed, "title", { required: true });
5251
- const estimatedTimeInMins = flagNumber(parsed, "estimated-minutes");
5266
+ const targetDurationInMins = flagNumber(parsed, "target-minutes");
5252
5267
  const body = {
5253
5268
  userId: studentId,
5254
5269
  title,
@@ -5258,7 +5273,7 @@ export async function executeRecessCommand(argv, options = {}) {
5258
5273
  ...(flagString(parsed, "url")
5259
5274
  ? { url: flagString(parsed, "url") }
5260
5275
  : {}),
5261
- ...(estimatedTimeInMins !== undefined ? { estimatedTimeInMins } : {}),
5276
+ ...(targetDurationInMins !== undefined ? { targetDurationInMins } : {}),
5262
5277
  };
5263
5278
  return writeCommand(parsed, {
5264
5279
  action: "create a todo for a managed student",
@@ -5586,8 +5601,8 @@ export async function executeRecessCommand(argv, options = {}) {
5586
5601
  title: template.title,
5587
5602
  cadence: template.cadence,
5588
5603
  consequence: verb === "assign"
5589
- ? "Appends `### <title> — <cadence>` to rocky-v3/plan.md, rebuilds Today, and writes an ACTIVE assignment row."
5590
- : "Deletes that subject block from rocky-v3/plan.md and marks the assignment REMOVED.",
5604
+ ? "Appends `### <title> — <cadence>` to the kid's memory/subjects.md (Rocky live reads it) and writes an ACTIVE assignment row."
5605
+ : "Deletes that subject block from memory/subjects.md and marks the assignment REMOVED.",
5591
5606
  },
5592
5607
  }, async () => verb === "assign"
5593
5608
  ? unwrap(await api.client.POST("/tutor-templates/{slug}/assign", {
@@ -5655,7 +5670,7 @@ export async function executeRecessCommand(argv, options = {}) {
5655
5670
  },
5656
5671
  details: {
5657
5672
  lessonNames: Object.keys(shared.lessons ?? {}),
5658
- renamingNote: "`title` is the `### <heading>` join key in every kid's plan.md — renaming later orphans existing plans.",
5673
+ renamingNote: "`title` is the `### <heading>` join key in every kid's memory/subjects.md — renaming later orphans existing blocks.",
5659
5674
  },
5660
5675
  }, async () => unwrap(await api.client.POST("/tutor-templates/", { body })));
5661
5676
  }
@@ -5674,7 +5689,7 @@ export async function executeRecessCommand(argv, options = {}) {
5674
5689
  },
5675
5690
  details: {
5676
5691
  fields: Object.keys(body),
5677
- renamingNote: "Changing `title` orphans the `### <heading>` in every plan.md already carrying this template.",
5692
+ renamingNote: "Changing `title` orphans the `### <heading>` in every memory/subjects.md already carrying this template.",
5678
5693
  },
5679
5694
  }, async () => unwrap(await api.client.PATCH("/tutor-templates/{slug}", {
5680
5695
  params: { path: { slug } },
@@ -5692,7 +5707,7 @@ export async function executeRecessCommand(argv, options = {}) {
5692
5707
  request: {},
5693
5708
  details: {
5694
5709
  title: template.title,
5695
- consequence: "The row is soft-deleted; subject blocks already written into kids' plan.md stay where they are.",
5710
+ consequence: "The row is soft-deleted; subject blocks already written into kids' memory/subjects.md stay where they are.",
5696
5711
  },
5697
5712
  }, async () => unwrap(await api.client.DELETE("/tutor-templates/{slug}", {
5698
5713
  params: { path: { slug } },
@@ -43,13 +43,15 @@ const BOOLEAN_FLAGS = new Set([
43
43
  "skill-only",
44
44
  "spec-only",
45
45
  "starter-only",
46
+ "state-funding",
47
+ "even-installments",
46
48
  "supersede",
47
49
  "unlink",
48
50
  "visual-only",
49
51
  "whole-family",
50
52
  "wait",
51
53
  ]);
52
- const REPEATABLE_FLAGS = new Set(["kid", "unassign"]);
54
+ const REPEATABLE_FLAGS = new Set(["bill-date", "kid", "note", "unassign"]);
53
55
  const GLOBAL_FLAGS = new Set([
54
56
  "deliver",
55
57
  "help",
@@ -304,6 +306,7 @@ const STAFF_COMMANDS = new Set([
304
306
  "school update",
305
307
  "store-items list",
306
308
  "students upload-map-scores",
309
+ "students issue-email",
307
310
  "students todos",
308
311
  "students analysis",
309
312
  "todos complete",
@@ -97,4 +97,14 @@ export async function readJsonFile(filePath, label) {
97
97
  }
98
98
  return parsed;
99
99
  }
100
+ /** Left-aligned text columns (two-space gutter) for human-mode tables. */
101
+ export function renderColumns(rows) {
102
+ const widths = rows[0].map((_, column) => Math.max(...rows.map((row) => row[column].length)));
103
+ return rows
104
+ .map((row) => row
105
+ .map((cell, column) => column === row.length - 1 ? cell : cell.padEnd(widths[column]))
106
+ .join(" ")
107
+ .trimEnd())
108
+ .join("\n");
109
+ }
100
110
  //# sourceMappingURL=shared.js.map
@@ -0,0 +1,221 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { unwrap } from "../api.js";
4
+ import { flagList, flagString, hasFlag } from "../args.js";
5
+ import { openBrowser } from "../auth.js";
6
+ import { CliError } from "../errors.js";
7
+ import { assertChoice, renderColumns } from "./shared.js";
8
+ const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
9
+ function requiredFlag(parsed, name, pattern) {
10
+ const value = flagString(parsed, name)?.trim();
11
+ if (!value) {
12
+ throw new CliError("invalid_arguments", `Missing required --${name}.`);
13
+ }
14
+ if (pattern && !pattern.test(value)) {
15
+ throw new CliError("invalid_arguments", `--${name} must look like ${name === "state" ? "a two-letter state code" : "YYYY-MM-DD"}.`);
16
+ }
17
+ return value;
18
+ }
19
+ /** A comma-separated subset of friendly names, mapped to the server's values. */
20
+ function csvFlag(parsed, name, values) {
21
+ const raw = flagString(parsed, name)?.trim();
22
+ if (raw === undefined)
23
+ return undefined;
24
+ const picked = raw.split(",").map((v) => v.trim().toLowerCase());
25
+ const bad = picked.filter((v) => !(v in values));
26
+ if (!picked.length || bad.length) {
27
+ throw new CliError("invalid_arguments", `--${name} takes a comma-separated subset of: ${Object.keys(values).join(", ")}.`);
28
+ }
29
+ return [...new Set(picked.map((v) => values[v]))];
30
+ }
31
+ const TERM_FLAGS = {
32
+ "full-year": "INSTRUCTIONAL_180",
33
+ "school-year": "STATE_YEAR_END",
34
+ custom: "CUSTOM",
35
+ };
36
+ const PAYMENT_FLAGS = {
37
+ upfront: "PAY_IN_FULL",
38
+ installments: "INSTALLMENTS",
39
+ };
40
+ /** Dollars, with cents only when there are any (matches the PDF). */
41
+ const dollars = (cents) => `$${(cents / 100).toLocaleString("en-US", {
42
+ minimumFractionDigits: cents % 100 === 0 ? 0 : 2,
43
+ maximumFractionDigits: 2,
44
+ })}`;
45
+ /** The tuition plan as terminal text, in the PDF's order: one block per term. */
46
+ function renderPlan(plan, webUrl, pdfPath) {
47
+ const out = [
48
+ `RECESS ACADEMY ${plan.enrollment.indicative ? "ESTIMATED " : ""}TUITION PLAN (${plan.calendarLabel})`,
49
+ ];
50
+ if (plan.enrollment.disclaimer)
51
+ out.push(`!! ${plan.enrollment.disclaimer}`);
52
+ out.push("", `Tuition options for ${plan.studentName}`, `Prepared for ${plan.parentName} · ${plan.state.name} · ${plan.enrollment.partnerSchool
53
+ ? `Through ${plan.enrollment.partnerSchool.name}`
54
+ : "Direct enrollment"}`, "", plan.introduction);
55
+ for (const o of plan.options) {
56
+ out.push("", `${o.label.toUpperCase()} (${o.startDate} → ${o.endDate}, ${o.instructionalDays} school days)`, ` ${o.description}`, renderColumns(o.paymentPlans.map((p) => [
57
+ ` ${p.label}`,
58
+ dollars(p.totalCents),
59
+ p.summary,
60
+ p.scheduleLine,
61
+ ])));
62
+ }
63
+ if (plan.staffNotes.length) {
64
+ out.push("", "Notes:", ...plan.staffNotes.map((n) => ` ${n}`));
65
+ }
66
+ out.push("", `Optional add-ons: ${plan.addOns
67
+ .map((a) => `${a.label} ${dollars(a.priceCents)} ${a.unit}`)
68
+ .join(" · ")}`, "", ...plan.footnotes.map((n) => ` · ${n}`), ...(plan.agreement
69
+ ? [
70
+ "",
71
+ "ENROLLMENT AGREEMENT (page 2 of the PDF; parent checks one and signs)",
72
+ ...plan.agreement.choices.map((c) => ` [ ] ${c.label}`),
73
+ ...plan.agreement.clauses.map((c, i) => ` ${i + 1}. ${c}`),
74
+ ]
75
+ : []), "", `Web: ${webUrl}`);
76
+ if (pdfPath)
77
+ out.push(`PDF: ${pdfPath}`);
78
+ return out.join("\n");
79
+ }
80
+ export async function runTuitionPlansCommand({ parsed, api, }) {
81
+ const verb = parsed.positionals[1];
82
+ if (verb === "states") {
83
+ return unwrap(await api.client.GET("/admin/tuition-plans/states/"));
84
+ }
85
+ if (verb !== "generate") {
86
+ throw new CliError("invalid_arguments", "Usage: recess tuition-plans generate|states. See `recess help`.");
87
+ }
88
+ const annual = Number(requiredFlag(parsed, "annual").replace(/[$,]/g, ""));
89
+ if (!Number.isFinite(annual) || annual <= 0) {
90
+ throw new CliError("invalid_arguments", "--annual must be a positive dollar amount (net of Recess financial aid).");
91
+ }
92
+ // The server owns the supported-state list; resolve against it so a bad
93
+ // code fails with the valid choices.
94
+ const { states } = unwrap(await api.client.GET("/admin/tuition-plans/states/"));
95
+ const state = assertChoice(requiredFlag(parsed, "state", /^[A-Za-z]{2}$/).toUpperCase(), states.map((s) => s.code), "--state");
96
+ const enrollment = assertChoice(requiredFlag(parsed, "enrollment"), ["direct", "partner-school"], "--enrollment") === "partner-school"
97
+ ? "PARTNER_SCHOOL"
98
+ : "DIRECT";
99
+ const partnerSchool = flagString(parsed, "partner-school")?.trim();
100
+ if (enrollment === "PARTNER_SCHOOL" && !partnerSchool) {
101
+ throw new CliError("invalid_arguments", "--enrollment partner-school needs --partner-school <slug|id> (see `recess users enrollment list-partner-schools`).");
102
+ }
103
+ if (enrollment === "DIRECT" && partnerSchool) {
104
+ throw new CliError("invalid_arguments", "--partner-school applies only with --enrollment partner-school.");
105
+ }
106
+ // Add-on overrides; omitted = the server's school-pricing defaults.
107
+ const addOnFlag = (name, integer) => {
108
+ const raw = flagString(parsed, name)?.trim().replace(/[$,]/g, "");
109
+ if (raw === undefined)
110
+ return undefined;
111
+ const value = Number(raw);
112
+ if (!Number.isFinite(value) ||
113
+ value <= 0 ||
114
+ (integer && !Number.isInteger(value))) {
115
+ throw new CliError("invalid_arguments", `--${name} must be a positive ${integer ? "whole number" : "dollar amount"}.`);
116
+ }
117
+ return value;
118
+ };
119
+ const electivePrice = addOnFlag("elective-price", false);
120
+ const oneOnOnePrice = addOnFlag("one-on-one-price", false);
121
+ const oneOnOneSessions = addOnFlag("one-on-one-sessions", true);
122
+ const addOnQuery = {
123
+ ...(electivePrice !== undefined ? { electivePrice } : {}),
124
+ ...(oneOnOnePrice !== undefined ? { oneOnOnePrice } : {}),
125
+ ...(oneOnOneSessions !== undefined ? { oneOnOneSessions } : {}),
126
+ };
127
+ // Optional: without it the sheet leaves out the student's age.
128
+ const dob = flagString(parsed, "dob")?.trim();
129
+ if (dob && !ISO_DATE.test(dob)) {
130
+ throw new CliError("invalid_arguments", "--dob must look like YYYY-MM-DD.");
131
+ }
132
+ // Omitted = the full matrix (full year + school year [+ custom with --end]) ×
133
+ // (upfront + installments). A full year past July 1 drops out of the
134
+ // default; asking for it explicitly is refused by the server.
135
+ const endDate = flagString(parsed, "end")?.trim();
136
+ if (endDate && !ISO_DATE.test(endDate)) {
137
+ throw new CliError("invalid_arguments", "--end must look like YYYY-MM-DD.");
138
+ }
139
+ const terms = csvFlag(parsed, "terms", TERM_FLAGS);
140
+ if (terms?.includes("CUSTOM") && !endDate) {
141
+ throw new CliError("invalid_arguments", "--terms custom needs --end YYYY-MM-DD.");
142
+ }
143
+ if (endDate && terms && !terms.includes("CUSTOM")) {
144
+ throw new CliError("invalid_arguments", "--end adds the custom term; include custom in --terms.");
145
+ }
146
+ const payments = csvFlag(parsed, "payments", PAYMENT_FLAGS);
147
+ // Staff overrides: notes printed on the sheet, and moved invoice dates.
148
+ const notes = flagList(parsed, "note")
149
+ .map((n) => n.trim())
150
+ .filter(Boolean);
151
+ const billDates = flagList(parsed, "bill-date").map((raw) => {
152
+ const [key, date] = raw.split("=").map((v) => v.trim().toLowerCase());
153
+ if (!key ||
154
+ !date ||
155
+ !/^(upfront|[1-9]\d*)$/.test(key) ||
156
+ !ISO_DATE.test(date)) {
157
+ throw new CliError("invalid_arguments", `--bill-date takes upfront=YYYY-MM-DD or N=YYYY-MM-DD (installment N), got "${raw}".`);
158
+ }
159
+ return `${key}=${date}`;
160
+ });
161
+ const even = hasFlag(parsed, "even-installments");
162
+ const subsetQuery = {
163
+ ...(even ? { evenInstallments: "true" } : {}),
164
+ ...(billDates.length ? { billDates: billDates.join(",") } : {}),
165
+ ...(endDate ? { endDate } : {}),
166
+ ...(terms ? { terms: terms.join(",") } : {}),
167
+ ...(payments ? { payments: payments.join(",") } : {}),
168
+ };
169
+ const query = {
170
+ parentName: requiredFlag(parsed, "parent"),
171
+ studentName: requiredFlag(parsed, "student"),
172
+ ...(dob ? { studentDob: dob } : {}),
173
+ state,
174
+ startDate: requiredFlag(parsed, "start", ISO_DATE),
175
+ annualTuition: annual,
176
+ stateFunding: hasFlag(parsed, "state-funding") ? "true" : "false",
177
+ enrollment,
178
+ ...(partnerSchool ? { partnerSchool } : {}),
179
+ ...addOnQuery,
180
+ ...subsetQuery,
181
+ ...(notes.length ? { notes } : {}),
182
+ };
183
+ const plan = unwrap(await api.client.GET("/admin/tuition-plans/", { params: { query } }));
184
+ const search = new URLSearchParams({
185
+ parentName: query.parentName,
186
+ studentName: query.studentName,
187
+ ...(dob ? { studentDob: dob } : {}),
188
+ state: query.state,
189
+ startDate: query.startDate,
190
+ annualTuition: String(annual),
191
+ ...(query.stateFunding === "true" ? { stateFunding: "true" } : {}),
192
+ enrollment,
193
+ ...(partnerSchool ? { partnerSchool } : {}),
194
+ ...Object.fromEntries(Object.entries(addOnQuery).map(([k, v]) => [k, String(v)])),
195
+ ...subsetQuery,
196
+ });
197
+ for (const note of notes)
198
+ search.append("notes", note);
199
+ const webUrl = new URL(`/admin/tuition-plans?${search}`, api.config.webOrigin).toString();
200
+ let pdfPath;
201
+ const pdfFlag = flagString(parsed, "pdf");
202
+ if (pdfFlag) {
203
+ const pdf = await api.client.GET("/admin/tuition-plans/pdf/", {
204
+ params: { query },
205
+ parseAs: "arrayBuffer",
206
+ });
207
+ const bytes = unwrap(pdf);
208
+ pdfPath = path.resolve(pdfFlag);
209
+ await fs.writeFile(pdfPath, new Uint8Array(bytes));
210
+ }
211
+ if (hasFlag(parsed, "open"))
212
+ openBrowser(webUrl);
213
+ if (!hasFlag(parsed, "json"))
214
+ return { help: renderPlan(plan, webUrl, pdfPath) };
215
+ return {
216
+ webUrl,
217
+ ...(pdfPath ? { pdfPath } : {}),
218
+ plan,
219
+ };
220
+ }
221
+ //# sourceMappingURL=tuition-plans.js.map
@@ -1,6 +1,7 @@
1
1
  import { unwrap } from "../api.js";
2
2
  import { flagString, hasFlag } from "../args.js";
3
3
  import { apiError, CliError } from "../errors.js";
4
+ import { renderColumns } from "./shared.js";
4
5
  const NONE = "—";
5
6
  const WEEKDAYS = ["MO", "TU", "WE", "TH", "FR", "SA", "SU"];
6
7
  async function fetchTemplatesAndRooms(ctx) {
@@ -29,15 +30,6 @@ function templateDays(template) {
29
30
  .filter((day) => WEEKDAYS.includes(day));
30
31
  return days.length > 0 ? days : null;
31
32
  }
32
- function renderColumns(rows) {
33
- const widths = rows[0].map((_, column) => Math.max(...rows.map((row) => row[column].length)));
34
- return rows
35
- .map((row) => row
36
- .map((cell, column) => column === row.length - 1 ? cell : cell.padEnd(widths[column]))
37
- .join(" ")
38
- .trimEnd())
39
- .join("\n");
40
- }
41
33
  /** `village events` — every editable Recess Hour template and its Town Center zone. */
42
34
  async function listEvents(ctx) {
43
35
  const { templates, rooms } = await fetchTemplatesAndRooms(ctx);
package/dist/help.js CHANGED
@@ -73,6 +73,7 @@ Usage:
73
73
  [--focus <text> | --clear-focus] [--confirm]
74
74
  recess [--json] students upload-map-scores --student <kid-id>
75
75
  --file </path/to/map-report.pdf> [--confirm]
76
+ recess [--json] students issue-email --student <kid-id> [--confirm]
76
77
  recess [--json] chat-logs list --student <user-id> [--limit 100] [--cursor <cursor>]
77
78
  recess [--json] chat-logs get <conversation-id>
78
79
  recess [--json] chat-logs by-todo <todo-id>
@@ -183,6 +184,14 @@ Usage:
183
184
  recess [--json] channels members add <channel-id> <user-id...> [--role MEMBER|MODERATOR|ADMIN] [--confirm]
184
185
  recess [--json] channels members set-role <channel-id> <user-id...> --role MEMBER|MODERATOR|ADMIN [--confirm]
185
186
  recess [--json] channels members remove <channel-id> <user-id...> [--confirm]
187
+ 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]
190
+ [--one-on-one-price DOLLARS] [--one-on-one-sessions N] [--end YYYY-MM-DD]
191
+ [--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]
194
+ recess [--json] tuition-plans states
186
195
  recess [--json] cohorts get <cohort-id> [--events-tab ACTIVE|ENDED|CANCELED|ARCHIVED]
187
196
  recess [--json] cohorts schedule get <cohort-id>
188
197
  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>]
@@ -457,7 +466,7 @@ Usage:
457
466
  --entries-file <path.json> --delta TEXT [--replace-description-pointer]
458
467
  [--confirm --approval-token TOKEN]
459
468
  recess [--json] todos create --student <kid-id> --title TEXT
460
- [--due-date YYYY-MM-DD] [--estimated-minutes N] [--url URL] [--confirm]
469
+ [--due-date YYYY-MM-DD] [--target-minutes N] [--url URL] [--confirm]
461
470
  recess [--json] todos edit <todo-id> --patch-file <path/patch.json>
462
471
  [--confirm --approval-token TOKEN]
463
472
  recess [--json] todos complete <todo-id> --xp N
@@ -648,6 +657,29 @@ omitted for US; US ZIPs must be 12345 or 12345-6789. Each entry replaces the
648
657
  family's whole address. The preview is the server's dry run: before and after
649
658
  for every family that changes.
650
659
 
660
+ Tuition-plan notes: "generate" computes a Recess Academy tuition plan (nothing is
661
+ stored): a 180-instructional-day term at --annual (tuition net of Recess aid) and
662
+ a term through the state's typical school-year end. Each is paid in full upfront
663
+ (5% off, per /school/tuition) or quarterly; Florida is instead cash upfront or
664
+ monthly in arrears (Step Up pays only in arrears). --state-funding (family pays
665
+ with ESA funds) makes quarters follow the state's ESA funding dates where Recess
666
+ has them (AZ). It returns the /admin/tuition-plans web URL (--open opens it)
667
+ and, with --pdf, writes the letterhead PDF to that path. "states" lists the
668
+ supported states and their year-end dates. --enrollment partner-school
669
+ (with --partner-school, e.g. wonder-ed) marks the plan an estimate: the partner
670
+ school of record makes the final determination. Add-on prices default to
671
+ $160/month per extra elective and $400 per 4 tutoring sessions; --elective-price,
672
+ --one-on-one-price, and --one-on-one-sessions override them on this sheet.
673
+ --end YYYY-MM-DD adds a custom term through that date (priced by school days).
674
+ --terms and --payments pick a subset of the matrix (default: every term ×
675
+ upfront + installments). Full-year and custom terms may not end after July 1:
676
+ a full year that would is left out of the default and refused if asked for.
677
+ --note TEXT (repeatable) prints a note on the sheet. --bill-date (repeatable)
678
+ moves an invoice date: upfront=YYYY-MM-DD for pay in full, N=YYYY-MM-DD for
679
+ installment N in every term; due dates follow and dates must stay in order.
680
+ --even-installments splits each installment plan evenly in whole dollars (any
681
+ remainder on the first payment) instead of pricing each by its school days.
682
+
651
683
  Payout notes: amounts are integer cents. "payout items add" without --date
652
684
  defaults the item date to the penultimate day of the invoice's cycle (its
653
685
  endDate minus one day) and shows the computed date in the preview.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "recess-cli",
3
- "version": "3.7.0",
3
+ "version": "3.9.0",
4
4
  "description": "Safe Recess administration and family AI tools from the command line.",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {