recess-cli 3.39.0 → 3.41.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 +2 -0
- package/dist/cli.js +45 -8
- package/dist/command-schema.js +18 -0
- package/dist/commands/admissions.js +18 -1
- package/dist/commands/family.js +80 -2
- package/dist/help.js +21 -8
- package/package.json +3 -3
package/dist/args.js
CHANGED
|
@@ -44,6 +44,7 @@ export const BOOLEAN_FLAGS = new Set([
|
|
|
44
44
|
"append",
|
|
45
45
|
"apply",
|
|
46
46
|
"archived",
|
|
47
|
+
"auto",
|
|
47
48
|
"cancel-subscriptions",
|
|
48
49
|
"clear",
|
|
49
50
|
"clear-focus",
|
|
@@ -75,6 +76,7 @@ export const BOOLEAN_FLAGS = new Set([
|
|
|
75
76
|
"no-json",
|
|
76
77
|
"no-wait",
|
|
77
78
|
"open",
|
|
79
|
+
"optional",
|
|
78
80
|
"pretty",
|
|
79
81
|
"refresh",
|
|
80
82
|
"replace-description-pointer",
|
package/dist/cli.js
CHANGED
|
@@ -2220,10 +2220,19 @@ async function readAssignmentSelection(filePath) {
|
|
|
2220
2220
|
}
|
|
2221
2221
|
/** Hosted goal-template authoring and skills are guide/admin only (see below). */
|
|
2222
2222
|
const HOSTED_STAFF_NOUNS = new Set(["goal-templates", "skills"]);
|
|
2223
|
+
/**
|
|
2224
|
+
* Staff reach every hosted noun; a `family_ai` session (a guardian with goal
|
|
2225
|
+
* creation: Parent Rocky's power-parent lane) also reaches goal-templates.
|
|
2226
|
+
*/
|
|
2227
|
+
function hostedNounAllowed(noun, role, scope) {
|
|
2228
|
+
return (role === "GUIDE" ||
|
|
2229
|
+
role === "ADMIN" ||
|
|
2230
|
+
!HOSTED_STAFF_NOUNS.has(noun) ||
|
|
2231
|
+
(noun === "goal-templates" && scope === "family_ai"));
|
|
2232
|
+
}
|
|
2223
2233
|
/** The hosted catalog, minus nouns the hosted gate would refuse this role. */
|
|
2224
2234
|
function hostedCommands(commands, discovery) {
|
|
2225
|
-
|
|
2226
|
-
return remoteCommands(commands).filter((command) => staff || !HOSTED_STAFF_NOUNS.has(command.path[0]));
|
|
2235
|
+
return remoteCommands(commands).filter((command) => hostedNounAllowed(command.path[0], discovery.role, discovery.scope));
|
|
2227
2236
|
}
|
|
2228
2237
|
export async function executeRecessCommand(argv, options = {}) {
|
|
2229
2238
|
const parsed = parseArgs(argv);
|
|
@@ -2318,9 +2327,7 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
2318
2327
|
].includes(command.path.join(" "))) {
|
|
2319
2328
|
throw new CliError("invalid_arguments", "Structured input is accepted only by hosted apps validate and goal-templates validate-spec/create.");
|
|
2320
2329
|
}
|
|
2321
|
-
if (
|
|
2322
|
-
options.session?.user.role !== "GUIDE" &&
|
|
2323
|
-
options.session?.user.role !== "ADMIN") {
|
|
2330
|
+
if (!hostedNounAllowed(noun, options.session?.user.role, options.discovery?.scope)) {
|
|
2324
2331
|
throw new CliError("forbidden", "Hosted goal-template authoring requires a guide or admin.");
|
|
2325
2332
|
}
|
|
2326
2333
|
if (noun === "skills" &&
|
|
@@ -5064,6 +5071,12 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5064
5071
|
const chatTitleRaw = flagString(parsed, "chat-title");
|
|
5065
5072
|
const visibility = flagString(parsed, "visibility");
|
|
5066
5073
|
const targetPlatform = flagString(parsed, "target-platform");
|
|
5074
|
+
// Rocky's iPad pencil on the challenge's todos (false: the site's own
|
|
5075
|
+
// Pencil tools get the Pencil). Stored as `pageInkDisabled`.
|
|
5076
|
+
const pageInkRaw = flagString(parsed, "page-ink");
|
|
5077
|
+
const pageInkDisabled = pageInkRaw === undefined
|
|
5078
|
+
? undefined
|
|
5079
|
+
: assertChoice(pageInkRaw, ["true", "false"], "--page-ink") === "false";
|
|
5067
5080
|
const isStarterRaw = flagString(parsed, "is-starter");
|
|
5068
5081
|
const setupAudienceRaw = flagString(parsed, "setup-audience");
|
|
5069
5082
|
const isStarter = isStarterRaw === undefined
|
|
@@ -5104,6 +5117,7 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5104
5117
|
: {}),
|
|
5105
5118
|
...(sortOrder === undefined ? {} : { sortOrder }),
|
|
5106
5119
|
...(isStarter === undefined ? {} : { isStarter }),
|
|
5120
|
+
...(pageInkDisabled === undefined ? {} : { pageInkDisabled }),
|
|
5107
5121
|
...(setupAudienceRaw
|
|
5108
5122
|
? {
|
|
5109
5123
|
setupAudience: assertChoice(setupAudienceRaw, GOAL_TEMPLATE_SETUP_AUDIENCES, "--setup-audience"),
|
|
@@ -5138,7 +5152,7 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5138
5152
|
// shape that caused the template incident; editing an existing spec goes
|
|
5139
5153
|
// through the guarded /ai patch path with its destructive-change token.
|
|
5140
5154
|
if (Object.keys(body).length === 1) {
|
|
5141
|
-
throw new CliError("invalid_arguments", "Pass at least one field to change (--title, --description, --emoji, --image-url, --coin-amount, --chat-title, --category, --tags, --sort-order, --is-starter, --setup-audience, --kind, --visibility, --target-platform, --agent-instructions-file, --output-template-file).");
|
|
5155
|
+
throw new CliError("invalid_arguments", "Pass at least one field to change (--title, --description, --emoji, --image-url, --coin-amount, --chat-title, --category, --tags, --sort-order, --is-starter, --setup-audience, --kind, --visibility, --target-platform, --page-ink, --agent-instructions-file, --output-template-file).");
|
|
5142
5156
|
}
|
|
5143
5157
|
return writeCommand(parsed, {
|
|
5144
5158
|
action: "update goal template metadata (never its setupWorkflowSpec)",
|
|
@@ -5373,6 +5387,8 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5373
5387
|
if (verb === "apply") {
|
|
5374
5388
|
const id = await resolveGoalTemplateId(api, positional(parsed, 2, "template ID or slug"));
|
|
5375
5389
|
const answersFile = flagString(parsed, "answers-file");
|
|
5390
|
+
if (isRemote && answersFile)
|
|
5391
|
+
throw new CliError("remote_flag_unavailable", "--answers-file is not available over the hosted CLI; pass --student.");
|
|
5376
5392
|
const students = await resolveStudentList();
|
|
5377
5393
|
if (!answersFile && students.length === 0) {
|
|
5378
5394
|
throw new CliError("invalid_arguments", "Pass --student <kid-id-or-name> and/or --answers-file <path>. `goal-templates answers-template <id>` prints the answers shape.");
|
|
@@ -5437,14 +5453,19 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5437
5453
|
note: "Counts come from the backend's own dry run. `skipped_existing` items are idempotent — re-applying does not duplicate them.",
|
|
5438
5454
|
},
|
|
5439
5455
|
};
|
|
5440
|
-
|
|
5456
|
+
const apply = async () => unwrap(await api.client.POST("/ai/goal-templates/{id}/apply-workflow", {
|
|
5441
5457
|
params: { path: { id } },
|
|
5442
5458
|
body: {
|
|
5443
5459
|
answers,
|
|
5444
5460
|
dryRun: false,
|
|
5445
5461
|
expectedTemplateVersion: preflight.templateVersion,
|
|
5446
5462
|
},
|
|
5447
|
-
}))
|
|
5463
|
+
}));
|
|
5464
|
+
// Hosted (Parent Rocky's power-parent lane): the operation store's
|
|
5465
|
+
// preview → confirm, not the local approval ledger.
|
|
5466
|
+
return isRemote
|
|
5467
|
+
? writeCommand(parsed, preview, apply)
|
|
5468
|
+
: previewBoundWrite(parsed, preview, apply);
|
|
5448
5469
|
}
|
|
5449
5470
|
if (verb === "apply-starter") {
|
|
5450
5471
|
const id = await resolveGoalTemplateId(api, positional(parsed, 2, "template ID or slug"));
|
|
@@ -5838,6 +5859,16 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5838
5859
|
})));
|
|
5839
5860
|
}
|
|
5840
5861
|
if (verb === "create") {
|
|
5862
|
+
// Hosted: a description-only goal (no local files, no draft lane).
|
|
5863
|
+
const localOnly = [
|
|
5864
|
+
"description-file",
|
|
5865
|
+
"source-dir",
|
|
5866
|
+
"draft",
|
|
5867
|
+
"enable-applet-follow-ups",
|
|
5868
|
+
"disable-applet-follow-ups",
|
|
5869
|
+
].find((name) => hasFlag(parsed, name));
|
|
5870
|
+
if (isRemote && localOnly)
|
|
5871
|
+
throw new CliError("remote_flag_unavailable", `--${localOnly} is not available over the hosted CLI; pass --description.`);
|
|
5841
5872
|
const requestedStudent = await studentFlag(api, parsed);
|
|
5842
5873
|
const requestedStudentId = requestedStudent?.id;
|
|
5843
5874
|
const sourceDirectory = flagString(parsed, "source-dir");
|
|
@@ -5985,6 +6016,10 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
5985
6016
|
request: {
|
|
5986
6017
|
title,
|
|
5987
6018
|
descriptionChars: description.length,
|
|
6019
|
+
// Binds the text itself: a confirm can't swap the description.
|
|
6020
|
+
descriptionSha256: createHash("sha256")
|
|
6021
|
+
.update(description)
|
|
6022
|
+
.digest("hex"),
|
|
5988
6023
|
targetDate: targetDate ?? null,
|
|
5989
6024
|
schedule: schedule ?? null,
|
|
5990
6025
|
},
|
|
@@ -6501,6 +6536,8 @@ export async function executeRecessCommand(argv, options = {}) {
|
|
|
6501
6536
|
? { url: flagString(parsed, "url") }
|
|
6502
6537
|
: {}),
|
|
6503
6538
|
...(targetDurationInMins !== undefined ? { targetDurationInMins } : {}),
|
|
6539
|
+
// An extra: off the kid's required day, never gates the feed lock.
|
|
6540
|
+
...(hasFlag(parsed, "optional") ? { required: false } : {}),
|
|
6504
6541
|
};
|
|
6505
6542
|
return writeCommand(parsed, {
|
|
6506
6543
|
action: "create a todo for a managed student",
|
package/dist/command-schema.js
CHANGED
|
@@ -120,9 +120,11 @@ export const FAMILY_REMOTE_WRITES = [
|
|
|
120
120
|
"kid set-goal-games",
|
|
121
121
|
"kid set-goal-note",
|
|
122
122
|
"kid set-goal-required",
|
|
123
|
+
"kid set-challenge-order",
|
|
123
124
|
"kid set-goal-coins",
|
|
124
125
|
"kid set-goal-days",
|
|
125
126
|
"kid mark-done",
|
|
127
|
+
"kid set-todo-required",
|
|
126
128
|
"kid rename-challenge",
|
|
127
129
|
"kid set-todo-naming",
|
|
128
130
|
"kid set-profile",
|
|
@@ -152,6 +154,10 @@ const REMOTE_COMMAND_SCOPES = new Map([
|
|
|
152
154
|
["goal-templates get", [RECESS_MCP_SCOPES.templatesRead]],
|
|
153
155
|
["goal-templates validate-spec", [RECESS_MCP_SCOPES.templatesWrite]],
|
|
154
156
|
["goal-templates create", [RECESS_MCP_SCOPES.templatesWrite]],
|
|
157
|
+
// Parent Rocky's power-parent lane (family_ai): apply a template, or a
|
|
158
|
+
// description-only goal.
|
|
159
|
+
["goal-templates apply", [RECESS_MCP_SCOPES.templatesWrite]],
|
|
160
|
+
["goals create", [RECESS_MCP_SCOPES.templatesWrite]],
|
|
155
161
|
["skills guardian get", [RECESS_MCP_SCOPES.templatesRead]],
|
|
156
162
|
["doctor", []],
|
|
157
163
|
["help", []],
|
|
@@ -184,6 +190,14 @@ const REMOTE_COMMAND_SCOPES = new Map([
|
|
|
184
190
|
]),
|
|
185
191
|
]);
|
|
186
192
|
const REMOTE_USAGE = new Map([
|
|
193
|
+
[
|
|
194
|
+
"goal-templates apply",
|
|
195
|
+
"recess goal-templates apply <template-id> --student <kid-id> [--dry-run] [--confirm --operation-key <key>]",
|
|
196
|
+
],
|
|
197
|
+
[
|
|
198
|
+
"goals create",
|
|
199
|
+
"recess goals create --student <kid-id> --title TEXT --description TEXT [--target-date <iso>] [--schedule TEXT] [--confirm --operation-key <key>]",
|
|
200
|
+
],
|
|
187
201
|
["goal-templates validate-spec", "recess goal-templates validate-spec"],
|
|
188
202
|
[
|
|
189
203
|
"goal-templates create",
|
|
@@ -207,6 +221,8 @@ const REMOTE_USAGE = new Map([
|
|
|
207
221
|
]);
|
|
208
222
|
const REMOTE_CONFIRMATION_COMMANDS = new Set([
|
|
209
223
|
"goal-templates create",
|
|
224
|
+
"goal-templates apply",
|
|
225
|
+
"goals create",
|
|
210
226
|
"apps validate",
|
|
211
227
|
"apps publish",
|
|
212
228
|
"apps assign",
|
|
@@ -307,9 +323,11 @@ const FAMILY_COMMANDS = new Set([
|
|
|
307
323
|
"kid set-goal-games",
|
|
308
324
|
"kid set-goal-note",
|
|
309
325
|
"kid set-goal-required",
|
|
326
|
+
"kid set-challenge-order",
|
|
310
327
|
"kid set-goal-coins",
|
|
311
328
|
"kid set-goal-days",
|
|
312
329
|
"kid mark-done",
|
|
330
|
+
"kid set-todo-required",
|
|
313
331
|
"kid rename-challenge",
|
|
314
332
|
"kid set-todo-naming",
|
|
315
333
|
"kid set-profile",
|
|
@@ -609,6 +609,23 @@ export async function runAdmissionsCommand({ parsed, api, writeCommand, }) {
|
|
|
609
609
|
return json ? result : { help: await render(result.packet) };
|
|
610
610
|
});
|
|
611
611
|
}
|
|
612
|
+
if (verb === "pay-link") {
|
|
613
|
+
const packetId = positional(parsed, 2, "packet ID");
|
|
614
|
+
return writeCommand(parsed, {
|
|
615
|
+
action: `create a no-sign-in payment link for admission packet ${packetId}`,
|
|
616
|
+
target: { packetId },
|
|
617
|
+
request: {},
|
|
618
|
+
}, async () => {
|
|
619
|
+
const result = unwrap(await api.client.POST("/admin/admissions/{packetId}/pay-link", {
|
|
620
|
+
params: { path: { packetId } },
|
|
621
|
+
}));
|
|
622
|
+
return json
|
|
623
|
+
? result
|
|
624
|
+
: {
|
|
625
|
+
help: `${result.url}\nWorks without signing in until ${result.expiresAt}, or until the family has nothing left to pay.`,
|
|
626
|
+
};
|
|
627
|
+
});
|
|
628
|
+
}
|
|
612
629
|
if (verb === "set-paywall") {
|
|
613
630
|
const packetId = positional(parsed, 2, "packet ID");
|
|
614
631
|
const paywallRaw = flagString(parsed, "paywall")?.replace(/[$,]/g, "");
|
|
@@ -695,6 +712,6 @@ export async function runAdmissionsCommand({ parsed, api, writeCommand, }) {
|
|
|
695
712
|
};
|
|
696
713
|
});
|
|
697
714
|
}
|
|
698
|
-
throw new CliError("invalid_arguments", "Usage: recess admissions create|get|list|resend|void|mark-signed|upload-signed|contract|mark-paid|set-paywall|orientation-week|requote|archive-agreement. See `recess help`.");
|
|
715
|
+
throw new CliError("invalid_arguments", "Usage: recess admissions create|get|list|resend|void|mark-signed|upload-signed|contract|mark-paid|pay-link|set-paywall|orientation-week|requote|archive-agreement. See `recess help`.");
|
|
699
716
|
}
|
|
700
717
|
//# sourceMappingURL=admissions.js.map
|
package/dist/commands/family.js
CHANGED
|
@@ -1832,6 +1832,61 @@ export async function runKidCommand({ parsed, api, writeCommand, }) {
|
|
|
1832
1832
|
};
|
|
1833
1833
|
});
|
|
1834
1834
|
}
|
|
1835
|
+
if (verb === "set-challenge-order") {
|
|
1836
|
+
// The order the kid's challenges (and so their to-dos) run in; "rocky"
|
|
1837
|
+
// is Rocky's practice. Required ones stay first (the server regroups).
|
|
1838
|
+
const auto = hasFlag(parsed, "auto");
|
|
1839
|
+
const raw = flagString(parsed, "order")?.trim();
|
|
1840
|
+
if (auto === (raw !== undefined) || raw === "")
|
|
1841
|
+
throw new CliError("invalid_arguments", 'Pass --order "<challenge>,<challenge>,rocky,…" (ids or titles), or --auto for Rocky\'s order.');
|
|
1842
|
+
const { goals } = unwrap(await api.client.GET("/parent/kid/{kidId}/goals/", {
|
|
1843
|
+
params: { path: { kidId } },
|
|
1844
|
+
}));
|
|
1845
|
+
const active = goals.filter((goal) => goal.status === "ACTIVE");
|
|
1846
|
+
const items = auto
|
|
1847
|
+
? null
|
|
1848
|
+
: raw
|
|
1849
|
+
.split(",")
|
|
1850
|
+
.map((entry) => entry.trim())
|
|
1851
|
+
.filter(Boolean)
|
|
1852
|
+
.map((entry) => {
|
|
1853
|
+
if (entry.toLowerCase() === "rocky")
|
|
1854
|
+
return "rocky";
|
|
1855
|
+
const hits = active.filter((goal) => goal.id === entry ||
|
|
1856
|
+
goal.title.trim().toLowerCase() === entry.toLowerCase());
|
|
1857
|
+
if (hits.length !== 1)
|
|
1858
|
+
throw new CliError("invalid_arguments", hits.length
|
|
1859
|
+
? `"${entry}" matches more than one of ${name}'s challenges: use its id.`
|
|
1860
|
+
: `${name} has no active challenge "${entry}". Run \`kid challenges\` for theirs.`);
|
|
1861
|
+
return hits[0].id;
|
|
1862
|
+
});
|
|
1863
|
+
const titleOf = (id) => id === "rocky"
|
|
1864
|
+
? "Rocky's practice"
|
|
1865
|
+
: (active.find((goal) => goal.id === id)?.title ?? id);
|
|
1866
|
+
return writeNow(parsed, {
|
|
1867
|
+
action: items
|
|
1868
|
+
? `run ${name}'s challenges in this order: ${items.map(titleOf).join(", ")}`
|
|
1869
|
+
: `put ${name}'s challenges back in Rocky's order`,
|
|
1870
|
+
target: kidTarget(kid),
|
|
1871
|
+
request: { items },
|
|
1872
|
+
details: {
|
|
1873
|
+
consequence: "Their to-dos follow it; required challenges stay before optional ones (undo: family undo).",
|
|
1874
|
+
},
|
|
1875
|
+
}, async () => {
|
|
1876
|
+
const result = unwrap(await api.client.PUT("/parent-v2/kid/{kidId}/challenges/order/", {
|
|
1877
|
+
params: { path: { kidId } },
|
|
1878
|
+
body: { items },
|
|
1879
|
+
}));
|
|
1880
|
+
const order = result.order.items.map(titleOf);
|
|
1881
|
+
return result.change
|
|
1882
|
+
? { ...result, order, custom: result.order.custom }
|
|
1883
|
+
: {
|
|
1884
|
+
status: "no_change",
|
|
1885
|
+
reason: `${name}'s challenges already run in that order.`,
|
|
1886
|
+
order,
|
|
1887
|
+
};
|
|
1888
|
+
});
|
|
1889
|
+
}
|
|
1835
1890
|
if (verb === "set-goal-coins") {
|
|
1836
1891
|
const goalId = flagUuid(parsed, "goal", { required: true });
|
|
1837
1892
|
const raw = flagString(parsed, "value", { required: true })
|
|
@@ -1891,7 +1946,7 @@ export async function runKidCommand({ parsed, api, writeCommand, }) {
|
|
|
1891
1946
|
}));
|
|
1892
1947
|
return {
|
|
1893
1948
|
challenges: goals.map((goal) => `${goal.id} · ${goal.title} · ${goal.required ? "required" : "optional"} · ${goal.todoCoins ?? (goal.required ? 20 : 5)} coins/to-do · ${goal.status.toLowerCase()}`),
|
|
1894
|
-
page: `${api.config.webOrigin}/ai
|
|
1949
|
+
page: `${api.config.webOrigin}/ai?kid=${encodeURIComponent(kidId)}&tab=challenges`,
|
|
1895
1950
|
browse: `${api.config.webOrigin}/activity/challenges`,
|
|
1896
1951
|
};
|
|
1897
1952
|
}
|
|
@@ -1911,6 +1966,29 @@ export async function runKidCommand({ parsed, api, writeCommand, }) {
|
|
|
1911
1966
|
body,
|
|
1912
1967
|
})));
|
|
1913
1968
|
}
|
|
1969
|
+
if (verb === "set-todo-required") {
|
|
1970
|
+
const todoId = flagUuid(parsed, "todo", { required: true });
|
|
1971
|
+
const value = assertChoice(flagString(parsed, "value", { required: true }).trim().toLowerCase(), ["on", "off", "default"], "--value");
|
|
1972
|
+
const required = value === "default" ? null : value === "on";
|
|
1973
|
+
return writeNow(parsed, {
|
|
1974
|
+
action: `make ${name}'s todo ${todoId} ${value === "default" ? "follow its challenge" : value === "on" ? "required" : "optional"}`,
|
|
1975
|
+
target: { ...kidTarget(kid), todoId },
|
|
1976
|
+
request: { required },
|
|
1977
|
+
details: {
|
|
1978
|
+
consequence: "Only this to-do: required is part of the day's plan, optional is an extra; default follows its challenge. The whole challenge is set-goal-required (undo: family undo).",
|
|
1979
|
+
},
|
|
1980
|
+
}, async () => {
|
|
1981
|
+
const result = unwrap(await api.client.PATCH("/parent-v2/kid/{kidId}/todos/{todoId}/required/", { params: { path: { kidId, todoId } }, body: { required } }));
|
|
1982
|
+
return result.change
|
|
1983
|
+
? result
|
|
1984
|
+
: {
|
|
1985
|
+
status: "no_change",
|
|
1986
|
+
reason: `"${result.title}" is already ${result.required === null ? "at its default" : result.required ? "required" : "optional"}.`,
|
|
1987
|
+
todoId,
|
|
1988
|
+
required: result.required,
|
|
1989
|
+
};
|
|
1990
|
+
});
|
|
1991
|
+
}
|
|
1914
1992
|
if (verb === "rename-challenge") {
|
|
1915
1993
|
const goalId = flagUuid(parsed, "goal", { required: true });
|
|
1916
1994
|
const title = flagString(parsed, "title", { required: true }).trim();
|
|
@@ -2405,7 +2483,7 @@ export async function runKidCommand({ parsed, api, writeCommand, }) {
|
|
|
2405
2483
|
body,
|
|
2406
2484
|
})));
|
|
2407
2485
|
}
|
|
2408
|
-
throw new CliError("invalid_arguments", "Use kid today|goals|xp|map-scores|classes|profile|set-profile|texts|set-texts|set-rooms|feed-lock|set-feed-lock|logins|reveal-login|add-login|edit-login|remove-login|excuse|unexcuse-weekly|cowork|switch-cowork|friends|friend-parent|pair-device|goal-schedule|pause-goal|resume-goal|goal-note|set-goal-note|add-todo|todo|move-todo|end-session|remove-todo|edit-todo|repeat-todo|join-challenge|leave-challenge|complete-challenge|set-goal-games|set-goal-required|set-goal-coins|set-goal-days|set-todo-reward|mark-done|challenges|rename-challenge|set-todo-naming|help|help-done|excuse-days|excused-days|unexcuse-days|moments|config|set|progress|schedule|attendance|browse-challenges|sign-in-code|todos|goal|conversations|social|enrollments|math-progress|memory|observe|send-note.");
|
|
2486
|
+
throw new CliError("invalid_arguments", "Use kid today|goals|xp|map-scores|classes|profile|set-profile|texts|set-texts|set-rooms|feed-lock|set-feed-lock|logins|reveal-login|add-login|edit-login|remove-login|excuse|unexcuse-weekly|cowork|switch-cowork|friends|friend-parent|pair-device|goal-schedule|pause-goal|resume-goal|goal-note|set-goal-note|add-todo|todo|move-todo|end-session|remove-todo|edit-todo|repeat-todo|join-challenge|leave-challenge|complete-challenge|set-goal-games|set-goal-required|set-challenge-order|set-goal-coins|set-goal-days|set-todo-reward|mark-done|set-todo-required|challenges|rename-challenge|set-todo-naming|help|help-done|excuse-days|excused-days|unexcuse-days|moments|config|set|progress|schedule|attendance|browse-challenges|sign-in-code|todos|goal|conversations|social|enrollments|math-progress|memory|observe|send-note.");
|
|
2409
2487
|
}
|
|
2410
2488
|
/**
|
|
2411
2489
|
* `me`: the caller's OWN to-dos and challenges (a parent learning too), over
|
package/dist/help.js
CHANGED
|
@@ -286,11 +286,15 @@ Usage:
|
|
|
286
286
|
recess [--json] kid leave-challenge --student <kid> --goal <goal-id> [--confirm]
|
|
287
287
|
recess [--json] kid set-goal-games --student <kid> --goal <goal-id> --value on|off [--confirm]
|
|
288
288
|
recess [--json] kid set-goal-required --student <kid> --goal <goal-id> --value on|off [--confirm]
|
|
289
|
+
recess [--json] kid set-challenge-order --student <kid> (--order "<goal-id|title>,…,rocky" | --auto)
|
|
290
|
+
[--confirm]
|
|
289
291
|
recess [--json] kid set-goal-coins --student <kid> --goal <goal-id> --value 0-20|default [--confirm]
|
|
290
292
|
recess [--json] kid set-goal-days --student <kid> --goal <goal-id>
|
|
291
293
|
--days <"Tue, Thu"|Mon-Fri|weekdays|daily> [--confirm]
|
|
292
294
|
recess [--json] kid challenges --student <kid>
|
|
293
295
|
recess [--json] kid mark-done --student <kid> --todo <todo-id> [--note TEXT] [--confirm]
|
|
296
|
+
recess [--json] kid set-todo-required --student <kid> --todo <todo-id> --value on|off|default
|
|
297
|
+
[--confirm]
|
|
294
298
|
recess [--json] kid rename-challenge --student <kid> --goal <goal-id> --title TEXT [--confirm]
|
|
295
299
|
recess [--json] kid set-todo-naming --student <kid> --goal <goal-id> (--text TEXT | --clear)
|
|
296
300
|
[--confirm]
|
|
@@ -378,6 +382,7 @@ Usage:
|
|
|
378
382
|
recess [--json] admissions archive-agreement <packet-id> [--confirm]
|
|
379
383
|
recess [--json] admissions attach-aid <packet-id> --financial-aid <financial-aid-application-id>|none [--confirm]
|
|
380
384
|
recess [--json] admissions mark-paid <packet-id> [--note TEXT] [--confirm]
|
|
385
|
+
recess [--json] admissions pay-link <packet-id> [--confirm]
|
|
381
386
|
recess [--json] admissions set-paywall <packet-id> (--paywall DOLLARS | --paywall-offline | --no-paywall) [--note TEXT] [--confirm]
|
|
382
387
|
recess [--json] admissions orientation-week <packet-id> --kid <packet-kid-id> --week YYYY-MM-DD [--confirm]
|
|
383
388
|
recess [--json] admissions contract <packet-id> [--option <term:payment>] [--out <file>]
|
|
@@ -621,6 +626,7 @@ Usage:
|
|
|
621
626
|
[--is-starter true|false] [--setup-audience KID_FRIENDLY|PARENT_SETUP]
|
|
622
627
|
[--kind SIMPLE|BLUEPRINT]
|
|
623
628
|
[--visibility PUBLIC|PRIVATE|STAFF_ONLY] [--target-platform ANY|MOBILE|DESKTOP]
|
|
629
|
+
[--page-ink true|false]
|
|
624
630
|
[--agent-instructions-file <path>] [--output-template-file <path>] [--confirm]
|
|
625
631
|
recess [--json] goal-templates delete <template-id> [--expected-version N] [--confirm]
|
|
626
632
|
recess [--json] goal-templates generate-image <template-id|slug>
|
|
@@ -669,7 +675,7 @@ Usage:
|
|
|
669
675
|
--entries-file <path.json> --delta TEXT [--replace-description-pointer]
|
|
670
676
|
[--confirm --approval-token TOKEN]
|
|
671
677
|
recess [--json] todos create --student <kid-id> --title TEXT
|
|
672
|
-
[--due-date YYYY-MM-DD] [--target-minutes N] [--url URL] [--confirm]
|
|
678
|
+
[--due-date YYYY-MM-DD] [--target-minutes N] [--url URL] [--optional] [--confirm]
|
|
673
679
|
recess [--json] todos edit <todo-id> --patch-file <path/patch.json>
|
|
674
680
|
[--confirm --approval-token TOKEN]
|
|
675
681
|
recess [--json] todos complete <todo-id> --xp N
|
|
@@ -969,10 +975,10 @@ new device. Plan changes apply at once with no confirm step and are logged
|
|
|
969
975
|
(undo: family undo, or family undo --change ID): excuse, unexcuse-weekly,
|
|
970
976
|
goal-schedule, pause-goal, resume-goal, set-goal-note, add-todo, move-todo,
|
|
971
977
|
remove-todo, edit-todo, repeat-todo, join-challenge, set-goal-games,
|
|
972
|
-
set-goal-required, set-goal-coins, set-goal-days, mark-done,
|
|
973
|
-
set-todo-naming, help-done, excuse-days,
|
|
974
|
-
that apply at once. --confirm on them changes
|
|
975
|
-
the first result (alreadyApplied) instead of applying twice. Every other write
|
|
978
|
+
set-goal-required, set-challenge-order, set-goal-coins, set-goal-days, mark-done,
|
|
979
|
+
set-todo-required, rename-challenge, set-todo-naming, help-done, excuse-days,
|
|
980
|
+
unexcuse-days, and "set" fields that apply at once. --confirm on them changes
|
|
981
|
+
nothing: a rerun with it returns the first result (alreadyApplied) instead of applying twice. Every other write
|
|
976
982
|
previews first, then needs --confirm. Passwords are
|
|
977
983
|
never echoed in previews (redacted plus a sha256 prefix); "kid reveal-login" is
|
|
978
984
|
an audited read. --interests replaces the whole list. The daily summary is opt-in
|
|
@@ -1131,7 +1137,12 @@ plan flags as create, or --keep-plan to reopen the payment choice on the plan
|
|
|
1131
1137
|
as it is; --paywall/--no-paywall changes the family share): the Documenso
|
|
1132
1138
|
envelope is cancelled, the family signs again from the same link, and their
|
|
1133
1139
|
account, consent and answers stand (a completed packet completes again on its
|
|
1134
|
-
own); paid packets need a refund first and voided ones a new packet. "
|
|
1140
|
+
own); paid packets need a refund first and voided ones a new packet. "pay-link"
|
|
1141
|
+
prints a 14-day link to the pay screen for a packet on its card payment step: no
|
|
1142
|
+
sign-in, a newly entered card, and it walks the family's admission charges in
|
|
1143
|
+
turn, skipping canceled or voided packets. It can't be revoked while the family
|
|
1144
|
+
owes an admission charge, so send it only to the family.
|
|
1145
|
+
"set-paywall" changes only the paywall (--paywall DOLLARS, --paywall-offline or
|
|
1135
1146
|
--no-paywall) with no re-signing: the agreement stands, an open admission
|
|
1136
1147
|
charge Stripe never saw is canceled, and a packet at the payment step reopens
|
|
1137
1148
|
the new paywall or completes. It refuses while the parent is mid-signing.
|
|
@@ -1418,9 +1429,11 @@ export const COMMAND_SUMMARIES = {
|
|
|
1418
1429
|
"kid leave-challenge": "Take a kid off a challenge; progress is kept.",
|
|
1419
1430
|
"kid set-goal-games": "Practice games on/off after one challenge's lessons (at once).",
|
|
1420
1431
|
"kid set-goal-required": "Whether a kid may drop one challenge themselves (at once).",
|
|
1432
|
+
"kid set-challenge-order": "Set the order a kid's challenges run in; their to-dos follow it (at once).",
|
|
1421
1433
|
"kid set-goal-coins": "Coins each of one challenge's to-dos pays, 0-20 or default, fixed (at once; tutors too).",
|
|
1422
1434
|
"kid challenges": "A kid's challenges, one line each, plus the page with the rest.",
|
|
1423
1435
|
"kid mark-done": "Mark a to-do done a parent vouches for; it pays as usual (at once).",
|
|
1436
|
+
"kid set-todo-required": "Make one to-do required, optional (an extra) or follow its challenge (at once).",
|
|
1424
1437
|
"kid rename-challenge": "Rename one of a kid's challenges (at once).",
|
|
1425
1438
|
"kid set-todo-naming": "How one challenge's new to-dos are titled (at once).",
|
|
1426
1439
|
"kid help": "The day's ways to help (from the daily summary).",
|
|
@@ -1641,8 +1654,8 @@ export const COMMAND_SUMMARIES = {
|
|
|
1641
1654
|
"goals launch-todo": "Create a goal module's todo now.",
|
|
1642
1655
|
"goals queue get": "Read a goal's module queue.",
|
|
1643
1656
|
"goals queue set": "Replace a goal's module queue from JSON.",
|
|
1644
|
-
"todos create": "Create a todo for a kid.",
|
|
1645
|
-
"todos edit": "Patch a todo's fields.",
|
|
1657
|
+
"todos create": "Create a todo for a kid (--optional: an extra, off the required day and feed lock).",
|
|
1658
|
+
"todos edit": "Patch a todo's fields ({\"pageInk\": false} turns Rocky's iPad pencil off; null follows the challenge).",
|
|
1646
1659
|
"todos complete": "Complete a todo with XP.",
|
|
1647
1660
|
"todos delete": "Delete a todo (soft).",
|
|
1648
1661
|
"todos restore": "Restore a deleted todo.",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "recess-cli",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.41.0",
|
|
4
4
|
"description": "Safe Recess administration and family AI tools from the command line.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"repository": {
|
|
@@ -46,8 +46,8 @@
|
|
|
46
46
|
"oxlint-tsgolint": "^0.6.0",
|
|
47
47
|
"typescript": "^5.9.2",
|
|
48
48
|
"vitest": "^1.6.0",
|
|
49
|
-
"@tryrecess/
|
|
50
|
-
"@tryrecess/
|
|
49
|
+
"@tryrecess/typescript-config": "0.0.0",
|
|
50
|
+
"@tryrecess/api-types": "0.0.0"
|
|
51
51
|
},
|
|
52
52
|
"scripts": {
|
|
53
53
|
"build": "node node_modules/@tryrecess/typescript-config/bin/tsc-fast.mjs",
|