recess-cli 2.8.0 → 2.10.0

package/dist/cli.js

@@ -9,6 +9,7 @@ import { clearStoredSession, deleteProfile, listProfiles, resolveConfig, savePro
 import { agentContext, buildCommandSchema, findCommandSchema, remoteCommands, scopedHelp, validateInvocation, } from "./command-schema.js";
 import { runApplicationsCommand } from "./commands/applications.js";
 import { runAppsCommand } from "./commands/apps.js";
+import { runChatLogsCommand } from "./commands/chat-logs.js";
 import { runMasteryCommand } from "./commands/mastery.js";
 import { runOnboardingCommand } from "./commands/onboarding.js";
 import { runSchoolCommand } from "./commands/school.js";
@@ -4400,6 +4401,9 @@ export async function executeRecessCommand(argv, options = {}) {
         }
         throw new CliError("invalid_arguments", "Use goals list|create|edit|delete|restore|archive|unarchive|complete|undo-completion|queue|files|pdf.");
     }
+    if (noun === "chat-logs") {
+        return runChatLogsCommand({ parsed, api, writeCommand });
+    }
     if (noun === "students") {
         if (verb === "list") {
             const requestedScope = flagString(parsed, "scope");

package/dist/command-schema.js

@@ -138,6 +138,9 @@ const AUTHENTICATED_COMMAND_PREFIXES = [
     "village render",
 ];
 const FAMILY_AI_COMMANDS = new Set([
+    "chat-logs by-todo",
+    "chat-logs get",
+    "chat-logs list",
     "content-library search",
     "goal-templates apply",
     "goal-templates apply-starter",

package/dist/commands/chat-logs.js

@@ -0,0 +1,43 @@
+import { unwrap } from "../api.js";
+import { flagNumber, flagString } from "../args.js";
+import { CliError } from "../errors.js";
+import { positional } from "./shared.js";
+export async function runChatLogsCommand({ parsed, api, }) {
+    const verb = parsed.positionals[1];
+    if (verb === "list") {
+        const limit = flagNumber(parsed, "limit");
+        if (limit !== undefined &&
+            (!Number.isInteger(limit) || limit < 1 || limit > 500)) {
+            throw new CliError("invalid_arguments", "--limit must be an integer from 1 to 500.");
+        }
+        return unwrap(await api.client.GET("/ai/chat-logs", {
+            params: {
+                query: {
+                    studentId: flagString(parsed, "student", { required: true }),
+                    limit,
+                    cursor: flagString(parsed, "cursor"),
+                },
+            },
+        }));
+    }
+    const query = verb === "get"
+        ? { conversationId: positional(parsed, 2, "conversation ID") }
+        : { todoId: positional(parsed, 2, "todo ID") };
+    const messages = [];
+    let cursor;
+    const seenCursors = new Set();
+    do {
+        const page = unwrap(await api.client.GET("/ai/chat-logs/messages", {
+            params: { query: { ...query, limit: 500, cursor } },
+        }));
+        messages.push(...page.messages);
+        if (!page.nextCursor)
+            return { ...page, messages, complete: true };
+        if (seenCursors.has(page.nextCursor)) {
+            throw new CliError("pagination_error", "Chat-log pagination did not advance; no complete download was produced.");
+        }
+        seenCursors.add(page.nextCursor);
+        cursor = page.nextCursor;
+    } while (cursor);
+}
+//# sourceMappingURL=chat-logs.js.map

package/dist/commands/mastery.js

@@ -10,6 +10,18 @@ const hash = (value) => createHash("sha256").update(JSON.stringify(value)).diges
 async function executeApproved(api, preview) {
     const body = preview.request;
     switch (preview.action) {
+        case "mastery.delete-draft":
+            return unwrap(await api.client.DELETE("/ai/rcs/drafts/{id}", {
+                params: {
+                    path: { id: String(preview.target.id) },
+                    query: { expectedUpdatedAt: String(body.expectedUpdatedAt) },
+                },
+            }));
+        case "mastery.archive":
+            return unwrap(await api.client.POST("/ai/rcs/releases/{id}/archive", {
+                params: { path: { id: String(preview.target.id) } },
+                body: body,
+            }));
         case "mastery.link":
             return unwrap(await api.client.POST("/ai/rcs/content-links", {
                 body: body,
@@ -41,7 +53,14 @@ export async function runMasteryCommand({ parsed, api, writeCommand: gate, }) {
     if (session.user.role !== "ADMIN" || session.cliScope !== "full_admin")
         throw new CliError("forbidden", "Mastery curriculum commands require a full-admin session.");
     const verb = parsed.positionals[1];
-    const isWrite = ["edit", "publish", "link", "unlink"].includes(verb ?? "");
+    const isWrite = [
+        "edit",
+        "publish",
+        "link",
+        "unlink",
+        "delete-draft",
+        "archive",
+    ].includes(verb ?? "");
     const file = isWrite ? flagString(parsed, "file") : undefined;
     const invocation = hash({
         actorId: session.user.id,
@@ -68,6 +87,27 @@ export async function runMasteryCommand({ parsed, api, writeCommand: gate, }) {
             params: { query: { domainSlug: flagString(parsed, "domain") } },
         }));
     }
+    if (verb === "delete-draft" || verb === "archive") {
+        const id = positional(parsed, 2, verb === "archive" ? "release ID" : "draft ID");
+        const kind = verb === "archive" ? "release" : "draft";
+        const impact = unwrap(await api.client.GET("/ai/rcs/graphs/removal-preview", {
+            params: { query: { id, kind } },
+        }));
+        const preview = {
+            action: `mastery.${verb}`,
+            target: { id, kind, title: impact.title, domainSlug: impact.domainSlug },
+            request: verb === "archive"
+                ? { expectedPublishedAt: impact.revision }
+                : { expectedUpdatedAt: impact.revision },
+            details: {
+                ...impact,
+                consequence: verb === "archive"
+                    ? "Archives this exact release (DEPRECATED). Removes it from active graph selection and new diagnostics; keeps the graph, learner history, content links, and already-issued work. Does not activate a replacement or disable the whole subject."
+                    : "Permanently deletes this unpublished draft and its completed assembly parts. Cannot be undone. Does not delete any published graph, learner evidence, applet, or goal.",
+            },
+        };
+        return writeCommand(parsed, preview, () => executeApproved(api, preview));
+    }
     if (verb === "get" || verb === "edit" || verb === "publish") {
         const id = positional(parsed, 2, "graph artifact ID");
         const kind = verb === "publish"

package/dist/help.js

@@ -6,6 +6,8 @@ Usage:
   recess [--json] mastery edit <graph-id> [--kind seed|draft|release]
     [--file <graph.json> | --instruction TEXT] [--node <node-id>] [--confirm]
   recess [--json] mastery publish <draft-id> --expected-active-release <release-id-or-none> [--confirm]
+  recess [--json] mastery delete-draft <draft-id> [--confirm]
+  recess [--json] mastery archive <release-id> [--confirm]
   recess [--json] mastery links --graph <release-id> [--node <node-id>] [--cursor <link-id>]
   recess [--json] mastery link <content-id> --type applet|goal --graph <release-id>
     [--node <node-id>] [--confirm]
@@ -49,6 +51,9 @@ Usage:
     --first-name TEXT [--last-name TEXT] [--no-invite] [--confirm]
   recess [--json] students upload-map-scores --student <kid-id>
     --file </path/to/map-report.pdf> [--confirm]
+  recess [--json] chat-logs list --student <user-id> [--limit 100] [--cursor <cursor>]
+  recess [--json] chat-logs get <conversation-id>
+  recess [--json] chat-logs by-todo <todo-id>
   recess [--json] students list [--scope mine|family]
   recess [--json] students today --student <kid-id> [--date YYYY-MM-DD]
   recess [--json] students schedule --student <kid-id> [--days 14]

package/package.json

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