recess-cli 2.6.1 → 2.8.0

package/dist/commands/village-events.js

@@ -2,6 +2,7 @@ import { unwrap } from "../api.js";
 import { flagString, hasFlag } from "../args.js";
 import { apiError, CliError } from "../errors.js";
 const NONE = "—";
+const WEEKDAYS = ["MO", "TU", "WE", "TH", "FR", "SA", "SU"];
 async function fetchTemplatesAndRooms(ctx) {
     const [templatesResponse, rooms] = await Promise.all([
         ctx.api.client.GET("/recess/event-templates-editable/"),
@@ -17,6 +18,17 @@ function schedule(template) {
         return template.singleEventDate.slice(0, 10);
     return template.rrule || NONE;
 }
+function templateDays(template) {
+    if (template.singleEventDate)
+        return null;
+    const match = /BYDAY=([A-Z,]+)/.exec(template.rrule);
+    if (!match)
+        return null;
+    const days = match[1]
+        .split(",")
+        .filter((day) => WEEKDAYS.includes(day));
+    return days.length > 0 ? days : null;
+}
 function renderColumns(rows) {
     const widths = rows[0].map((_, column) => Math.max(...rows.map((row) => row[column].length)));
     return rows
@@ -45,7 +57,7 @@ async function listEvents(ctx) {
         };
     });
     const unlinkedRooms = rooms
-        .filter((room) => !room.linkedTemplateId)
+        .filter((room) => room.bookings.length === 0)
         .map((room) => ({ id: room.id, name: room.name }));
     if (hasFlag(ctx.parsed, "json")) {
         return { templates: templateRows, unlinkedRooms };
@@ -97,14 +109,22 @@ async function linkEvent(ctx) {
         throw new CliError("not_found", `No editable event template found for ${templateId}. Run \`recess village events\` to list them.`);
     }
     let room;
+    let informationalBookings = [];
     if (roomId) {
         room = rooms.find((row) => row.id === roomId);
         if (!room) {
             throw new CliError("not_found", `No Village Town Center zone found for ${roomId}. Run \`recess village events\` to list linkable zones.`);
         }
-        if (room.linkedTemplateId && room.linkedTemplateId !== templateId) {
-            throw new CliError("invalid_arguments", `Zone ${room.id} (${room.name}) is already linked to template ${room.linkedTemplateId} (${room.linkedTemplateName ?? "unnamed"}). Unlink that template first.`);
+        const otherBookings = room.bookings.filter((booking) => booking.templateId !== templateId);
+        const days = templateDays(template);
+        const conflict = days
+            ? otherBookings.find((booking) => booking.days.some((day) => days.includes(day)))
+            : undefined;
+        if (conflict) {
+            throw new CliError("invalid_arguments", `Zone ${room.id} (${room.name}) is already linked to template ${conflict.templateId} (${conflict.name}). Unlink that template first.`);
         }
+        if (!days)
+            informationalBookings = otherBookings;
     }
     const previousRoom = template.villageRoomId
         ? rooms.find((row) => row.id === template.villageRoomId)
@@ -123,6 +143,9 @@ async function linkEvent(ctx) {
             currentVillageRoomId: template.villageRoomId,
         },
         request: body,
+        ...(informationalBookings.length > 0 && {
+            details: { bookings: informationalBookings },
+        }),
     }, async () => {
         const result = await api.client.PATCH("/recess/event-templates/{id}/", {
             params: { path: { id: template.id } },

package/dist/engine.js

@@ -0,0 +1,6 @@
+export { executeRecessCommand, } from "./cli.js";
+export { buildCommandSchema, findCommandSchema, RECESS_MCP_SCOPES, } from "./command-schema.js";
+export { RecessAdminApi } from "./api.js";
+export { CliError } from "./errors.js";
+export { APP_BUNDLE_EDITABLE_FILES } from "./commands/apps.js";
+//# sourceMappingURL=engine.js.map

package/dist/errors.js

@@ -10,9 +10,18 @@ export class CliError extends Error {
     }
 }
 export function apiError(status, body) {
-    const message = typeof body === "object" && body && "message" in body
-        ? String(body.message)
-        : `Recess API request failed with status ${status}`;
-    return new CliError("api_error", message, 1, { status, body });
+    const message = typeof body === "object" && body && "error" in body
+        ? String(body.error)
+        : typeof body === "object" && body && "message" in body
+            ? String(body.message)
+            : `Recess API request failed with status ${status}`;
+    const code = status === 404
+        ? "not_found"
+        : status === 409
+            ? "conflict"
+            : status === 403
+                ? "forbidden"
+                : "api_error";
+    return new CliError(code, message, 1, { status, body });
 }
 //# sourceMappingURL=errors.js.map

package/dist/help.js

@@ -1,7 +1,17 @@
 export const HELP = `recess — safe Recess administration and family AI tools
 
 Usage:
+  recess [--json] mastery graphs [--domain <slug>]
+  recess [--json] mastery get <graph-id> [--kind seed|draft|release]
+  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 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]
+  recess [--json] mastery unlink <link-id> [--confirm]
   recess [--json] --version
+  recess [--json] help [noun] [verb]
   recess [--json] agent-context
   recess [--json] setup [--skill-only]
   recess [--json] doctor
@@ -39,10 +49,11 @@ 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] students list
+  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]
-  recess [--json] students todos --student <kid-id> [--limit 30] [--analyzed]
+  recess [--json] students todos --student <id-or-name> [--date <today-or-YYYY-MM-DD>]
+    [--limit 30] [--cursor <todo-id>] [--analyzed]
   recess [--json] students analysis --todo <todo-id>
   recess [--json] students xp-history --student <kid-id>
     [--range week|month|quarter|year]
@@ -55,6 +66,7 @@ Usage:
     --method refund|credit|tokens [--full | --amount-cents N]
     [--who-pays guide|recess] [--reason TEXT] [--confirm]
   recess [--json] apps init <dir> [--for-todo <todo-id>] [--force]
+  recess [--json] apps scaffold [--for-todo <todo-id>]
   recess [--json] apps preview [dir] [--port N]
   recess [--json] apps primitives list
   recess [--json] apps primitives publish <file.js> --name <kebab-name> [--description TEXT]
@@ -301,12 +313,12 @@ Usage:
     --status ACTIVE|INACTIVE|COMING_SOON [--confirm]
   recess [--json] content-library search <query> [--limit 8]
   recess [--json] content-library status <gem-id-or-url>
-  recess [--json] content-library set-stage <gem-id-or-url...> [--file <path>]
+  recess [--json] content-library set-stage [<gem-id-or-url>...] [--file <path>]
     --stage review|polishing|live|archived [--wait] [--timeout 900] [--confirm]
-  recess [--json] content-library submit <url...> [--file <path>]
+  recess [--json] content-library submit [<url>...] [--file <path>]
     [--stage review|polish] [--title TEXT] [--summary TEXT]
-    [--lane web-toys|mechanics|explorables|data-stories|sims|maps-scale|sound-art|puzzles|wonder|idea-games]
-    [--wait] [--timeout 900] [--confirm]
+    [--lane web-toys|mechanics|explorables|data-stories|sims|maps-scale|sound-art|puzzles|wonder|idea-games|makers|drills]
+    [--allow-possible-duplicate] [--wait] [--timeout 900] [--confirm]
   recess [--json] skills guardian list [--query TEXT] [--category TEXT]
   recess [--json] skills guardian get <skill-name>
     [--reference NAME | --all-references] [--refresh]
@@ -353,6 +365,8 @@ Usage:
     --delta TEXT [--confirm --approval-token TOKEN]
   recess [--json] goals delete <goal-id> --student <kid-id>
     [--confirm --approval-token TOKEN]
+  recess [--json] goals restore <goal-id> --student <kid-id>
+    [--confirm --approval-token TOKEN]
   recess [--json] goals complete <goal-id> [--confirm]
   recess [--json] goals undo-completion <goal-id> [--confirm]
   recess [--json] goals archive <goal-id> --student <kid-id>
@@ -371,6 +385,9 @@ Usage:
     [--confirm --approval-token TOKEN]
   recess [--json] todos delete <todo-id>
     [--confirm --approval-token TOKEN]
+  recess [--json] todos restore <todo-id>
+    [--confirm --approval-token TOKEN]
+  recess [--json] todos generate-learning-analysis <todo-id> [--confirm]
   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>

package/dist/upload-names.js

@@ -0,0 +1,19 @@
+// A mirror of `apps/web-server/src/services/os-v2/upload-names.ts` — the one
+// rule for what a goal workspace stores an upload under (PROD-983). Read that
+// module for why the rule is what it is; change it there first, then here.
+//
+// A copy, not an import, because `recess-cli` is published to npm from this
+// directory's own `tsc` output and every workspace package it could import the
+// rule from is private, so a `workspace:*` dependency would leave
+// `npm i -g recess-cli` unable to resolve it. `skills-cache.ts` and
+// `skill-update.ts` mirror web-server code for the same reason.
+/**
+ * The name a workspace stores an upload under: safe for a Mesa path, stable,
+ * idempotent, and total — never empty, never `.` or `..`, never a path
+ * separator, never a dotfile.
+ */
+export function sanitizeWorkspaceUploadName(original) {
+    const cleaned = original.replace(/^\.+/, "").replace(/[^a-zA-Z0-9._-]/g, "_");
+    return cleaned || "file";
+}
+//# sourceMappingURL=upload-names.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recess-cli",
-  "version": "2.6.1",
+  "version": "2.8.0",
   "description": "Safe Recess administration and family AI tools from the command line.",
   "license": "UNLICENSED",
   "repository": {
@@ -9,6 +9,13 @@
     "directory": "apps/admin-cli"
   },
   "type": "module",
+  "exports": {
+    "./engine": {
+      "development": "./src/engine.ts",
+      "types": "./src/engine.ts",
+      "default": "./dist/engine.js"
+    }
+  },
   "bin": {
     "recess": "dist/index.js"
   },

package/skill/recess-cli/SKILL.md

@@ -50,7 +50,7 @@ Never print or paste session cookies, device codes, or config-file contents.
 
 ## Agent contract
 
-Always pass `--json`. Stdout contains one object:
+With the local binary, always pass `--json`. Stdout contains one object:
 
 - Success: `{"ok":true,"data":{...}}`, exit 0.
 - Failure: `{"ok":false,"error":{"code":"...","message":"...","details":{...}}}`, exit 1.
@@ -70,6 +70,21 @@ Every write is two-step:
 
 Any changed target, payload, local file, server revision, amount, recipient, or consequence requires a new preview and new approval. Never infer approval from the original request. If a confirmed invocation is interrupted, retry the unchanged command with the same operation key; never mint a new one for an uncertain write. Inspect recovery state with `recess --json jobs get <operation-key>`.
 
+### Hosted MCP transport
+
+When this skill is reached through the hosted Recess connector, use its only tool,
+`recess_exec({argv,input?})`. `argv` starts with the command noun, omits both `recess` and `--json`,
+and still carries `--reason`. The CLI envelope is returned in MCP `structuredContent`; a
+`confirmation_required` envelope is expected control flow, while other failures are tool errors.
+Start with `argv:["agent-context"]` or `argv:["help","apps"]` for the remote-only catalog. OAuth
+already supplies the live user and scopes: never ask for cookies, profiles, local paths, or
+`--deliver`.
+
+Hosted writes stage the exact argv and structured payload on the server. Preview without
+`--confirm`, show the human `error.details.preview`, then confirm with the same command path plus
+`--confirm --operation-key <key>` and **omit `input`**. The server executes the stored bytes; changed
+source, flags, project/version, or operation keys require a fresh preview.
+
 ## Building Studio apps (`recess apps`)
 
 Guides build Recess Studio apps in their own editor and publish them with the CLI; Studio never
@@ -91,6 +106,21 @@ prompts a model for them.
 - `recess --json apps standards "<words or notation>"` finds the CCSS standard for `manifest.json`
   (`"grade 4 adding fractions"` → `4.NF.B.3a`…); guides rarely know the codes, look them up.
 
+Hosted authoring keeps those same contracts but carries no folder:
+
+- `apps scaffold [--for-todo <id>]` returns authoring instructions, the five editable starter
+  files, fork guidance, and an optional learner brief. It performs no write.
+- Generate `input.appBundle` with exactly `skill.js`, `model.js`, `model.css`,
+  `params.schema.json`, and `params.json`, plus `contract` and `manifest`. Preview and confirm
+  `apps validate`; keep the returned project/version/build IDs and poll `apps status <build-id>`.
+- Fix findings in the bundle. For an existing project, first `apps pull <project-id>` and preserve
+  its `baseVersion`; a stale version is a conflict, never an overwrite.
+- `apps preview <project-id> --version <n>` returns the short-lived capability URL.
+  Preview/confirm `apps publish <project-id> --version <n>`, then poll its build. Publication sends
+  no source and reviews exactly that validated version.
+- After publication, preview/confirm `apps assign <project-id> --student <id> [--due YYYY-MM-DD]`.
+  Assignment is intentionally separate from hosted publish.
+
 Two ways in. If the guide names a kid or a todo, pull the analysis first and build against it;
 otherwise build from their description:
 

package/skill/recess-cli/agents/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "2.5.0",
-  "minCliVersion": "2.4.0"
+  "version": "2.6.0",
+  "minCliVersion": "2.6.1"
 }