recess-cli 3.4.0 → 3.4.1

package/dist/cli.js

@@ -4259,6 +4259,7 @@ export async function executeRecessCommand(argv, options = {}) {
                 (!Number.isInteger(coinAmount) || coinAmount < 1)) {
                 throw new CliError("invalid_arguments", "--coin-amount must be a positive integer.");
             }
+            const visibility = flagString(parsed, "visibility");
             const isStarterRaw = flagString(parsed, "is-starter");
             const setupAudienceRaw = flagString(parsed, "setup-audience");
             const isStarter = isStarterRaw === undefined
@@ -4300,6 +4301,11 @@ export async function executeRecessCommand(argv, options = {}) {
                 ...(kind
                     ? { kind: assertChoice(kind, GOAL_TEMPLATE_KINDS, "--kind") }
                     : {}),
+                ...(visibility
+                    ? {
+                        visibility: assertChoice(visibility, ["PUBLIC", "PRIVATE", "STAFF_ONLY"], "--visibility"),
+                    }
+                    : {}),
                 ...(agentInstructionsFile
                     ? {
                         agentInstructions: await fs.readFile(path.resolve(agentInstructionsFile), "utf8"),
@@ -4316,7 +4322,7 @@ export async function executeRecessCommand(argv, options = {}) {
             // shape that caused the template incident; editing an existing spec goes
             // through the guarded /ai patch path with its destructive-change token.
             if (Object.keys(body).length === 1) {
-                throw new CliError("invalid_arguments", "Pass at least one field to change (--title, --description, --emoji, --image-url, --coin-amount, --category, --tags, --sort-order, --is-starter, --setup-audience, --kind, --agent-instructions-file, --output-template-file).");
+                throw new CliError("invalid_arguments", "Pass at least one field to change (--title, --description, --emoji, --image-url, --coin-amount, --category, --tags, --sort-order, --is-starter, --setup-audience, --kind, --visibility, --agent-instructions-file, --output-template-file).");
             }
             return writeCommand(parsed, {
                 action: "update goal template metadata (never its setupWorkflowSpec)",
@@ -4557,6 +4563,25 @@ export async function executeRecessCommand(argv, options = {}) {
         }
         throw new CliError("invalid_arguments", "Use goal-templates list|get|versions|validate-spec|create|patch-spec|set-metadata|generate-image|delete|snapshot-files|capture-snapshot|apply|apply-starter.");
     }
+    if (noun === "goals" && verb === "adaptations") {
+        const action = positional(parsed, 2, "goals adaptations action");
+        const studentId = flagString(parsed, "student", { required: true });
+        const goalId = flagString(parsed, "goal", { required: true });
+        if (action === "list") {
+            return unwrap(await api.client.GET("/tutor/students/{studentId}/goals/{goalId}/adaptations", { params: { path: { studentId, goalId } } }));
+        }
+        if (action === "diff") {
+            const runId = positional(parsed, 3, "adaptation run ID");
+            const path = flagString(parsed, "path");
+            return unwrap(await api.client.GET("/tutor/students/{studentId}/goals/{goalId}/adaptations/{runId}/diff", {
+                params: {
+                    path: { studentId, goalId, runId },
+                    query: path ? { path } : {},
+                },
+            }));
+        }
+        throw new CliError("invalid_arguments", "Use goals adaptations list|diff.");
+    }
     if (noun === "goals" && verb !== "files" && verb !== "pdf") {
         if (verb === "complete" || verb === "undo-completion") {
             const goalId = positional(parsed, 2, "goal ID");

package/dist/command-schema.js

@@ -165,6 +165,8 @@ const FAMILY_AI_COMMANDS = new Set([
     "goal-templates list",
     "goal-templates snapshot-files",
     "goal-templates validate-spec",
+    "goals adaptations diff",
+    "goals adaptations list",
     "goals archive",
     "goals create",
     "goals edit",

package/dist/commands/apps.js

@@ -212,7 +212,7 @@ function agentsGuide(docs) {
         "widgets.js, engine.js, key.js — a modified locked file fails validation.",
         "",
         "Before publishing, write two files at the root:",
-        "- contract.json — the BuildContract described below (copy the shape in the template contract).",
+        "- contract.json — the BuildContract: copy the example in the contract.json section below.",
         '- manifest.json — { "title": "...", "description": "...", "template": { "ccss": "5.NF.A.1", "modes": ["prepare","remediate"], "misconceptions": ["..."] } }',
         "",
         'Then: `recess apps validate --reason "..."` (reports without publishing) and',
@@ -228,6 +228,10 @@ function agentsGuide(docs) {
         "",
         "---",
         "",
+        docs.contract ?? "",
+        "",
+        "---",
+        "",
         docs.pedagogy ? `# Pedagogy\n\n${docs.pedagogy}` : "",
         "",
         "---",

package/dist/help.js

@@ -391,7 +391,7 @@ Usage:
     [--title TEXT] [--description TEXT] [--emoji X] [--category TEXT] [--tags A,B]
     [--image-url URL] [--coin-amount N] [--sort-order N] [--is-starter true|false]
     [--setup-audience KID_FRIENDLY|PARENT_SETUP] [--kind SIMPLE|BLUEPRINT]
-    [--agent-instructions-file <path>]
+    [--visibility PUBLIC|PRIVATE|STAFF_ONLY] [--agent-instructions-file <path>]
     [--output-template-file <path>] [--confirm]
   recess [--json] goal-templates delete <template-id> --expected-version N [--confirm]
   recess [--json] goal-templates generate-image <template-id|slug>
@@ -468,6 +468,9 @@ Usage:
     [--lessons-dir <dir>] [--emoji TEXT] [--grade-min N] [--grade-max N]
     [--visibility PUBLIC|STAFF] [--confirm]
   recess [--json] tutor-templates delete <slug> [--confirm]
+  recess [--json] goals adaptations list --student <goal-owner-id> --goal <goal-id>
+  recess [--json] goals adaptations diff <run-id> --student <goal-owner-id>
+    --goal <goal-id> [--path P]
   recess [--json] goals files list --student <goal-owner-id> --goal <goal-id>
   recess [--json] goals files read --student <goal-owner-id> --goal <goal-id> --path P
   recess [--json] goals files init --student <goal-owner-id> --draft <draft-slug>

package/package.json

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