recess-cli 2.6.1 → 2.8.0

package/README.md

@@ -274,7 +274,10 @@ recess --json goals list --student <kid-id> --reason "Review the student's goals
 recess --json todos create --student <kid-id> --title "Read chapter 4" --reason "Add the assigned reading"
 recess --json todos complete <todo-id> --xp 35 --reason "Complete the todo with a 35 XP total reward"
 recess --json goals delete <goal-id> --student <kid-id> --reason "Remove this obsolete goal"
+recess --json goals restore <goal-id> --student <kid-id> --reason "Restore this goal"
 recess --json todos delete <todo-id> --reason "Remove this disposable todo"
+recess --json todos restore <todo-id> --reason "Restore this todo"
+recess --json todos generate-learning-analysis <todo-id> --reason "Backfill this todo's missing learning analysis"
 recess --json todos generate-applet <todo-id> --student <kid-id> --reason "Generate this todo's applet"
 recess --json memories context --student <kid-id> --reason "Review durable tutor context"
 recess --json memories log --student <kid-id> --date 2026-08-12 --reason "Review the learning log for this date"
@@ -286,7 +289,12 @@ into the confirmed request. `todos complete` is staff-only; `--xp` is the target
 todo, so its preview reports prior credit and the new delta before the normal completion and reward
 side effects run. Applet generation is also 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
+select v1 or v2 for that student. Learning-analysis generation is ADMIN-only and queues the
+idempotent forensic pipeline from the latest completed Gemini analysis without rerunning completion
+or rewards. Goal and todo deletion is soft-only. Restoring a goal retains its Mesa workspace,
+rechecks open-goal capacity, and restores only linked todos sharing that deletion's tombstone;
+standalone todo restore uses the same preview-bound tombstone check. 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/api.js

@@ -19,16 +19,19 @@ export class RecessAdminApi {
     clientTag;
     client;
     villageSessionPromise;
-    constructor(config, reason, clientTag = RECESS_CLIENT_CLI) {
+    constructor(config, reason, clientTag = RECESS_CLIENT_CLI, clientOverride, fetchOverride) {
         this.config = config;
         this.reason = reason;
         this.clientTag = clientTag;
-        this.client = createClient({
-            baseUrl: config.apiOrigin,
-            headers: config.sessionCookie
-                ? { cookie: config.sessionCookie }
-                : undefined,
-        });
+        this.client =
+            clientOverride ??
+                createClient({
+                    baseUrl: config.apiOrigin,
+                    headers: config.sessionCookie
+                        ? { cookie: config.sessionCookie }
+                        : undefined,
+                    ...(fetchOverride ? { fetch: fetchOverride } : {}),
+                });
         const requestReason = this.reason;
         const requestClientTag = this.clientTag;
         this.client.use({
@@ -162,7 +165,9 @@ export class RecessAdminApi {
     async uploadMapTestScores(studentId, pdf, fileName) {
         this.requireAuth();
         const formData = new FormData();
-        formData.append("file", new Blob([pdf], { type: "application/pdf" }), fileName);
+        const pdfBody = new Uint8Array(pdf.byteLength);
+        pdfBody.set(pdf);
+        formData.append("file", new Blob([pdfBody.buffer], { type: "application/pdf" }), fileName);
         const headers = cliRequestHeaders({ cookie: this.config.sessionCookie }, this.reason, this.clientTag);
         applyIdempotencyHeaders(headers);
         const response = await fetch(new URL(`/tutor/students/${encodeURIComponent(studentId)}/map-test-scores/upload`, this.config.apiOrigin), {

package/dist/args.js

@@ -32,7 +32,6 @@ const BOOLEAN_FLAGS = new Set([
     "starter-only",
     "unlink",
     "visual-only",
-    "version",
     "wait",
 ]);
 export function parseArgs(args) {