@tostudy-ai/cli 0.17.4 → 0.17.6

package/dist/cli.js

@@ -1496,6 +1496,11 @@ var init_slug = __esm({
 function resolveWorkspaceTokensInText(text, paths) {
   return text.replace(WORKSPACE_TOKEN, () => paths.workspace).replace(VAULT_TOKEN, () => paths.vault);
 }
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
 function resolveWorkspaceTokens(value, paths) {
   if (typeof value === "string") {
     return resolveWorkspaceTokensInText(value, paths);
@@ -1503,7 +1508,7 @@ function resolveWorkspaceTokens(value, paths) {
   if (Array.isArray(value)) {
     return value.map((item) => resolveWorkspaceTokens(item, paths));
   }
-  if (value !== null && typeof value === "object") {
+  if (isPlainObject(value)) {
     const out = {};
     for (const [key, item] of Object.entries(value)) {
       out[key] = resolveWorkspaceTokens(item, paths);
@@ -2281,12 +2286,15 @@ var runtime_registry_exports = {};
 __export(runtime_registry_exports, {
   RUNTIMES: () => RUNTIMES,
   detectedSlashHints: () => detectedSlashHints,
+  isTrackedByGit: () => isTrackedByGit,
   needsRootAgentsConsent: () => needsRootAgentsConsent,
-  upsertRootAgentsBlock: () => upsertRootAgentsBlock
+  parseTemplateVersion: () => parseTemplateVersion,
+  upsertRootAgentsBlock: () => upsertRootAgentsBlock,
+  writeProjectUniversalCommand: () => writeProjectUniversalCommand
 });
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join2 } from "node:path";
+import { dirname, join as join2 } from "node:path";
 function hasBinary(name) {
   try {
     execFileSync2("which", [name], { encoding: "utf-8", stdio: "pipe" });
@@ -2299,6 +2307,42 @@ function writeFile2(absDir, fileName, body) {
   mkdirSync2(absDir, { recursive: true });
   writeFileSync2(join2(absDir, fileName), body);
 }
+function parseTemplateVersion(text) {
+  const match = text.match(/tostudy-template-version:\s*(\d+)/);
+  if (!match || !match[1]) return null;
+  const val = Number.parseInt(match[1], 10);
+  return Number.isNaN(val) ? null : val;
+}
+function isTrackedByGit(cwd, relativePath) {
+  try {
+    execFileSync2("git", ["ls-files", "--error-unmatch", "--", relativePath], {
+      cwd,
+      stdio: "pipe"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function writeProjectUniversalCommand(cwd, relativePath, body, onKept) {
+  const absPath = join2(cwd, relativePath);
+  if (!existsSync2(absPath)) {
+    mkdirSync2(dirname(absPath), { recursive: true });
+    writeFileSync2(absPath, body);
+    return [relativePath];
+  }
+  const existing = readFileSync(absPath, "utf-8");
+  if (existing === body) {
+    return [relativePath];
+  }
+  const version2 = parseTemplateVersion(existing);
+  if (!isTrackedByGit(cwd, relativePath) && version2 !== null && version2 < UNIVERSAL_TEMPLATE_VERSION) {
+    writeFileSync2(absPath, body);
+    return [relativePath];
+  }
+  onKept?.(relativePath, version2, UNIVERSAL_TEMPLATE_VERSION);
+  return [];
+}
 function cursorMdc(title, content) {
   return `---
 description: ${title} \u2014 ToStudy Course Guide
@@ -2380,6 +2424,7 @@ var init_runtime_registry = __esm({
     "use strict";
     init_dist();
     init_slug();
+    init_instruction_template_v3();
     logger2 = createLogger("cli:runtime-registry");
     detectOpencode = (home) => existsSync2(join2(home, ".opencode")) || existsSync2(join2(home, ".config", "opencode"));
     detectGrok = (home) => existsSync2(join2(home, ".grok")) || hasBinary("grok");
@@ -2393,9 +2438,8 @@ var init_runtime_registry = __esm({
           writeFile2(join2(cwd, ".claude", "commands"), `tostudy-${slug}.md`, content);
           return [`.claude/commands/tostudy-${slug}.md`];
         },
-        writeUniversal({ cwd, content }) {
-          writeFile2(join2(cwd, ".claude", "commands"), "tostudy.md", content);
-          return [".claude/commands/tostudy.md"];
+        writeUniversal({ cwd, content, onKept }) {
+          return writeProjectUniversalCommand(cwd, ".claude/commands/tostudy.md", content, onKept);
         },
         slashHint: (slug) => `No Claude Code, digite: /tostudy-${slug}`
       },
@@ -2412,9 +2456,13 @@ var init_runtime_registry = __esm({
           );
           return [`.cursor/rules/tostudy-${slug}.mdc`];
         },
-        writeUniversal({ cwd, content }) {
-          writeFile2(join2(cwd, ".cursor", "rules"), "tostudy.mdc", cursorMdc("ToStudy", content));
-          return [".cursor/rules/tostudy.mdc"];
+        writeUniversal({ cwd, content, onKept }) {
+          return writeProjectUniversalCommand(
+            cwd,
+            ".cursor/rules/tostudy.mdc",
+            cursorMdc("ToStudy", content),
+            onKept
+          );
         }
       },
       {
@@ -2488,17 +2536,17 @@ ${content}`;
           );
           return [`.agents/skills/tostudy-${slug}/SKILL.md`];
         },
-        writeUniversal({ cwd, content }) {
-          writeFile2(
-            join2(cwd, ".agents", "skills", "tostudy"),
-            "SKILL.md",
+        writeUniversal({ cwd, content, onKept }) {
+          return writeProjectUniversalCommand(
+            cwd,
+            ".agents/skills/tostudy/SKILL.md",
             antigravitySkillMd(
               "tostudy",
               "ToStudy \u2014 AI Tutor Guide. Use when the student asks to study or runs tostudy commands.",
               content
-            )
+            ),
+            onKept
           );
-          return [".agents/skills/tostudy/SKILL.md"];
         },
         slashHint: (slug) => `No Antigravity, a skill tostudy-${slug} ativa automaticamente`
       },
@@ -2515,9 +2563,8 @@ ${content}`;
           if (rootAgents) written.push(rootAgents);
           return written;
         },
-        writeUniversal({ cwd, content }) {
-          writeFile2(join2(cwd, ".tostudy"), "AGENTS.md", content);
-          return [".tostudy/AGENTS.md"];
+        writeUniversal({ cwd, content, onKept }) {
+          return writeProjectUniversalCommand(cwd, ".tostudy/AGENTS.md", content, onKept);
         }
       }
     ];
@@ -2532,6 +2579,7 @@ var instruction_files_exports = {};
 __export(instruction_files_exports, {
   installUniversalCommand: () => installUniversalCommand,
   needsRootAgentsConsent: () => needsRootAgentsConsent,
+  parseTemplateVersion: () => parseTemplateVersion,
   slugify: () => slugify,
   upsertRootAgentsBlock: () => upsertRootAgentsBlock,
   writeInstructionFiles: () => writeInstructionFiles
@@ -2548,11 +2596,11 @@ function writeInstructionFiles(cwd, ctx, content, opts = {}) {
   logger3.info("Generated instruction files (v3)", { slug, files: written });
   return written;
 }
-function installUniversalCommand(platform2, cwd = process.cwd(), homeDir = homedir()) {
+function installUniversalCommand(platform2, cwd = process.cwd(), homeDir = homedir(), onKept) {
   const entry = RUNTIMES.find((r) => r.id === platform2);
   if (!entry?.writeUniversal) return [];
   const content = renderUniversalInstruction();
-  const written = entry.writeUniversal({ cwd, home: homeDir, content });
+  const written = entry.writeUniversal({ cwd, home: homeDir, content, onKept });
   logger3.info("Installed universal /tostudy command", { platform: platform2, files: written });
   return written;
 }
@@ -2744,9 +2792,13 @@ var init_login = __esm({
           }
           const cwd = process.cwd();
           const home = homedir2();
+          const keptFiles = [];
+          const onKept = (file2, foundVersion, availableVersion) => {
+            keptFiles.push({ file: file2, foundVersion, availableVersion });
+          };
           for (const runtime of RUNTIMES2) {
             if (runtime.writeUniversal && runtime.detect(home, cwd)) {
-              installedFiles.push(...installUniversalCommand2(runtime.id, cwd));
+              installedFiles.push(...installUniversalCommand2(runtime.id, cwd, home, onKept));
             }
           }
           if (installedFiles.length > 0) {
@@ -2755,6 +2807,16 @@ var init_login = __esm({
               console.log(`  \u2713 Instalado: ${file2}`);
             }
           }
+          if (keptFiles.length > 0) {
+            if (installedFiles.length === 0) {
+              console.log("");
+            }
+            for (const { file: file2, foundVersion, availableVersion } of keptFiles) {
+              console.log(
+                `  \u26A0 Mantido: ${file2} (template v${foundVersion ?? "?"} -> v${availableVersion} dispon\xEDvel -- apague o arquivo e rode tostudy login para atualizar)`
+              );
+            }
+          }
         } catch {
         }
         try {
@@ -2866,6 +2928,7 @@ var init_errors_pt_br = __esm({
       workspaceCommandDescription: "Gerenciar workspace de estudo local",
       workspaceSetupDescription: "Criar estrutura do workspace para o curso ativo",
       insufficientCredits: "\u274C Voc\xEA est\xE1 sem cr\xE9ditos. Cada resposta do tutor de IA consome cr\xE9ditos para cobrir o processamento. Recarregue em https://tostudy.ai/student/credits para continuar de onde parou.\n",
+      dailyAiLimit: "\u274C Voc\xEA atingiu o teto di\xE1rio de gastos com IA da sua conta. N\xE3o \xE9 falta de cr\xE9ditos: o teto reinicia \xE0 meia-noite (UTC). Para um teto maior, fa\xE7a upgrade do plano em https://tostudy.ai/student/plan.\n",
       workspaceRefusedAtHome: "N\xE3o d\xE1 para configurar o estudo direto na sua pasta pessoal.\nCrie uma pasta para o curso e entre nela antes de continuar:\n\n  mkdir ~/meus-cursos && cd ~/meus-cursos\n",
       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",
@@ -2888,6 +2951,7 @@ var init_errors_en_us = __esm({
       workspaceCommandDescription: "Manage local study workspace",
       workspaceSetupDescription: "Create the workspace structure for the active course",
       insufficientCredits: "\u274C You're out of credits. Every reply from the AI tutor uses credits to cover processing. Top up at https://tostudy.ai/student/credits to continue from where you stopped.\n",
+      dailyAiLimit: "\u274C You have reached your account's daily AI spending limit. This is not an empty wallet: the limit resets at midnight (UTC). For a higher limit, upgrade your plan at https://tostudy.ai/student/plan.\n",
       workspaceRefusedAtHome: "Study can't be set up directly in your home folder.\nCreate a folder for the course and switch into it first:\n\n  mkdir ~/my-courses && cd ~/my-courses\n",
       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",
@@ -2934,6 +2998,9 @@ function resolveErrorCode(err) {
 function isInsufficientCreditsError(err) {
   return resolveErrorCode(err).includes("INSUFFICIENT_CREDITS");
 }
+function isDailyAiLimitError(err) {
+  return resolveErrorCode(err).includes("DAILY_AI_COST_LIMIT_EXCEEDED");
+}
 function isCourseArchivedError(err) {
   return resolveErrorCode(err).includes("COURSE_ARCHIVED");
 }
@@ -3531,7 +3598,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.17.3" : "0.7.1";
+    CLI_VERSION = true ? "0.17.6" : "0.7.1";
   }
 });
 
@@ -3697,6 +3764,26 @@ var init_cache2 = __esm({
 
 // src/commands/doctor.ts
 import { Command as Command4 } from "commander";
+async function verifyToken(session, fetchImpl = fetch) {
+  try {
+    const res = await fetchImpl(`${session.apiUrl}/api/cli/courses`, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${session.token}`
+      },
+      signal: AbortSignal.timeout(5e3)
+    });
+    if (res.ok) {
+      return "valid";
+    }
+    if (res.status === 401 || res.status === 403) {
+      return "rejected";
+    }
+    return "unverified";
+  } catch {
+    return "unverified";
+  }
+}
 var doctorCommand;
 var init_doctor = __esm({
   "src/commands/doctor.ts"() {
@@ -3739,10 +3826,22 @@ var init_doctor = __esm({
         session = await getSession();
       } catch {
       }
+      let serverVerdict = null;
+      if (session) {
+        if (session.expiresAt && new Date(session.expiresAt) < /* @__PURE__ */ new Date()) {
+          serverVerdict = "expired";
+        } else {
+          serverVerdict = await verifyToken({
+            apiUrl: session.apiUrl ?? "https://tostudy.ai",
+            token: session.token
+          });
+        }
+      }
       checks["auth"] = {
         loggedIn: !!session,
         userName: session?.userName ?? null,
-        expiresAt: session?.expiresAt ?? null
+        expiresAt: session?.expiresAt ?? null,
+        serverVerdict
       };
       try {
         const apiUrl = session?.apiUrl ?? "https://tostudy.ai";
@@ -3842,7 +3941,17 @@ var init_doctor = __esm({
       console.log(`  ${pnpmVersion ? "\u2713" : "\u25CB"} pnpm          ${pnpmVersion ?? errs.notFound}`);
       console.log(`  ${gitVersion ? "\u2713" : "\u25CB"} git           ${gitVersion ?? errs.notFound}`);
       console.log("\n  Autentica\xE7\xE3o");
-      console.log(`  ${session ? "\u2713" : "\u2717"} Token         ${session ? "v\xE1lido" : "n\xE3o logado"}`);
+      if (!session) {
+        console.log("  \u2717 Token         n\xE3o logado");
+      } else if (serverVerdict === "valid") {
+        console.log("  \u2713 Token         v\xE1lido");
+      } else if (serverVerdict === "expired") {
+        console.log("  \u25CB Token         expirado (renova sozinho no pr\xF3ximo comando)");
+      } else if (serverVerdict === "rejected") {
+        console.log("  \u2717 Token         recusado pelo servidor \u2014 rode: tostudy login");
+      } else {
+        console.log("  ? Token         n\xE3o verificado (API indispon\xEDvel)");
+      }
       if (session) {
         console.log(`  \u2713 Usu\xE1rio       ${session.userName}`);
       }
@@ -4711,6 +4820,7 @@ async function runStart(opts, deps = defaultDeps3) {
     if (ws)
       await deps.updateWorkspaceState(ws.workspacePath, {
         currentLessonId: moduleData.firstLesson.id,
+        retryLessonId: void 0,
         currentModuleId: moduleData.module.id
       });
     if (opts.json) {
@@ -4803,6 +4913,7 @@ var init_start_next = __esm({
         if (ws)
           await updateWorkspaceState(ws.workspacePath, {
             currentLessonId: moduleData.firstLesson.id,
+            retryLessonId: void 0,
             currentModuleId: moduleData.module.id
           });
         if (opts.json) {
@@ -4863,6 +4974,7 @@ var init_next = __esm({
         if (ws)
           await updateWorkspaceState(ws.workspacePath, {
             currentLessonId: lessonData.lesson.id,
+            retryLessonId: void 0,
             ...lessonData.lesson.moduleId ? { currentModuleId: lessonData.lesson.moduleId } : {}
           });
         if (opts.json) {
@@ -5359,7 +5471,7 @@ __export(util_exports, {
   getSizableOrigin: () => getSizableOrigin,
   hexToUint8Array: () => hexToUint8Array,
   isObject: () => isObject,
-  isPlainObject: () => isPlainObject,
+  isPlainObject: () => isPlainObject2,
   issue: () => issue,
   joinValues: () => joinValues,
   jsonStringifyReplacer: () => jsonStringifyReplacer,
@@ -5528,7 +5640,7 @@ function slugify2(input2) {
 function isObject(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
-function isPlainObject(o) {
+function isPlainObject2(o) {
   if (isObject(o) === false)
     return false;
   const ctor = o.constructor;
@@ -5545,7 +5657,7 @@ function isPlainObject(o) {
   return true;
 }
 function shallowClone(o) {
-  if (isPlainObject(o))
+  if (isPlainObject2(o))
     return { ...o };
   if (Array.isArray(o))
     return [...o];
@@ -5681,7 +5793,7 @@ function omit(schema, mask) {
   return clone(schema, def);
 }
 function extend(schema, shape) {
-  if (!isPlainObject(shape)) {
+  if (!isPlainObject2(shape)) {
     throw new Error("Invalid input to extend: expected a plain object");
   }
   const checks = schema._zod.def.checks;
@@ -5704,7 +5816,7 @@ function extend(schema, shape) {
   return clone(schema, def);
 }
 function safeExtend(schema, shape) {
-  if (!isPlainObject(shape)) {
+  if (!isPlainObject2(shape)) {
     throw new Error("Invalid input to safeExtend: expected a plain object");
   }
   const def = mergeDefs(schema._zod.def, {
@@ -7180,7 +7292,7 @@ function mergeValues(a, b) {
   if (a instanceof Date && b instanceof Date && +a === +b) {
     return { valid: true, data: a };
   }
-  if (isPlainObject(a) && isPlainObject(b)) {
+  if (isPlainObject2(a) && isPlainObject2(b)) {
     const bKeys = Object.keys(b);
     const sharedKeys = Object.keys(a).filter((key) => bKeys.indexOf(key) !== -1);
     const newObj = { ...a, ...b };
@@ -8374,7 +8486,7 @@ var init_schemas = __esm({
       $ZodType.init(inst, def);
       inst._zod.parse = (payload, ctx) => {
         const input2 = payload.value;
-        if (!isPlainObject(input2)) {
+        if (!isPlainObject2(input2)) {
           payload.issues.push({
             expected: "record",
             code: "invalid_type",
@@ -20142,6 +20254,12 @@ var init_init_template = __esm({
 import fs11 from "node:fs";
 import path14 from "node:path";
 import { Command as Command14 } from "commander";
+async function clearRetryPin() {
+  const ws = await findWorkspaceState();
+  if (ws?.state.retryLessonId) {
+    await updateWorkspaceState(ws.workspacePath, { retryLessonId: void 0 });
+  }
+}
 var logger16, validateCommand;
 var init_validate = __esm({
   "src/commands/validate.ts"() {
@@ -20152,6 +20270,7 @@ var init_validate = __esm({
     init_http();
     init_guards();
     init_course_state();
+    init_workspace_state();
     init_formatter();
     init_init_template();
     init_errors();
@@ -20165,7 +20284,8 @@ var init_validate = __esm({
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
         const deps = { data, logger: logger16 };
-        let lessonId = activeCourse.currentLessonId;
+        const retryLessonId = activeCourse.retryLessonId;
+        let lessonId = retryLessonId ?? activeCourse.currentLessonId;
         if (!lessonId) {
           try {
             const prog = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
@@ -20249,8 +20369,19 @@ var init_validate = __esm({
         } else {
           output(formatValidation(result), { json: false });
         }
+        if (retryLessonId && result.passed) {
+          await clearRetryPin();
+          if (!opts.json) {
+            process.stderr.write(
+              "\n\u21A9\uFE0F Revalida\xE7\xE3o aprovada e registrada. Voltando para a sua li\xE7\xE3o atual.\n"
+            );
+          }
+        }
         process.exit(result.passed ? 0 : 1);
       } catch (err) {
+        if (err instanceof CliApiError && err.code === "LESSON_NOT_REACHED") {
+          await clearRetryPin();
+        }
         if (isEnrollmentNotEntitledError(err)) {
           const friendly = getErrors().enrollmentNotEntitled;
           if (opts.json) jsonError("enrollment_not_entitled", { message: friendly });
@@ -20269,6 +20400,12 @@ var init_validate = __esm({
           error(friendly);
           return;
         }
+        if (isDailyAiLimitError(err)) {
+          const friendly = getErrors().dailyAiLimit;
+          if (opts.json) jsonError("daily_ai_limit", { message: friendly });
+          error(friendly);
+          return;
+        }
         const msg = err instanceof Error ? err.message : String(err);
         if (opts.json) jsonError(msg);
         error(msg);
@@ -20277,8 +20414,81 @@ var init_validate = __esm({
   }
 });
 
-// src/commands/menu.ts
+// src/commands/retry.ts
 import { Command as Command15 } from "commander";
+var logger17, LESSON_ID_RE, retryCommand;
+var init_retry = __esm({
+  "src/commands/retry.ts"() {
+    "use strict";
+    init_dist();
+    init_lessons();
+    init_http();
+    init_guards();
+    init_workspace_state();
+    init_formatter();
+    logger17 = createLogger("cli:retry");
+    LESSON_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    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) => {
+      try {
+        if (opts.clear) {
+          const ws2 = await findWorkspaceState();
+          if (ws2?.state.retryLessonId) {
+            await updateWorkspaceState(ws2.workspacePath, { retryLessonId: void 0 });
+          }
+          if (opts.json) output({ retryLessonId: null }, { json: true });
+          else
+            output("Revalida\xE7\xE3o cancelada. `tostudy validate` volta a usar a sua li\xE7\xE3o atual.", {
+              json: false
+            });
+          return;
+        }
+        if (!lessonId || !LESSON_ID_RE.test(lessonId)) {
+          const message = "Informe o id da li\xE7\xE3o conclu\xEDda. Os ids aparecem em: tostudy grades --course <slug> --json";
+          if (opts.json) jsonError("invalid_lesson_id", { message });
+          error(message);
+        }
+        const session = await requireSession();
+        const activeCourse = await requireActiveCourse();
+        const ws = await findWorkspaceState();
+        if (!ws) {
+          const message = "Nenhum workspace ativo. Rode: tostudy select";
+          if (opts.json) jsonError("no_workspace", { message });
+          error(message);
+        }
+        const data = createHttpProvider(session.apiUrl, session.token);
+        const content = await getContent(
+          { lessonId, enrollmentId: activeCourse.enrollmentId },
+          { data, logger: logger17 }
+        );
+        await updateWorkspaceState(ws.workspacePath, { retryLessonId: lessonId });
+        if (opts.json) {
+          output({ retryLessonId: lessonId, lesson: content }, { json: true });
+          return;
+        }
+        output(
+          [
+            `\u21A9\uFE0F Revalida\xE7\xE3o da li\xE7\xE3o: ${content.title}`,
+            "",
+            content.content,
+            ...content.acceptanceCriteria ? ["", "Crit\xE9rios de aceita\xE7\xE3o:", content.acceptanceCriteria] : [],
+            "",
+            "Esta li\xE7\xE3o continua conclu\xEDda. A nova tentativa entra na sua nota se for a melhor.",
+            "\u2192 tostudy validate <arquivo>   para enviar a nova resposta",
+            "\u2192 tostudy retry --clear        para desistir e voltar \xE0 li\xE7\xE3o atual"
+          ].join("\n"),
+          { json: false }
+        );
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (opts.json) jsonError(message);
+        error(message);
+      }
+    });
+  }
+});
+
+// src/commands/menu.ts
+import { Command as Command16 } from "commander";
 var menuCommand;
 var init_menu = __esm({
   "src/commands/menu.ts"() {
@@ -20286,7 +20496,7 @@ var init_menu = __esm({
     init_session_store();
     init_workspace_state();
     init_formatter();
-    menuCommand = new Command15("menu").description("Show available commands and current study context").action(async () => {
+    menuCommand = new Command16("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;
@@ -20463,7 +20673,7 @@ var init_learner_context = __esm({
 });
 
 // src/commands/init.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function isCompleteProfile(flags) {
   return Boolean(
     flags.segment && flags.company && flags.products && flags.region && flags.team && flags.goal && flags.level
@@ -20634,7 +20844,7 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
     deps.output(artifacts.learnerBrief, { json: false });
   }
 }
-var logger17, defaultDeps4, initCommand;
+var logger18, defaultDeps4, initCommand;
 var init_init = __esm({
   "src/commands/init.ts"() {
     "use strict";
@@ -20651,7 +20861,7 @@ var init_init = __esm({
     init_instruction_pipeline();
     init_root_agents_consent();
     init_pipeline_deps();
-    logger17 = createLogger("cli:init");
+    logger18 = createLogger("cli:init");
     defaultDeps4 = {
       // GH #1419 item 3 — `init` used the raw session, so an expired access
       // token met the POST as a 401. Refresh through the guard when one exists.
@@ -20671,12 +20881,12 @@ var init_init = __esm({
       saveCourseLearnerProfile,
       buildInitArtifacts,
       output,
-      logger: logger17,
+      logger: logger18,
       createHttpProvider,
       resolveAndGenerate,
       buildPipelineDeps
     };
-    initCommand = new Command16("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(
+    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(
       "--root-agents",
       "Add the ToStudy block to an existing AGENTS.md in this folder without asking"
     ).option("--json", "Output structured JSON").action(async (opts) => {
@@ -21004,11 +21214,11 @@ var init_workspace = __esm({
 });
 
 // src/commands/workspace.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 import path17 from "node:path";
 import os8 from "node:os";
 import fs14 from "node:fs/promises";
-var logger18, workspaceCommand;
+var logger19, workspaceCommand;
 var init_workspace2 = __esm({
   "src/commands/workspace.ts"() {
     "use strict";
@@ -21018,8 +21228,8 @@ var init_workspace2 = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger18 = createLogger("cli:workspace");
-    workspaceCommand = new Command17("workspace").description(
+    logger19 = createLogger("cli:workspace");
+    workspaceCommand = new Command18("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) => {
@@ -21084,7 +21294,7 @@ Pr\xF3ximo passo: tostudy export
           );
         }
       } catch (err) {
-        logger18.error("workspace setup failed", { error: err });
+        logger19.error("workspace setup failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -21188,11 +21398,11 @@ Pr\xF3ximo passo: tostudy export
 });
 
 // src/commands/export.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 import path18 from "node:path";
 import os9 from "node:os";
 import fs15 from "node:fs/promises";
-var logger19, exportCommand;
+var logger20, exportCommand;
 var init_export = __esm({
   "src/commands/export.ts"() {
     "use strict";
@@ -21203,8 +21413,8 @@ var init_export = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger19 = createLogger("cli:export");
-    exportCommand = new Command18("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) => {
+    logger20 = createLogger("cli:export");
+    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) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -21231,7 +21441,7 @@ var init_export = __esm({
           }
           if (!hasConfig) {
             const slug = courseSlug(activeCourse.courseTitle);
-            logger19.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
+            logger20.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
             await fs15.mkdir(ws.workspacePath, { recursive: true });
             for (const dir of ["exercises", "generated", "notes", "diagrams"]) {
               await fs15.mkdir(path18.join(ws.workspacePath, dir), { recursive: true });
@@ -21296,7 +21506,7 @@ ${result.files.map((f) => `  \u{1F4C4} ${f}`).join("\n")}
           );
         }
       } catch (err) {
-        logger19.error("export failed", { error: err });
+        logger20.error("export failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -21306,11 +21516,11 @@ ${result.files.map((f) => `  \u{1F4C4} ${f}`).join("\n")}
 });
 
 // src/commands/open.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 import { execFile as execFile3 } from "node:child_process";
 import path19 from "node:path";
 import os10 from "node:os";
-var logger20, openCommand;
+var logger21, openCommand;
 var init_open = __esm({
   "src/commands/open.ts"() {
     "use strict";
@@ -21319,8 +21529,8 @@ var init_open = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger20 = createLogger("cli:open");
-    openCommand = new Command19("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path19.join(os10.homedir(), "study")).action(async (opts) => {
+    logger21 = createLogger("cli:open");
+    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) => {
       try {
         const activeCourse = await requireActiveCourse();
         const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -21337,7 +21547,7 @@ var init_open = __esm({
         const editor = process.env["EDITOR"] ?? "code";
         execFile3(editor, [ws.workspacePath], (err) => {
           if (err) {
-            logger20.error("open failed", { editor, workspacePath: ws.workspacePath });
+            logger21.error("open failed", { editor, workspacePath: ws.workspacePath });
             process.stderr.write(`\u274C Falha ao abrir: ${err.message}
 `);
             process.exit(1);
@@ -21346,7 +21556,7 @@ var init_open = __esm({
 `);
         });
       } catch (err) {
-        logger20.error("open command failed", { error: err });
+        logger21.error("open command failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -21415,11 +21625,11 @@ var init_vault = __esm({
 });
 
 // src/commands/vault.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 import path21 from "node:path";
 import os11 from "node:os";
 import fs17 from "node:fs/promises";
-var logger21, vaultCommand;
+var logger22, vaultCommand;
 var init_vault2 = __esm({
   "src/commands/vault.ts"() {
     "use strict";
@@ -21432,8 +21642,8 @@ var init_vault2 = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger21 = createLogger("cli:vault");
-    vaultCommand = new Command20("vault").description("Gerenciar vault Obsidian do curso");
+    logger22 = createLogger("cli:vault");
+    vaultCommand = new Command21("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();
@@ -21476,7 +21686,7 @@ var init_vault2 = __esm({
           cliWorkspacePaths(workspacePath, activeCourse.courseTitle)
         );
         const result = await writeVaultFiles(files, vaultOutputPath, activeCourse.courseId, slug);
-        logger21.info("Vault generated", {
+        logger22.info("Vault generated", {
           courseId: activeCourse.courseId,
           vaultPath: result.vaultPath,
           filesWritten: result.filesWritten
@@ -21509,7 +21719,7 @@ Para visualizar:
           );
         }
       } catch (err) {
-        logger21.error("vault init failed", { error: err });
+        logger22.error("vault init failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -21539,7 +21749,7 @@ Para visualizar:
           process.exit(1);
         }
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger21 };
+        const deps = { data, logger: logger22 };
         const progress = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
         const markerPath = path21.join(vaultPath, ".ana-vault.json");
         const markerRaw = await fs17.readFile(markerPath, "utf-8");
@@ -21593,7 +21803,7 @@ Para visualizar:
           );
         }
       } catch (err) {
-        logger21.error("vault sync failed", { error: err });
+        logger22.error("vault sync failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -21603,7 +21813,7 @@ Para visualizar:
 });
 
 // src/commands/profile.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 var profileCommand;
 var init_profile = __esm({
   "src/commands/profile.ts"() {
@@ -21611,7 +21821,7 @@ var init_profile = __esm({
     init_guards();
     init_course_state();
     init_user_profile();
-    profileCommand = new Command21("profile").description("Show your learner profile for the active course").option("--json", "Output structured JSON").action(async (opts) => {
+    profileCommand = new Command22("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();
@@ -21672,8 +21882,8 @@ var init_profile = __esm({
 });
 
 // src/commands/sync.ts
-import { Command as Command22 } from "commander";
-var logger22, syncCommand;
+import { Command as Command23 } from "commander";
+var logger23, syncCommand;
 var init_sync = __esm({
   "src/commands/sync.ts"() {
     "use strict";
@@ -21684,8 +21894,8 @@ var init_sync = __esm({
     init_workspace_state();
     init_root_agents_consent();
     init_pipeline_deps();
-    logger22 = createLogger("cli:sync");
-    syncCommand = new Command22("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").option(
+    logger23 = createLogger("cli:sync");
+    syncCommand = new Command23("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(
@@ -21749,7 +21959,7 @@ var init_sync = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger22.warn("sync failed", { error: msg });
+        logger23.warn("sync failed", { error: msg });
         error(msg);
       }
     });
@@ -21757,8 +21967,8 @@ var init_sync = __esm({
 });
 
 // src/commands/brief.ts
-import { Command as Command23 } from "commander";
-var logger23, briefCommand;
+import { Command as Command24 } from "commander";
+var logger24, briefCommand;
 var init_brief = __esm({
   "src/commands/brief.ts"() {
     "use strict";
@@ -21767,8 +21977,8 @@ var init_brief = __esm({
     init_cache();
     init_api();
     init_formatter();
-    logger23 = createLogger("cli:brief");
-    briefCommand = new Command23("brief").description("Show your base learner brief (T1) status and content").option("--json", "Output structured JSON").action(async (opts) => {
+    logger24 = createLogger("cli:brief");
+    briefCommand = new Command24("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();
@@ -21801,7 +22011,7 @@ var init_brief = __esm({
         }
         output(lines.join("\n"), { json: false });
       } catch (err) {
-        logger23.error("Failed to show brief", { err });
+        logger24.error("Failed to show brief", { err });
         error(`Erro ao buscar brief: ${err instanceof Error ? err.message : String(err)}`);
       }
     });
@@ -21809,8 +22019,8 @@ var init_brief = __esm({
 });
 
 // src/commands/brief-create.ts
-import { Command as Command24 } from "commander";
-var logger24, briefCreateCommand;
+import { Command as Command25 } from "commander";
+var logger25, briefCreateCommand;
 var init_brief_create = __esm({
   "src/commands/brief-create.ts"() {
     "use strict";
@@ -21820,8 +22030,8 @@ var init_brief_create = __esm({
     init_api();
     init_cache();
     init_formatter();
-    logger24 = createLogger("cli:brief-create");
-    briefCreateCommand = new Command24("brief-create").description("Create your base learner brief via interactive prompts (T1 bootstrap)").action(async () => {
+    logger25 = createLogger("cli:brief-create");
+    briefCreateCommand = new Command25("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 });
@@ -21845,7 +22055,7 @@ var init_brief_create = __esm({
         ];
         output(doneLines.join("\n"), { json: false });
       } catch (err) {
-        logger24.error("Failed to create brief", { err });
+        logger25.error("Failed to create brief", { err });
         error(`Erro ao criar brief: ${err instanceof Error ? err.message : String(err)}`);
       }
     });
@@ -21853,7 +22063,7 @@ var init_brief_create = __esm({
 });
 
 // src/commands/brief-open.ts
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 import { execFile as execFile4 } from "node:child_process";
 import { platform } from "node:process";
 function openUrl(url2) {
@@ -21882,7 +22092,7 @@ var init_brief_open = __esm({
     init_guards();
     init_formatter();
     BRIEF_URL = "https://tostudy.ai/student/settings/learner-brief";
-    briefOpenCommand = new Command25("brief-open").description("Open the learner brief editor in your web browser").action(async () => {
+    briefOpenCommand = new Command26("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);
@@ -21910,7 +22120,7 @@ async function saveModuleSummary(workspacePath, input2) {
     ""
   ].join("\n");
   fs18.writeFileSync(filePath, header + input2.summary, { mode: 384 });
-  logger25.debug("Module summary saved", { moduleId: input2.moduleId, path: filePath });
+  logger26.debug("Module summary saved", { moduleId: input2.moduleId, path: filePath });
   return filePath;
 }
 async function loadSessionContext(workspacePath) {
@@ -21931,19 +22141,19 @@ async function loadSessionContext(workspacePath) {
   }
   return { moduleSummaries: summaries };
 }
-var logger25;
+var logger26;
 var init_storage = __esm({
   "src/sessions/storage.ts"() {
     "use strict";
     init_dist();
-    logger25 = createLogger("cli:sessions");
+    logger26 = createLogger("cli:sessions");
   }
 });
 
 // src/commands/compact.ts
 import fs19 from "node:fs";
-import { Command as Command26 } from "commander";
-var logger26, compactCommand;
+import { Command as Command27 } from "commander";
+var logger27, compactCommand;
 var init_compact = __esm({
   "src/commands/compact.ts"() {
     "use strict";
@@ -21952,8 +22162,8 @@ var init_compact = __esm({
     init_workspace_state();
     init_storage();
     init_formatter();
-    logger26 = createLogger("cli:compact");
-    compactCommand = new Command26("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) => {
+    logger27 = createLogger("cli:compact");
+    compactCommand = new Command27("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();
@@ -21973,7 +22183,7 @@ var init_compact = __esm({
           moduleTitle,
           summary
         });
-        logger26.debug("Compact summary saved", { moduleId, filePath });
+        logger27.debug("Compact summary saved", { moduleId, filePath });
         if (opts.json) {
           output({ saved: true, path: filePath, moduleId }, { json: true });
         } else {
@@ -21982,7 +22192,7 @@ var init_compact = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger26.warn("compact failed", { error: msg });
+        logger27.warn("compact failed", { error: msg });
         if (opts.json) jsonError(msg);
         error(msg);
       }
@@ -21991,8 +22201,8 @@ var init_compact = __esm({
 });
 
 // src/commands/context.ts
-import { Command as Command27 } from "commander";
-var logger27, contextCommand;
+import { Command as Command28 } from "commander";
+var logger28, contextCommand;
 var init_context = __esm({
   "src/commands/context.ts"() {
     "use strict";
@@ -22002,8 +22212,8 @@ var init_context = __esm({
     init_course_state();
     init_formatter();
     init_errors();
-    logger27 = createLogger("cli:context");
-    contextCommand = new Command27("context").description("Load session context (workspace state + module summaries) for LLM consumption").option("--json", "Output structured JSON").action(async (opts) => {
+    logger28 = createLogger("cli:context");
+    contextCommand = new Command28("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) {
@@ -22033,7 +22243,7 @@ var init_context = __esm({
           totalModulesCompleted: sessionCtx.moduleSummaries.length,
           driftWarning: driftWarning ?? null
         };
-        logger27.debug("Context loaded", {
+        logger28.debug("Context loaded", {
           courseId: ws.state.courseId,
           moduleSummaries: sessionCtx.moduleSummaries.length
         });
@@ -22047,7 +22257,7 @@ var init_context = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger27.warn("context failed", { error: msg });
+        logger28.warn("context failed", { error: msg });
         if (opts.json) jsonError(msg);
         error(msg);
       }
@@ -22056,8 +22266,8 @@ var init_context = __esm({
 });
 
 // src/commands/memory.ts
-import { Command as Command28 } from "commander";
-var logger28, memoryCommand;
+import { Command as Command29 } from "commander";
+var logger29, memoryCommand;
 var init_memory = __esm({
   "src/commands/memory.ts"() {
     "use strict";
@@ -22067,8 +22277,8 @@ var init_memory = __esm({
     init_guards();
     init_formatter();
     init_errors();
-    logger28 = createLogger("cli:memory");
-    memoryCommand = new Command28("memory").description("Load accumulated student memory (learning profile + recent lessons) for the tutor").option("--json", "Output structured JSON").action(async (opts) => {
+    logger29 = createLogger("cli:memory");
+    memoryCommand = new Command29("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) {
@@ -22091,7 +22301,7 @@ var init_memory = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger28.warn("memory failed", { error: msg });
+        logger29.warn("memory failed", { error: msg });
         if (opts.json) jsonError(msg);
         else error(msg);
       }
@@ -22100,8 +22310,8 @@ var init_memory = __esm({
 });
 
 // src/commands/insight.ts
-import { Command as Command29 } from "commander";
-var logger29, VALID_TYPES, insightCommand;
+import { Command as Command30 } from "commander";
+var logger30, VALID_TYPES, insightCommand;
 var init_insight = __esm({
   "src/commands/insight.ts"() {
     "use strict";
@@ -22111,9 +22321,9 @@ var init_insight = __esm({
     init_guards();
     init_formatter();
     init_errors();
-    logger29 = createLogger("cli:insight");
+    logger30 = createLogger("cli:insight");
     VALID_TYPES = ["difficulty", "breakthrough", "question"];
-    insightCommand = new Command29("insight").description(
+    insightCommand = new Command30("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 {
@@ -22153,7 +22363,7 @@ var init_insight = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger29.warn("insight failed", { error: msg });
+        logger30.warn("insight failed", { error: msg });
         if (opts.json) jsonError(msg);
         else error(msg);
       }
@@ -22162,11 +22372,11 @@ var init_insight = __esm({
 });
 
 // src/commands/level.ts
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 function isExerciseLevel2(value) {
   return ALL_LEVELS.includes(value);
 }
-var logger30, ALL_LEVELS, LEVEL_LABELS2, levelCommand;
+var logger31, ALL_LEVELS, LEVEL_LABELS2, levelCommand;
 var init_level = __esm({
   "src/commands/level.ts"() {
     "use strict";
@@ -22175,7 +22385,7 @@ var init_level = __esm({
     init_exercises();
     init_guards();
     init_formatter();
-    logger30 = createLogger("cli:level");
+    logger31 = createLogger("cli:level");
     ALL_LEVELS = ["L0", "L1", "L2", "L3", "L4"];
     LEVEL_LABELS2 = {
       L0: "Pr\xE9-check (perguntas conceituais)",
@@ -22184,12 +22394,12 @@ var init_level = __esm({
       L3: "Guiado (passo a passo + checkpoints)",
       L4: "Desafio livre (folha em branco)"
     };
-    levelCommand = new Command30("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) => {
+    levelCommand = new Command31("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();
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger30 };
+        const deps = { data, logger: logger31 };
         if (!rawLevel) {
           const levels = await getEnrollmentLevels({ enrollmentId: activeCourse.enrollmentId }, deps);
           if (opts.json) {
@@ -22247,8 +22457,8 @@ var init_level = __esm({
 });
 
 // src/commands/theory.ts
-import { Command as Command31 } from "commander";
-var logger31, EXERCISE_LEVELS2, theoryCommand;
+import { Command as Command32 } from "commander";
+var logger32, EXERCISE_LEVELS2, theoryCommand;
 var init_theory = __esm({
   "src/commands/theory.ts"() {
     "use strict";
@@ -22256,9 +22466,9 @@ var init_theory = __esm({
     init_guards();
     init_formatter();
     init_errors();
-    logger31 = createLogger("cli:theory");
+    logger32 = createLogger("cli:theory");
     EXERCISE_LEVELS2 = ["L0", "L1", "L2", "L3", "L4"];
-    theoryCommand = new Command31("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) => {
+    theoryCommand = new Command32("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();
@@ -22295,7 +22505,7 @@ var init_theory = __esm({
           currentLevel = levels.currentLevel;
         }
         const requestUrl = `${session.apiUrl}/api/cli/exercises/more-theory`;
-        logger31.debug("Requesting more theory", { lessonId, currentLevel });
+        logger32.debug("Requesting more theory", { lessonId, currentLevel });
         const res = await fetch(requestUrl, {
           method: "POST",
           headers: {
@@ -22316,6 +22526,11 @@ var init_theory = __esm({
             if (opts.json) jsonError("insufficient_credits", { message: friendly });
             error(friendly);
           }
+          if (body.error === "DAILY_AI_COST_LIMIT_EXCEEDED") {
+            const friendly = getErrors().dailyAiLimit;
+            if (opts.json) jsonError("daily_ai_limit", { message: friendly });
+            error(friendly);
+          }
           const msg = body.error ?? body.message ?? `Falha ao pedir teoria (${res.status})`;
           if (opts.json) jsonError("request_failed", { message: msg, code: res.status });
           error(msg);
@@ -22333,6 +22548,12 @@ var init_theory = __esm({
           error(friendly);
           return;
         }
+        if (isDailyAiLimitError(err)) {
+          const friendly = getErrors().dailyAiLimit;
+          if (opts.json) jsonError("daily_ai_limit", { message: friendly });
+          error(friendly);
+          return;
+        }
         const msg = err instanceof Error ? err.message : String(err);
         if (opts.json) jsonError("unexpected_error", { message: msg });
         error(msg);
@@ -22618,7 +22839,7 @@ var init_resolve_enrollment = __esm({
 });
 
 // src/commands/export-grades.ts
-import { Command as Command32 } from "commander";
+import { Command as Command33 } from "commander";
 function isFormat(value) {
   return SUPPORTED_FORMATS.includes(value);
 }
@@ -22705,7 +22926,7 @@ async function runExportGrades(opts, deps = defaultDeps5) {
   if (!rendered.endsWith("\n")) rendered += "\n";
   deps.stdoutWrite(rendered);
 }
-var logger32, SUPPORTED_FORMATS, defaultDeps5, exportGradesCommand;
+var logger33, SUPPORTED_FORMATS, defaultDeps5, exportGradesCommand;
 var init_export_grades = __esm({
   "src/commands/export-grades.ts"() {
     "use strict";
@@ -22713,7 +22934,7 @@ var init_export_grades = __esm({
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger32 = createLogger("cli:export-grades");
+    logger33 = createLogger("cli:export-grades");
     SUPPORTED_FORMATS = ["json", "csv", "md"];
     defaultDeps5 = {
       requireSession,
@@ -22726,10 +22947,10 @@ var init_export_grades = __esm({
       stderrWrite: (message) => process.stderr.write(message),
       // process.exit is typed as `never` — wrap so the cast is local to one line.
       exit: (code) => process.exit(code),
-      logger: logger32,
+      logger: logger33,
       resolveBySlug: resolveEnrollmentBySlug
     };
-    exportGradesCommand = new Command32("export-grades").description("Exporta o hist\xF3rico de valida\xE7\xF5es (notas) do curso ativo").option(
+    exportGradesCommand = new Command33("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(
@@ -22754,7 +22975,7 @@ C\xF3digos de sa\xEDda:
 });
 
 // src/commands/grades.ts
-import { Command as Command33 } from "commander";
+import { Command as Command34 } from "commander";
 async function fetchAttempts(session, enrollmentId, deps) {
   const url2 = `${session.apiUrl}/api/cli/validations/by-enrollment?enrollmentId=${encodeURIComponent(
     enrollmentId
@@ -22789,15 +23010,13 @@ function summarizeAttempts(courseTitle, attempts) {
     };
   }
   let passedCount = 0;
-  let scoreSum = 0;
-  let scoreCount = 0;
   let latestTs = -Infinity;
   let latestAt = attempts[0].attemptedAt;
+  const bestByLesson = /* @__PURE__ */ new Map();
   for (const a of attempts) {
     if (a.passed) passedCount++;
     if (a.score !== null) {
-      scoreSum += a.score;
-      scoreCount++;
+      bestByLesson.set(a.lessonId, Math.max(a.score, bestByLesson.get(a.lessonId) ?? -Infinity));
     }
     const t = (a.attemptedAt instanceof Date ? a.attemptedAt : new Date(a.attemptedAt)).getTime();
     if (t > latestTs) {
@@ -22805,13 +23024,14 @@ function summarizeAttempts(courseTitle, attempts) {
       latestAt = a.attemptedAt;
     }
   }
+  const bestScores = [...bestByLesson.values()];
   return {
     courseTitle,
     lastAttemptAt: latestAt,
     attemptsCount: attempts.length,
     passedCount,
     failedCount: attempts.length - passedCount,
-    averageScore: scoreCount === 0 ? null : scoreSum / scoreCount
+    averageScore: bestScores.length === 0 ? null : bestScores.reduce((a, b) => a + b, 0) / bestScores.length
   };
 }
 async function runGrades(opts, deps = defaultDeps6) {
@@ -22895,7 +23115,7 @@ async function runGrades(opts, deps = defaultDeps6) {
   );
   deps.stdoutWrite(formatGradesAllEnrollmentsTable(summaries) + "\n");
 }
-var logger33, defaultDeps6, gradesCommand;
+var logger34, defaultDeps6, gradesCommand;
 var init_grades2 = __esm({
   "src/commands/grades.ts"() {
     "use strict";
@@ -22905,7 +23125,7 @@ var init_grades2 = __esm({
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger33 = createLogger("cli:grades");
+    logger34 = createLogger("cli:grades");
     defaultDeps6 = {
       requireSession,
       // Lazy: ler `globalThis.fetch` no escopo do modulo executa no LOAD do arquivo,
@@ -22915,12 +23135,12 @@ var init_grades2 = __esm({
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
-      logger: logger33,
+      logger: logger34,
       resolveBySlug: resolveEnrollmentBySlug,
       buildDataProvider: createHttpProvider,
       listCoursesFn: listCourses
     };
-    gradesCommand = new Command33("grades").description("Mostra um resumo das notas (todas as matr\xEDculas ou um curso espec\xEDfico)").option(
+    gradesCommand = new Command34("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(
@@ -22944,7 +23164,7 @@ C\xF3digos de sa\xEDda:
 });
 
 // src/commands/review.ts
-import { Command as Command34 } from "commander";
+import { Command as Command35 } from "commander";
 import { createInterface } from "node:readline/promises";
 import { stdin as defaultStdin, stdout as defaultStdout } from "node:process";
 async function defaultPromptLessonChoice(lessonIds) {
@@ -23080,7 +23300,7 @@ async function runReview(slug, opts, deps = defaultDeps7) {
     }) + "\n"
   );
 }
-var logger34, defaultDeps7, reviewCommand;
+var logger35, defaultDeps7, reviewCommand;
 var init_review2 = __esm({
   "src/commands/review.ts"() {
     "use strict";
@@ -23088,7 +23308,7 @@ var init_review2 = __esm({
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger34 = createLogger("cli:review");
+    logger35 = createLogger("cli:review");
     defaultDeps7 = {
       requireSession,
       // Lazy: ler `globalThis.fetch` no escopo do modulo executa no LOAD do arquivo,
@@ -23098,11 +23318,11 @@ var init_review2 = __esm({
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
-      logger: logger34,
+      logger: logger35,
       resolveBySlug: resolveEnrollmentBySlug,
       promptLessonChoice: defaultPromptLessonChoice
     };
-    reviewCommand = new Command34("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(
+    reviewCommand = new Command35("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:
@@ -23131,9 +23351,9 @@ __export(cli_exports, {
   CLI_VERSION: () => CLI_VERSION,
   createProgram: () => createProgram
 });
-import { Command as Command35 } from "commander";
+import { Command as Command36 } from "commander";
 function createProgram() {
-  const program2 = new Command35();
+  const program2 = new Command36();
   program2.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",
     [
@@ -23159,6 +23379,7 @@ function createProgram() {
   program2.addCommand(knowledgeCommand);
   program2.addCommand(hintCommand);
   program2.addCommand(validateCommand);
+  program2.addCommand(retryCommand);
   program2.addCommand(levelCommand);
   program2.addCommand(theoryCommand);
   program2.addCommand(menuCommand);
@@ -23197,6 +23418,7 @@ var init_cli = __esm({
     init_knowledge();
     init_hint();
     init_validate();
+    init_retry();
     init_menu();
     init_init();
     init_workspace2();