recess-cli 1.9.1 → 1.9.2

package/dist/auth.js

@@ -4,12 +4,16 @@ import { randomBytes } from "node:crypto";
 import { clearPendingDeviceAuth, updateStoredConfig } from "./config.js";
 import { apiError, CliError } from "./errors.js";
 function openBrowser(url) {
+    // Windows goes through rundll32, not `cmd /c start`: cmd treats `&` (and the
+    // `%`-encoded redirect_uri) as metacharacters and chops the URL at the first
+    // `&`, so the browser only ever received `?client_id=…` and the OAuth page
+    // rejected it. rundll32 takes the URL as a single, unparsed argument.
     const command = process.platform === "darwin"
         ? "open"
         : process.platform === "win32"
-            ? "cmd"
+            ? "rundll32"
             : "xdg-open";
-    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url] : [url];
     const child = spawn(command, args, { detached: true, stdio: "ignore" });
     child.unref();
 }

package/dist/cli.js

@@ -176,6 +176,10 @@ Usage:
     [--confirm --approval-token TOKEN]
   recess [--json] goals edit <goal-id> --student <kid-id> --patch-file <path/patch.json>
     --delta TEXT [--confirm --approval-token TOKEN]
+  recess [--json] goals queue get <goal-id> --student <kid-id>
+  recess [--json] goals queue set <goal-id> --student <kid-id>
+    --entries-file <path.json> --delta TEXT [--replace-description-pointer]
+    [--confirm --approval-token TOKEN]
   recess [--json] todos create --student <kid-id> --title TEXT
     [--due-date YYYY-MM-DD] [--estimated-minutes N] [--url URL] [--confirm]
   recess [--json] todos edit <todo-id> --patch-file <path/patch.json>
@@ -368,6 +372,8 @@ async function writeCommand(parsed, preview, execute) {
 const GOAL_WORKSPACE_WRITE_MAX_FILES = 1_000;
 const GOAL_WORKSPACE_WRITE_MAX_TOTAL_BYTES = 20 * 1024 * 1024;
 const GOAL_PDF_UPLOAD_MAX_BYTES = 1024 * 1024 * 1024;
+const GOAL_QUEUE_MAX_ENTRIES = 500;
+const URL_QUEUE_DESCRIPTION_POINTER = "Skill queue managed by the system.";
 function approvalTokenFor(preview) {
     return createHash("sha256").update(JSON.stringify(preview)).digest("hex");
 }
@@ -693,6 +699,61 @@ async function readJsonFile(filePath, label) {
     }
     return parsed;
 }
+function parseGoalQueueEntries(value, label) {
+    if (!Array.isArray(value)) {
+        throw new CliError("invalid_arguments", `${label} must be a JSON array of queue entries.`);
+    }
+    if (value.length > GOAL_QUEUE_MAX_ENTRIES) {
+        throw new CliError("invalid_arguments", `${label} has ${value.length} entries; the maximum is ${GOAL_QUEUE_MAX_ENTRIES}.`);
+    }
+    return value.map((raw, index) => parseGoalQueueEntry(raw, `${label}[${index}]`));
+}
+function parseGoalQueueEntry(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new CliError("invalid_arguments", `${label} must be an object with title and url.`);
+    }
+    const record = value;
+    const { title, url } = record;
+    if (typeof title !== "string" || !title.trim()) {
+        throw new CliError("invalid_arguments", `${label}.title is required.`);
+    }
+    if (typeof url !== "string" || !/^https:\/\//i.test(url.trim())) {
+        throw new CliError("invalid_arguments", `${label}.url must be an https URL.`);
+    }
+    const entry = { title: title.trim(), url: url.trim() };
+    if (record.completed !== undefined) {
+        if (typeof record.completed !== "boolean") {
+            throw new CliError("invalid_arguments", `${label}.completed must be a boolean.`);
+        }
+        entry.completed = record.completed;
+    }
+    if (record.sourceMeta !== undefined) {
+        if (!record.sourceMeta ||
+            typeof record.sourceMeta !== "object" ||
+            Array.isArray(record.sourceMeta)) {
+            throw new CliError("invalid_arguments", `${label}.sourceMeta must be an object.`);
+        }
+        const meta = record.sourceMeta;
+        const sourceMeta = {};
+        for (const key of [
+            "permacode",
+            "skillId",
+            "section",
+            "subjectKey",
+            "planKey",
+        ]) {
+            const raw = meta[key];
+            if (raw === undefined)
+                continue;
+            if (typeof raw !== "string") {
+                throw new CliError("invalid_arguments", `${label}.sourceMeta.${key} must be a string.`);
+            }
+            sourceMeta[key] = raw;
+        }
+        entry.sourceMeta = sourceMeta;
+    }
+    return entry;
+}
 function contentLibrarySubmitItem(value, label) {
     const record = typeof value === "string"
         ? { url: value }
@@ -3337,7 +3398,72 @@ export async function runCommand(argv) {
                 body: patch,
             }));
         }
-        throw new CliError("invalid_arguments", "Use goals list|create|edit|files|pdf.");
+        if (verb === "queue") {
+            const subverb = positional(parsed, 2, "queue action (get|set)");
+            const goalId = positional(parsed, 3, "goal ID");
+            const studentId = flagString(parsed, "student", { required: true });
+            if (subverb === "get") {
+                return unwrap(await api.client.GET("/tutor/browser/students/goals/{goalId}/queue/", { params: { path: { goalId } } }));
+            }
+            if (subverb === "set") {
+                const entriesFile = flagString(parsed, "entries-file", {
+                    required: true,
+                });
+                const delta = flagString(parsed, "delta", { required: true });
+                const replaceDescriptionPointer = hasFlag(parsed, "replace-description-pointer");
+                const { absolutePath, parsed: rawEntries } = await readJsonValue(entriesFile, "Queue entries file");
+                const entries = parseGoalQueueEntries(rawEntries, "Queue entries file");
+                const goal = unwrap(await api.client.GET("/tutor/browser/students/{userId}/goals/", {
+                    params: { path: { userId: studentId } },
+                })).goals.find((candidate) => candidate.id === goalId);
+                if (!goal) {
+                    throw new CliError("not_found", `Goal ${goalId} was not found for student ${studentId}.`);
+                }
+                const current = unwrap(await api.client.GET("/tutor/browser/students/goals/{goalId}/queue/", { params: { path: { goalId } } }));
+                const currentUrls = new Set(current.queue.map((item) => item.url));
+                const proposedUrls = new Set(entries.map((entry) => entry.url));
+                const preview = {
+                    action: "replace a goal's URL skill queue for a managed student",
+                    target: { goalId, studentUserId: studentId },
+                    request: {
+                        entriesFile: absolutePath,
+                        entryCount: entries.length,
+                        delta,
+                        replaceDescriptionPointer,
+                        expectedUpdatedAt: goal.updatedAt,
+                    },
+                    details: {
+                        currentQueue: current.queue.map((item) => ({
+                            moduleRef: item.moduleRef,
+                            url: item.url,
+                            completedAt: item.completedAt,
+                        })),
+                        added: entries
+                            .filter((entry) => !currentUrls.has(entry.url))
+                            .map((entry) => entry.url),
+                        removed: current.queue
+                            .filter((item) => !proposedUrls.has(item.url))
+                            .map((item) => item.url),
+                        note: "Replaces the entire EXTERNAL_URL queue. Completion is preserved for unchanged URLs; WORKSPACE modules are untouched. Daily generation mints the head entry for a flag-on kid.",
+                    },
+                };
+                requirePreviewBoundConfirmation(parsed, preview);
+                const body = {
+                    delta,
+                    expectedUpdatedAt: goal.updatedAt,
+                    queue: entries,
+                    ...(replaceDescriptionPointer
+                        ? { description: URL_QUEUE_DESCRIPTION_POINTER }
+                        : {}),
+                };
+                return unwrap(await api.client.PATCH("/tutor/browser/students/goals/{goalId}/", {
+                    params: { path: { goalId } },
+                    body,
+                }));
+            }
+            throw new CliError("invalid_arguments", "Use goals queue get|set.");
+        }
+        throw new CliError("invalid_arguments", "Use goals list|create|edit|queue|files|pdf.");
     }
     if (noun === "students") {
         if (verb === "list") {

package/package.json

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