@tostudy-ai/cli 0.18.4 → 0.18.5

package/dist/main.js

@@ -1029,6 +1029,13 @@ var init_errors_pt_br = __esm({
       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:",
+      suggestCommandDescription: "Sugere at\xE9 3 cursos gratuitos para matricular no terminal.",
+      suggestEmpty: "Nenhum curso gratuito dispon\xEDvel para o terminal.",
+      suggestNoWorkspace: "Sem contexto nesta pasta. Usei s\xF3 o perfil.",
+      suggestNoOverlap: "Sem coincid\xEAncia com o perfil.",
+      suggestEmptyProfile: "Perfil vazio. Mostrando cursos gratuitos em aberto.",
+      suggestReason: "Motivo:",
+      suggestPaidHeader: "Pagos. 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.",
@@ -1131,6 +1138,13 @@ var init_errors_en_us = __esm({
       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:",
+      suggestCommandDescription: "Suggest up to 3 free courses to enroll in from the terminal.",
+      suggestEmpty: "No free course is available for the terminal.",
+      suggestNoWorkspace: "No context in this folder. Only the profile was used.",
+      suggestNoOverlap: "No word in the profile matched.",
+      suggestEmptyProfile: "Profile is empty. Showing open free courses.",
+      suggestReason: "Why:",
+      suggestPaidHeader: "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.",
@@ -3150,7 +3164,7 @@ var init_guards = __esm({
 });
 
 // src/cli.ts
-import { Command as Command38 } from "commander";
+import { Command as Command39 } from "commander";
 
 // src/commands/login.ts
 init_dist();
@@ -3796,7 +3810,7 @@ init_workspace_state();
 init_formatter();
 
 // src/version.ts
-var CLI_VERSION = true ? "0.18.4" : "0.7.1";
+var CLI_VERSION = true ? "0.18.5" : "0.7.1";
 
 // src/update-checker.ts
 init_config_dir();
@@ -4292,10 +4306,295 @@ var coursesCommand = new Command5("courses").description("List your enrolled cou
   }
 });
 
-// src/commands/enroll.ts
+// src/commands/suggest.ts
 import { Command as Command6 } from "commander";
 init_guards();
 init_errors();
+
+// src/learner-brief/api.ts
+async function fetchLearnerBrief(input2) {
+  const response = await cliApiFetch(
+    `${input2.apiUrl}/api/cli/student/learner-brief`,
+    input2.token
+  );
+  return response.brief;
+}
+async function upsertLearnerBrief(input2) {
+  const response = await cliApiFetch(
+    `${input2.apiUrl}/api/cli/student/learner-brief`,
+    input2.token,
+    {
+      method: "POST",
+      body: JSON.stringify({ text: input2.text, source: input2.source })
+    }
+  );
+  return response.brief;
+}
+
+// src/commands/suggest.ts
+init_user_profile();
+init_formatter();
+
+// src/commands/suggest-score.ts
+var STOP_WORDS = /* @__PURE__ */ new Set([
+  "de",
+  "da",
+  "do",
+  "das",
+  "dos",
+  "para",
+  "com",
+  "uma",
+  "um",
+  "the",
+  "and",
+  "for",
+  "you",
+  "seu",
+  "sua",
+  "curso",
+  "course"
+]);
+var TOKEN_SPLIT = /[^\p{L}\p{N}]+/u;
+var MAX_RESULTS = 3;
+var MAX_REASON_TOKENS = 3;
+var LEVEL_BONUS = 2;
+function tokensOf(value, dropStops) {
+  const seen = /* @__PURE__ */ new Set();
+  const tokens = [];
+  for (const raw2 of value.toLowerCase().split(TOKEN_SPLIT)) {
+    if (raw2.length < 3 || seen.has(raw2)) continue;
+    if (dropStops && STOP_WORDS.has(raw2)) continue;
+    seen.add(raw2);
+    tokens.push(raw2);
+  }
+  return tokens;
+}
+function tokenSet(parts) {
+  return new Set(tokensOf(parts.join(" "), false));
+}
+function haystack(course) {
+  return tokenSet([
+    course.title,
+    course.tags.join(" "),
+    course.description,
+    course.level,
+    course.category
+  ]);
+}
+function haystackWithoutLevel(course) {
+  return tokenSet([course.title, course.tags.join(" "), course.description, course.category]);
+}
+function rankSuggestions(courses, query) {
+  const text2 = query.text.trim();
+  const level = query.level;
+  if (text2 === "" && level === null) {
+    return courses.slice(0, MAX_RESULTS).map((course) => ({
+      course,
+      reason: "empty-profile"
+    }));
+  }
+  const textTokens = tokensOf(text2, true);
+  const levelTokens = level === null ? [] : tokensOf(level, false);
+  const scored = courses.map((course) => {
+    const stack = haystack(course);
+    const outsideLevel = haystackWithoutLevel(course);
+    const hits = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const token of textTokens) {
+      if (seen.has(token) || !stack.has(token)) continue;
+      seen.add(token);
+      hits.push(token);
+    }
+    for (const token of levelTokens) {
+      if (seen.has(token) || !outsideLevel.has(token)) continue;
+      seen.add(token);
+      hits.push(token);
+    }
+    const levelBonus = level !== null && course.level.toLowerCase() === level.trim().toLowerCase() ? LEVEL_BONUS : 0;
+    return {
+      course,
+      score: hits.length + levelBonus,
+      reason: hits.slice(0, MAX_REASON_TOKENS).join(",") || "no-overlap"
+    };
+  });
+  scored.sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score;
+    return left.course.title.localeCompare(right.course.title);
+  });
+  return scored.slice(0, MAX_RESULTS).map(({ course, reason }) => ({ course, reason }));
+}
+
+// src/commands/suggest-workspace.ts
+import fs11 from "node:fs";
+import path13 from "node:path";
+var DOC_LINE_LIMIT = 40;
+var MIN_TOKEN_LENGTH = 3;
+var FENCE_LINE = /^[ \t]{0,3}```/;
+function readWorkspaceSignals(cwd) {
+  const packagePath = path13.join(cwd, "package.json");
+  const readmePath = path13.join(cwd, "README.md");
+  const agentsPath = path13.join(cwd, "AGENTS.md");
+  const hasPackage = fs11.existsSync(packagePath);
+  const hasReadme = fs11.existsSync(readmePath);
+  const hasAgents = fs11.existsSync(agentsPath);
+  if (!hasPackage && !hasReadme && !hasAgents) {
+    return { tokens: [], found: false };
+  }
+  const tokens = [];
+  if (hasPackage) tokens.push(...readPackageTokens(packagePath));
+  const docPath = hasReadme ? readmePath : hasAgents ? agentsPath : null;
+  if (docPath) tokens.push(...readDocTokens(docPath));
+  return { tokens: dedupe(tokens), found: true };
+}
+function readPackageTokens(filePath) {
+  const raw2 = readUtf8(filePath);
+  if (raw2 === null) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(raw2);
+  } catch {
+    return [];
+  }
+  if (!isRecord(parsed)) return [];
+  const names = [
+    ...dependencyNames(parsed.dependencies),
+    ...dependencyNames(parsed.devDependencies)
+  ];
+  return tokenize(names.join("\n"));
+}
+function readDocTokens(filePath) {
+  const raw2 = readUtf8(filePath);
+  if (raw2 === null) return [];
+  const lines = raw2.split(/\r?\n/).slice(0, DOC_LINE_LIMIT);
+  return tokenize(stripFencedBlocks(lines));
+}
+function stripFencedBlocks(lines) {
+  const kept = [];
+  let inFence = false;
+  for (const line of lines) {
+    if (FENCE_LINE.test(line)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (!inFence) kept.push(line);
+  }
+  return kept.join("\n");
+}
+function dependencyNames(value) {
+  if (!isRecord(value)) return [];
+  return Object.keys(value);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function tokenize(text2) {
+  return text2.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((token) => token.length >= MIN_TOKEN_LENGTH);
+}
+function dedupe(tokens) {
+  return [...new Set(tokens)];
+}
+function readUtf8(filePath) {
+  try {
+    return fs11.readFileSync(filePath, "utf8");
+  } catch {
+    return null;
+  }
+}
+
+// src/commands/suggest.ts
+var defaultSuggestDeps = {
+  requireSession,
+  fetchCandidates: async () => {
+    const session = await requireSession();
+    return cliApiFetch(`${session.apiUrl}/api/cli/courses/suggest`, session.token, {
+      method: "GET"
+    });
+  },
+  readBrief: async () => {
+    const session = await requireSession();
+    return fetchLearnerBrief({ apiUrl: session.apiUrl, token: session.token });
+  },
+  readProfile: () => getUserProfile(),
+  readWorkspace: () => readWorkspaceSignals(process.cwd())
+};
+function suggestionQuery(brief, profile, workspaceTokens) {
+  const parts = [];
+  const briefText = brief?.text.trim() ?? "";
+  if (briefText !== "") parts.push(briefText);
+  if (profile) {
+    parts.push(
+      profile.goal,
+      profile.segment,
+      profile.productsOrServices,
+      profile.team,
+      profile.learnerLevel
+    );
+  }
+  const workspaceText = workspaceTokens.join(" ");
+  if (workspaceText !== "") parts.push(workspaceText);
+  return {
+    text: parts.map((part) => part.trim()).filter((part) => part !== "").join(" "),
+    level: profile?.learnerLevel ?? null
+  };
+}
+function reasonText(reason, copy) {
+  if (reason === "empty-profile") return copy.suggestEmptyProfile;
+  if (reason === "no-overlap") return copy.suggestNoOverlap;
+  return reason;
+}
+function formatBlock(ranked, lineFor) {
+  const copy = getErrors();
+  const lines = [];
+  for (const [index, row] of ranked.entries()) {
+    lines.push(`${index + 1}. ${row.course.title}`);
+    lines.push(`${copy.suggestReason} ${reasonText(row.reason, copy)}`);
+    lines.push(lineFor(row));
+  }
+  return lines;
+}
+function formatSuggestResult(free, paid, workspaceFound, enrollUrlFor) {
+  const copy = getErrors();
+  if (free.length === 0 && paid.length === 0) return copy.suggestEmpty;
+  const lines = [];
+  lines.push(...formatBlock(free, (row) => `tostudy enroll ${row.course.id}`));
+  if (paid.length > 0) {
+    if (lines.length > 0) lines.push("");
+    lines.push(copy.suggestPaidHeader);
+    lines.push(...formatBlock(paid, (row) => enrollUrlFor(row.course.id)));
+  }
+  if (!workspaceFound) lines.push(copy.suggestNoWorkspace);
+  return lines.join("\n");
+}
+async function runSuggest(deps = defaultSuggestDeps) {
+  const session = await deps.requireSession();
+  const [candidates, brief, profile] = await Promise.all([
+    deps.fetchCandidates(),
+    deps.readBrief(),
+    deps.readProfile()
+  ]);
+  const workspace = deps.readWorkspace();
+  const query = suggestionQuery(brief, profile, workspace.tokens);
+  const origin = session.apiUrl.replace(/\/$/, "");
+  return formatSuggestResult(
+    rankSuggestions(candidates.free, query),
+    rankSuggestions(candidates.paid, query),
+    workspace.found,
+    (courseId) => `${origin}/enroll/${courseId}`
+  );
+}
+var suggestCommand = new Command6("suggest").description(getErrors().suggestCommandDescription).action(async () => {
+  try {
+    output(await runSuggest(), { json: false });
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+  }
+});
+
+// src/commands/enroll.ts
+import { Command as Command7 } 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) {
@@ -4328,7 +4627,7 @@ async function runEnroll(courseId, deps = {
   });
   return formatEnrollResult(result);
 }
-var enrollCommand = new Command6("enroll").description(getErrors().enrollCommandDescription).argument("<courseId>", "Published course ID (UUID)").action(async (courseId) => {
+var enrollCommand = new Command7("enroll").description(getErrors().enrollCommandDescription).argument("<courseId>", "Published course ID (UUID)").action(async (courseId) => {
   try {
     output(await runEnroll(courseId), { json: false });
   } catch (err) {
@@ -4338,7 +4637,7 @@ var enrollCommand = new Command6("enroll").description(getErrors().enrollCommand
 
 // src/commands/select.ts
 init_dist();
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 import os7 from "node:os";
 init_guards();
 init_workspace_marker();
@@ -4371,26 +4670,6 @@ init_dist();
 init_workspace_marker();
 init_workspace_state();
 
-// src/learner-brief/api.ts
-async function fetchLearnerBrief(input2) {
-  const response = await cliApiFetch(
-    `${input2.apiUrl}/api/cli/student/learner-brief`,
-    input2.token
-  );
-  return response.brief;
-}
-async function upsertLearnerBrief(input2) {
-  const response = await cliApiFetch(
-    `${input2.apiUrl}/api/cli/student/learner-brief`,
-    input2.token,
-    {
-      method: "POST",
-      body: JSON.stringify({ text: input2.text, source: input2.source })
-    }
-  );
-  return response.brief;
-}
-
 // src/learner-brief/bootstrap.ts
 import readline from "node:readline/promises";
 import { stdin as processStdin, stdout as processStdout } from "node:process";
@@ -4782,7 +5061,7 @@ function isInteractiveTerminal(json2) {
 
 // src/commands/select.ts
 var logger8 = createLogger("cli:select");
-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(
+var selectCommand = new Command8("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) => {
@@ -4910,13 +5189,13 @@ var selectCommand = new Command7("select").description("Activate a course by ID
 
 // src/commands/progress.ts
 init_dist();
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 init_guards();
 init_course_state();
 init_formatter();
 init_errors();
 var logger9 = createLogger("cli:progress");
-var progressCommand = new Command8("progress").description("Show your progress in the active course").option("--json", "Output structured JSON").action(async (opts) => {
+var progressCommand = new Command9("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();
@@ -4942,7 +5221,7 @@ var progressCommand = new Command8("progress").description("Show your progress i
 
 // src/commands/start.ts
 init_dist();
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/lessons/next-lesson.ts
 async function nextLesson(input2, deps) {
@@ -5051,20 +5330,20 @@ async function runStart(opts, deps = defaultDeps3) {
     deps.error(msg);
   }
 }
-var startCommand = new Command9("start").description("Start (or resume) the current module of the active course").option("--json", "Output structured JSON").action(async (opts) => {
+var startCommand = new Command10("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 Command10 } from "commander";
+import { Command as Command11 } from "commander";
 init_guards();
 init_course_state();
 init_workspace_state();
 init_formatter();
 init_errors();
 var logger11 = createLogger("cli:start-next");
-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) => {
+var startNextCommand = new Command11("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();
@@ -5107,14 +5386,14 @@ var startNextCommand = new Command10("start-next").description("Transition to th
 
 // src/commands/next.ts
 init_dist();
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 init_guards();
 init_course_state();
 init_workspace_state();
 init_formatter();
 init_errors();
 var logger12 = createLogger("cli:next");
-var nextCommand = new Command11("next").description("Advance to the next lesson in the active course").option("--json", "Output structured JSON").action(async (opts) => {
+var nextCommand = new Command12("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();
@@ -5192,14 +5471,14 @@ var nextCommand = new Command11("next").description("Advance to the next lesson
 
 // src/commands/lesson.ts
 init_dist();
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 init_guards();
 init_course_state();
 init_formatter();
 init_resolve();
 init_workspace_tokens();
 init_errors();
-import path13 from "node:path";
+import path14 from "node:path";
 var logger13 = createLogger("cli:lesson");
 function adjustTimeEstimate(type, baseMinutes) {
   if (type === "exercise") return Math.max(baseMinutes, 30);
@@ -5216,7 +5495,7 @@ function formatLessonContent(data, workspacePath, courseTitle) {
   const isPractical = isPracticalType(data.type) || isCheckpoint(data.type, data.title);
   const lines = [`\u2501\u2501\u2501 Li\xE7\xE3o: ${data.title} \u2501\u2501\u2501`];
   if (isPractical && workspacePath) {
-    const base = path13.basename(workspacePath) === ".tostudy" ? path13.dirname(workspacePath) : workspacePath;
+    const base = path14.basename(workspacePath) === ".tostudy" ? path14.dirname(workspacePath) : workspacePath;
     const slug = courseSlug(courseTitle);
     const vaultPath = resolveVaultPath(workspacePath, slug);
     lines.push(
@@ -5250,7 +5529,7 @@ function formatLessonContent(data, workspacePath, courseTitle) {
   }
   return lines.join("\n");
 }
-var lessonCommand = new Command12("lesson").description("Show the content of the current lesson").option("--json", "Output structured JSON").option(
+var lessonCommand = new Command13("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) => {
@@ -5321,7 +5600,7 @@ var lessonCommand = new Command12("lesson").description("Show the content of the
 
 // src/commands/knowledge.ts
 init_dist();
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 init_guards();
 init_formatter();
 var logger14 = createLogger("cli:knowledge");
@@ -5341,7 +5620,7 @@ function formatKnowledge(data) {
   });
   return lines.join("\n").trimEnd();
 }
-var knowledgeCommand = new Command13("knowledge").description("Show the active course's knowledge base (base de conhecimento)").option("--json", "Output structured JSON").action(async (opts) => {
+var knowledgeCommand = new Command14("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) {
@@ -5372,13 +5651,13 @@ var knowledgeCommand = new Command13("knowledge").description("Show the active c
 
 // src/commands/hint.ts
 init_dist();
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 init_guards();
 init_course_state();
 init_formatter();
 init_errors();
 var logger15 = createLogger("cli:hint");
-var hintCommand = new Command14("hint").description("Get a progressive hint for the current exercise").option("--json", "Output structured JSON").action(async (opts) => {
+var hintCommand = new Command15("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();
@@ -5427,9 +5706,9 @@ var hintCommand = new Command14("hint").description("Get a progressive hint for
 
 // src/commands/validate.ts
 init_dist();
-import fs11 from "node:fs";
-import path14 from "node:path";
-import { Command as Command15 } from "commander";
+import fs12 from "node:fs";
+import path15 from "node:path";
+import { Command as Command16 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/exercises/validate-solution.ts
 async function validateSolution(input2, deps) {
@@ -6218,10 +6497,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path28) {
-  if (!path28)
+function getElementAtPath(obj, path29) {
+  if (!path29)
     return obj;
-  return path28.reduce((acc, key) => acc?.[key], obj);
+  return path29.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -6604,11 +6883,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path28, issues) {
+function prefixIssues(path29, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path28);
+    iss.path.unshift(path29);
     return iss;
   });
 }
@@ -6791,7 +7070,7 @@ function formatError(error49, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error49, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error50, path28 = []) => {
+  const processError = (error50, path29 = []) => {
     var _a2, _b;
     for (const issue2 of error50.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -6801,7 +7080,7 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path28, ...issue2.path];
+        const fullpath = [...path29, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -6833,8 +7112,8 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path28 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path28) {
+  const path29 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path29) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -18811,13 +19090,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path28 = ref.slice(1).split("/").filter(Boolean);
-  if (path28.length === 0) {
+  const path29 = ref.slice(1).split("/").filter(Boolean);
+  if (path29.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path28[0] === defsKey) {
-    const key = path28[1];
+  if (path29[0] === defsKey) {
+    const key = path29[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -19615,7 +19894,7 @@ async function clearRetryPin() {
     await updateWorkspaceState(ws.workspacePath, { retryLessonId: void 0 });
   }
 }
-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) => {
+var validateCommand = new Command16("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();
@@ -19644,21 +19923,21 @@ var validateCommand = new Command15("validate").description("Validate your solut
     }
     let solution;
     if (opts.stdin) {
-      solution = fs11.readFileSync("/dev/stdin", "utf-8");
+      solution = fs12.readFileSync("/dev/stdin", "utf-8");
     } else if (file2) {
-      if (!fs11.existsSync(file2)) {
+      if (!fs12.existsSync(file2)) {
         if (opts.json)
           jsonError("file_not_found", { message: `Arquivo n\xE3o encontrado: ${file2}` });
         error(`Arquivo n\xE3o encontrado: ${file2}`);
       }
-      solution = fs11.readFileSync(file2, "utf-8");
+      solution = fs12.readFileSync(file2, "utf-8");
     } else {
       if (opts.json)
         jsonError("no_solution_provided", { message: "Forne\xE7a um arquivo ou use --stdin" });
       error("Forne\xE7a um arquivo ou use --stdin.\n\nExemplo: tostudy validate resposta.md");
     }
     if (file2 && activeCourse.courseTags?.length) {
-      const ext = path14.extname(file2).toLowerCase();
+      const ext = path15.extname(file2).toLowerCase();
       const LANG_EXTENSIONS = {
         ".html": ["html", "html5"],
         ".css": ["css"],
@@ -19753,13 +20032,13 @@ var validateCommand = new Command15("validate").description("Validate your solut
 
 // src/commands/retry.ts
 init_dist();
-import { Command as Command16 } from "commander";
+import { Command as Command17 } 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 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) => {
+var retryCommand = new Command17("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();
@@ -19820,8 +20099,8 @@ var retryCommand = new Command16("retry").description("Revalidate a lesson you a
 init_session_store();
 init_workspace_state();
 init_formatter();
-import { Command as Command17 } from "commander";
-var menuCommand = new Command17("menu").description("Show available commands and current study context").action(async () => {
+import { Command as Command18 } from "commander";
+var menuCommand = new Command18("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;
@@ -19878,7 +20157,7 @@ var menuCommand = new Command17("menu").description("Show available commands and
 
 // src/commands/init.ts
 init_dist();
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 init_session_store();
 init_course_state();
 init_workspace_state();
@@ -20194,7 +20473,7 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
     deps.output(artifacts.learnerBrief, { json: false });
   }
 }
-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(
+var initCommand = new Command19("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) => {
@@ -20203,18 +20482,18 @@ var initCommand = new Command18("init").description("Generate tutor instructions
 
 // src/commands/workspace.ts
 init_dist();
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/workspace/setup-workspace.ts
-import fs12 from "node:fs/promises";
-import path15 from "node:path";
+import fs13 from "node:fs/promises";
+import path16 from "node:path";
 var WORKSPACE_DIRS = ["exercises", "generated", "notes", "diagrams", "vault"];
 async function setupWorkspace(input2) {
-  const workspacePath = path15.join(input2.basePath, input2.courseSlug);
+  const workspacePath = path16.join(input2.basePath, input2.courseSlug);
   for (const dir of WORKSPACE_DIRS) {
-    await fs12.mkdir(path15.join(workspacePath, dir), { recursive: true });
+    await fs13.mkdir(path16.join(workspacePath, dir), { recursive: true });
   }
-  const configPath = path15.join(workspacePath, ".ana-config.json");
+  const configPath = path16.join(workspacePath, ".ana-config.json");
   const config2 = {
     courseId: input2.courseId,
     courseSlug: input2.courseSlug,
@@ -20224,7 +20503,7 @@ async function setupWorkspace(input2) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     lastAccessedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  await fs12.writeFile(configPath, JSON.stringify(config2, null, 2), "utf-8");
+  await fs13.writeFile(configPath, JSON.stringify(config2, null, 2), "utf-8");
   const readme = [
     `# ${input2.courseName}`,
     "",
@@ -20249,13 +20528,13 @@ async function setupWorkspace(input2) {
     "tostudy vault sync      # Sincronizar progresso",
     "```"
   ].join("\n");
-  await fs12.writeFile(path15.join(workspacePath, "README.md"), readme, "utf-8");
+  await fs13.writeFile(path16.join(workspacePath, "README.md"), readme, "utf-8");
   return { workspacePath, directories: WORKSPACE_DIRS, configPath };
 }
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/workspace/extract-exercise.ts
-import fs13 from "node:fs/promises";
-import path16 from "node:path";
+import fs14 from "node:fs/promises";
+import path17 from "node:path";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/workspace/templates.ts
 var VITE_VERSION = "^6.0.0";
@@ -20367,16 +20646,16 @@ async function extractExercise(input2) {
   const lessonData = resolveWorkspaceTokens(input2.lessonData, paths);
   const moduleDir = `${padOrder(lessonData.moduleOrder)}-${lessonData.moduleSlug}`;
   const lessonDir = `${padOrder(lessonData.lessonOrder)}-${lessonData.lessonSlug}`;
-  const exercisePath = path16.join(workspacePath, "exercises", moduleDir, lessonDir);
-  await fs13.mkdir(exercisePath, { recursive: true });
+  const exercisePath = path17.join(workspacePath, "exercises", moduleDir, lessonDir);
+  await fs14.mkdir(exercisePath, { recursive: true });
   const extractedFiles = [];
   let hasStarterCode = false;
   if (lessonData.sandpackConfig?.files) {
     for (const [filePath, fileData] of Object.entries(lessonData.sandpackConfig.files)) {
       const cleanPath = filePath.startsWith("/") ? filePath.slice(1) : filePath;
-      const fullPath = path16.join(exercisePath, cleanPath);
-      await fs13.mkdir(path16.dirname(fullPath), { recursive: true });
-      await fs13.writeFile(fullPath, fileData.code, "utf-8");
+      const fullPath = path17.join(exercisePath, cleanPath);
+      await fs14.mkdir(path17.dirname(fullPath), { recursive: true });
+      await fs14.writeFile(fullPath, fileData.code, "utf-8");
       extractedFiles.push(cleanPath);
       hasStarterCode = true;
     }
@@ -20384,13 +20663,13 @@ async function extractExercise(input2) {
     const tierData = getTierData(lessonData.structuredData, exerciseTier2);
     const tierCode = tierData?.code;
     if (tierCode) {
-      await fs13.writeFile(path16.join(exercisePath, "exercise.js"), tierCode, "utf-8");
+      await fs14.writeFile(path17.join(exercisePath, "exercise.js"), tierCode, "utf-8");
       extractedFiles.push("exercise.js");
       hasStarterCode = true;
     } else {
       const starter = getStarterCode(lessonData.structuredData);
       if (starter) {
-        await fs13.writeFile(path16.join(exercisePath, "exercise.js"), starter, "utf-8");
+        await fs14.writeFile(path17.join(exercisePath, "exercise.js"), starter, "utf-8");
         extractedFiles.push("exercise.js");
         hasStarterCode = true;
       }
@@ -20408,8 +20687,8 @@ async function extractExercise(input2) {
           ...exerciseDeps
         }
       };
-      await fs13.writeFile(
-        path16.join(exercisePath, "package.json"),
+      await fs14.writeFile(
+        path17.join(exercisePath, "package.json"),
         JSON.stringify(pkgJson, null, 2),
         "utf-8"
       );
@@ -20421,20 +20700,20 @@ async function extractExercise(input2) {
       );
       for (const [configFile, configContent] of Object.entries(scaffold.configs)) {
         if (!sandpackFileNames.has(configFile)) {
-          await fs13.writeFile(path16.join(exercisePath, configFile), configContent, "utf-8");
+          await fs14.writeFile(path17.join(exercisePath, configFile), configContent, "utf-8");
           extractedFiles.push(configFile);
         }
       }
       const setupSh = `#!/bin/sh
 ${scaffold.setupScript}
 `;
-      await fs13.writeFile(path16.join(exercisePath, "setup.sh"), setupSh, "utf-8");
+      await fs14.writeFile(path17.join(exercisePath, "setup.sh"), setupSh, "utf-8");
       extractedFiles.push("setup.sh");
     }
   }
   const readme = generateReadme(lessonData, exerciseTier2);
-  const readmePath = path16.join(exercisePath, "README.md");
-  await fs13.writeFile(readmePath, readme, "utf-8");
+  const readmePath = path17.join(exercisePath, "README.md");
+  await fs14.writeFile(readmePath, readme, "utf-8");
   extractedFiles.push("README.md");
   return {
     exercisePath,
@@ -20490,11 +20769,11 @@ init_guards();
 init_course_state();
 init_resolve();
 init_errors();
-import path17 from "node:path";
+import path18 from "node:path";
 import os8 from "node:os";
-import fs14 from "node:fs/promises";
+import fs15 from "node:fs/promises";
 var logger19 = createLogger("cli:workspace");
-var workspaceCommand = new Command19("workspace").description(
+var workspaceCommand = new Command20("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) => {
@@ -20506,14 +20785,14 @@ workspaceCommand.command("setup").description(getErrors().workspaceSetupDescript
     let directories;
     if (!opts.path && cwdIsWorkspace) {
       const resolvedCwd = await resolveCwdWorkspacePath(process.cwd());
-      workspacePath = resolvedCwd ?? path17.join(process.cwd(), ".tostudy");
-      await fs14.mkdir(workspacePath, { recursive: true });
+      workspacePath = resolvedCwd ?? path18.join(process.cwd(), ".tostudy");
+      await fs15.mkdir(workspacePath, { recursive: true });
       directories = ["exercises", "generated", "notes", "diagrams"];
       for (const dir of directories) {
-        await fs14.mkdir(path17.join(workspacePath, dir), { recursive: true });
+        await fs15.mkdir(path18.join(workspacePath, dir), { recursive: true });
       }
-      const configPath = path17.join(workspacePath, ".ana-config.json");
-      await fs14.writeFile(
+      const configPath = path18.join(workspacePath, ".ana-config.json");
+      await fs15.writeFile(
         configPath,
         JSON.stringify(
           {
@@ -20531,7 +20810,7 @@ workspaceCommand.command("setup").description(getErrors().workspaceSetupDescript
         "utf-8"
       );
     } else {
-      const basePath = opts.path ?? path17.join(os8.homedir(), "study");
+      const basePath = opts.path ?? path18.join(os8.homedir(), "study");
       const result2 = await setupWorkspace({
         courseId: activeCourse.courseId,
         courseSlug: courseSlug(activeCourse.courseTitle),
@@ -20565,7 +20844,7 @@ Pr\xF3ximo passo: tostudy export
     process.exit(1);
   }
 });
-workspaceCommand.command("status").description("Mostrar status do workspace do curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path17.join(os8.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+workspaceCommand.command("status").description("Mostrar status do workspace do curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path18.join(os8.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const activeCourse = await requireActiveCourse();
     const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -20582,40 +20861,40 @@ workspaceCommand.command("status").description("Mostrar status do workspace do c
     const workspacePath = ws.workspacePath;
     let configData = null;
     try {
-      const raw2 = await fs14.readFile(path17.join(workspacePath, ".ana-config.json"), "utf-8");
+      const raw2 = await fs15.readFile(path18.join(workspacePath, ".ana-config.json"), "utf-8");
       configData = JSON.parse(raw2);
     } catch {
       configData = null;
     }
-    const exercisesDir = path17.join(workspacePath, "exercises");
+    const exercisesDir = path18.join(workspacePath, "exercises");
     let exerciseCount = 0;
     try {
-      const moduleDirs = await fs14.readdir(exercisesDir);
+      const moduleDirs = await fs15.readdir(exercisesDir);
       for (const modDir of moduleDirs) {
-        const modPath = path17.join(exercisesDir, modDir);
-        const stat = await fs14.stat(modPath);
+        const modPath = path18.join(exercisesDir, modDir);
+        const stat = await fs15.stat(modPath);
         if (stat.isDirectory()) {
-          const lessonDirs = await fs14.readdir(modPath);
+          const lessonDirs = await fs15.readdir(modPath);
           for (const lessonDir of lessonDirs) {
-            const lessonPath2 = path17.join(modPath, lessonDir);
-            const lstat = await fs14.stat(lessonPath2);
+            const lessonPath2 = path18.join(modPath, lessonDir);
+            const lstat = await fs15.stat(lessonPath2);
             if (lstat.isDirectory()) exerciseCount++;
           }
         }
       }
     } catch {
     }
-    const generatedDir = path17.join(workspacePath, "generated");
+    const generatedDir = path18.join(workspacePath, "generated");
     let artifactCount = 0;
     try {
-      const files = await fs14.readdir(generatedDir);
+      const files = await fs15.readdir(generatedDir);
       artifactCount = files.length;
     } catch {
     }
-    const diagramsDir = path17.join(workspacePath, "diagrams");
+    const diagramsDir = path18.join(workspacePath, "diagrams");
     let diagramCount = 0;
     try {
-      const files = await fs14.readdir(diagramsDir);
+      const files = await fs15.readdir(diagramsDir);
       diagramCount = files.length;
     } catch {
     }
@@ -20662,16 +20941,16 @@ workspaceCommand.command("status").description("Mostrar status do workspace do c
 
 // src/commands/export.ts
 init_dist();
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 init_guards();
 init_course_state();
 init_resolve();
 init_errors();
-import path18 from "node:path";
+import path19 from "node:path";
 import os9 from "node:os";
-import fs15 from "node:fs/promises";
+import fs16 from "node:fs/promises";
 var logger20 = createLogger("cli:export");
-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) => {
+var exportCommand = new Command21("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", path19.join(os9.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -20689,21 +20968,21 @@ var exportCommand = new Command20("export").description("Extrair exerc\xEDcio at
       opts.path
     );
     if (ws.found && ws.source === "cwd" && ws.workspacePath) {
-      const configPath = path18.join(ws.workspacePath, ".ana-config.json");
+      const configPath = path19.join(ws.workspacePath, ".ana-config.json");
       let hasConfig = false;
       try {
-        await fs15.access(configPath);
+        await fs16.access(configPath);
         hasConfig = true;
       } catch {
       }
       if (!hasConfig) {
         const slug = courseSlug(activeCourse.courseTitle);
         logger20.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
-        await fs15.mkdir(ws.workspacePath, { recursive: true });
+        await fs16.mkdir(ws.workspacePath, { recursive: true });
         for (const dir of ["exercises", "generated", "notes", "diagrams"]) {
-          await fs15.mkdir(path18.join(ws.workspacePath, dir), { recursive: true });
+          await fs16.mkdir(path19.join(ws.workspacePath, dir), { recursive: true });
         }
-        await fs15.writeFile(
+        await fs16.writeFile(
           configPath,
           JSON.stringify(
             {
@@ -20721,7 +21000,7 @@ var exportCommand = new Command20("export").description("Extrair exerc\xEDcio at
           "utf-8"
         );
         await setCourseWorkspacePath(activeCourse.courseId, ws.workspacePath);
-        const isNamespaced = ws.workspacePath === path18.join(process.cwd(), ".tostudy");
+        const isNamespaced = ws.workspacePath === path19.join(process.cwd(), ".tostudy");
         process.stderr.write(
           isNamespaced ? `\u2728 Workspace inicializado em .tostudy/ (isolado do projeto).
 ` : `\u2728 Workspace inicializado nesta pasta.
@@ -20776,12 +21055,12 @@ init_guards();
 init_course_state();
 init_resolve();
 init_errors();
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 import { execFile as execFile3 } from "node:child_process";
-import path19 from "node:path";
+import path20 from "node:path";
 import os10 from "node:os";
 var logger21 = createLogger("cli:open");
-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) => {
+var openCommand = new Command22("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path20.join(os10.homedir(), "study")).action(async (opts) => {
   try {
     const activeCourse = await requireActiveCourse();
     const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -20816,14 +21095,14 @@ var openCommand = new Command21("open").description("Abrir workspace do curso na
 
 // src/commands/vault.ts
 init_dist();
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/vault/generate-vault-files.ts
 init_slug();
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/vault/write-vault.ts
-import fs16 from "node:fs/promises";
-import path20 from "node:path";
+import fs17 from "node:fs/promises";
+import path21 from "node:path";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/vault/types.ts
 var VAULT_MARKER_FILENAME = ".ana-vault.json";
@@ -20832,20 +21111,20 @@ var VAULT_MARKER_VERSION = 1;
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/tostudy-core/src/vault/write-vault.ts
 async function writeVaultFiles(files, outputPath, courseId, courseSlug2) {
   for (const file2 of files) {
-    const fullPath = path20.join(outputPath, file2.relativePath);
-    await fs16.mkdir(path20.dirname(fullPath), { recursive: true });
-    await fs16.writeFile(fullPath, file2.content, "utf-8");
+    const fullPath = path21.join(outputPath, file2.relativePath);
+    await fs17.mkdir(path21.dirname(fullPath), { recursive: true });
+    await fs17.writeFile(fullPath, file2.content, "utf-8");
   }
-  const vaultPath = path20.join(outputPath, courseSlug2);
+  const vaultPath = path21.join(outputPath, courseSlug2);
   const marker = {
     courseId,
     courseSlug: courseSlug2,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     version: VAULT_MARKER_VERSION
   };
-  await fs16.mkdir(vaultPath, { recursive: true });
-  await fs16.writeFile(
-    path20.join(vaultPath, VAULT_MARKER_FILENAME),
+  await fs17.mkdir(vaultPath, { recursive: true });
+  await fs17.writeFile(
+    path21.join(vaultPath, VAULT_MARKER_FILENAME),
     JSON.stringify(marker, null, 2),
     "utf-8"
   );
@@ -20858,12 +21137,12 @@ init_guards();
 init_course_state();
 init_resolve();
 init_errors();
-import path21 from "node:path";
+import path22 from "node:path";
 import os11 from "node:os";
-import fs17 from "node:fs/promises";
+import fs18 from "node:fs/promises";
 var logger22 = createLogger("cli:vault");
-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) => {
+var vaultCommand = new Command23("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", path22.join(os11.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -20944,7 +21223,7 @@ Para visualizar:
     process.exit(1);
   }
 });
-vaultCommand.command("sync").description("Sincronizar progresso do curso com o vault local").option("--path <dir>", "Diret\xF3rio base do workspace", path21.join(os11.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+vaultCommand.command("sync").description("Sincronizar progresso do curso com o vault local").option("--path <dir>", "Diret\xF3rio base do workspace", path22.join(os11.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
   try {
     const session = await requireSession();
     const activeCourse = await requireActiveCourse();
@@ -20970,8 +21249,8 @@ vaultCommand.command("sync").description("Sincronizar progresso do curso com o v
     const data = createHttpProvider(session.apiUrl, session.token);
     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");
+    const markerPath = path22.join(vaultPath, ".ana-vault.json");
+    const markerRaw = await fs18.readFile(markerPath, "utf-8");
     const marker = JSON.parse(markerRaw);
     marker.lastSyncedAt = (/* @__PURE__ */ new Date()).toISOString();
     marker.progress = {
@@ -20979,10 +21258,10 @@ vaultCommand.command("sync").description("Sincronizar progresso do curso com o v
       currentModule: progress.currentModule.title,
       currentLesson: progress.currentLesson.title
     };
-    await fs17.writeFile(markerPath, JSON.stringify(marker, null, 2), "utf-8");
-    const courseIndexPath = path21.join(vaultPath, slug, "index.md");
+    await fs18.writeFile(markerPath, JSON.stringify(marker, null, 2), "utf-8");
+    const courseIndexPath = path22.join(vaultPath, slug, "index.md");
     try {
-      let indexContent = await fs17.readFile(courseIndexPath, "utf-8");
+      let indexContent = await fs18.readFile(courseIndexPath, "utf-8");
       indexContent = indexContent.replace(/\n---\n\n> 📊 Progresso:.*\n/g, "");
       const titleEnd = indexContent.indexOf("\n");
       if (titleEnd !== -1) {
@@ -20993,7 +21272,7 @@ vaultCommand.command("sync").description("Sincronizar progresso do curso com o v
 `;
         indexContent = indexContent.slice(0, titleEnd) + banner + indexContent.slice(titleEnd);
       }
-      await fs17.writeFile(courseIndexPath, indexContent, "utf-8");
+      await fs18.writeFile(courseIndexPath, indexContent, "utf-8");
     } catch {
     }
     const syncedAt = marker.lastSyncedAt;
@@ -21034,8 +21313,8 @@ init_dist();
 init_formatter();
 init_errors();
 import os13 from "node:os";
-import path25 from "node:path";
-import { Command as Command24 } from "commander";
+import path26 from "node:path";
+import { Command as Command25 } from "commander";
 
 // ../../../../../Users/cleitonparis/www/pg/apps/cursos/packages/validators/src/authored-course.ts
 import { createHash } from "node:crypto";
@@ -21308,12 +21587,12 @@ function assembleAuthoredCourse(manifest, files) {
 init_guards();
 
 // src/creator/state.ts
-import fs18 from "node:fs/promises";
-import path22 from "node:path";
-var STATE_FILE = path22.join(".tostudy", "creator.json");
+import fs19 from "node:fs/promises";
+import path23 from "node:path";
+var STATE_FILE = path23.join(".tostudy", "creator.json");
 async function readCreatorState(root) {
   try {
-    const parsed = JSON.parse(await fs18.readFile(path22.join(root, STATE_FILE), "utf-8"));
+    const parsed = JSON.parse(await fs19.readFile(path23.join(root, STATE_FILE), "utf-8"));
     const hashes = parsed.baseHashes;
     const wellFormed = Array.isArray(hashes) && hashes.every(
       (mod) => Array.isArray(mod) && // wire shape of authoredCoursePushSchema.baseHashes; anything else is not a base we can send
@@ -21329,9 +21608,9 @@ async function readCreatorState(root) {
   }
 }
 async function writeCreatorState(root, state) {
-  const file2 = path22.join(root, STATE_FILE);
-  await fs18.mkdir(path22.dirname(file2), { recursive: true });
-  await fs18.writeFile(file2, JSON.stringify(state, null, 2) + "\n", "utf-8");
+  const file2 = path23.join(root, STATE_FILE);
+  await fs19.mkdir(path23.dirname(file2), { recursive: true });
+  await fs19.writeFile(file2, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 function changedSlots(baseHashes, remoteHashes, incomingHashes) {
   const changed = [];
@@ -21348,9 +21627,9 @@ function changedSlots(baseHashes, remoteHashes, incomingHashes) {
 // src/creator/workspace.ts
 init_errors();
 import { randomUUID } from "node:crypto";
-import fs19 from "node:fs/promises";
+import fs20 from "node:fs/promises";
 import os12 from "node:os";
-import path23 from "node:path";
+import path24 from "node:path";
 var MANIFEST_FILE2 = "tostudy.json";
 var STATE_GITIGNORE_ENTRY = ".tostudy/creator.json";
 var CreatorWorkspaceError = class extends Error {
@@ -21364,10 +21643,10 @@ var CreatorWorkspaceError = class extends Error {
   file;
 };
 function assertInsideRoot(root, relPath) {
-  const abs = path23.resolve(root, relPath);
-  const back = path23.relative(path23.resolve(root), abs);
-  const escapes = back === "" || back === ".." || back.startsWith(`..${path23.sep}`) || path23.isAbsolute(back);
-  if (path23.isAbsolute(relPath) || escapes) {
+  const abs = path24.resolve(root, relPath);
+  const back = path24.relative(path24.resolve(root), abs);
+  const escapes = back === "" || back === ".." || back.startsWith(`..${path24.sep}`) || path24.isAbsolute(back);
+  if (path24.isAbsolute(relPath) || escapes) {
     throw new CreatorWorkspaceError(
       "PATH_OUTSIDE_ROOT",
       fillTemplate(getErrors().creator.pathOutsideRoot, { path: relPath }),
@@ -21377,9 +21656,9 @@ function assertInsideRoot(root, relPath) {
   return abs;
 }
 function assertNotHome(dir, home = os12.homedir()) {
-  const resolvedHome = path23.resolve(home);
-  const resolved = path23.resolve(dir);
-  const prefix = resolved.endsWith(path23.sep) ? resolved : resolved + path23.sep;
+  const resolvedHome = path24.resolve(home);
+  const resolved = path24.resolve(dir);
+  const prefix = resolved.endsWith(path24.sep) ? resolved : resolved + path24.sep;
   if (resolved === resolvedHome || resolvedHome.startsWith(prefix)) {
     throw new CreatorWorkspaceError("REFUSED_AT_HOME", getErrors().creator.refusedAtHome);
   }
@@ -21398,7 +21677,7 @@ function manifestLessonPaths(manifestRaw) {
 async function readManifest(root) {
   let text2;
   try {
-    text2 = await fs19.readFile(path23.join(root, MANIFEST_FILE2), "utf-8");
+    text2 = await fs20.readFile(path24.join(root, MANIFEST_FILE2), "utf-8");
   } catch {
     throw new CreatorWorkspaceError(
       "MANIFEST_MISSING",
@@ -21417,7 +21696,7 @@ async function readManifest(root) {
   }
 }
 async function readCourseId(dir) {
-  const manifest = await readManifest(path23.resolve(dir));
+  const manifest = await readManifest(path24.resolve(dir));
   const courseId = manifest?.courseId;
   if (typeof courseId !== "string" || courseId.length === 0) {
     throw new CreatorWorkspaceError(
@@ -21431,23 +21710,23 @@ async function readCourseId(dir) {
 async function readInside(root, realRoot, relPath) {
   let real;
   try {
-    real = await fs19.realpath(path23.resolve(root, relPath));
+    real = await fs20.realpath(path24.resolve(root, relPath));
   } catch {
     return null;
   }
-  if (!real.startsWith(realRoot + path23.sep)) {
+  if (!real.startsWith(realRoot + path24.sep)) {
     throw new CreatorWorkspaceError(
       "PATH_OUTSIDE_ROOT",
       fillTemplate(getErrors().creator.pathOutsideRoot, { path: relPath }),
       relPath
     );
   }
-  return fs19.readFile(real, "utf-8");
+  return fs20.readFile(real, "utf-8");
 }
 async function readWorkspace(dir) {
-  const root = path23.resolve(dir);
+  const root = path24.resolve(dir);
   const manifestRaw = await readManifest(root);
-  const realRoot = await fs19.realpath(root);
+  const realRoot = await fs20.realpath(root);
   const files = {};
   for (const relPath of manifestLessonPaths(manifestRaw).flat()) {
     assertInsideRoot(root, relPath);
@@ -21459,18 +21738,18 @@ async function readWorkspace(dir) {
   return { manifestRaw, files, root };
 }
 async function ensureGitignore(root) {
-  const file2 = path23.join(root, ".gitignore");
-  const current = await fs19.readFile(file2, "utf-8").catch(() => "");
+  const file2 = path24.join(root, ".gitignore");
+  const current = await fs20.readFile(file2, "utf-8").catch(() => "");
   if (current.split(/\r?\n/).some((line) => line.trim() === STATE_GITIGNORE_ENTRY)) return false;
   const separator = current.length === 0 || current.endsWith("\n") ? "" : "\n";
-  await fs19.writeFile(file2, `${current}${separator}${STATE_GITIGNORE_ENTRY}
+  await fs20.writeFile(file2, `${current}${separator}${STATE_GITIGNORE_ENTRY}
 `, "utf-8");
   return true;
 }
 async function scaffoldWorkspace(dir, home) {
-  const root = path23.resolve(dir);
+  const root = path24.resolve(dir);
   assertNotHome(root, home);
-  await fs19.mkdir(root, { recursive: true });
+  await fs20.mkdir(root, { recursive: true });
   const files = [];
   let courseId = randomUUID();
   let manifestCreated = true;
@@ -21481,11 +21760,11 @@ async function scaffoldWorkspace(dir, home) {
     modules: [{ title: "", description: "", objectives: [], lessons: [] }]
   };
   try {
-    await fs19.writeFile(path23.join(root, MANIFEST_FILE2), JSON.stringify(manifest, null, 2) + "\n", {
+    await fs20.writeFile(path24.join(root, MANIFEST_FILE2), JSON.stringify(manifest, null, 2) + "\n", {
       encoding: "utf-8",
       flag: "wx"
     });
-    await fs19.mkdir(path23.join(root, "modules", "01"), { recursive: true });
+    await fs20.mkdir(path24.join(root, "modules", "01"), { recursive: true });
     files.push(MANIFEST_FILE2, "modules/01/");
   } catch (err) {
     if (err.code !== "EEXIST") throw err;
@@ -21547,8 +21826,8 @@ async function validateWorkspace(dir, opts = {}) {
 }
 
 // src/creator/pull.ts
-import fs20 from "node:fs/promises";
-import path24 from "node:path";
+import fs21 from "node:fs/promises";
+import path25 from "node:path";
 init_errors();
 function stripToSchema(schema, value) {
   const current = structuredClone(value);
@@ -21573,17 +21852,17 @@ function stripToSchema(schema, value) {
 }
 async function exists(file2) {
   try {
-    await fs20.access(file2);
+    await fs21.access(file2);
     return true;
   } catch {
     return false;
   }
 }
 async function assertWritableInside(realRoot, root, rel) {
-  const abs = path24.resolve(root, rel);
+  const abs = path25.resolve(root, rel);
   let target;
   try {
-    target = await fs20.lstat(abs);
+    target = await fs21.lstat(abs);
   } catch {
     target = void 0;
   }
@@ -21594,10 +21873,10 @@ async function assertWritableInside(realRoot, root, rel) {
       rel
     );
   }
-  let dir = path24.dirname(abs);
-  while (!await exists(dir)) dir = path24.dirname(dir);
-  const realDir = await fs20.realpath(dir);
-  if (realDir !== realRoot && !realDir.startsWith(realRoot + path24.sep)) {
+  let dir = path25.dirname(abs);
+  while (!await exists(dir)) dir = path25.dirname(dir);
+  const realDir = await fs21.realpath(dir);
+  if (realDir !== realRoot && !realDir.startsWith(realRoot + path25.sep)) {
     throw new CreatorWorkspaceError(
       "PATH_OUTSIDE_ROOT",
       fillTemplate(getErrors().creator.pathOutsideRoot, { path: rel }),
@@ -21606,7 +21885,7 @@ async function assertWritableInside(realRoot, root, rel) {
   }
 }
 async function applyPull(root, manifestRaw, remoteModules) {
-  const realRoot = await fs20.realpath(root);
+  const realRoot = await fs21.realpath(root);
   const local = manifestLessonPaths(manifestRaw);
   const localShape = local.map((mod) => mod.length);
   const remoteShape = remoteModules.map((mod) => mod.lessons.length);
@@ -21625,7 +21904,7 @@ async function applyPull(root, manifestRaw, remoteModules) {
       assertInsideRoot(root, rel);
       const contract = stripped.data;
       const sidecarRel = sidecarPath(rel);
-      if (await exists(path24.resolve(root, sidecarRel))) {
+      if (await exists(path25.resolve(root, sidecarRel))) {
         const { teachingContent, ...rest } = contract;
         planned.push({ rel: sidecarRel, text: String(teachingContent ?? "") });
         planned.push({ rel, text: `${JSON.stringify(rest, null, 2)}
@@ -21641,9 +21920,9 @@ async function applyPull(root, manifestRaw, remoteModules) {
     await assertWritableInside(realRoot, root, file2.rel);
   }
   for (const file2 of planned) {
-    const abs = path24.resolve(root, file2.rel);
-    await fs20.mkdir(path24.dirname(abs), { recursive: true });
-    await fs20.writeFile(abs, file2.text, "utf-8");
+    const abs = path25.resolve(root, file2.rel);
+    await fs21.mkdir(path25.dirname(abs), { recursive: true });
+    await fs21.writeFile(abs, file2.text, "utf-8");
   }
   return { kind: "written", files: planned.map((file2) => file2.rel) };
 }
@@ -21977,7 +22256,7 @@ function installCreatorSkill(input2) {
 // src/commands/brief-open.ts
 init_guards();
 init_formatter();
-import { Command as Command23 } from "commander";
+import { Command as Command24 } 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";
@@ -22002,7 +22281,7 @@ function openUrl(url2, options = {}) {
     }
   });
 }
-var briefOpenCommand = new Command23("brief-open").description("Open the learner brief editor in your web browser").action(async () => {
+var briefOpenCommand = new Command24("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);
@@ -22010,7 +22289,7 @@ var briefOpenCommand = new Command23("brief-open").description("Open the learner
 
 // src/commands/creator.ts
 var logger23 = createLogger("cli:creator");
-var creatorCommand = new Command24("creator").description(
+var creatorCommand = new Command25("creator").description(
   "Author a course with your own AI agent: init, validate, push, pull, audit, status, open"
 );
 function fail(err, opts, context) {
@@ -22024,7 +22303,7 @@ function fail(err, opts, context) {
 creatorCommand.command("init").description("Create an authoring workspace (tostudy.json, modules/01) and install the skill").argument("[dir]", "Workspace folder", ".").option("--all-runtimes", "Install the skill for every supported runtime, detected or not").option("--json", "Output structured JSON").action(async (dir, opts) => {
   try {
     const home = os13.homedir();
-    const scaffold = await scaffoldWorkspace(path25.resolve(process.cwd(), dir), home);
+    const scaffold = await scaffoldWorkspace(path26.resolve(process.cwd(), dir), home);
     const kept = [];
     const installed = installCreatorSkill({
       cwd: scaffold.root,
@@ -22307,8 +22586,8 @@ creatorCommand.command("open").description("Open the course in the creator porta
 init_guards();
 init_course_state();
 init_user_profile();
-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) => {
+import { Command as Command26 } from "commander";
+var profileCommand = new Command26("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();
@@ -22370,10 +22649,10 @@ var profileCommand = new Command25("profile").description("Show your learner pro
 init_dist();
 init_guards();
 init_formatter();
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 init_workspace_state();
 var logger24 = createLogger("cli:sync");
-var syncCommand = new Command26("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").option(
+var syncCommand = new Command27("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(
@@ -22445,10 +22724,10 @@ var syncCommand = new Command26("sync").description("Regenerate instruction file
 // src/commands/brief.ts
 init_dist();
 init_guards();
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 init_formatter();
 var logger25 = createLogger("cli:brief");
-var briefCommand = new Command27("brief").description("Show your base learner brief (T1) status and content").option("--json", "Output structured JSON").action(async (opts) => {
+var briefCommand = new Command28("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();
@@ -22489,10 +22768,10 @@ var briefCommand = new Command27("brief").description("Show your base learner br
 // src/commands/brief-create.ts
 init_dist();
 init_guards();
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 init_formatter();
 var logger26 = createLogger("cli:brief-create");
-var briefCreateCommand = new Command28("brief-create").description("Create your base learner brief via interactive prompts (T1 bootstrap)").action(async () => {
+var briefCreateCommand = new Command29("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 });
@@ -22525,22 +22804,22 @@ var briefCreateCommand = new Command28("brief-create").description("Create your
 init_dist();
 init_guards();
 init_workspace_state();
-import fs22 from "node:fs";
-import { Command as Command29 } from "commander";
+import fs23 from "node:fs";
+import { Command as Command30 } from "commander";
 
 // src/sessions/storage.ts
 init_dist();
-import fs21 from "node:fs";
-import path26 from "node:path";
+import fs22 from "node:fs";
+import path27 from "node:path";
 var logger27 = createLogger("cli:sessions");
 function sessionsDir(workspacePath) {
-  return path26.join(workspacePath, ".tostudy", "sessions");
+  return path27.join(workspacePath, ".tostudy", "sessions");
 }
 async function saveModuleSummary(workspacePath, input2) {
   const dir = sessionsDir(workspacePath);
-  fs21.mkdirSync(dir, { recursive: true });
+  fs22.mkdirSync(dir, { recursive: true });
   const filename = `module-${input2.moduleId}-summary.md`;
-  const filePath = path26.join(dir, filename);
+  const filePath = path27.join(dir, filename);
   const header = [
     "---",
     `moduleId: ${input2.moduleId}`,
@@ -22549,17 +22828,17 @@ async function saveModuleSummary(workspacePath, input2) {
     "---",
     ""
   ].join("\n");
-  fs21.writeFileSync(filePath, header + input2.summary, { mode: 384 });
+  fs22.writeFileSync(filePath, header + input2.summary, { mode: 384 });
   logger27.debug("Module summary saved", { moduleId: input2.moduleId, path: filePath });
   return filePath;
 }
 async function loadSessionContext(workspacePath) {
   const dir = sessionsDir(workspacePath);
-  if (!fs21.existsSync(dir)) return { moduleSummaries: [] };
-  const files = fs21.readdirSync(dir).filter((f) => f.startsWith("module-") && f.endsWith("-summary.md")).sort();
+  if (!fs22.existsSync(dir)) return { moduleSummaries: [] };
+  const files = fs22.readdirSync(dir).filter((f) => f.startsWith("module-") && f.endsWith("-summary.md")).sort();
   const summaries = [];
   for (const file2 of files) {
-    const content = fs21.readFileSync(path26.join(dir, file2), "utf-8");
+    const content = fs22.readFileSync(path27.join(dir, file2), "utf-8");
     const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
     if (!frontmatterMatch) continue;
     const meta3 = frontmatterMatch[1];
@@ -22575,7 +22854,7 @@ async function loadSessionContext(workspacePath) {
 // src/commands/compact.ts
 init_formatter();
 var logger28 = createLogger("cli:compact");
-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) => {
+var compactCommand = new Command30("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();
@@ -22583,7 +22862,7 @@ var compactCommand = new Command29("compact").description("Save a module study s
       if (opts.json) jsonError("no_workspace");
       error("Nenhum workspace encontrado.");
     }
-    const summary = fs22.readFileSync("/dev/stdin", "utf-8").trim();
+    const summary = fs23.readFileSync("/dev/stdin", "utf-8").trim();
     if (!summary) {
       if (opts.json) jsonError("empty_summary", { message: "Summary vazio" });
       error("Summary vazio. Envie o conte\xFAdo via stdin.");
@@ -22613,12 +22892,12 @@ var compactCommand = new Command29("compact").description("Save a module study s
 // src/commands/context.ts
 init_dist();
 init_workspace_state();
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 init_course_state();
 init_formatter();
 init_errors();
 var logger29 = createLogger("cli:context");
-var contextCommand = new Command30("context").description("Load session context (workspace state + module summaries) for LLM consumption").option("--json", "Output structured JSON").action(async (opts) => {
+var contextCommand = new Command31("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) {
@@ -22670,13 +22949,13 @@ var contextCommand = new Command30("context").description("Load session context
 
 // src/commands/memory.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 logger30 = createLogger("cli:memory");
-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) => {
+var memoryCommand = new Command32("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) {
@@ -22707,14 +22986,14 @@ var memoryCommand = new Command31("memory").description("Load accumulated studen
 
 // src/commands/insight.ts
 init_dist();
-import { Command as Command32 } from "commander";
+import { Command as Command33 } 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 Command32("insight").description(
+var insightCommand = new Command33("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 {
@@ -22762,7 +23041,7 @@ var insightCommand = new Command32("insight").description(
 
 // src/commands/level.ts
 init_dist();
-import { Command as Command33 } from "commander";
+import { Command as Command34 } from "commander";
 init_guards();
 init_formatter();
 var logger32 = createLogger("cli:level");
@@ -22777,7 +23056,7 @@ var LEVEL_LABELS2 = {
 function isExerciseLevel2(value) {
   return ALL_LEVELS.includes(value);
 }
-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) => {
+var levelCommand = new Command34("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();
@@ -22842,10 +23121,10 @@ init_dist();
 init_guards();
 init_formatter();
 init_errors();
-import { Command as Command34 } from "commander";
+import { Command as Command35 } from "commander";
 var logger33 = createLogger("cli:theory");
 var EXERCISE_LEVELS2 = ["L0", "L1", "L2", "L3", "L4"];
-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) => {
+var theoryCommand = new Command35("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();
@@ -22940,7 +23219,7 @@ var theoryCommand = new Command34("theory").description("Request more theory on
 // src/commands/export-grades.ts
 init_dist();
 init_guards();
-import { Command as Command35 } from "commander";
+import { Command as Command36 } from "commander";
 
 // src/formatters/grades.ts
 function formatGradesJson(attempts) {
@@ -23308,7 +23587,7 @@ async function runExportGrades(opts, deps = defaultDeps5) {
   if (!rendered.endsWith("\n")) rendered += "\n";
   deps.stdoutWrite(rendered);
 }
-var exportGradesCommand = new Command35("export-grades").description("Exporta o hist\xF3rico de valida\xE7\xF5es (notas) do curso ativo").option(
+var exportGradesCommand = new Command36("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(
@@ -23332,7 +23611,7 @@ C\xF3digos de sa\xEDda:
 
 // src/commands/grades.ts
 init_dist();
-import { Command as Command36 } from "commander";
+import { Command as Command37 } from "commander";
 init_guards();
 var logger35 = createLogger("cli:grades");
 var defaultDeps6 = {
@@ -23488,7 +23767,7 @@ async function runGrades(opts, deps = defaultDeps6) {
   );
   deps.stdoutWrite(formatGradesAllEnrollmentsTable(summaries) + "\n");
 }
-var gradesCommand = new Command36("grades").description("Mostra um resumo das notas (todas as matr\xEDculas ou um curso espec\xEDfico)").option(
+var gradesCommand = new Command37("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(
@@ -23512,7 +23791,7 @@ C\xF3digos de sa\xEDda:
 // src/commands/review.ts
 init_dist();
 init_guards();
-import { Command as Command37 } from "commander";
+import { Command as Command38 } from "commander";
 import { createInterface } from "node:readline/promises";
 import { stdin as defaultStdin, stdout as defaultStdout } from "node:process";
 var logger36 = createLogger("cli:review");
@@ -23662,7 +23941,7 @@ async function runReview(slug, opts, deps = defaultDeps7) {
     }) + "\n"
   );
 }
-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(
+var reviewCommand = new Command38("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:
@@ -23685,12 +23964,12 @@ C\xF3digos de sa\xEDda:
 
 // src/cli.ts
 function createProgram() {
-  const program = new Command38();
+  const program = new Command39();
   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 enroll <id> \u2192 courses \u2192 select <n> \u2192 start",
+      "  Come\xE7ando:   login \u2192 suggest \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)",
       ""
@@ -23702,6 +23981,7 @@ function createProgram() {
   program.addCommand(loginCommand);
   program.addCommand(logoutCommand);
   program.addCommand(coursesCommand);
+  program.addCommand(suggestCommand);
   program.addCommand(enrollCommand);
   program.addCommand(selectCommand);
   program.addCommand(progressCommand);
@@ -23738,12 +24018,12 @@ function createProgram() {
 
 // src/auto-updater.ts
 init_config_dir();
-import fs23 from "node:fs";
-import path27 from "node:path";
+import fs24 from "node:fs";
+import path28 from "node:path";
 import { spawn as spawn2 } from "node:child_process";
 var PACKAGE_NAME2 = "@tostudy-ai/cli";
 function detectManager(entryRealPath) {
-  const p = entryRealPath.split(path27.sep).join("/");
+  const p = entryRealPath.split(path28.sep).join("/");
   if (p.includes("/pnpm/")) return { cmd: "pnpm", args: ["add", "-g", `${PACKAGE_NAME2}@latest`] };
   if (p.includes("/.bun/")) return { cmd: "bun", args: ["add", "-g", `${PACKAGE_NAME2}@latest`] };
   if (p.includes(`/node_modules/${PACKAGE_NAME2}/`))
@@ -23751,10 +24031,10 @@ function detectManager(entryRealPath) {
   return null;
 }
 function installDir(entryRealPath) {
-  const normalized = entryRealPath.split(path27.sep).join("/");
+  const normalized = entryRealPath.split(path28.sep).join("/");
   const marker = `/node_modules/${PACKAGE_NAME2}/`;
   const idx = normalized.indexOf(marker);
-  if (idx === -1) return path27.dirname(entryRealPath);
+  if (idx === -1) return path28.dirname(entryRealPath);
   return entryRealPath.slice(0, idx + marker.length - 1);
 }
 function maybeAutoUpdate(currentVersion, opts = {}) {
@@ -23770,10 +24050,10 @@ function maybeAutoUpdate(currentVersion, opts = {}) {
     if (cache.attemptedVersion === cache.latest) return;
     const entryPath = opts.entryPath ?? argv[1];
     if (!entryPath) return;
-    const real = fs23.realpathSync(entryPath);
+    const real = fs24.realpathSync(entryPath);
     const mgr = detectManager(real);
     if (!mgr) return;
-    fs23.accessSync(installDir(real), fs23.constants.W_OK);
+    fs24.accessSync(installDir(real), fs24.constants.W_OK);
     writeCache({ ...cache, attemptedVersion: cache.latest }, configDir);
     process.stderr.write(
       `