@tostudy-ai/cli 0.18.2 → 0.18.4

package/dist/main.js

@@ -1021,6 +1021,14 @@ var init_errors_pt_br = __esm({
       courseArchived: "Este curso foi arquivado e est\xE1 dispon\xEDvel somente para leitura.\nUse `tostudy lesson` para revisar o conte\xFAdo j\xE1 estudado.\n",
       noActiveCourse: "Nenhum curso ativo nesta pasta.\nVeja seus cursos com `tostudy courses` e ative um com `tostudy select <n>`.\n",
       studyWorkspaceHint: "Dica: rode `tostudy select` desta pasta para us\xE1-la como workspace, ou `tostudy workspace setup` para criar em ~/study/. Depois rode `tostudy export` para gravar o exerc\xEDcio e os crit\xE9rios de valida\xE7\xE3o.\n",
+      setupCommandDescription: "Atalho antigo. A pasta de estudo \xE9 workspace setup; o MCP \xE9 setup mcp",
+      setupRetiredNotice: "\n  \u26A0\uFE0F  `tostudy setup` n\xE3o cria a pasta de estudo.",
+      setupRetiredNext: "  Pasta de estudo: `tostudy workspace setup`. MCP: `tostudy setup mcp`. Para entrar: `tostudy login`, depois `tostudy courses` e `tostudy select <n>`.\n",
+      enrollCommandDescription: "Matricula em um curso gratuito. Curso pago abre no navegador.",
+      enrollInvalidId: "Informe o ID do curso (UUID). Exemplo: tostudy enroll 11111111-1111-4111-8111-111111111111",
+      enrollDone: "Matriculado. Rode `tostudy courses` e depois `tostudy select <n>`.",
+      enrollDoneWebOnly: "Matriculado. Este curso n\xE3o abre no terminal. Continue no navegador:",
+      enrollPaid: "Este curso \xE9 pago. A matr\xEDcula fica no navegador e nada \xE9 debitado por aqui:",
       enrollmentNotEntitled: "\u{1F6AB} Sua matr\xEDcula neste curso n\xE3o est\xE1 mais ativa (reembolso, cancelamento ou preview expirado).\nPara voltar a estudar, adquira o curso novamente em https://tostudy.ai.\n",
       creator: {
         loginBrowserOnly: "`--creator` s\xF3 funciona no login pelo browser. Rode `tostudy login --creator` sem --code, --magic-link ou --manual.",
@@ -1115,6 +1123,14 @@ var init_errors_en_us = __esm({
       courseArchived: "This course has been archived and is available for reading only.\nUse `tostudy lesson` to review the content you've already studied.\n",
       noActiveCourse: "No active course in this folder.\nList your courses with `tostudy courses` and activate one with `tostudy select <n>`.\n",
       studyWorkspaceHint: "Tip: run `tostudy select` in this folder to use it as the workspace, or `tostudy workspace setup` to create one in ~/study/. Then run `tostudy export` to save the exercise and the validation criteria on this computer.\n",
+      setupCommandDescription: "Old shortcut. The study folder is workspace setup; MCP is setup mcp",
+      setupRetiredNotice: "\n  \u26A0\uFE0F  `tostudy setup` does not create the study folder.",
+      setupRetiredNext: "  Study folder: `tostudy workspace setup`. MCP: `tostudy setup mcp`. To sign in: `tostudy login`, then `tostudy courses` and `tostudy select <n>`.\n",
+      enrollCommandDescription: "Enroll in a free course. A priced course opens in the browser.",
+      enrollInvalidId: "Pass the course ID (UUID). Example: tostudy enroll 11111111-1111-4111-8111-111111111111",
+      enrollDone: "Enrolled. Run `tostudy courses`, then `tostudy select <n>`.",
+      enrollDoneWebOnly: "Enrolled. This course does not open in the terminal. Continue in the browser:",
+      enrollPaid: "This course is paid. Enrollment stays in the browser and nothing is charged here:",
       enrollmentNotEntitled: "\u{1F6AB} Your enrollment in this course is no longer active (refund, cancellation, or expired preview).\nTo study again, purchase the course at https://tostudy.ai.\n",
       creator: {
         loginBrowserOnly: "`--creator` only works with the browser login. Run `tostudy login --creator` without --code, --magic-link or --manual.",
@@ -3134,7 +3150,7 @@ var init_guards = __esm({
 });
 
 // src/cli.ts
-import { Command as Command37 } from "commander";
+import { Command as Command38 } from "commander";
 
 // src/commands/login.ts
 init_dist();
@@ -3669,6 +3685,7 @@ var logoutCommand = new Command2("logout").description("Remove token local").act
 
 // src/commands/setup.ts
 init_guards();
+init_errors();
 import { Command as Command3 } from "commander";
 
 // src/installer/mcp-setup.ts
@@ -3714,10 +3731,9 @@ var defaultDeps = {
   }
 };
 async function runSetup(_opts, deps = defaultDeps) {
-  deps.log("\n  \u26A0\uFE0F  `tostudy setup` foi incorporado ao `tostudy login`.");
-  deps.log(
-    "  Rode `tostudy login`, depois `tostudy courses` e `tostudy select <n>` para estudar no terminal.\n"
-  );
+  const errors = getErrors();
+  deps.log(errors.setupRetiredNotice);
+  deps.log(errors.setupRetiredNext);
 }
 async function runSetupMcpSubcommand() {
   console.log("\n  ToStudy MCP Setup\n  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
@@ -3730,7 +3746,7 @@ async function runSetupMcpSubcommand() {
   console.log("  \u2192 Reinicie o IDE para ativar o servidor MCP");
   console.log("  \u2192 tostudy doctor  (verificar conex\xE3o)\n");
 }
-var setupCommand = new Command3("setup").description("Configura ambiente para estudar").option("--quick", "Setup r\xE1pido (sem wizard)").option("--ide <ide>", "Configura IDE espec\xEDfica").option("--mcp", "Configura o MCP nas IDEs detectadas usando a sess\xE3o atual do CLI").action(async (opts) => {
+var setupCommand = new Command3("setup").description(getErrors().setupCommandDescription).option("--quick", "Setup r\xE1pido (sem wizard)").option("--ide <ide>", "Configura IDE espec\xEDfica").option("--mcp", "Configura o MCP nas IDEs detectadas usando a sess\xE3o atual do CLI").action(async (opts) => {
   await runSetup(opts);
 });
 setupCommand.command("mcp").description("Configura MCP server no seu IDE automaticamente").action(async () => {
@@ -3780,7 +3796,7 @@ init_workspace_state();
 init_formatter();
 
 // src/version.ts
-var CLI_VERSION = true ? "0.18.2" : "0.7.1";
+var CLI_VERSION = true ? "0.18.4" : "0.7.1";
 
 // src/update-checker.ts
 init_config_dir();
@@ -4276,9 +4292,53 @@ var coursesCommand = new Command5("courses").description("List your enrolled cou
   }
 });
 
+// src/commands/enroll.ts
+import { Command as Command6 } from "commander";
+init_guards();
+init_errors();
+init_formatter();
+var COURSE_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function formatEnrollResult(result) {
+  const copy = getErrors();
+  if (!result.enrolled) {
+    return `${copy.enrollPaid}
+${result.enrollUrl}`;
+  }
+  if (!result.cliChannel) {
+    return `${copy.enrollDoneWebOnly}
+${result.courseUrl}`;
+  }
+  return copy.enrollDone;
+}
+async function runEnroll(courseId, deps = {
+  requireSession,
+  request: ({ apiUrl, token, courseId: id }) => cliApiFetch(`${apiUrl}/api/cli/enrollments`, token, {
+    method: "POST",
+    body: JSON.stringify({ courseId: id })
+  })
+}) {
+  if (!COURSE_ID.test(courseId)) {
+    throw new Error(getErrors().enrollInvalidId);
+  }
+  const session = await deps.requireSession();
+  const result = await deps.request({
+    apiUrl: session.apiUrl,
+    token: session.token,
+    courseId
+  });
+  return formatEnrollResult(result);
+}
+var enrollCommand = new Command6("enroll").description(getErrors().enrollCommandDescription).argument("<courseId>", "Published course ID (UUID)").action(async (courseId) => {
+  try {
+    output(await runEnroll(courseId), { json: false });
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+  }
+});
+
 // src/commands/select.ts
 init_dist();
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 import os7 from "node:os";
 init_guards();
 init_workspace_marker();
@@ -4722,7 +4782,7 @@ function isInteractiveTerminal(json2) {
 
 // src/commands/select.ts
 var logger8 = createLogger("cli:select");
-var selectCommand = new Command6("select").description("Activate a course by ID or list index number").argument("<course>", "Course ID (UUID) or index number from `tostudy courses`").option("--json", "Output structured JSON").option(
+var selectCommand = new Command7("select").description("Activate a course by ID or list index number").argument("<course>", "Course ID (UUID) or index number from `tostudy courses`").option("--json", "Output structured JSON").option(
   "--root-agents",
   "Add the ToStudy block to an existing AGENTS.md in this folder without asking"
 ).action(async (course, opts) => {
@@ -4850,13 +4910,13 @@ var selectCommand = new Command6("select").description("Activate a course by ID
 
 // src/commands/progress.ts
 init_dist();
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 init_guards();
 init_course_state();
 init_formatter();
 init_errors();
 var logger9 = createLogger("cli:progress");
-var progressCommand = new Command7("progress").description("Show your progress in the active course").option("--json", "Output structured JSON").action(async (opts) => {
+var progressCommand = new Command8("progress").description("Show your progress in the active course").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -4882,7 +4942,7 @@ var progressCommand = new Command7("progress").description("Show your progress i
 
 // src/commands/start.ts
 init_dist();
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/lessons/next-lesson.ts
 async function nextLesson(input2, deps) {
@@ -4991,20 +5051,20 @@ async function runStart(opts, deps = defaultDeps3) {
     deps.error(msg);
   }
 }
-var startCommand = new Command8("start").description("Start (or resume) the current module of the active course").option("--json", "Output structured JSON").action(async (opts) => {
+var startCommand = new Command9("start").description("Start (or resume) the current module of the active course").option("--json", "Output structured JSON").action(async (opts) => {
   await runStart(opts);
 });
 
 // src/commands/start-next.ts
 init_dist();
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 init_guards();
 init_course_state();
 init_workspace_state();
 init_formatter();
 init_errors();
 var logger11 = createLogger("cli:start-next");
-var startNextCommand = new Command9("start-next").description("Transition to the next module after completing the current one").option("--json", "Output structured JSON").action(async (opts) => {
+var startNextCommand = new Command10("start-next").description("Transition to the next module after completing the current one").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -5047,14 +5107,14 @@ var startNextCommand = new Command9("start-next").description("Transition to the
 
 // src/commands/next.ts
 init_dist();
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 init_guards();
 init_course_state();
 init_workspace_state();
 init_formatter();
 init_errors();
 var logger12 = createLogger("cli:next");
-var nextCommand = new Command10("next").description("Advance to the next lesson in the active course").option("--json", "Output structured JSON").action(async (opts) => {
+var nextCommand = new Command11("next").description("Advance to the next lesson in the active course").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -5132,7 +5192,7 @@ var nextCommand = new Command10("next").description("Advance to the next lesson
 
 // src/commands/lesson.ts
 init_dist();
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 init_guards();
 init_course_state();
 init_formatter();
@@ -5190,7 +5250,7 @@ function formatLessonContent(data, workspacePath, courseTitle) {
   }
   return lines.join("\n");
 }
-var lessonCommand = new Command11("lesson").description("Show the content of the current lesson").option("--json", "Output structured JSON").option(
+var lessonCommand = new Command12("lesson").description("Show the content of the current lesson").option("--json", "Output structured JSON").option(
   "--read <lessonId>",
   "Read a specific lesson by id (works on archived / read-only courses)"
 ).action(async (opts) => {
@@ -5261,7 +5321,7 @@ var lessonCommand = new Command11("lesson").description("Show the content of the
 
 // src/commands/knowledge.ts
 init_dist();
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 init_guards();
 init_formatter();
 var logger14 = createLogger("cli:knowledge");
@@ -5281,7 +5341,7 @@ function formatKnowledge(data) {
   });
   return lines.join("\n").trimEnd();
 }
-var knowledgeCommand = new Command12("knowledge").description("Show the active course's knowledge base (base de conhecimento)").option("--json", "Output structured JSON").action(async (opts) => {
+var knowledgeCommand = new Command13("knowledge").description("Show the active course's knowledge base (base de conhecimento)").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const activeCourse = await requireActiveCourse();
     if (!activeCourse.courseId) {
@@ -5312,13 +5372,13 @@ var knowledgeCommand = new Command12("knowledge").description("Show the active c
 
 // src/commands/hint.ts
 init_dist();
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 init_guards();
 init_course_state();
 init_formatter();
 init_errors();
 var logger15 = createLogger("cli:hint");
-var hintCommand = new Command13("hint").description("Get a progressive hint for the current exercise").option("--json", "Output structured JSON").action(async (opts) => {
+var hintCommand = new Command14("hint").description("Get a progressive hint for the current exercise").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -5369,7 +5429,7 @@ var hintCommand = new Command13("hint").description("Get a progressive hint for
 init_dist();
 import fs11 from "node:fs";
 import path14 from "node:path";
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/exercises/validate-solution.ts
 async function validateSolution(input2, deps) {
@@ -19555,7 +19615,7 @@ async function clearRetryPin() {
     await updateWorkspaceState(ws.workspacePath, { retryLessonId: void 0 });
   }
 }
-var validateCommand = new Command14("validate").description("Validate your solution for the current exercise").argument("[file]", "Path to the solution file to read").option("--stdin", "Read solution from stdin instead of a file").option("--json", "Output structured JSON").action(async (file2, opts) => {
+var validateCommand = new Command15("validate").description("Validate your solution for the current exercise").argument("[file]", "Path to the solution file to read").option("--stdin", "Read solution from stdin instead of a file").option("--json", "Output structured JSON").action(async (file2, opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -19693,13 +19753,13 @@ var validateCommand = new Command14("validate").description("Validate your solut
 
 // src/commands/retry.ts
 init_dist();
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 init_guards();
 init_workspace_state();
 init_formatter();
 var logger17 = createLogger("cli:retry");
 var LESSON_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-var retryCommand = new Command15("retry").description("Revalidate a lesson you already completed (your grade keeps the best attempt)").argument("[lessonId]", "Id of the completed lesson (see: tostudy grades --course <slug> --json)").option("--clear", "Cancel the pending retry; validate goes back to the current lesson").option("--json", "Output structured JSON").action(async (lessonId, opts) => {
+var retryCommand = new Command16("retry").description("Revalidate a lesson you already completed (your grade keeps the best attempt)").argument("[lessonId]", "Id of the completed lesson (see: tostudy grades --course <slug> --json)").option("--clear", "Cancel the pending retry; validate goes back to the current lesson").option("--json", "Output structured JSON").action(async (lessonId, opts) => {
   try {
     if (opts.clear) {
       const ws2 = await findWorkspaceState();
@@ -19760,8 +19820,8 @@ var retryCommand = new Command15("retry").description("Revalidate a lesson you a
 init_session_store();
 init_workspace_state();
 init_formatter();
-import { Command as Command16 } from "commander";
-var menuCommand = new Command16("menu").description("Show available commands and current study context").action(async () => {
+import { Command as Command17 } from "commander";
+var menuCommand = new Command17("menu").description("Show available commands and current study context").action(async () => {
   const session = await getSession();
   const wsResult = session ? await findWorkspaceState() : null;
   const activeCourse = wsResult?.state ?? null;
@@ -19818,7 +19878,7 @@ var menuCommand = new Command16("menu").description("Show available commands and
 
 // src/commands/init.ts
 init_dist();
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 init_session_store();
 init_course_state();
 init_workspace_state();
@@ -20134,7 +20194,7 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
     deps.output(artifacts.learnerBrief, { json: false });
   }
 }
-var initCommand = new Command17("init").description("Generate tutor instructions and learner brief for the active course").option("--segment <segment>", "Learner segment/niche").option("--company <company>", "Company or business type").option("--products <products>", "Main products or services").option("--region <region>", "Operating region").option("--team <team>", "Team involved").option("--goal <goal>", "Primary learning goal").option("--level <level>", "Learner level: beginner, intermediate, advanced").option("--adapt-context", "Adapt examples to learner's real context").option(
+var initCommand = new Command18("init").description("Generate tutor instructions and learner brief for the active course").option("--segment <segment>", "Learner segment/niche").option("--company <company>", "Company or business type").option("--products <products>", "Main products or services").option("--region <region>", "Operating region").option("--team <team>", "Team involved").option("--goal <goal>", "Primary learning goal").option("--level <level>", "Learner level: beginner, intermediate, advanced").option("--adapt-context", "Adapt examples to learner's real context").option(
   "--root-agents",
   "Add the ToStudy block to an existing AGENTS.md in this folder without asking"
 ).option("--json", "Output structured JSON").action(async (opts) => {
@@ -20143,7 +20203,7 @@ var initCommand = new Command17("init").description("Generate tutor instructions
 
 // src/commands/workspace.ts
 init_dist();
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/workspace/setup-workspace.ts
 import fs12 from "node:fs/promises";
@@ -20434,7 +20494,7 @@ import path17 from "node:path";
 import os8 from "node:os";
 import fs14 from "node:fs/promises";
 var logger19 = createLogger("cli:workspace");
-var workspaceCommand = new Command18("workspace").description(
+var workspaceCommand = new Command19("workspace").description(
   getErrors().workspaceCommandDescription
 );
 workspaceCommand.command("setup").description(getErrors().workspaceSetupDescription).option("--path <dir>", "Diret\xF3rio base do workspace (omita para usar a pasta atual)").option("--json", "Output structured JSON").action(async (opts) => {
@@ -20602,7 +20662,7 @@ workspaceCommand.command("status").description("Mostrar status do workspace do c
 
 // src/commands/export.ts
 init_dist();
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 init_guards();
 init_course_state();
 init_resolve();
@@ -20611,7 +20671,7 @@ import path18 from "node:path";
 import os9 from "node:os";
 import fs15 from "node:fs/promises";
 var logger20 = createLogger("cli:export");
-var exportCommand = new Command19("export").description("Extrair exerc\xEDcio atual para o workspace local").option("--tier <tier>", "Tier do exerc\xEDcio: guided, semiGuided, challenging", "guided").option("--path <dir>", "Diret\xF3rio base do workspace", path18.join(os9.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+var exportCommand = new Command20("export").description("Extrair exerc\xEDcio atual para o workspace local").option("--tier <tier>", "Tier do exerc\xEDcio: guided, semiGuided, challenging", "guided").option("--path <dir>", "Diret\xF3rio base do workspace", path18.join(os9.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -20716,12 +20776,12 @@ init_guards();
 init_course_state();
 init_resolve();
 init_errors();
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 import { execFile as execFile3 } from "node:child_process";
 import path19 from "node:path";
 import os10 from "node:os";
 var logger21 = createLogger("cli:open");
-var openCommand = new Command20("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path19.join(os10.homedir(), "study")).action(async (opts) => {
+var openCommand = new Command21("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path19.join(os10.homedir(), "study")).action(async (opts) => {
   try {
     const activeCourse = await requireActiveCourse();
     const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -20756,7 +20816,7 @@ var openCommand = new Command20("open").description("Abrir workspace do curso na
 
 // src/commands/vault.ts
 init_dist();
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/vault/generate-vault-files.ts
 init_slug();
@@ -20802,7 +20862,7 @@ import path21 from "node:path";
 import os11 from "node:os";
 import fs17 from "node:fs/promises";
 var logger22 = createLogger("cli:vault");
-var vaultCommand = new Command21("vault").description("Gerenciar vault Obsidian do curso");
+var vaultCommand = new Command22("vault").description("Gerenciar vault Obsidian do curso");
 vaultCommand.command("init").description("Gerar vault Obsidian para o curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path21.join(os11.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
@@ -20975,7 +21035,7 @@ init_formatter();
 init_errors();
 import os13 from "node:os";
 import path25 from "node:path";
-import { Command as Command23 } from "commander";
+import { Command as Command24 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/validators/src/authored-course.ts
 import { createHash } from "node:crypto";
@@ -21917,7 +21977,7 @@ function installCreatorSkill(input2) {
 // src/commands/brief-open.ts
 init_guards();
 init_formatter();
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 import { execFile as execFile4 } from "node:child_process";
 import { platform } from "node:process";
 var BRIEF_URL = "https://tostudy.ai/student/settings/learner-brief";
@@ -21942,7 +22002,7 @@ function openUrl(url2, options = {}) {
     }
   });
 }
-var briefOpenCommand = new Command22("brief-open").description("Open the learner brief editor in your web browser").action(async () => {
+var briefOpenCommand = new Command23("brief-open").description("Open the learner brief editor in your web browser").action(async () => {
   await requireSession();
   output(`Abrindo ${BRIEF_URL} no navegador...`, { json: false });
   openUrl(BRIEF_URL);
@@ -21950,7 +22010,7 @@ var briefOpenCommand = new Command22("brief-open").description("Open the learner
 
 // src/commands/creator.ts
 var logger23 = createLogger("cli:creator");
-var creatorCommand = new Command23("creator").description(
+var creatorCommand = new Command24("creator").description(
   "Author a course with your own AI agent: init, validate, push, pull, audit, status, open"
 );
 function fail(err, opts, context) {
@@ -22247,8 +22307,8 @@ creatorCommand.command("open").description("Open the course in the creator porta
 init_guards();
 init_course_state();
 init_user_profile();
-import { Command as Command24 } from "commander";
-var profileCommand = new Command24("profile").description("Show your learner profile for the active course").option("--json", "Output structured JSON").action(async (opts) => {
+import { Command as Command25 } from "commander";
+var profileCommand = new Command25("profile").description("Show your learner profile for the active course").option("--json", "Output structured JSON").action(async (opts) => {
   const activeCourse = await requireActiveCourse();
   const onboarding = await getCourseOnboardingState(activeCourse.courseId);
   const profile = onboarding?.learnerProfile ?? await getUserProfile();
@@ -22310,10 +22370,10 @@ var profileCommand = new Command24("profile").description("Show your learner pro
 init_dist();
 init_guards();
 init_formatter();
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 init_workspace_state();
 var logger24 = createLogger("cli:sync");
-var syncCommand = new Command25("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").option(
+var syncCommand = new Command26("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").option(
   "--all-runtimes",
   "Write instruction files for every supported runtime, even undetected ones"
 ).option(
@@ -22385,10 +22445,10 @@ var syncCommand = new Command25("sync").description("Regenerate instruction file
 // src/commands/brief.ts
 init_dist();
 init_guards();
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 init_formatter();
 var logger25 = createLogger("cli:brief");
-var briefCommand = new Command26("brief").description("Show your base learner brief (T1) status and content").option("--json", "Output structured JSON").action(async (opts) => {
+var briefCommand = new Command27("brief").description("Show your base learner brief (T1) status and content").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const cached2 = await readBriefCache();
@@ -22429,10 +22489,10 @@ var briefCommand = new Command26("brief").description("Show your base learner br
 // src/commands/brief-create.ts
 init_dist();
 init_guards();
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 init_formatter();
 var logger26 = createLogger("cli:brief-create");
-var briefCreateCommand = new Command27("brief-create").description("Create your base learner brief via interactive prompts (T1 bootstrap)").action(async () => {
+var briefCreateCommand = new Command28("brief-create").description("Create your base learner brief via interactive prompts (T1 bootstrap)").action(async () => {
   try {
     const session = await requireSession();
     const answers = await collectBootstrapAnswers({ userName: session.userName });
@@ -22466,7 +22526,7 @@ init_dist();
 init_guards();
 init_workspace_state();
 import fs22 from "node:fs";
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 
 // src/sessions/storage.ts
 init_dist();
@@ -22515,7 +22575,7 @@ async function loadSessionContext(workspacePath) {
 // src/commands/compact.ts
 init_formatter();
 var logger28 = createLogger("cli:compact");
-var compactCommand = new Command28("compact").description("Save a module study summary (LLM-generated, from stdin)").option("--module-id <id>", "Module ID").option("--module-title <title>", "Module title").option("--json", "Output structured JSON").action(async (opts) => {
+var compactCommand = new Command29("compact").description("Save a module study summary (LLM-generated, from stdin)").option("--module-id <id>", "Module ID").option("--module-title <title>", "Module title").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const activeCourse = await requireActiveCourse();
     const ws = await findWorkspaceState();
@@ -22553,12 +22613,12 @@ var compactCommand = new Command28("compact").description("Save a module study s
 // src/commands/context.ts
 init_dist();
 init_workspace_state();
-import { Command as Command29 } from "commander";
+import { Command as Command30 } from "commander";
 init_course_state();
 init_formatter();
 init_errors();
 var logger29 = createLogger("cli:context");
-var contextCommand = new Command29("context").description("Load session context (workspace state + module summaries) for LLM consumption").option("--json", "Output structured JSON").action(async (opts) => {
+var contextCommand = new Command30("context").description("Load session context (workspace state + module summaries) for LLM consumption").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const ws = await findWorkspaceState();
     if (!ws) {
@@ -22610,13 +22670,13 @@ var contextCommand = new Command29("context").description("Load session context
 
 // src/commands/memory.ts
 init_dist();
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 init_workspace_state();
 init_guards();
 init_formatter();
 init_errors();
 var logger30 = createLogger("cli:memory");
-var memoryCommand = new Command30("memory").description("Load accumulated student memory (learning profile + recent lessons) for the tutor").option("--json", "Output structured JSON").action(async (opts) => {
+var memoryCommand = new Command31("memory").description("Load accumulated student memory (learning profile + recent lessons) for the tutor").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const ws = await findWorkspaceState();
     if (!ws) {
@@ -22647,14 +22707,14 @@ var memoryCommand = new Command30("memory").description("Load accumulated studen
 
 // src/commands/insight.ts
 init_dist();
-import { Command as Command31 } from "commander";
+import { Command as Command32 } from "commander";
 init_workspace_state();
 init_guards();
 init_formatter();
 init_errors();
 var logger31 = createLogger("cli:insight");
 var VALID_TYPES = ["difficulty", "breakthrough", "question"];
-var insightCommand = new Command31("insight").description(
+var insightCommand = new Command32("insight").description(
   "Persist a student cognitive insight (difficulty | breakthrough | question) into course memory"
 ).argument("<type>", "difficulty | breakthrough | question").argument("<content>", 'Short description, e.g. "confunde async/await com promises"').option("--module-id <id>", "Module the insight relates to").option("--json", "Output structured JSON").action(async (type, content, opts) => {
   try {
@@ -22702,7 +22762,7 @@ var insightCommand = new Command31("insight").description(
 
 // src/commands/level.ts
 init_dist();
-import { Command as Command32 } from "commander";
+import { Command as Command33 } from "commander";
 init_guards();
 init_formatter();
 var logger32 = createLogger("cli:level");
@@ -22717,7 +22777,7 @@ var LEVEL_LABELS2 = {
 function isExerciseLevel2(value) {
   return ALL_LEVELS.includes(value);
 }
-var levelCommand = new Command32("level").description("Show or set the exercise scaffolding level for the active course").argument("[level]", "Target level: L0, L1, L2, L3, or L4").option("--json", "Output structured JSON").action(async (rawLevel, opts) => {
+var levelCommand = new Command33("level").description("Show or set the exercise scaffolding level for the active course").argument("[level]", "Target level: L0, L1, L2, L3, or L4").option("--json", "Output structured JSON").action(async (rawLevel, opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -22782,10 +22842,10 @@ init_dist();
 init_guards();
 init_formatter();
 init_errors();
-import { Command as Command33 } from "commander";
+import { Command as Command34 } from "commander";
 var logger33 = createLogger("cli:theory");
 var EXERCISE_LEVELS2 = ["L0", "L1", "L2", "L3", "L4"];
-var theoryCommand = new Command33("theory").description("Request more theory on the current lesson (escape hatch)").option("--focus <text>", "Optional focus area in PT-BR (max 500 chars)").option("--level <L0|L1|L2|L3|L4>", "Override current exercise level (otherwise auto-detect)").option("--lesson <uuid>", "Override lesson ID (defaults to current workspace lesson)").option("--json", "Output structured JSON").action(async (opts) => {
+var theoryCommand = new Command34("theory").description("Request more theory on the current lesson (escape hatch)").option("--focus <text>", "Optional focus area in PT-BR (max 500 chars)").option("--level <L0|L1|L2|L3|L4>", "Override current exercise level (otherwise auto-detect)").option("--lesson <uuid>", "Override lesson ID (defaults to current workspace lesson)").option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const active = await requireActiveCourse();
@@ -22880,7 +22940,7 @@ var theoryCommand = new Command33("theory").description("Request more theory on
 // src/commands/export-grades.ts
 init_dist();
 init_guards();
-import { Command as Command34 } from "commander";
+import { Command as Command35 } from "commander";
 
 // src/formatters/grades.ts
 function formatGradesJson(attempts) {
@@ -23248,7 +23308,7 @@ async function runExportGrades(opts, deps = defaultDeps5) {
   if (!rendered.endsWith("\n")) rendered += "\n";
   deps.stdoutWrite(rendered);
 }
-var exportGradesCommand = new Command34("export-grades").description("Exporta o hist\xF3rico de valida\xE7\xF5es (notas) do curso ativo").option(
+var exportGradesCommand = new Command35("export-grades").description("Exporta o hist\xF3rico de valida\xE7\xF5es (notas) do curso ativo").option(
   "--course <slug>",
   "Slug do curso (gerado a partir do t\xEDtulo). Sem a flag, exporta o curso ativo."
 ).option("--format <json|csv|md>", "Formato de sa\xEDda (default: json)", "json").addHelpText(
@@ -23272,7 +23332,7 @@ C\xF3digos de sa\xEDda:
 
 // src/commands/grades.ts
 init_dist();
-import { Command as Command35 } from "commander";
+import { Command as Command36 } from "commander";
 init_guards();
 var logger35 = createLogger("cli:grades");
 var defaultDeps6 = {
@@ -23428,7 +23488,7 @@ async function runGrades(opts, deps = defaultDeps6) {
   );
   deps.stdoutWrite(formatGradesAllEnrollmentsTable(summaries) + "\n");
 }
-var gradesCommand = new Command35("grades").description("Mostra um resumo das notas (todas as matr\xEDculas ou um curso espec\xEDfico)").option(
+var gradesCommand = new Command36("grades").description("Mostra um resumo das notas (todas as matr\xEDculas ou um curso espec\xEDfico)").option(
   "--course <slug>",
   "Slug do curso (gerado a partir do t\xEDtulo). Sem a flag, lista todos os cursos."
 ).addHelpText(
@@ -23452,7 +23512,7 @@ C\xF3digos de sa\xEDda:
 // src/commands/review.ts
 init_dist();
 init_guards();
-import { Command as Command36 } from "commander";
+import { Command as Command37 } from "commander";
 import { createInterface } from "node:readline/promises";
 import { stdin as defaultStdin, stdout as defaultStdout } from "node:process";
 var logger36 = createLogger("cli:review");
@@ -23602,7 +23662,7 @@ async function runReview(slug, opts, deps = defaultDeps7) {
     }) + "\n"
   );
 }
-var reviewCommand = new Command36("review").description("Revisa a \xFAltima tentativa de valida\xE7\xE3o de uma li\xE7\xE3o").argument("<slug>", "Slug do curso (gerado a partir do t\xEDtulo)").option("--json", "Sa\xEDda em JSON (sem prompt interativo)").addHelpText(
+var reviewCommand = new Command37("review").description("Revisa a \xFAltima tentativa de valida\xE7\xE3o de uma li\xE7\xE3o").argument("<slug>", "Slug do curso (gerado a partir do t\xEDtulo)").option("--json", "Sa\xEDda em JSON (sem prompt interativo)").addHelpText(
   "after",
   `
 Exemplos:
@@ -23625,12 +23685,12 @@ C\xF3digos de sa\xEDda:
 
 // src/cli.ts
 function createProgram() {
-  const program = new Command37();
+  const program = new Command38();
   program.name("tostudy").description("ToStudy CLI \u2014 study courses from the terminal").version(CLI_VERSION).option("--verbose", "Enable debug output").option("--course <id>", "Override active course ID").option("--locale <code>", "Output locale (pt-BR | en-US); defaults to LANG env then pt-BR").addHelpText(
     "before",
     [
       "",
-      "  Come\xE7ando:   login \u2192 courses \u2192 select <n> \u2192 start",
+      "  Come\xE7ando:   login \u2192 enroll <id> \u2192 courses \u2192 select <n> \u2192 start",
       "  Estudando:   next \xB7 lesson \xB7 hint \xB7 validate \xB7 theory \xB7 progress",
       "  Com d\xFAvida:  tostudy menu  (mostra onde voc\xEA est\xE1 e o que fazer)",
       ""
@@ -23642,6 +23702,7 @@ function createProgram() {
   program.addCommand(loginCommand);
   program.addCommand(logoutCommand);
   program.addCommand(coursesCommand);
+  program.addCommand(enrollCommand);
   program.addCommand(selectCommand);
   program.addCommand(progressCommand);
   program.addCommand(startCommand);