recess-cli 1.9.0 → 1.9.1

package/README.md

@@ -197,13 +197,16 @@ recess --json students schedule --student <kid-id> --days 30
 recess --json students xp-history --student <kid-id> --range month
 recess --json goals list --student <kid-id>
 recess --json todos create --student <kid-id> --title "Read chapter 4"
+recess --json todos generate-applet <todo-id> --student <kid-id> [--due-date YYYY-MM-DD]
 recess --json memories context --student <kid-id>
 recess --json memories log --student <kid-id> --date 2026-08-12
 recess --json rocky get --student <kid-id>
 ```
 
 All family writes still preview first. Goal/todo/Rocky edits also carry the current server version
-into the confirmed request. A guardian cannot target another family, inspect frozen/deleted
+into the confirmed request. Applet generation is staff-only: it resolves the todo's latest learning
+analysis, defaults the generated todo to tomorrow in the student's timezone, and lets the server
+select v1 or v2 for that student. A guardian cannot target another family, inspect frozen/deleted
 template history, choose todo rewards/completion/internal fields, or use the ADMIN-only
 device-authorization flow. `memories context` and `memories log` read only the tutor repository's
 spine, rules, reminders, and session logs; private guide remarks are never returned. The CLI does

package/dist/cli.js

@@ -180,6 +180,8 @@ Usage:
     [--due-date YYYY-MM-DD] [--estimated-minutes N] [--url URL] [--confirm]
   recess [--json] todos edit <todo-id> --patch-file <path/patch.json>
     [--confirm --approval-token TOKEN]
+  recess [--json] todos generate-applet <todo-id> --student <kid-id>
+    [--due-date YYYY-MM-DD] [--confirm --approval-token TOKEN]
   recess [--json] memories context --student <kid-id>
   recess [--json] memories log --student <kid-id> --date YYYY-MM-DD
   recess [--json] rocky get --student <kid-id>
@@ -1175,6 +1177,20 @@ function flagItemDateMs(parsed) {
     }
     return ms;
 }
+function flagDateOnly(parsed, name) {
+    const raw = flagString(parsed, name);
+    if (raw === undefined)
+        return undefined;
+    const parsedDate = /^\d{4}-\d{2}-\d{2}$/.test(raw)
+        ? new Date(`${raw}T00:00:00.000Z`)
+        : null;
+    if (!parsedDate ||
+        Number.isNaN(parsedDate.getTime()) ||
+        parsedDate.toISOString().slice(0, 10) !== raw) {
+        throw new CliError("invalid_arguments", `--${name} must be a valid YYYY-MM-DD date.`);
+    }
+    return raw;
+}
 const DAY_MS = 24 * 60 * 60 * 1000;
 // The cohort event routes take zoneless local wall-clock datetimes
 // (interpreted in the cohort's timezone server-side).
@@ -3423,7 +3439,49 @@ export async function runCommand(argv) {
                 body,
             }));
         }
-        throw new CliError("invalid_arguments", "Use todos create|edit.");
+        if (verb === "generate-applet") {
+            const todoId = positional(parsed, 2, "todo ID");
+            const studentId = flagString(parsed, "student", { required: true });
+            const targetDueDateISO = flagDateOnly(parsed, "due-date");
+            const [todo, learningAnalysis] = await Promise.all([
+                api.client.GET("/tutor/browser/todos/{id}/", {
+                    params: { path: { id: todoId } },
+                }),
+                api.client.GET("/tutor/students/{studentId}/todos/{todoId}/learning-analysis", {
+                    params: { path: { studentId, todoId } },
+                }),
+            ]);
+            const currentTodo = unwrap(todo);
+            if (currentTodo.userId !== studentId) {
+                throw new CliError("not_found", "The todo does not belong to the requested student.");
+            }
+            const analysis = unwrap(learningAnalysis).analysis;
+            if (!analysis) {
+                throw new CliError("not_found", "This todo does not have a learning analysis to generate an applet from.");
+            }
+            const preview = {
+                action: "generate an applet from a student's todo analysis",
+                target: {
+                    studentUserId: studentId,
+                    todoId,
+                    todoTitle: currentTodo.title,
+                    analysisId: analysis.id,
+                },
+                request: {
+                    targetDueDateISO: targetDueDateISO ?? null,
+                },
+                details: {
+                    dueDate: targetDueDateISO ?? "tomorrow in the student's timezone",
+                    versionRouting: "The server evaluates applet-gen-v2 for this student and uses v1 when the flag is off or its evaluation fails.",
+                },
+            };
+            requirePreviewBoundConfirmation(parsed, preview);
+            return unwrap(await api.client.POST("/admin/learning-pipeline/{analysisId}/generate-applet/", {
+                params: { path: { analysisId: analysis.id } },
+                body: targetDueDateISO ? { targetDueDateISO } : {},
+            }));
+        }
+        throw new CliError("invalid_arguments", "Use todos create|edit|generate-applet.");
     }
     if (noun === "memories") {
         const studentId = flagString(parsed, "student", { required: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recess-cli",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Safe Recess administration and family AI tools from the command line.",
   "license": "UNLICENSED",
   "repository": {