@tostudy-ai/cli 0.11.2 → 0.12.0

package/dist/cli.js

@@ -5,11 +5,20 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -104,7 +113,7 @@ var require_picocolors = __commonJS({
   }
 });
 
-// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-CG4i4G4l.mjs
+// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-DJVL2Rjl.mjs
 function formatJson(entry) {
   const { timestamp: timestamp2, level, message, service, environment, context, data, error: error49 } = entry;
   const output3 = {
@@ -226,18 +235,24 @@ function isSensitiveKey(key) {
     ].some((p) => lowerKey.includes(p));
   });
 }
-function serializeError(error49) {
+function serializeError(error49, visited = /* @__PURE__ */ new WeakSet()) {
   const serialized = {
     name: error49.name,
     message: error49.message
   };
   if (error49.stack) serialized.stack = error49.stack;
   if ("code" in error49 && typeof error49.code === "string") serialized.code = error49.code;
-  if (error49.cause instanceof Error) serialized.cause = serializeError(error49.cause);
+  visited.add(error49);
+  if (error49.cause instanceof Error) serialized.cause = visited.has(error49.cause) ? {
+    name: error49.cause.name,
+    message: "[Circular]"
+  } : serializeError(error49.cause, visited);
   return serialized;
 }
-function object(obj, additionalSensitiveKeys) {
+function object(obj, additionalSensitiveKeys, visited = /* @__PURE__ */ new WeakSet()) {
   if (!obj || typeof obj !== "object") return obj;
+  if (visited.has(obj)) return "[Circular]";
+  visited.add(obj);
   const sanitized = { ...obj };
   for (const [key, value] of Object.entries(sanitized)) {
     const isAdditionalKey = additionalSensitiveKeys?.some((k) => key.toLowerCase() === k.toLowerCase());
@@ -250,15 +265,23 @@ function object(obj, additionalSensitiveKeys) {
       continue;
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
-      sanitized[key] = object(value, additionalSensitiveKeys);
+      if (visited.has(value)) {
+        sanitized[key] = "[Circular]";
+        continue;
+      }
+      sanitized[key] = object(value, additionalSensitiveKeys, visited);
       continue;
     }
     if (Array.isArray(value)) sanitized[key] = value.map((item) => {
       if (item instanceof Error) return serializeError(item);
-      if (item && typeof item === "object" && !Array.isArray(item)) return object(item, additionalSensitiveKeys);
+      if (item && typeof item === "object" && !Array.isArray(item)) {
+        if (visited.has(item)) return "[Circular]";
+        return object(item, additionalSensitiveKeys, visited);
+      }
       return item;
     });
   }
+  visited.delete(obj);
   return sanitized;
 }
 function headers(hdrs) {
@@ -273,19 +296,24 @@ function headers(hdrs) {
   for (const key of Object.keys(sanitized)) if (sensitiveHeaders.some((h) => key.toLowerCase() === h)) sanitized[key] = "[REDACTED]";
   return sanitized;
 }
-function extractErrorInfo(error49, includeStack) {
+function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new WeakSet()) {
   const info = {
     name: error49.name,
     message: error49.message
   };
   if (includeStack && error49.stack) info.stack = error49.stack;
   if ("code" in error49 && typeof error49.code === "string") info.code = error49.code;
-  if (error49.cause instanceof Error) info.cause = extractErrorInfo(error49.cause, includeStack);
+  visited.add(error49);
+  if (error49.cause instanceof Error) if (visited.has(error49.cause)) info.cause = {
+    name: error49.cause.name,
+    message: "[Circular]"
+  };
+  else info.cause = extractErrorInfo(error49.cause, includeStack, visited);
   return info;
 }
 var import_picocolors, LOG_LEVELS, LEVEL_COLORS, LEVEL_WIDTH, SENSITIVE_FIELDS, sanitize, BaseLogger;
-var init_logger_base_CG4i4G4l = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-CG4i4G4l.mjs"() {
+var init_logger_base_DJVL2Rjl = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-DJVL2Rjl.mjs"() {
     import_picocolors = __toESM(require_picocolors(), 1);
     LOG_LEVELS = {
       trace: 0,
@@ -611,7 +639,7 @@ function createLogger(module, options) {
 var asyncLocalStorage, ConsoleTransport, FileTransport, HttpTransport, SINGLETON_KEY, Logger, logger;
 var init_dist = __esm({
   "../../node_modules/@parisgroup-ai/logger/dist/index.mjs"() {
-    init_logger_base_CG4i4G4l();
+    init_logger_base_DJVL2Rjl();
     asyncLocalStorage = new AsyncLocalStorage();
     ConsoleTransport = class {
       log(entry, formatted) {
@@ -784,14 +812,6 @@ var init_dist = __esm({
   }
 });
 
-// ../../packages/logger/src/index.ts
-var init_src = __esm({
-  "../../packages/logger/src/index.ts"() {
-    "use strict";
-    init_dist();
-  }
-});
-
 // ../../packages/tostudy-core/src/courses/list-courses.ts
 async function listCourses(input2, deps) {
   deps.logger.info("tostudy-core: listCourses", { userId: input2.userId });
@@ -836,7 +856,7 @@ var init_courses = __esm({
 });
 
 // ../../packages/tostudy-core/src/adapters/http.ts
-async function apiFetch(url2, token2, init) {
+async function cliApiFetch(url2, token2, init) {
   const response = await fetch(url2, {
     ...init,
     headers: {
@@ -856,7 +876,7 @@ function createHttpProvider(apiUrl, token2) {
   return {
     courses: {
       list: async (_userId) => {
-        const res = await apiFetch(`${base}/courses`, token2);
+        const res = await cliApiFetch(`${base}/courses`, token2);
         return res.courses;
       },
       listCreatorCourses: async (filters) => {
@@ -868,26 +888,29 @@ function createHttpProvider(apiUrl, token2) {
         if (filters.limit) params.append("limit", filters.limit.toString());
         if (filters.offset) params.append("offset", filters.offset.toString());
         if (filters.projectId) params.append("projectId", filters.projectId);
-        const res = await apiFetch(
+        const res = await cliApiFetch(
           `${base}/creator-courses?${params.toString()}`,
           token2
         );
         return res.courses;
       },
       select: async (_userId, courseId) => {
-        const res = await apiFetch(`${base}/courses/select`, token2, {
+        const res = await cliApiFetch(`${base}/courses/select`, token2, {
           method: "POST",
           body: JSON.stringify({ courseId })
         });
         return res.course;
       },
       getProgress: async (enrollmentId) => {
-        return apiFetch(`${base}/progress?enrollmentId=${encodeURIComponent(enrollmentId)}`, token2);
+        return cliApiFetch(
+          `${base}/progress?enrollmentId=${encodeURIComponent(enrollmentId)}`,
+          token2
+        );
       }
     },
     lessons: {
       next: async (enrollmentId, userConfirmation) => {
-        return apiFetch(`${base}/lessons/next`, token2, {
+        return cliApiFetch(`${base}/lessons/next`, token2, {
           method: "POST",
           body: JSON.stringify({ enrollmentId, userConfirmation })
         });
@@ -895,22 +918,22 @@ function createHttpProvider(apiUrl, token2) {
       getContent: async (lessonId, enrollmentId) => {
         const params = new URLSearchParams({ lessonId });
         if (enrollmentId) params.set("enrollmentId", enrollmentId);
-        return apiFetch(`${base}/lessons/content?${params.toString()}`, token2);
+        return cliApiFetch(`${base}/lessons/content?${params.toString()}`, token2);
       },
       getHint: async (_userId, enrollmentId) => {
-        return apiFetch(`${base}/lessons/hint`, token2, {
+        return cliApiFetch(`${base}/lessons/hint`, token2, {
           method: "POST",
           body: JSON.stringify({ enrollmentId })
         });
       },
       startModule: async (enrollmentId) => {
-        return apiFetch(`${base}/modules/start`, token2, {
+        return cliApiFetch(`${base}/modules/start`, token2, {
           method: "POST",
           body: JSON.stringify({ enrollmentId })
         });
       },
       startNextModule: async (enrollmentId) => {
-        return apiFetch(`${base}/modules/start-next`, token2, {
+        return cliApiFetch(`${base}/modules/start-next`, token2, {
           method: "POST",
           body: JSON.stringify({ enrollmentId })
         });
@@ -933,17 +956,17 @@ function createHttpProvider(apiUrl, token2) {
     },
     exercises: {
       validate: async (lessonId, solution, _userId, enrollmentId) => {
-        return apiFetch(`${base}/exercises/validate`, token2, {
+        return cliApiFetch(`${base}/exercises/validate`, token2, {
           method: "POST",
           body: JSON.stringify({ lessonId, solution, enrollmentId })
         });
       },
       getEnrollmentLevels: async (enrollmentId) => {
         const params = new URLSearchParams({ enrollmentId });
-        return apiFetch(`${base}/enrollments/levels?${params.toString()}`, token2);
+        return cliApiFetch(`${base}/enrollments/levels?${params.toString()}`, token2);
       },
       setEnrollmentLevel: async (enrollmentId, level) => {
-        return apiFetch(`${base}/enrollments/levels`, token2, {
+        return cliApiFetch(`${base}/enrollments/levels`, token2, {
           method: "POST",
           body: JSON.stringify({ enrollmentId, level })
         });
@@ -955,6 +978,16 @@ function createHttpProvider(apiUrl, token2) {
           "createModuleSession is not available via HTTP adapter. Use the Drizzle adapter for session management."
         );
       }
+    },
+    memory: {
+      getContext: async (courseId, enrollmentId) => {
+        const params = new URLSearchParams({ courseId, enrollmentId });
+        return cliApiFetch(`${base}/memory?${params.toString()}`, token2);
+      },
+      recordInsight: async (input2) => cliApiFetch(`${base}/memory/record-insight`, token2, {
+        method: "POST",
+        body: JSON.stringify(input2)
+      })
     }
   };
 }
@@ -968,6 +1001,7 @@ var init_http = __esm({
         this.status = status;
         this.name = "CliApiError";
       }
+      status;
     };
   }
 });
@@ -1607,8 +1641,9 @@ Rode \`tostudy context --json\` em sil\xEAncio para descobrir o estado do aluno.
 ### Se tudo pronto (workspace + curso + contexto):
 
 1. Leia os \`moduleSummaries\` do resultado para saber o que o aluno j\xE1 estudou.
-2. Se houver summaries, mencione brevemente: "Da \xFAltima vez paramos em {ultimoModulo}. Pronto pra continuar?"
-3. Siga "Como Conduzir a Aula" abaixo.`);
+2. Rode \`tostudy memory --json\` em sil\xEAncio para carregar o perfil do aluno (dificuldades conhecidas, pontos fortes) e os resumos das li\xE7\xF5es recentes. Use esse contexto para adaptar a aula \u2014 n\xE3o repita o que o aluno j\xE1 domina, e reforce os pontos onde ele teve dificuldade. NUNCA mostre esse bloco cru ao aluno.
+3. Se houver summaries, mencione brevemente: "Da \xFAltima vez paramos em {ultimoModulo}. Pronto pra continuar?"
+4. Siga "Como Conduzir a Aula" abaixo.`);
   sections.push(renderHowToConduct());
   sections.push(renderSilentTools());
   sections.push(`## Compacta\xE7\xE3o de Contexto (Autom\xE1tico)
@@ -1808,6 +1843,10 @@ Estes comandos s\xE3o suas ferramentas. Rode em sil\xEAncio (sem anunciar), use
 - \`tostudy hint --json\` \u2014 dica progressiva (3 n\xEDveis).
 - \`tostudy validate <arquivo>\` \u2014 valida exerc\xEDcio (exit 0 = passou, 1 = falhou).
 
+- \`tostudy insight <tipo> "<descri\xE7\xE3o>" --json\` \u2014 registra na mem\xF3ria do curso um sinal cognitivo do aluno. Tipos: \`difficulty\` (travou ou confundiu um conceito), \`breakthrough\` (teve um clique, dominou algo), \`question\` (d\xFAvida recorrente).
+
+**Quando registrar insight:** em sil\xEAncio, ao perceber um desses sinais *reais* durante a aula \u2014 priorize \`difficulty\` (\xE9 o mais valioso pra adaptar as pr\xF3ximas li\xE7\xF5es). Use uma frase curta e espec\xEDfica (\u2264240 caracteres), no idioma do aluno. N\xE3o registre trivialidades nem repita o mesmo insight; no m\xE1ximo um ou dois por li\xE7\xE3o.
+
 Voc\xEA nunca menciona estes comandos ao aluno. Ele fala com VOC\xCA, n\xE3o com o CLI.`;
 }
 function renderHandlingSituations() {
@@ -1828,6 +1867,7 @@ function renderTechnicalReference() {
 - Use \`--json\` em qualquer comando para sa\xEDda estruturada.
 - \`tostudy validate\` retorna exit code 0 (aprovado) ou 1 (reprovado).
 - \`tostudy validate --stdin\` aceita solu\xE7\xE3o via pipe.
+- \`tostudy insight <difficulty|breakthrough|question> "<texto>"\` persiste um insight na mem\xF3ria cold do aluno (dedup autom\xE1tico; falha non-fatal).
 - \`tostudy lesson --json\` retorna \`{ type, title, content, hints, acceptanceCriteria }\`.
 - \`tostudy progress --json\` retorna \`{ coursePercent, currentModule, currentLesson }\`.`;
 }
@@ -1939,7 +1979,7 @@ var logger2;
 var init_instruction_files = __esm({
   "src/workspace/instruction-files.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_instruction_template_v3();
     logger2 = createLogger("cli:instruction-files");
   }
@@ -1948,6 +1988,72 @@ var init_instruction_files = __esm({
 // src/commands/login.ts
 import { Command } from "commander";
 import { execFile as execFile2 } from "node:child_process";
+function assertTrustedApiUrl(apiUrl) {
+  let url2;
+  try {
+    url2 = new URL(apiUrl);
+  } catch {
+    throw new Error(`API URL inv\xE1lida: ${apiUrl}`);
+  }
+  const host = url2.hostname.toLowerCase();
+  const isLocalhost = host === "localhost" || host === "127.0.0.1" || host === "::1";
+  const isToStudy = host === "tostudy.ai" || host.endsWith(".tostudy.ai");
+  if (isToStudy && url2.protocol === "https:") return;
+  if (isLocalhost && (url2.protocol === "https:" || url2.protocol === "http:")) return;
+  throw new Error(
+    `API URL n\xE3o confi\xE1vel: ${apiUrl}. Use https://tostudy.ai (ou um subdom\xEDnio) ou localhost.`
+  );
+}
+async function persistSession(data, apiUrl) {
+  await saveSession({
+    token: data.token,
+    refreshToken: data.refreshToken,
+    sessionId: data.sessionId,
+    userId: data.userId,
+    userName: data.userName,
+    expiresAt: data.expiresAt,
+    apiUrl
+  });
+}
+async function loginWithCode(code, apiUrl) {
+  assertTrustedApiUrl(apiUrl);
+  const res = await fetch(`${apiUrl}/api/cli/auth/exchange`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ code, client: "cli" })
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? "Falha na autentica\xE7\xE3o");
+  }
+  const data = await res.json();
+  await persistSession(data, apiUrl);
+  return data;
+}
+async function loginWithMagicLink(magicLinkUrl, apiUrl) {
+  assertTrustedApiUrl(apiUrl);
+  let token2;
+  try {
+    token2 = new URL(magicLinkUrl).searchParams.get("token");
+  } catch {
+    throw new Error("URL de magic-link inv\xE1lida");
+  }
+  if (!token2) {
+    throw new Error("Magic-link sem par\xE2metro token");
+  }
+  const res = await fetch(`${apiUrl}/api/cli/auth/exchange-magic-link`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ token: token2 })
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? "Falha na autentica\xE7\xE3o");
+  }
+  const data = await res.json();
+  await persistSession(data, apiUrl);
+  return data;
+}
 function ideToPlatform(ideName) {
   const lower = ideName.toLowerCase();
   if (lower.includes("claude")) return "claude";
@@ -1961,7 +2067,7 @@ var logger3, DEFAULT_API_URL, PORT, loginCommand;
 var init_login = __esm({
   "src/commands/login.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_courses();
     init_http();
     init_oauth_server();
@@ -1970,8 +2076,30 @@ var init_login = __esm({
     logger3 = createLogger("cli:login");
     DEFAULT_API_URL = "https://tostudy.ai";
     PORT = 9876;
-    loginCommand = new Command("login").description("Autentica no ToStudy via browser").option("--manual", "Login manual (sem browser)").option("--api-url <url>", "API URL override", DEFAULT_API_URL).action(async (opts) => {
+    loginCommand = new Command("login").description("Autentica no ToStudy via browser").option("--manual", "Login manual (sem browser)").option("--code <code>", "Login n\xE3o-interativo via c\xF3digo de autentica\xE7\xE3o").option("--magic-link <url>", "Login via URL de magic-link (recupera\xE7\xE3o)").option("--api-url <url>", "API URL override", DEFAULT_API_URL).action(async (opts) => {
       const apiUrl = opts.apiUrl;
+      if (opts.code) {
+        try {
+          const data = await loginWithCode(opts.code, apiUrl);
+          console.log(`
+  \u2713 Logado como ${data.userName}
+`);
+          return;
+        } catch (err) {
+          error(err instanceof Error ? err.message : "Login falhou");
+        }
+      }
+      if (opts.magicLink) {
+        try {
+          const data = await loginWithMagicLink(opts.magicLink, apiUrl);
+          console.log(`
+  \u2713 Logado como ${data.userName}
+`);
+          return;
+        } catch (err) {
+          error(err instanceof Error ? err.message : "Login falhou");
+        }
+      }
       if (opts.manual) {
         console.log(`
   Acesse este endere\xE7o no seu browser:`);
@@ -2333,7 +2461,8 @@ 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",
-      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"
+      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",
+      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"
     };
   }
 });
@@ -2352,7 +2481,8 @@ 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",
-      courseArchived: "This course has been archived and is available for reading only.\nUse `tostudy lesson` to review the content you've already studied.\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",
+      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"
     };
   }
 });
@@ -2388,6 +2518,10 @@ function isCourseArchivedError(err) {
   const msg = err instanceof Error ? err.message : String(err);
   return msg.includes("COURSE_ARCHIVED");
 }
+function isEnrollmentNotEntitledError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return msg.includes("ENROLLMENT_NOT_ENTITLED");
+}
 var BUNDLES, _cachedLocale;
 var init_errors = __esm({
   "src/errors/index.ts"() {
@@ -2584,7 +2718,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.11.2" : "0.7.1";
+    CLI_VERSION = true ? "0.12.0" : "0.7.1";
   }
 });
 
@@ -2598,16 +2732,9 @@ __export(update_checker_exports, {
 });
 import fs7 from "node:fs";
 import path9 from "node:path";
-import os6 from "node:os";
-function getConfigDir2() {
-  if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
-    return path9.join(process.env["XDG_CONFIG_HOME"], "tostudy");
-  }
-  return path9.join(os6.homedir(), ".tostudy");
-}
 function readCache() {
   try {
-    const p = path9.join(getConfigDir2(), CACHE_FILE);
+    const p = path9.join(getConfigDir(), CACHE_FILE);
     if (!fs7.existsSync(p)) return null;
     return JSON.parse(fs7.readFileSync(p, "utf-8"));
   } catch {
@@ -2616,7 +2743,7 @@ function readCache() {
 }
 function writeCache(cache) {
   try {
-    const dir = getConfigDir2();
+    const dir = getConfigDir();
     fs7.mkdirSync(dir, { recursive: true });
     fs7.writeFileSync(path9.join(dir, CACHE_FILE), JSON.stringify(cache));
   } catch {
@@ -2679,6 +2806,7 @@ var PACKAGE_NAME, CACHE_FILE, CHECK_INTERVAL_MS, REGISTRY_TIMEOUT_MS;
 var init_update_checker = __esm({
   "src/update-checker.ts"() {
     "use strict";
+    init_config_dir();
     PACKAGE_NAME = "@tostudy-ai/cli";
     CACHE_FILE = "update-check.json";
     CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
@@ -2688,19 +2816,12 @@ var init_update_checker = __esm({
 
 // src/learner-brief/cache.ts
 import fs8 from "node:fs";
-import os7 from "node:os";
 import path10 from "node:path";
-function getDefaultConfigDir() {
-  if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
-    return path10.join(process.env["XDG_CONFIG_HOME"], "tostudy");
-  }
-  return path10.join(os7.homedir(), ".tostudy");
-}
 function resolveCachePath(configDir) {
   return path10.join(configDir, "student-brief.json");
 }
 async function readBriefCache(configDir) {
-  const dir = configDir ?? getDefaultConfigDir();
+  const dir = configDir ?? getConfigDir();
   const p = resolveCachePath(dir);
   if (!fs8.existsSync(p)) return null;
   try {
@@ -2711,26 +2832,20 @@ async function readBriefCache(configDir) {
   }
 }
 async function writeBriefCache(configDir, cache) {
-  const dir = configDir ?? getDefaultConfigDir();
+  const dir = configDir ?? getConfigDir();
   fs8.mkdirSync(dir, { recursive: true });
   fs8.writeFileSync(resolveCachePath(dir), JSON.stringify(cache, null, 2), { mode: 384 });
 }
 var init_cache = __esm({
   "src/learner-brief/cache.ts"() {
     "use strict";
+    init_config_dir();
   }
 });
 
 // src/tutor-persona/cache.ts
 import fs9 from "node:fs";
-import os8 from "node:os";
 import path11 from "node:path";
-function getDefaultConfigDir2() {
-  if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
-    return path11.join(process.env["XDG_CONFIG_HOME"], "tostudy");
-  }
-  return path11.join(os8.homedir(), ".tostudy");
-}
 function resolveCachePath2(configDir) {
   return path11.join(configDir, "tutor-personalities.json");
 }
@@ -2748,12 +2863,12 @@ function writeAll(configDir, cache) {
   fs9.writeFileSync(resolveCachePath2(configDir), JSON.stringify(cache, null, 2), { mode: 384 });
 }
 async function readPersonaCacheForCourse(configDir, courseId) {
-  const dir = configDir ?? getDefaultConfigDir2();
+  const dir = configDir ?? getConfigDir();
   const all = readAll(dir);
   return all[courseId] ?? null;
 }
 async function writePersonaCacheForCourse(configDir, courseId, entry) {
-  const dir = configDir ?? getDefaultConfigDir2();
+  const dir = configDir ?? getConfigDir();
   const all = readAll(dir);
   all[courseId] = entry;
   writeAll(dir, all);
@@ -2761,6 +2876,7 @@ async function writePersonaCacheForCourse(configDir, courseId, entry) {
 var init_cache2 = __esm({
   "src/tutor-persona/cache.ts"() {
     "use strict";
+    init_config_dir();
   }
 });
 
@@ -2981,7 +3097,7 @@ var logger4, coursesCommand;
 var init_courses2 = __esm({
   "src/commands/courses.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_courses();
     init_http();
     init_guards();
@@ -3017,7 +3133,7 @@ var init_courses2 = __esm({
 // src/workspace/resolve.ts
 import fs10 from "node:fs/promises";
 import path12 from "node:path";
-import os9 from "node:os";
+import os6 from "node:os";
 function courseSlug(title) {
   return title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
 }
@@ -3048,7 +3164,7 @@ async function resolveCwdWorkspacePath(cwd = process.cwd()) {
     return null;
   }
 }
-async function findCwdWorkspaceUpwards(startCwd = process.cwd(), homeDir = os9.homedir()) {
+async function findCwdWorkspaceUpwards(startCwd = process.cwd(), homeDir = os6.homedir()) {
   const home = path12.resolve(homeDir);
   let current = path12.resolve(startCwd);
   while (true) {
@@ -3079,7 +3195,7 @@ async function findExistingVault(workspacePath, slug) {
     return null;
   }
 }
-async function resolveEffectiveWorkspace(courseTitle, storedPath, cwd = process.cwd(), defaultBasePath = DEFAULT_BASE, homeDir = os9.homedir()) {
+async function resolveEffectiveWorkspace(courseTitle, storedPath, cwd = process.cwd(), defaultBasePath = DEFAULT_BASE, homeDir = os6.homedir()) {
   const cwdWorkspace = await findCwdWorkspaceUpwards(cwd, homeDir);
   if (cwdWorkspace) {
     return { found: true, workspacePath: cwdWorkspace, source: "cwd" };
@@ -3101,7 +3217,7 @@ var DEFAULT_BASE;
 var init_resolve = __esm({
   "src/workspace/resolve.ts"() {
     "use strict";
-    DEFAULT_BASE = path12.join(os9.homedir(), "study");
+    DEFAULT_BASE = path12.join(os6.homedir(), "study");
   }
 });
 
@@ -3130,31 +3246,15 @@ var init_status = __esm({
 });
 
 // src/learner-brief/api.ts
-async function apiFetch2(url2, token2, init) {
-  const response = await fetch(url2, {
-    method: init?.method ?? "GET",
-    body: init?.body,
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${token2}`,
-      ...init?.headers ?? {}
-    }
-  });
-  const body = await response.json();
-  if (!response.ok) {
-    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
-  }
-  return body;
-}
 async function fetchLearnerBrief(input2) {
-  const response = await apiFetch2(
+  const response = await cliApiFetch(
     `${input2.apiUrl}/api/cli/student/learner-brief`,
     input2.token
   );
   return response.brief;
 }
 async function upsertLearnerBrief(input2) {
-  const response = await apiFetch2(
+  const response = await cliApiFetch(
     `${input2.apiUrl}/api/cli/student/learner-brief`,
     input2.token,
     {
@@ -3265,32 +3365,17 @@ var init_api2 = __esm({
 });
 
 // src/onboarding/api.ts
-async function apiFetch3(url2, token2, init) {
-  const response = await fetch(url2, {
-    ...init,
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${token2}`,
-      ...init?.headers
-    }
-  });
-  const body = await response.json();
-  if (!response.ok) {
-    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
-  }
-  return body;
-}
 async function getRemoteEnrollmentOnboarding(input2) {
   const url2 = new URL(`${input2.apiUrl}/api/cli/onboarding`);
   url2.searchParams.set("enrollmentId", input2.enrollmentId);
-  const response = await apiFetch3(
+  const response = await cliApiFetch(
     url2.toString(),
     input2.token
   );
   return response.onboarding;
 }
 async function saveRemoteEnrollmentOnboarding(input2) {
-  const response = await apiFetch3(
+  const response = await cliApiFetch(
     `${input2.apiUrl}/api/cli/onboarding`,
     input2.token,
     {
@@ -3465,7 +3550,7 @@ var logger5, defaultDeps2;
 var init_instruction_pipeline = __esm({
   "src/instruction-pipeline.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_workspace_marker();
     init_workspace_state();
     init_api();
@@ -3569,7 +3654,7 @@ var logger6;
 var init_pipeline_deps = __esm({
   "src/commands/_shared/pipeline-deps.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_courses();
     init_http();
     init_instruction_pipeline();
@@ -3580,18 +3665,19 @@ var init_pipeline_deps = __esm({
 
 // src/commands/select.ts
 import { Command as Command6 } from "commander";
-import os10 from "node:os";
+import os7 from "node:os";
 var logger7, selectCommand;
 var init_select = __esm({
   "src/commands/select.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_courses();
     init_http();
     init_guards();
     init_workspace_marker();
     init_resolve();
     init_formatter();
+    init_errors();
     init_status();
     init_instruction_pipeline();
     init_pipeline_deps();
@@ -3664,7 +3750,7 @@ var init_select = __esm({
           );
         } else {
           const slashCmd = courseSlug2 ? `/tostudy-${courseSlug2}` : "/tostudy";
-          const home = os10.homedir();
+          const home = os7.homedir();
           const cwd = process.cwd();
           const namespacedPath = `${cwd}/.tostudy`;
           let wsLine;
@@ -3699,6 +3785,10 @@ var init_select = __esm({
           output(lines.join("\n"), { json: false });
         }
       } catch (err) {
+        if (isEnrollmentNotEntitledError(err)) {
+          process.stderr.write(getErrors().enrollmentNotEntitled);
+          process.exit(1);
+        }
         const msg = err instanceof Error ? err.message : String(err);
         error(msg);
       }
@@ -3712,12 +3802,13 @@ var logger8, progressCommand;
 var init_progress = __esm({
   "src/commands/progress.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_courses();
     init_http();
     init_guards();
     init_course_state();
     init_formatter();
+    init_errors();
     logger8 = createLogger("cli:progress");
     progressCommand = new Command7("progress").description("Show your progress in the active course").option("--json", "Output structured JSON").action(async (opts) => {
       try {
@@ -3734,6 +3825,10 @@ var init_progress = __esm({
           output(formatProgress(progress3), { json: false });
         }
       } catch (err) {
+        if (isEnrollmentNotEntitledError(err)) {
+          process.stderr.write(getErrors().enrollmentNotEntitled);
+          process.exit(1);
+        }
         const msg = err instanceof Error ? err.message : String(err);
         error(msg);
       }
@@ -5287,7 +5382,7 @@ var init_query_promise = __esm({
 function mapResultRow(columns, row, joinsNotNullableMap) {
   const nullifyMap = {};
   const result = columns.reduce(
-    (result2, { path: path22, field }, columnIndex) => {
+    (result2, { path: path23, field }, columnIndex) => {
       let decoder;
       if (is(field, Column)) {
         decoder = field;
@@ -5299,8 +5394,8 @@ function mapResultRow(columns, row, joinsNotNullableMap) {
         decoder = field.sql.decoder;
       }
       let node = result2;
-      for (const [pathChunkIndex, pathChunk] of path22.entries()) {
-        if (pathChunkIndex < path22.length - 1) {
+      for (const [pathChunkIndex, pathChunk] of path23.entries()) {
+        if (pathChunkIndex < path23.length - 1) {
           if (!(pathChunk in node)) {
             node[pathChunk] = {};
           }
@@ -5308,8 +5403,8 @@ function mapResultRow(columns, row, joinsNotNullableMap) {
         } else {
           const rawValue = row[columnIndex];
           const value = node[pathChunk] = rawValue === null ? null : decoder.mapFromDriverValue(rawValue);
-          if (joinsNotNullableMap && is(field, Column) && path22.length === 2) {
-            const objectName = path22[0];
+          if (joinsNotNullableMap && is(field, Column) && path23.length === 2) {
+            const objectName = path23[0];
             if (!(objectName in nullifyMap)) {
               nullifyMap[objectName] = value === null ? getTableName(field.table) : false;
             } else if (typeof nullifyMap[objectName] === "string" && nullifyMap[objectName] !== getTableName(field.table)) {
@@ -9256,13 +9351,13 @@ function Subscribe(postgres2, options) {
       }
     }
     function handle(a, b2) {
-      const path22 = b2.relation.schema + "." + b2.relation.table;
+      const path23 = b2.relation.schema + "." + b2.relation.table;
       call("*", a, b2);
-      call("*:" + path22, a, b2);
-      b2.relation.keys.length && call("*:" + path22 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
+      call("*:" + path23, a, b2);
+      b2.relation.keys.length && call("*:" + path23 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
       call(b2.command, a, b2);
-      call(b2.command + ":" + path22, a, b2);
-      b2.relation.keys.length && call(b2.command + ":" + path22 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
+      call(b2.command + ":" + path23, a, b2);
+      b2.relation.keys.length && call(b2.command + ":" + path23 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
     }
     function pong() {
       const x2 = Buffer.alloc(34);
@@ -9375,8 +9470,8 @@ function parseEvent(x) {
   const xs = x.match(/^(\*|insert|update|delete)?:?([^.]+?\.?[^=]+)?=?(.+)?/i) || [];
   if (!xs)
     throw new Error("Malformed subscribe pattern: " + x);
-  const [, command, path22, key] = xs;
-  return (command || "*") + (path22 ? ":" + (path22.indexOf(".") === -1 ? "public." + path22 : path22) : "") + (key ? "=" + key : "");
+  const [, command, path23, key] = xs;
+  return (command || "*") + (path23 ? ":" + (path23.indexOf(".") === -1 ? "public." + path23 : path23) : "") + (key ? "=" + key : "");
 }
 var noop2;
 var init_subscribe = __esm({
@@ -9457,7 +9552,7 @@ var init_large = __esm({
 });
 
 // ../../node_modules/postgres/src/index.js
-import os11 from "os";
+import os8 from "os";
 import fs11 from "fs";
 function Postgres(a, b2) {
   const options = parseOptions(a, b2), subscribe = options.no_subscribe || Subscribe(Postgres, { ...options });
@@ -9514,10 +9609,10 @@ function Postgres(a, b2) {
       });
       return query;
     }
-    function file2(path22, args = [], options2 = {}) {
+    function file2(path23, args = [], options2 = {}) {
       arguments.length === 2 && !Array.isArray(args) && (options2 = args, args = []);
       const query = new Query([], args, (query2) => {
-        fs11.readFile(path22, "utf8", (err, string4) => {
+        fs11.readFile(path23, "utf8", (err, string4) => {
           if (err)
             return query2.reject(err);
           query2.strings = [string4];
@@ -9835,13 +9930,13 @@ function parseUrl(url2) {
 }
 function osUsername() {
   try {
-    return os11.userInfo().username;
+    return os8.userInfo().username;
   } catch (_) {
     return process.env.USERNAME || process.env.USER || process.env.LOGNAME;
   }
 }
 var src_default;
-var init_src2 = __esm({
+var init_src = __esm({
   "../../node_modules/postgres/src/index.js"() {
     init_types();
     init_connection();
@@ -14096,12 +14191,12 @@ var init_session2 = __esm({
     init_tracing();
     init_utils();
     PostgresJsPreparedQuery = class extends PgPreparedQuery {
-      constructor(client, queryString, params, logger31, cache, queryMetadata, cacheConfig, fields, _isResponseInArrayMode, customResultMapper) {
+      constructor(client, queryString, params, logger33, cache, queryMetadata, cacheConfig, fields, _isResponseInArrayMode, customResultMapper) {
         super({ sql: queryString, params }, cache, queryMetadata, cacheConfig);
         this.client = client;
         this.queryString = queryString;
         this.params = params;
-        this.logger = logger31;
+        this.logger = logger33;
         this.fields = fields;
         this._isResponseInArrayMode = _isResponseInArrayMode;
         this.customResultMapper = customResultMapper;
@@ -14242,11 +14337,11 @@ function construct(client, config2 = {}) {
   client.options.serializers["114"] = transparentParser;
   client.options.serializers["3802"] = transparentParser;
   const dialect = new PgDialect({ casing: config2.casing });
-  let logger31;
+  let logger33;
   if (config2.logger === true) {
-    logger31 = new DefaultLogger();
+    logger33 = new DefaultLogger();
   } else if (config2.logger !== false) {
-    logger31 = config2.logger;
+    logger33 = config2.logger;
   }
   let schema;
   if (config2.schema) {
@@ -14260,7 +14355,7 @@ function construct(client, config2 = {}) {
       tableNamesMap: tablesConfig.tableNamesMap
     };
   }
-  const session = new PostgresJsSession(client, dialect, schema, { logger: logger31, cache: config2.cache });
+  const session = new PostgresJsSession(client, dialect, schema, { logger: logger33, cache: config2.cache });
   const db2 = new PostgresJsDatabase(dialect, session, schema);
   db2.$client = client;
   db2.$cache = config2.cache;
@@ -14290,7 +14385,7 @@ function drizzle(...params) {
 var PostgresJsDatabase;
 var init_driver = __esm({
   "../../node_modules/drizzle-orm/postgres-js/driver.js"() {
-    init_src2();
+    init_src();
     init_entity();
     init_logger();
     init_db();
@@ -14575,10 +14670,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path22) {
-  if (!path22)
+function getElementAtPath(obj, path23) {
+  if (!path23)
     return obj;
-  return path22.reduce((acc, key) => acc?.[key], obj);
+  return path23.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -14890,11 +14985,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path22, issues) {
+function prefixIssues(path23, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path22);
+    iss.path.unshift(path23);
     return iss;
   });
 }
@@ -15136,7 +15231,7 @@ function formatError(error49, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error49, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error50, path22 = []) => {
+  const processError = (error50, path23 = []) => {
     var _a2, _b;
     for (const issue2 of error50.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -15146,7 +15241,7 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path22, ...issue2.path];
+        const fullpath = [...path23, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -15178,8 +15273,8 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path22 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path22) {
+  const path23 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path23) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -27873,13 +27968,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path22 = ref.slice(1).split("/").filter(Boolean);
-  if (path22.length === 0) {
+  const path23 = ref.slice(1).split("/").filter(Boolean);
+  if (path23.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path22[0] === defsKey) {
-    const key = path22[1];
+  if (path23[0] === defsKey) {
+    const key = path23[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -28644,6 +28739,7 @@ var init_users = __esm({
   "../../packages/database/src/schema/users.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     userRoleEnum = pgEnum("user_role", [
       "student",
       "creator_provisional",
@@ -28691,7 +28787,7 @@ var init_users = __esm({
         photoUrl: text("photo_url"),
         // Cloudflare R2 URL for custom uploaded photo
         studentRole: studentRoleEnum("student_role"),
-        // for students only: PM, Developer, Designer, Manager, Outros
+        // learner self-id, any role may set it (GH #657 — calibrates exercise difficulty): PM, Developer, Designer, Manager, Outros
         referralSource: varchar("referral_source", { length: 50 }),
         // How the user heard about tostudy (optional, for attribution)
         expertise: varchar("expertise", { length: 200 }),
@@ -28806,7 +28902,12 @@ var init_users = __esm({
         externalIdIdx: index("idx_users_external_id").on(
           table.provisioningSource,
           table.externalUserId
-        )
+        ),
+        // Partial UNIQUE guard (migration 0015): prevents two concurrent paris
+        // provisioning inserts with the same external_user_id from creating two
+        // distinct users. Partial (WHERE provisioning_source IS NOT NULL) so it
+        // never conflicts with self-service users whose provisioning_source is null.
+        uniqueParisProvisioningIdx: uniqueIndex("idx_unique_paris_provisioning").on(table.provisioningSource, table.externalUserId).where(sql`${table.provisioningSource} IS NOT NULL`)
       })
     );
   }
@@ -28947,6 +29048,14 @@ var init_user_preferences = __esm({
       emailNewReplies: boolean("email_new_replies").default(true).notNull(),
       /** Whether user wants push notifications for mentorship (via MCP) */
       pushMentoria: boolean("push_mentoria").default(true).notNull(),
+      // Marketing email preferences (FEAT-1285)
+      /**
+       * Whether user wants marketing/nurture emails (day-3/day-7 nurture,
+       * course recommendations). Defaults true (opt-out) to preserve the
+       * pre-existing behavior where these sends were gated only by the
+       * `emailNotifications` master toggle.
+       */
+      marketingEmails: boolean("marketing_emails").default(true).notNull(),
       // i18n nickname pilot column (dogfooding)
       nicknameI18n: jsonb("nickname_i18n").$type(),
       // Timestamps
@@ -29209,7 +29318,6 @@ var init_courses3 = __esm({
         tags: jsonb("tags").$type().default([]).notNull(),
         // Search tags: ['agent', 'mcp', 'automation', 'claude-code']
         categoryId: uuid("category_id").references(() => courseCategories.id, { onDelete: "set null" }),
-        enrollmentCount: integer("enrollment_count").default(0).notNull(),
         thumbnailUrl: varchar("thumbnail_url", { length: 500 }),
         videoIntroUrl: varchar("video_intro_url", { length: 500 }),
         // Story 10.8: Video upload integration
@@ -29314,8 +29422,6 @@ var init_courses3 = __esm({
         // B-tree index for essential course filter
         createdAtIdx: index("courses_created_at_idx").on(table.createdAt),
         // B-tree index for newest sort
-        enrollmentCountIdx: index("courses_enrollment_count_idx").on(table.enrollmentCount),
-        // B-tree for best-sellers sort
         // Story 11.1: Curadoria queue sorting and filtering indexes
         statusIdx: index("courses_status_idx").on(table.status),
         // B-tree for status filtering
@@ -29659,6 +29765,18 @@ var init_credit_wallets = __esm({
         walletCreatedAtIdx: index("cwt_wallet_created_at_idx").on(table.walletId, table.createdAt),
         walletTypeIdx: index("cwt_wallet_type_idx").on(table.walletId, table.type),
         referenceIdx: index("cwt_reference_idx").on(table.referenceId, table.referenceType),
+        // TASK-1841 (GH #712 follow-up): partial UNIQUE closes the residual
+        // concurrency window in ClawbackCourseSaleCreditUseCase — two distinct
+        // `charge.refunded` deliveries for the same enrollment can both pass the
+        // in-tx idempotency check before either commits (read committed never sees
+        // the other's uncommitted insert), producing a double `refund_debit`. The
+        // index makes the DB the final arbiter; the use-case catches 23505 as an
+        // idempotent skip. Scoped to reference_type='enrollment' ONLY: RefundBooking
+        // also writes `refund_debit` (reference_type='booking') with no idempotency
+        // guard, so a general `type='refund_debit'` index could 23505 a legitimate
+        // re-booking refund. Raw `sql` literal (not eq()) to dodge the drizzle-kit
+        // `$N` placeholder DDL bug — see packages/database/AGENTS.md.
+        refundDebitEnrollmentUnique: uniqueIndex("cwt_refund_debit_enrollment_unique").on(table.referenceId, table.referenceType, table.type).where(sql`${table.type} = 'refund_debit' AND ${table.referenceType} = 'enrollment'`),
         referenceTypeCheck: check(
           "cwt_reference_type_check",
           sql`${table.referenceType} IS NULL OR ${table.referenceType} IN (
@@ -30202,7 +30320,7 @@ var init_errors6 = __esm({
 });
 
 // ../../packages/types/src/index.ts
-var init_src3 = __esm({
+var init_src2 = __esm({
   "../../packages/types/src/index.ts"() {
     "use strict";
     init_user();
@@ -30224,7 +30342,7 @@ var init_course_reviews = __esm({
     init_pg_core();
     init_users();
     init_courses3();
-    init_src3();
+    init_src2();
     courseReviewStatusEnum = pgEnum("course_review_status", [
       "pending",
       "approved",
@@ -30332,6 +30450,7 @@ var init_enrollments = __esm({
   "../../packages/database/src/schema/enrollments.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     init_users();
     init_courses3();
     init_cohorts();
@@ -30412,7 +30531,14 @@ var init_enrollments = __esm({
           table.currentLevel
         ),
         // Paris Group integration: partial index for cohort lookups.
-        cohortIdIdx: index("idx_enrollments_cohort_id").on(table.cohortId)
+        cohortIdIdx: index("idx_enrollments_cohort_id").on(table.cohortId),
+        // TASK-1765 (GH #660 Q2): at most ONE active enrollment per (user, course).
+        // Partial on status='active' so refunded/cancelled/completed history rows
+        // can coexist (re-purchase after refund creates a fresh active row).
+        // Raw sql in .where() — drizzle-kit serializes eq() as a `$1` placeholder
+        // (42P02, see AGENTS.md). Backfill of the 3 prod duplicate pairs lives in
+        // migration 0023.
+        uniqueActivePerUserCourse: uniqueIndex("enrollments_user_course_active_unique").on(table.userId, table.courseId).where(sql`${table.status} = 'active'`)
       })
     );
   }
@@ -33915,6 +34041,34 @@ var init_mentor_availability = __esm({
   }
 });
 
+// ../../packages/database/src/schema/mentor-specializations.ts
+var mentorSpecializations;
+var init_mentor_specializations = __esm({
+  "../../packages/database/src/schema/mentor-specializations.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    mentorSpecializations = pgTable(
+      "mentor_specializations",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        creatorId: uuid("creator_id").references(() => users.id, { onDelete: "cascade" }).notNull(),
+        name: varchar("name", { length: 50 }).notNull(),
+        // Display order — mirrors the order the creator typed the chips in
+        position: integer("position").default(0).notNull(),
+        createdAt: timestamp("created_at").defaultNow().notNull()
+      },
+      (table) => ({
+        creatorIdIdx: index("mentor_specializations_creator_id_idx").on(table.creatorId),
+        creatorNameUq: uniqueIndex("mentor_specializations_creator_name_uq").on(
+          table.creatorId,
+          table.name
+        )
+      })
+    );
+  }
+});
+
 // ../../packages/database/src/schema/mentorship-sessions.ts
 var mentorshipSessions2, sessionParticipants2, sessionWaitlist2;
 var init_mentorship_sessions = __esm({
@@ -34178,14 +34332,16 @@ var init_mentorship_packages = __esm({
 function isCreditUsable(credit) {
   return credit.status === "active" && credit.creditsRemaining > 0 && new Date(credit.expiresAt) > /* @__PURE__ */ new Date();
 }
-var creditStatusEnum, mentorshipCredits2, insertMentorshipCreditSchema;
+var creditStatusEnum, creditOriginEnum, mentorshipCredits2, insertMentorshipCreditSchema;
 var init_mentorship_credits = __esm({
   "../../packages/database/src/schema/mentorship-credits.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     init_users();
     init_mentorship_packages();
     init_mentorship_services();
+    init_enrollments();
     init_zod();
     creditStatusEnum = pgEnum("mentorship_credit_status", [
       "active",
@@ -34195,12 +34351,17 @@ var init_mentorship_credits = __esm({
       "expired"
       // Credits expired (not used before expiration date)
     ]);
+    creditOriginEnum = pgEnum("mentorship_credit_origin", ["package", "course_purchase"]);
     mentorshipCredits2 = pgTable(
       "mentorship_credits",
       {
         id: uuid("id").defaultRandom().primaryKey(),
         userId: uuid("user_id").references(() => users.id, { onDelete: "cascade" }).notNull(),
-        packageId: uuid("package_id").references(() => mentorshipPackages2.id, { onDelete: "cascade" }).notNull(),
+        // FEAT-1288: nullable since course-purchase grants have no package. The
+        // origin-consistency CHECK below keeps package rows package-backed.
+        packageId: uuid("package_id").references(() => mentorshipPackages2.id, {
+          onDelete: "cascade"
+        }),
         mentorId: uuid("mentor_id").references(() => users.id, { onDelete: "cascade" }).notNull(),
         serviceId: uuid("service_id").references(() => mentorshipServices2.id, { onDelete: "cascade" }).notNull(),
         // Credit balance
@@ -34210,6 +34371,12 @@ var init_mentorship_credits = __esm({
         // Current available credits
         // Status tracking
         status: creditStatusEnum("status").default("active").notNull(),
+        // FEAT-1288: grant origin + the enrollment that granted course credits
+        // (refund revoke looks credits up by enrollment_id).
+        origin: creditOriginEnum("origin").default("package").notNull(),
+        enrollmentId: uuid("enrollment_id").references(() => enrollments.id, {
+          onDelete: "cascade"
+        }),
         // Payment reference
         stripePaymentIntentId: varchar("stripe_payment_intent_id", { length: 100 }),
         // Dates
@@ -34255,21 +34422,47 @@ var init_mentorship_credits = __esm({
           table.stripePaymentIntentId
         ),
         // ORDER BY purchasedAt DESC (credit transaction history)
-        purchasedAtIdx: index("mentorship_credits_purchased_at_idx").on(table.purchasedAt)
+        purchasedAtIdx: index("mentorship_credits_purchased_at_idx").on(table.purchasedAt),
+        // FEAT-1288: refund revoke looks up course-granted credits by enrollment
+        enrollmentIdIdx: index("mentorship_credits_enrollment_id_idx").on(table.enrollmentId),
+        // FEAT-1288: each origin carries its tracing FK — package rows keep a
+        // package_id, course-purchase rows keep an enrollment_id.
+        originConsistencyCheck: check(
+          "mentorship_credits_origin_consistency_check",
+          sql`(${table.origin} = 'package' AND ${table.packageId} IS NOT NULL) OR (${table.origin} = 'course_purchase' AND ${table.enrollmentId} IS NOT NULL)`
+        )
       })
     );
     insertMentorshipCreditSchema = external_exports.object({
       userId: external_exports.string().uuid(),
-      packageId: external_exports.string().uuid(),
+      // FEAT-1288: optional — required iff origin === "package" (refinement below)
+      packageId: external_exports.string().uuid().optional().nullable(),
       mentorId: external_exports.string().uuid(),
       serviceId: external_exports.string().uuid(),
       totalCredits: external_exports.number().int().positive(),
       creditsRemaining: external_exports.number().int().min(0),
       status: external_exports.enum(["active", "depleted", "expired"]).optional().default("active"),
+      origin: external_exports.enum(["package", "course_purchase"]).optional().default("package"),
+      enrollmentId: external_exports.string().uuid().optional().nullable(),
       stripePaymentIntentId: external_exports.string().max(100).optional().nullable(),
       expiresAt: external_exports.date(),
       reminderSent30d: external_exports.boolean().optional().default(false),
       reminderSent7d: external_exports.boolean().optional().default(false)
+    }).superRefine((value, ctx) => {
+      if (value.origin === "package" && value.packageId == null) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          path: ["packageId"],
+          message: "packageId is required when origin is 'package'"
+        });
+      }
+      if (value.origin === "course_purchase" && value.enrollmentId == null) {
+        ctx.addIssue({
+          code: external_exports.ZodIssueCode.custom,
+          path: ["enrollmentId"],
+          message: "enrollmentId is required when origin is 'course_purchase'"
+        });
+      }
     });
   }
 });
@@ -34468,6 +34661,55 @@ var init_mentorship_transactions = __esm({
   }
 });
 
+// ../../packages/database/src/schema/course-mentoria-offers.ts
+var courseMentoriaOffers, insertCourseMentoriaOfferSchema;
+var init_course_mentoria_offers = __esm({
+  "../../packages/database/src/schema/course-mentoria-offers.ts"() {
+    "use strict";
+    init_pg_core();
+    init_drizzle_orm();
+    init_zod();
+    init_courses3();
+    init_mentorship_services();
+    courseMentoriaOffers = pgTable(
+      "course_mentoria_offers",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        courseId: uuid("course_id").references(() => courses.id, { onDelete: "cascade" }).notNull(),
+        serviceId: uuid("service_id").references(() => mentorshipServices2.id, { onDelete: "cascade" }).notNull(),
+        /** Sessions granted to the buyer (mentorship_credits) on hybrid purchase. */
+        sessionsIncluded: integer("sessions_included").notNull(),
+        /** Credit validity window, mirrors mentorship_packages (3/6/12). */
+        validityMonths: integer("validity_months").default(6).notNull(),
+        /** Draft offers (e.g. creator without availability) stay inactive. */
+        isActive: boolean("is_active").default(false).notNull(),
+        createdAt: timestamp("created_at").defaultNow().notNull(),
+        updatedAt: timestamp("updated_at").defaultNow().notNull()
+      },
+      (table) => ({
+        // 1 offer per course — the checkout gate lookup key.
+        courseIdUnique: uniqueIndex("course_mentoria_offers_course_id_unique").on(table.courseId),
+        serviceIdIdx: index("course_mentoria_offers_service_id_idx").on(table.serviceId),
+        sessionsIncludedCheck: check(
+          "course_mentoria_offers_sessions_included_check",
+          sql`${table.sessionsIncluded} >= 1`
+        ),
+        validityMonthsCheck: check(
+          "course_mentoria_offers_validity_months_check",
+          sql`${table.validityMonths} IN (3, 6, 12)`
+        )
+      })
+    );
+    insertCourseMentoriaOfferSchema = external_exports.object({
+      courseId: external_exports.string().uuid(),
+      serviceId: external_exports.string().uuid(),
+      sessionsIncluded: external_exports.number().int().min(1),
+      validityMonths: external_exports.union([external_exports.literal(3), external_exports.literal(6), external_exports.literal(12)]).default(6),
+      isActive: external_exports.boolean().default(false)
+    });
+  }
+});
+
 // ../../packages/database/src/schema/session-reviews.ts
 var REVIEW_TAGS, sessionReviews2, sessionReviewVotes2;
 var init_session_reviews = __esm({
@@ -34552,11 +34794,13 @@ var init_mentorship_index = __esm({
     init_mentorship_templates();
     init_mentorship_services();
     init_mentor_availability();
+    init_mentor_specializations();
     init_mentorship_sessions();
     init_session_resources();
     init_mentorship_transactions();
     init_mentorship_packages();
     init_mentorship_credits();
+    init_course_mentoria_offers();
     init_session_reviews();
   }
 });
@@ -34632,6 +34876,7 @@ var init_transactions = __esm({
     init_pg_core();
     init_courses3();
     init_users();
+    init_enrollments();
     transactions2 = pgTable(
       "transactions",
       {
@@ -34644,6 +34889,15 @@ var init_transactions = __esm({
         courseId: uuid("course_id").notNull().references(() => courses.id, { onDelete: "restrict" }),
         creatorId: uuid("creator_id").notNull().references(() => users.id, { onDelete: "restrict" }),
         studentId: uuid("student_id").notNull().references(() => users.id, { onDelete: "restrict" }),
+        // CHORE-1676: links the transaction to the exact enrollment it paid for so
+        // the charge.refunded webhook (ProcessRefundUseCase) flips ONLY that row,
+        // never collateral (user, course) history rows. Nullable: historical txns
+        // (pre-link) and TOCTOU-refused purchases (no enrollment created) leave it
+        // null; the refund then falls back to a status-filtered (user, course) match.
+        // onDelete: 'set null' preserves the financial record if the enrollment is deleted.
+        enrollmentId: uuid("enrollment_id").references(() => enrollments.id, {
+          onDelete: "set null"
+        }),
         // Financial details (all amounts in cents)
         amount: integer("amount").notNull(),
         // Total amount charged
@@ -34663,11 +34917,24 @@ var init_transactions = __esm({
         paymentMethod: varchar("payment_method", { length: 50 }),
         // 'card' or 'pix'
         status: varchar("status", { length: 20 }).notNull().default("pending"),
-        // 'pending', 'succeeded', 'failed', 'refunded'
+        // 'pending', 'succeeded', 'failed', 'refunded', 'disputed' (GH #718 chargeback)
         // Timestamps
         createdAt: timestamp("created_at").defaultNow().notNull(),
         processedAt: timestamp("processed_at"),
         refundedAt: timestamp("refunded_at"),
+        refundedAmount: integer("refunded_amount").default(0).notNull(),
+        // Cumulative amount refunded in cents
+        refusalReason: varchar("refusal_reason", { length: 50 }),
+        // TOCTOU refusal marker (e.g. 'toctou_course_status')
+        // GH #718: Stripe chargeback/dispute tracking. disputedAt is stamped when a
+        // charge.dispute.created arrives (status flips to 'disputed') and on a lost
+        // dispute (charge.dispute.closed status=lost). disputeFee is the platform's
+        // ~$15 chargeback fee (cents), recorded only on a lost dispute and netted
+        // out of netPlatformRevenue. Both nullable — non-disputed transactions leave
+        // them null.
+        disputedAt: timestamp("disputed_at"),
+        disputeFee: integer("dispute_fee"),
+        // Stripe dispute fee in cents (lost disputes only)
         updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
       },
       (table) => ({
@@ -34754,6 +35021,56 @@ var init_payouts = __esm({
   }
 });
 
+// ../../packages/database/src/schema/subscription-pools.ts
+var subscriptionPoolStatusEnum, subscriptionSplitStatusEnum, catalogSubscriptionRevenuePools, catalogSubscriptionCreatorSplits;
+var init_subscription_pools = __esm({
+  "../../packages/database/src/schema/subscription-pools.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    subscriptionPoolStatusEnum = pgEnum("subscription_pool_status", [
+      "open",
+      "calculating",
+      "distributed"
+    ]);
+    subscriptionSplitStatusEnum = pgEnum("subscription_split_status", [
+      "pending",
+      "paid",
+      "failed"
+    ]);
+    catalogSubscriptionRevenuePools = pgTable("catalog_subscription_revenue_pools", {
+      id: uuid("id").defaultRandom().primaryKey(),
+      month: varchar("month", { length: 7 }).notNull().unique(),
+      // "YYYY-MM"
+      totalAmount: integer("total_amount").notNull(),
+      // pool amount in BRL cents
+      status: subscriptionPoolStatusEnum("status").default("open").notNull(),
+      createdAt: timestamp("created_at").defaultNow().notNull(),
+      updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+    });
+    catalogSubscriptionCreatorSplits = pgTable(
+      "catalog_subscription_creator_splits",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        poolId: uuid("pool_id").references(() => catalogSubscriptionRevenuePools.id, { onDelete: "cascade" }).notNull(),
+        creatorId: uuid("creator_id").references(() => users.id, { onDelete: "restrict" }).notNull(),
+        viewsCount: integer("views_count").notNull(),
+        sharePercentage: numeric("share_percentage", { precision: 10, scale: 6 }).notNull(),
+        // e.g. 0.354123
+        allocatedAmount: integer("allocated_amount").notNull(),
+        // share amount in BRL cents
+        status: subscriptionSplitStatusEnum("status").default("pending").notNull(),
+        createdAt: timestamp("created_at").defaultNow().notNull(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (table) => ({
+        poolIdIdx: index("idx_csc_splits_pool_id").on(table.poolId),
+        creatorIdIdx: index("idx_csc_splits_creator_id").on(table.creatorId)
+      })
+    );
+  }
+});
+
 // ../../packages/database/src/schema/creator-applications.ts
 var creatorApplications2;
 var init_creator_applications = __esm({
@@ -35016,7 +35333,10 @@ var init_course_project_enums = __esm({
 });
 
 // ../../packages/database/src/schema/course-project-types.ts
-var CANCEL_REASONS;
+function v3CancelReasonRedisKey(courseId) {
+  return `v3:cancel-reason:${courseId}`;
+}
+var CANCEL_REASONS, V3_CANCEL_REASON_TTL_SECONDS;
 var init_course_project_types = __esm({
   "../../packages/database/src/schema/course-project-types.ts"() {
     "use strict";
@@ -35027,6 +35347,7 @@ var init_course_project_types = __esm({
       "incomplete_stream",
       "unknown"
     ];
+    V3_CANCEL_REASON_TTL_SECONDS = 86400;
   }
 });
 
@@ -35066,6 +35387,7 @@ var init_course_projects = __esm({
   "../../packages/database/src/schema/course-projects.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     init_users();
     init_brainstormings();
     init_courses3();
@@ -35184,7 +35506,9 @@ var init_course_projects = __esm({
         statusIdx: index("course_projects_status_idx").on(table.status),
         currentPhaseIdx: index("course_projects_current_phase_idx").on(table.currentPhase),
         sourceTypeIdx: index("course_projects_source_type_idx").on(table.sourceType),
-        sourceIdeaIdIdx: index("course_projects_source_idea_id_idx").on(table.sourceIdeaId),
+        // CHORE-1709: one durable project per source idea. Partial UNIQUE keeps
+        // manual/context projects (NULL source_idea_id) unconstrained.
+        sourceIdeaIdUnique: uniqueIndex("course_projects_source_idea_id_unique").on(table.sourceIdeaId).where(sql`${table.sourceIdeaId} IS NOT NULL`),
         categoryIdIdx: index("course_projects_category_id_idx").on(table.categoryId),
         // ORDER BY createdAt/updatedAt DESC (project listing + creator initial state)
         createdAtIdx: index("course_projects_created_at_idx").on(table.createdAt),
@@ -37003,6 +37327,12 @@ var init_security_audit_log = __esm({
       "account.role_change",
       "account.profile_update",
       "account.delete",
+      "account.data_export",
+      // LGPD Art. 18 I/II — personal-data export (GH #608)
+      "account.deletion_requested",
+      // LGPD Art. 18 VI (GH #609)
+      "account.restored",
+      "account.hard_deleted",
       // Admin events
       "admin.user_suspend",
       "admin.user_unsuspend",
@@ -38045,12 +38375,14 @@ var init_system_config = __esm({
       "ai.context.compression_threshold": "ai.context.compression_threshold",
       // Business - Pricing
       "business.pricing.min_course_price_brl": "business.pricing.min_course_price_brl",
-      "business.pricing.mentorship_platform_fee_percent": "business.pricing.mentorship_platform_fee_percent",
       "business.pricing.course_mentoria_creator_share": "business.pricing.course_mentoria_creator_share",
       "business.pricing.course_mentoria_platform_share": "business.pricing.course_mentoria_platform_share",
-      "business.pricing.course_selfpaced_creator_share": "business.pricing.course_selfpaced_creator_share",
-      "business.pricing.course_selfpaced_platform_share": "business.pricing.course_selfpaced_platform_share",
       "business.pricing.ai_margin_percent": "business.pricing.ai_margin_percent",
+      "business.pricing.course_creator_share": "business.pricing.course_creator_share",
+      "business.pricing.course_platform_share": "business.pricing.course_platform_share",
+      "business.pricing.mentorship_creator_share": "business.pricing.mentorship_creator_share",
+      "business.pricing.mentorship_platform_share": "business.pricing.mentorship_platform_share",
+      "business.pricing.subscription_creator_share": "business.pricing.subscription_creator_share",
       // Business - Monitoring Thresholds
       "business.monitoring.cache_success_threshold": "business.monitoring.cache_success_threshold",
       "business.monitoring.cache_warning_threshold": "business.monitoring.cache_warning_threshold",
@@ -38639,7 +38971,7 @@ var init_course_transfer_logs = __esm({
     "use strict";
     init_pg_core();
     init_users();
-    transferTypeEnum = pgEnum("transfer_type", ["export", "import"]);
+    transferTypeEnum = pgEnum("transfer_type", ["export", "import", "reassign"]);
     transferStatusEnum = pgEnum("transfer_status", [
       "pending",
       "processing",
@@ -38654,6 +38986,8 @@ var init_course_transfer_logs = __esm({
         adminId: uuid("admin_id").references(() => users.id, { onDelete: "restrict" }).notNull(),
         type: transferTypeEnum("type").notNull(),
         courseId: uuid("course_id"),
+        fromCreatorId: uuid("from_creator_id").references(() => users.id, { onDelete: "set null" }),
+        toCreatorId: uuid("to_creator_id").references(() => users.id, { onDelete: "set null" }),
         courseName: text("course_name").notNull(),
         sourceEnvironment: text("source_environment"),
         status: transferStatusEnum("status").default("pending").notNull(),
@@ -38668,9 +39002,7 @@ var init_course_transfer_logs = __esm({
         adminIdIdx: index("course_transfer_logs_admin_id_idx").on(table.adminId),
         typeIdx: index("course_transfer_logs_type_idx").on(table.type),
         statusIdx: index("course_transfer_logs_status_idx").on(table.status),
-        createdAtIdx: index("course_transfer_logs_created_at_idx").on(
-          table.createdAt
-        )
+        createdAtIdx: index("course_transfer_logs_created_at_idx").on(table.createdAt)
       })
     );
   }
@@ -40709,34 +41041,6 @@ var init_magic_link_tokens = __esm({
   }
 });
 
-// ../../packages/database/src/schema/platform-fees.ts
-var platformFeeTypeEnum, platformFees;
-var init_platform_fees = __esm({
-  "../../packages/database/src/schema/platform-fees.ts"() {
-    "use strict";
-    init_pg_core();
-    platformFeeTypeEnum = pgEnum("platform_fee_type", ["course", "mentorship"]);
-    platformFees = pgTable(
-      "platform_fees",
-      {
-        id: uuid("id").defaultRandom().primaryKey(),
-        countryCode: varchar("country_code", { length: 2 }).notNull(),
-        feeType: platformFeeTypeEnum("fee_type").notNull(),
-        feePercent: numeric("fee_percent", { precision: 5, scale: 2 }).notNull(),
-        isActive: boolean("is_active").default(true),
-        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
-        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
-      },
-      (table) => ({
-        countryFeeTypeUniq: unique("platform_fees_country_fee_type_uniq").on(
-          table.countryCode,
-          table.feeType
-        )
-      })
-    );
-  }
-});
-
 // ../../packages/database/src/schema/payout-methods.ts
 var payoutMethods, payoutAccounts;
 var init_payout_methods = __esm({
@@ -40776,6 +41080,34 @@ var init_payout_methods = __esm({
   }
 });
 
+// ../../packages/database/src/schema/withdrawal-taxes.ts
+var withdrawalTaxes;
+var init_withdrawal_taxes = __esm({
+  "../../packages/database/src/schema/withdrawal-taxes.ts"() {
+    "use strict";
+    init_pg_core();
+    init_drizzle_orm();
+    withdrawalTaxes = pgTable(
+      "withdrawal_taxes",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        countryCode: varchar("country_code", { length: 2 }).notNull(),
+        taxPercent: numeric("tax_percent", { precision: 5, scale: 2 }).notNull(),
+        isActive: boolean("is_active").default(true).notNull(),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (table) => ({
+        countryUniq: unique("withdrawal_taxes_country_uniq").on(table.countryCode),
+        taxRange: check(
+          "withdrawal_taxes_tax_range",
+          sql`${table.taxPercent} >= 0 AND ${table.taxPercent} <= 100`
+        )
+      })
+    );
+  }
+});
+
 // ../../packages/database/src/schema/media-assets.ts
 var mediaAssetStatusEnum, mediaAssetTypeEnum, mediaAssetDomainEnum, mediaAssets;
 var init_media_assets = __esm({
@@ -40857,7 +41189,7 @@ var init_push_tokens = __esm({
 });
 
 // ../../packages/database/src/schema/payout.ts
-var payoutFeeConfig, payoutWithdrawals, payoutBankAccounts, payoutWithdrawalTransitions;
+var payoutWithdrawals, payoutBankAccounts, payoutWithdrawalTransitions;
 var init_payout = __esm({
   "../../packages/database/src/schema/payout.ts"() {
     "use strict";
@@ -40867,22 +41199,6 @@ var init_payout = __esm({
     init_credit_wallets();
     init_credit_wallets();
     init_payout_methods();
-    payoutFeeConfig = pgTable(
-      "payout_fee_config",
-      {
-        id: uuid("id").defaultRandom().primaryKey(),
-        mentorId: uuid("mentor_id").references(() => users.id, {
-          onDelete: "cascade"
-        }).unique(),
-        // null = global default
-        feePercent: decimal("fee_percent", { precision: 5, scale: 2 }).notNull(),
-        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
-        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
-      },
-      (table) => ({
-        feeRange: check("pfc_fee_range", sql`${table.feePercent} >= 0 AND ${table.feePercent} <= 100`)
-      })
-    );
     payoutWithdrawals = pgTable(
       "payout_withdrawals",
       {
@@ -40899,10 +41215,17 @@ var init_payout = __esm({
           precision: 10,
           scale: 4
         }).notNull(),
-        feePercent: decimal("fee_percent", { precision: 5, scale: 2 }).notNull(),
+        // Camada 3 (ADR-0169 / FEAT-1287): the deduction at cash-out is the
+        // creator's country-of-residence TAX — never a revenue split. Renamed
+        // from fee_percent/fee_usd (legal: table had 0 rows at rename time).
+        taxPercent: decimal("tax_percent", { precision: 5, scale: 2 }).notNull(),
         grossUsd: decimal("gross_usd", { precision: 10, scale: 4 }).notNull(),
-        feeUsd: decimal("fee_usd", { precision: 10, scale: 4 }).notNull(),
+        taxUsd: decimal("tax_usd", { precision: 10, scale: 4 }).notNull(),
         netUsd: decimal("net_usd", { precision: 10, scale: 4 }).notNull(),
+        // Audit snapshot: which country code resolved the tax at request time
+        // ('*' when the mentor had no confirmed country). Nullable: rows created
+        // before Camada 3 (none in prod) would not have it.
+        taxCountry: varchar("tax_country", { length: 2 }),
         exchangeRateBrl: decimal("exchange_rate_brl", {
           precision: 10,
           scale: 4
@@ -41101,6 +41424,7 @@ var init_course_allowlist = __esm({
   "../../packages/database/src/schema/course-allowlist.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     init_courses3();
     init_users();
     courseAllowlist = pgTable(
@@ -41114,14 +41438,20 @@ var init_course_allowlist = __esm({
           onDelete: "set null"
         }),
         invitedAt: timestamp("invited_at", { withTimezone: true }).defaultNow().notNull(),
-        resolvedAt: timestamp("resolved_at", { withTimezone: true })
+        resolvedAt: timestamp("resolved_at", { withTimezone: true }),
+        // GH #631: per-invite recipient binding carried in the email link as
+        // ?invite=<accept_token>. NULL = legacy/expired invite (creator must resend).
+        acceptToken: uuid("accept_token"),
+        acceptTokenExpiresAt: timestamp("accept_token_expires_at", { withTimezone: true })
       },
       (table) => ({
         courseEmailUnique: uniqueIndex("course_allowlist_course_email_unique").on(
           table.courseId,
           table.email
         ),
-        courseIdIdx: index("course_allowlist_course_id_idx").on(table.courseId)
+        courseIdIdx: index("course_allowlist_course_id_idx").on(table.courseId),
+        // Partial unique index: multiple NULL tokens allowed; minted tokens are globally unique.
+        acceptTokenUnique: uniqueIndex("course_allowlist_accept_token_unique").on(table.acceptToken).where(sql`${table.acceptToken} IS NOT NULL`)
         // partial indexes (user_id IS NOT NULL / IS NULL) are created via raw SQL in the migration — see drizzle-kit $N gotcha in packages/database/AGENTS.md
       })
     );
@@ -41164,6 +41494,119 @@ var init_idempotency = __esm({
   }
 });
 
+// ../../packages/database/src/schema/user-deletions.ts
+var userDeletionStatusEnum, userDeletions;
+var init_user_deletions = __esm({
+  "../../packages/database/src/schema/user-deletions.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    userDeletionStatusEnum = pgEnum("user_deletion_status", [
+      "pending",
+      // grace period running
+      "restored",
+      // user reverted within grace
+      "hard_deleted"
+      // cron purged the account
+    ]);
+    userDeletions = pgTable(
+      "user_deletions",
+      {
+        id: uuid("id").primaryKey().defaultRandom(),
+        userId: uuid("user_id").notNull().references(() => users.id, { onDelete: "cascade" }),
+        requestedAt: timestamp("requested_at", { withTimezone: true }).defaultNow().notNull(),
+        scheduledHardDeleteAt: timestamp("scheduled_hard_delete_at", {
+          withTimezone: true
+        }).notNull(),
+        // SHA-256 of the restore JWT (the raw token only lives in the email link).
+        restoreTokenHash: text("restore_token_hash"),
+        reason: text("reason"),
+        status: userDeletionStatusEnum("status").default("pending").notNull(),
+        anonymizedAt: timestamp("anonymized_at", { withTimezone: true })
+      },
+      (table) => ({
+        userIdIdx: index("user_deletions_user_id_idx").on(table.userId),
+        statusScheduledIdx: index("user_deletions_status_scheduled_idx").on(
+          table.status,
+          table.scheduledHardDeleteAt
+        )
+      })
+    );
+  }
+});
+
+// ../../packages/database/src/schema/user-profiles.ts
+var profileVisibilityEnum, userProfiles;
+var init_user_profiles = __esm({
+  "../../packages/database/src/schema/user-profiles.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    profileVisibilityEnum = pgEnum("profile_visibility", ["public", "private"]);
+    userProfiles = pgTable("user_profiles", {
+      // One row per user — userId is both PK and FK (singleton satellite, same
+      // pattern as user_preferences).
+      userId: uuid("user_id").primaryKey().references(() => users.id, { onDelete: "cascade" }),
+      // Short tagline shown under the name, e.g. "Full-stack dev & educator"
+      headline: varchar("headline", { length: 120 }),
+      // Free-form location, e.g. "São Paulo, Brasil"
+      location: varchar("location", { length: 100 }),
+      // Emoji avatar fallback when no photo is uploaded, e.g. "🧑‍💻"
+      avatarEmoji: varchar("avatar_emoji", { length: 16 }),
+      // Profile-wide visibility (distinct from users.portfolioPublic, which is
+      // scoped to the creator portfolio feature only)
+      visibility: profileVisibilityEnum("visibility").default("public").notNull(),
+      createdAt: timestamp("created_at").defaultNow().notNull(),
+      updatedAt: timestamp("updated_at").defaultNow().notNull()
+    });
+  }
+});
+
+// ../../packages/database/src/schema/user-resource-audits.ts
+var userProfileAudits, userPreferencesAudits;
+var init_user_resource_audits = __esm({
+  "../../packages/database/src/schema/user-resource-audits.ts"() {
+    "use strict";
+    init_pg_core();
+    userProfileAudits = pgTable(
+      "user_profile_audits",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        resource: text("resource").notNull(),
+        row_id: text("row_id").notNull(),
+        op: text("op").notNull(),
+        actor: jsonb("actor").notNull(),
+        before: jsonb("before"),
+        after: jsonb("after"),
+        at: timestamp("at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (table) => ({
+        resourceIdx: index("user_profile_audits_resource_idx").on(table.resource),
+        rowIdIdx: index("user_profile_audits_row_id_idx").on(table.row_id),
+        atIdx: index("user_profile_audits_at_idx").on(table.at)
+      })
+    );
+    userPreferencesAudits = pgTable(
+      "user_preferences_audits",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        resource: text("resource").notNull(),
+        row_id: text("row_id").notNull(),
+        op: text("op").notNull(),
+        actor: jsonb("actor").notNull(),
+        before: jsonb("before"),
+        after: jsonb("after"),
+        at: timestamp("at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (table) => ({
+        resourceIdx: index("user_preferences_audits_resource_idx").on(table.resource),
+        rowIdIdx: index("user_preferences_audits_row_id_idx").on(table.row_id),
+        atIdx: index("user_preferences_audits_at_idx").on(table.at)
+      })
+    );
+  }
+});
+
 // ../../packages/database/src/schema/index.ts
 var schema_exports = {};
 __export(schema_exports, {
@@ -41178,6 +41621,7 @@ __export(schema_exports, {
   PACKAGE_VALIDITY_OPTIONS: () => PACKAGE_VALIDITY_OPTIONS,
   REVIEW_TAGS: () => REVIEW_TAGS,
   SUGGESTED_DISCOUNTS: () => SUGGESTED_DISCOUNTS,
+  V3_CANCEL_REASON_TTL_SECONDS: () => V3_CANCEL_REASON_TTL_SECONDS,
   accounts: () => accounts,
   accountsRelations: () => accountsRelations2,
   actionTypeEnum: () => actionTypeEnum,
@@ -41206,6 +41650,8 @@ __export(schema_exports, {
   browserSessions: () => browserSessions,
   browserSessionsRelations: () => browserSessionsRelations,
   cancellationReasonEnum: () => cancellationReasonEnum,
+  catalogSubscriptionCreatorSplits: () => catalogSubscriptionCreatorSplits,
+  catalogSubscriptionRevenuePools: () => catalogSubscriptionRevenuePools,
   certificates: () => certificates,
   certificatesRelations: () => certificatesRelations2,
   challengeType: () => challengeType,
@@ -41251,6 +41697,7 @@ __export(schema_exports, {
   courseKnowledgeBases: () => courseKnowledgeBases,
   courseKnowledgeBasesRelations: () => courseKnowledgeBasesRelations,
   courseLevelEnum: () => courseLevelEnum,
+  courseMentoriaOffers: () => courseMentoriaOffers,
   courseProjects: () => courseProjects,
   courseProjectsRelations: () => courseProjectsRelations,
   courseProposals: () => courseProposals2,
@@ -41291,6 +41738,7 @@ __export(schema_exports, {
   creatorVariationAxesRelations: () => creatorVariationAxesRelations,
   creditMovementAuditLog: () => creditMovementAuditLog,
   creditMovementAuditLogRelations: () => creditMovementAuditLogRelations,
+  creditOriginEnum: () => creditOriginEnum,
   creditPackages: () => creditPackages,
   creditStatusEnum: () => creditStatusEnum,
   creditSubscriptionPlans: () => creditSubscriptionPlans,
@@ -41340,6 +41788,7 @@ __export(schema_exports, {
   helpArticleRatings: () => helpArticleRatings,
   ideas: () => ideas,
   ideasRelations: () => ideasRelations,
+  insertCourseMentoriaOfferSchema: () => insertCourseMentoriaOfferSchema,
   insertMentorshipCreditSchema: () => insertMentorshipCreditSchema,
   insertMentorshipPackageSchema: () => insertMentorshipPackageSchema,
   insertPlatformSettingSchema: () => insertPlatformSettingSchema,
@@ -41389,6 +41838,7 @@ __export(schema_exports, {
   mentorAvailabilityExceptions: () => mentorAvailabilityExceptions2,
   mentorAvailabilityExceptionsRelations: () => mentorAvailabilityExceptionsRelations2,
   mentorAvailabilityRelations: () => mentorAvailabilityRelations2,
+  mentorSpecializations: () => mentorSpecializations,
   mentorshipCredits: () => mentorshipCredits2,
   mentorshipCreditsRelations: () => mentorshipCreditsRelations2,
   mentorshipMessages: () => mentorshipMessages2,
@@ -41439,7 +41889,6 @@ __export(schema_exports, {
   pathStatusEnum: () => pathStatusEnum,
   payoutAccounts: () => payoutAccounts,
   payoutBankAccounts: () => payoutBankAccounts,
-  payoutFeeConfig: () => payoutFeeConfig,
   payoutMethods: () => payoutMethods,
   payoutStatusEnum: () => payoutStatusEnum,
   payoutTransactions: () => payoutTransactions2,
@@ -41452,8 +41901,6 @@ __export(schema_exports, {
   pgBackendIdempotencyKeys: () => pgBackendIdempotencyKeys,
   pixKeyTypeEnum: () => pixKeyTypeEnum,
   platformConfig: () => platformConfig,
-  platformFeeTypeEnum: () => platformFeeTypeEnum,
-  platformFees: () => platformFees,
   platformSettings: () => platformSettings2,
   playgroundEvalScores: () => playgroundEvalScores,
   playgroundEvalScoresRelations: () => playgroundEvalScoresRelations,
@@ -41471,6 +41918,7 @@ __export(schema_exports, {
   portfolioViews: () => portfolioViews,
   portfolioViewsRelations: () => portfolioViewsRelations,
   pricingTiers: () => pricingTiers,
+  profileVisibilityEnum: () => profileVisibilityEnum,
   progress: () => progress,
   progressRelations: () => progressRelations2,
   progressStatusEnum: () => progressStatusEnum,
@@ -41576,6 +42024,8 @@ __export(schema_exports, {
   studyModuleSessionsRelations: () => studyModuleSessionsRelations,
   studyPhaseV2Values: () => studyPhaseV2Values,
   studyPhaseValues: () => studyPhaseValues,
+  subscriptionPoolStatusEnum: () => subscriptionPoolStatusEnum,
+  subscriptionSplitStatusEnum: () => subscriptionSplitStatusEnum,
   supportedCurrencies: () => supportedCurrencies,
   syncLogs: () => syncLogs,
   syncLogsRelations: () => syncLogsRelations2,
@@ -41601,12 +42051,17 @@ __export(schema_exports, {
   userBadgesRelations: () => userBadgesRelations2,
   userChallengeScores: () => userChallengeScores,
   userChallengeScoresRelations: () => userChallengeScoresRelations,
+  userDeletionStatusEnum: () => userDeletionStatusEnum,
+  userDeletions: () => userDeletions,
   userFollows: () => userFollows2,
   userFollowsRelations: () => userFollowsRelations2,
   userPathEnrollments: () => userPathEnrollments,
   userPathEnrollmentsRelations: () => userPathEnrollmentsRelations,
   userPreferences: () => userPreferences,
+  userPreferencesAudits: () => userPreferencesAudits,
   userPreferencesRelations: () => userPreferencesRelations2,
+  userProfileAudits: () => userProfileAudits,
+  userProfiles: () => userProfiles,
   userRegionalSettings: () => userRegionalSettings,
   userRegionalSettingsRelations: () => userRegionalSettingsRelations,
   userRoleEnum: () => userRoleEnum,
@@ -41614,6 +42069,7 @@ __export(schema_exports, {
   userUsageQuotas: () => userUsageQuotas2,
   users: () => users,
   usersRelations: () => usersRelations2,
+  v3CancelReasonRedisKey: () => v3CancelReasonRedisKey,
   validationAttempts: () => validationAttempts2,
   validationAttemptsRelations: () => validationAttemptsRelations2,
   validationLessonProgress: () => validationLessonProgress,
@@ -41634,7 +42090,8 @@ __export(schema_exports, {
   videoTemplateNameEnum: () => videoTemplateNameEnum,
   videoTypeEnum: () => videoTypeEnum,
   webhookEvents: () => webhookEvents2,
-  wishlists: () => wishlists
+  wishlists: () => wishlists,
+  withdrawalTaxes: () => withdrawalTaxes
 });
 var init_schema3 = __esm({
   "../../packages/database/src/schema/index.ts"() {
@@ -41650,6 +42107,7 @@ var init_schema3 = __esm({
     init_mentorship_index();
     init_reviews();
     init_payouts();
+    init_subscription_pools();
     init_creator_index();
     init_webhook_events();
     init_transactions();
@@ -41725,8 +42183,8 @@ var init_schema3 = __esm({
     init_tutor_content_issues();
     init_magic_link_tokens();
     init_mobile_refresh_tokens();
-    init_platform_fees();
     init_payout_methods();
+    init_withdrawal_taxes();
     init_media_assets();
     init_push_tokens();
     init_payout();
@@ -41736,6 +42194,9 @@ var init_schema3 = __esm({
     init_course_visibility();
     init_course_allowlist();
     init_idempotency();
+    init_user_deletions();
+    init_user_profiles();
+    init_user_resource_audits();
   }
 });
 
@@ -41743,7 +42204,7 @@ var init_schema3 = __esm({
 var init_check_module_unlocked = __esm({
   "../../packages/database/src/utils/check-module-unlocked.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
     init_schema3();
   }
 });
@@ -41772,11 +42233,11 @@ var init_ids = __esm({
 
 // ../../packages/database/src/index.ts
 var envSchema, _db, createDb, getDb, db;
-var init_src4 = __esm({
+var init_src3 = __esm({
   "../../packages/database/src/index.ts"() {
     "use strict";
     init_postgres_js();
-    init_src2();
+    init_src();
     init_zod();
     init_schema3();
     init_schema3();
@@ -41873,7 +42334,7 @@ var init_formats = __esm({
 var init_parser = __esm({
   "../../packages/tostudy-core/src/exercises/parser.ts"() {
     "use strict";
-    init_src3();
+    init_src2();
     init_formats();
     init_formats();
   }
@@ -41897,8 +42358,8 @@ var init_lesson_exercise_data = __esm({
 var init_sync_enrollment_progress = __esm({
   "../../packages/tostudy-core/src/learning/sync-enrollment-progress.ts"() {
     "use strict";
-    init_src4();
-    init_src();
+    init_src3();
+    init_dist();
   }
 });
 
@@ -41907,21 +42368,38 @@ var DEFAULT_MAX_SESSION_TIME_SECONDS;
 var init_study_state_sync = __esm({
   "../../packages/tostudy-core/src/learning/study-state-sync.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
     DEFAULT_MAX_SESSION_TIME_SECONDS = 2 * 60 * 60;
   }
 });
 
+// ../../packages/tostudy-core/src/enrollments/entitlement.ts
+var init_entitlement = __esm({
+  "../../packages/tostudy-core/src/enrollments/entitlement.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/tostudy-core/src/enrollments/archived-access.ts
+var init_archived_access = __esm({
+  "../../packages/tostudy-core/src/enrollments/archived-access.ts"() {
+    "use strict";
+    init_src3();
+  }
+});
+
 // ../../packages/tostudy-core/src/learning/start-module-full.ts
 var init_start_module_full = __esm({
   "../../packages/tostudy-core/src/learning/start-module-full.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
     init_parser();
     init_exercise_types();
     init_lesson_exercise_data();
     init_sync_enrollment_progress();
     init_study_state_sync();
+    init_entitlement();
+    init_archived_access();
   }
 });
 
@@ -41929,10 +42407,13 @@ var init_start_module_full = __esm({
 var init_next_lesson_full = __esm({
   "../../packages/tostudy-core/src/learning/next-lesson-full.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
+    init_dist();
     init_parser();
     init_lesson_exercise_data();
     init_sync_enrollment_progress();
+    init_entitlement();
+    init_archived_access();
     init_study_state_sync();
   }
 });
@@ -41941,8 +42422,8 @@ var init_next_lesson_full = __esm({
 var init_student_memory = __esm({
   "../../packages/tostudy-core/src/memory/student-memory.ts"() {
     "use strict";
-    init_src4();
-    init_src();
+    init_src3();
+    init_dist();
   }
 });
 
@@ -41950,7 +42431,7 @@ var init_student_memory = __esm({
 var init_summarize_lesson = __esm({
   "../../packages/tostudy-core/src/learning/summarize-lesson.ts"() {
     "use strict";
-    init_src();
+    init_dist();
   }
 });
 
@@ -41958,14 +42439,16 @@ var init_summarize_lesson = __esm({
 var init_validate_solution_full = __esm({
   "../../packages/tostudy-core/src/learning/validate-solution-full.ts"() {
     "use strict";
-    init_src4();
-    init_src();
+    init_src3();
+    init_dist();
     init_parser();
     init_extractors();
     init_exercise_types();
     init_study_state_sync();
     init_sync_enrollment_progress();
     init_student_memory();
+    init_entitlement();
+    init_archived_access();
     init_summarize_lesson();
   }
 });
@@ -41974,8 +42457,10 @@ var init_validate_solution_full = __esm({
 var init_go_to_lesson = __esm({
   "../../packages/tostudy-core/src/learning/go-to-lesson.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
     init_parser();
+    init_entitlement();
+    init_archived_access();
   }
 });
 
@@ -41983,8 +42468,9 @@ var init_go_to_lesson = __esm({
 var init_get_lesson_content_full = __esm({
   "../../packages/tostudy-core/src/learning/get-lesson-content-full.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
     init_parser();
+    init_entitlement();
   }
 });
 
@@ -42000,9 +42486,11 @@ var init_formatter2 = __esm({
 var init_get_hint_full = __esm({
   "../../packages/tostudy-core/src/learning/get-hint-full.ts"() {
     "use strict";
-    init_src4();
+    init_src3();
     init_parser();
     init_formatter2();
+    init_entitlement();
+    init_archived_access();
   }
 });
 
@@ -42010,8 +42498,8 @@ var init_get_hint_full = __esm({
 var init_explain_concept = __esm({
   "../../packages/tostudy-core/src/learning/explain-concept.ts"() {
     "use strict";
-    init_src4();
-    init_src();
+    init_src3();
+    init_dist();
   }
 });
 
@@ -42051,10 +42539,6 @@ async function runStart(opts, deps = defaultDeps3) {
     const session = await deps.requireSession();
     const activeCourse = await deps.requireActiveCourse();
     const onboarding = await deps.getCourseOnboardingStatus(activeCourse);
-    if (!onboarding.initReady) {
-      deps.stderrWrite(`Dica: rode \`tostudy init\` para personalizar o tutor ao seu contexto.
-`);
-    }
     const driftWarning = await deps.checkCourseDrift();
     if (driftWarning) deps.stderrWrite(driftWarning + "\n");
     const data = deps.createHttpProvider(session.apiUrl, session.token);
@@ -42073,12 +42557,20 @@ async function runStart(opts, deps = defaultDeps3) {
     } else {
       deps.output(deps.formatModuleStart(moduleData), { json: false });
     }
+    if (!onboarding.initReady) {
+      deps.stderrWrite(`Dica: rode \`tostudy init\` para personalizar o tutor ao seu contexto.
+`);
+    }
   } catch (err) {
     if (err instanceof CliApiError && err.status === 403 && err.message === "CHANNEL_MISMATCH") {
       process.stderr.write("Este curso n\xE3o est\xE1 dispon\xEDvel via CLI.\n");
       process.stderr.write("Acesse tostudy.ai para estudar este curso pelo ChatStudy.\n");
       process.exit(1);
     }
+    if (isEnrollmentNotEntitledError(err)) {
+      deps.stderrWrite(getErrors().enrollmentNotEntitled);
+      process.exit(1);
+    }
     if (isCourseArchivedError(err)) {
       deps.stderrWrite(getErrors().courseArchived);
       process.exit(1);
@@ -42091,7 +42583,7 @@ var logger9, defaultDeps3, startCommand;
 var init_start = __esm({
   "src/commands/start.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_lessons2();
     init_http();
     init_guards();
@@ -42128,7 +42620,7 @@ var logger10, startNextCommand;
 var init_start_next = __esm({
   "src/commands/start-next.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_lessons2();
     init_http();
     init_guards();
@@ -42163,6 +42655,10 @@ var init_start_next = __esm({
           process.stderr.write("\u2192 tostudy courses  para ver outros cursos\n");
           process.exit(0);
         }
+        if (isEnrollmentNotEntitledError(err)) {
+          process.stderr.write(getErrors().enrollmentNotEntitled);
+          process.exit(1);
+        }
         if (isCourseArchivedError(err)) {
           process.stderr.write(getErrors().courseArchived);
           process.exit(1);
@@ -42181,7 +42677,7 @@ var logger11, nextCommand;
 var init_next = __esm({
   "src/commands/next.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_lessons2();
     init_http();
     init_guards();
@@ -42214,6 +42710,12 @@ var init_next = __esm({
           output(formatLesson(lessonData), { json: false });
         }
       } catch (err) {
+        if (isEnrollmentNotEntitledError(err)) {
+          const friendly = getErrors().enrollmentNotEntitled;
+          if (opts.json) jsonError("enrollment_not_entitled", { message: friendly });
+          process.stderr.write(friendly);
+          process.exit(1);
+        }
         if (isCourseArchivedError(err)) {
           const friendly = getErrors().courseArchived;
           if (opts.json) jsonError("course_archived", { message: friendly });
@@ -42252,6 +42754,7 @@ var init_next = __esm({
 
 // src/commands/lesson.ts
 import { Command as Command11 } from "commander";
+import path13 from "node:path";
 function adjustTimeEstimate(type, baseMinutes) {
   if (type === "exercise") return Math.max(baseMinutes, 30);
   return baseMinutes;
@@ -42259,15 +42762,29 @@ function adjustTimeEstimate(type, baseMinutes) {
 function isCheckpoint(title) {
   return /^checkpoint/i.test(title.trim());
 }
-function formatLessonContent(data) {
+function replacePlaceholders(text2, workspacePath, courseTitle) {
+  const base = path13.basename(workspacePath) === ".tostudy" ? path13.dirname(workspacePath) : workspacePath;
+  const slug = courseSlug(courseTitle);
+  const vaultPath = resolveVaultPath(workspacePath, slug);
+  return text2.replaceAll("$WORKSPACE", base).replaceAll("$VAULT", vaultPath);
+}
+function formatLessonContent(data, workspacePath, courseTitle) {
   const time4 = adjustTimeEstimate(data.type, data.estimatedTimeMinutes);
-  const lines = [
-    `\u2501\u2501\u2501 Li\xE7\xE3o: ${data.title} \u2501\u2501\u2501`,
-    "",
-    `Tipo: ${data.type}  |  Dura\xE7\xE3o estimada: ~${time4} min`,
-    "",
-    data.content
-  ];
+  const isPractical = data.type === "exercise" || isCheckpoint(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 slug = courseSlug(courseTitle);
+    const vaultPath = resolveVaultPath(workspacePath, slug);
+    lines.push(
+      `Pasta de trabalho (workspace): ${base}`,
+      `Cofre Obsidian (vault): ${vaultPath}`,
+      ""
+    );
+  } else {
+    lines.push("");
+  }
+  lines.push(`Tipo: ${data.type}  |  Dura\xE7\xE3o estimada: ~${time4} min`, "", data.content);
   if (data.acceptanceCriteria) {
     lines.push("", "Crit\xE9rios de aceita\xE7\xE3o:", data.acceptanceCriteria);
   }
@@ -42294,7 +42811,7 @@ var logger12, lessonCommand;
 var init_lesson = __esm({
   "src/commands/lesson.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_lessons2();
     init_courses();
     init_http();
@@ -42332,24 +42849,51 @@ var init_lesson = __esm({
           error("Nenhuma li\xE7\xE3o encontrada para leitura. Rode: tostudy start  ou  tostudy next");
         }
         const content = await getContent({ lessonId, enrollmentId: activeCourse.enrollmentId }, deps);
+        const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
+        const ws = await resolveEffectiveWorkspace(
+          activeCourse.courseTitle,
+          onboardingState?.workspacePath
+        );
+        if (ws.found && ws.workspacePath) {
+          if (content.content) {
+            content.content = replacePlaceholders(
+              content.content,
+              ws.workspacePath,
+              activeCourse.courseTitle
+            );
+          }
+          if (content.acceptanceCriteria) {
+            content.acceptanceCriteria = replacePlaceholders(
+              content.acceptanceCriteria,
+              ws.workspacePath,
+              activeCourse.courseTitle
+            );
+          }
+        }
         if (opts.json) {
           output(content, { json: true });
         } else {
-          output(formatLessonContent(content), { json: false });
+          output(
+            formatLessonContent(
+              content,
+              ws.found ? ws.workspacePath : null,
+              activeCourse.courseTitle
+            ),
+            { json: false }
+          );
         }
-        if (content.type === "exercise") {
-          const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
-          const ws = await resolveEffectiveWorkspace(
-            activeCourse.courseTitle,
-            onboardingState?.workspacePath
+        if (content.type === "exercise" && !ws.found) {
+          process.stderr.write(
+            "\n\u{1F4A1} Dica: rode `tostudy select` desta pasta para us\xE1-la como workspace, ou `tostudy workspace setup` para criar em ~/study/.\n"
           );
-          if (!ws.found) {
-            process.stderr.write(
-              "\n\u{1F4A1} Dica: rode `tostudy select` desta pasta para us\xE1-la como workspace, ou `tostudy workspace setup` para criar em ~/study/.\n"
-            );
-          }
         }
       } catch (err) {
+        if (isEnrollmentNotEntitledError(err)) {
+          const friendly = getErrors().enrollmentNotEntitled;
+          if (opts.json) jsonError("enrollment_not_entitled", { message: friendly });
+          else process.stderr.write(friendly);
+          process.exit(1);
+        }
         if (isInsufficientCreditsError(err)) {
           const friendly = getErrors().insufficientCredits;
           if (opts.json) jsonError("insufficient_credits", { message: friendly });
@@ -42370,7 +42914,7 @@ var logger13, hintCommand;
 var init_hint = __esm({
   "src/commands/hint.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_lessons2();
     init_http();
     init_guards();
@@ -42396,11 +42940,17 @@ var init_hint = __esm({
           output(formatHint(hint), { json: false });
         }
       } catch (err) {
+        if (isEnrollmentNotEntitledError(err)) {
+          const friendly = getErrors().enrollmentNotEntitled;
+          if (opts.json) jsonError("enrollment_not_entitled", { message: friendly });
+          else process.stderr.write(friendly);
+          process.exit(1);
+        }
         if (isCourseArchivedError(err)) {
           const friendly = getErrors().courseArchived;
           if (opts.json) jsonError("course_archived", { message: friendly });
-          error(friendly);
-          return;
+          else process.stderr.write(friendly);
+          process.exit(1);
         }
         if (isInsufficientCreditsError(err)) {
           const friendly = getErrors().insufficientCredits;
@@ -42436,7 +42986,7 @@ var init_validate_solution = __esm({
 var init_level_validator = __esm({
   "../../packages/tostudy-core/src/exercises/level-validator.ts"() {
     "use strict";
-    init_src3();
+    init_src2();
   }
 });
 
@@ -42731,14 +43281,15 @@ var init_init_template = __esm({
 
 // src/commands/validate.ts
 import fs12 from "node:fs";
-import path13 from "node:path";
+import path14 from "node:path";
 import { Command as Command13 } from "commander";
 var logger14, validateCommand;
 var init_validate = __esm({
   "src/commands/validate.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_exercises();
+    init_courses();
     init_http();
     init_guards();
     init_course_state();
@@ -42752,7 +43303,22 @@ var init_validate = __esm({
         const activeCourse = await requireActiveCourse();
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
-        const lessonId = activeCourse.currentLessonId;
+        const data = createHttpProvider(session.apiUrl, session.token);
+        const deps = { data, logger: logger14 };
+        let lessonId = activeCourse.currentLessonId;
+        if (!lessonId) {
+          try {
+            const prog = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
+            if (prog.isArchived) {
+              const friendly = getErrors().courseArchived;
+              if (opts.json) jsonError("course_archived", { message: friendly });
+              else process.stderr.write(friendly);
+              process.exit(1);
+            }
+            lessonId = prog.currentLesson?.id || void 0;
+          } catch {
+          }
+        }
         if (!lessonId) {
           if (opts.json) jsonError("no_active_lesson", { message: "Nenhuma li\xE7\xE3o ativa encontrada" });
           error("Nenhuma li\xE7\xE3o ativa encontrada. Rode: tostudy start  ou  tostudy next");
@@ -42773,7 +43339,7 @@ var init_validate = __esm({
           error("Forne\xE7a um arquivo ou use --stdin.\n\nExemplo: tostudy validate resposta.md");
         }
         if (file2 && activeCourse.courseTags?.length) {
-          const ext = path13.extname(file2).toLowerCase();
+          const ext = path14.extname(file2).toLowerCase();
           const LANG_EXTENSIONS = {
             ".html": ["html", "html5"],
             ".css": ["css"],
@@ -42808,8 +43374,6 @@ var init_validate = __esm({
             }
           }
         }
-        const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger14 };
         const result = await validateSolution(
           {
             lessonId,
@@ -42826,11 +43390,17 @@ var init_validate = __esm({
         }
         process.exit(result.passed ? 0 : 1);
       } catch (err) {
+        if (isEnrollmentNotEntitledError(err)) {
+          const friendly = getErrors().enrollmentNotEntitled;
+          if (opts.json) jsonError("enrollment_not_entitled", { message: friendly });
+          else process.stderr.write(friendly);
+          process.exit(1);
+        }
         if (isCourseArchivedError(err)) {
           const friendly = getErrors().courseArchived;
           if (opts.json) jsonError("course_archived", { message: friendly });
-          error(friendly);
-          return;
+          else process.stderr.write(friendly);
+          process.exit(1);
         }
         if (isInsufficientCreditsError(err)) {
           const friendly = getErrors().insufficientCredits;
@@ -43187,7 +43757,7 @@ var logger15, defaultDeps4, initCommand;
 var init_init = __esm({
   "src/commands/init.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_courses();
     init_http();
     init_session_store();
@@ -43226,13 +43796,13 @@ var init_init = __esm({
 
 // ../../packages/tostudy-core/src/workspace/setup-workspace.ts
 import fs13 from "node:fs/promises";
-import path14 from "node:path";
+import path15 from "node:path";
 async function setupWorkspace(input2) {
-  const workspacePath = path14.join(input2.basePath, input2.courseSlug);
+  const workspacePath = path15.join(input2.basePath, input2.courseSlug);
   for (const dir of WORKSPACE_DIRS) {
-    await fs13.mkdir(path14.join(workspacePath, dir), { recursive: true });
+    await fs13.mkdir(path15.join(workspacePath, dir), { recursive: true });
   }
-  const configPath = path14.join(workspacePath, ".ana-config.json");
+  const configPath = path15.join(workspacePath, ".ana-config.json");
   const config2 = {
     courseId: input2.courseId,
     courseSlug: input2.courseSlug,
@@ -43267,7 +43837,7 @@ async function setupWorkspace(input2) {
     "tostudy vault sync      # Sincronizar progresso",
     "```"
   ].join("\n");
-  await fs13.writeFile(path14.join(workspacePath, "README.md"), readme, "utf-8");
+  await fs13.writeFile(path15.join(workspacePath, "README.md"), readme, "utf-8");
   return { workspacePath, directories: WORKSPACE_DIRS, configPath };
 }
 var WORKSPACE_DIRS;
@@ -43369,7 +43939,7 @@ var init_templates = __esm({
 
 // ../../packages/tostudy-core/src/workspace/extract-exercise.ts
 import fs14 from "node:fs/promises";
-import path15 from "node:path";
+import path16 from "node:path";
 function padOrder(n) {
   return String(n).padStart(2, "0");
 }
@@ -43393,15 +43963,15 @@ async function extractExercise(input2) {
   const { lessonData, exerciseTier, workspacePath } = input2;
   const moduleDir = `${padOrder(lessonData.moduleOrder)}-${lessonData.moduleSlug}`;
   const lessonDir = `${padOrder(lessonData.lessonOrder)}-${lessonData.lessonSlug}`;
-  const exercisePath = path15.join(workspacePath, "exercises", moduleDir, lessonDir);
+  const exercisePath = path16.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 = path15.join(exercisePath, cleanPath);
-      await fs14.mkdir(path15.dirname(fullPath), { recursive: true });
+      const fullPath = path16.join(exercisePath, cleanPath);
+      await fs14.mkdir(path16.dirname(fullPath), { recursive: true });
       await fs14.writeFile(fullPath, fileData.code, "utf-8");
       extractedFiles.push(cleanPath);
       hasStarterCode = true;
@@ -43410,13 +43980,13 @@ async function extractExercise(input2) {
     const tierData = getTierData(lessonData.structuredData, exerciseTier);
     const tierCode = tierData?.code;
     if (tierCode) {
-      await fs14.writeFile(path15.join(exercisePath, "exercise.js"), tierCode, "utf-8");
+      await fs14.writeFile(path16.join(exercisePath, "exercise.js"), tierCode, "utf-8");
       extractedFiles.push("exercise.js");
       hasStarterCode = true;
     } else {
       const starter = getStarterCode(lessonData.structuredData);
       if (starter) {
-        await fs14.writeFile(path15.join(exercisePath, "exercise.js"), starter, "utf-8");
+        await fs14.writeFile(path16.join(exercisePath, "exercise.js"), starter, "utf-8");
         extractedFiles.push("exercise.js");
         hasStarterCode = true;
       }
@@ -43435,7 +44005,7 @@ async function extractExercise(input2) {
         }
       };
       await fs14.writeFile(
-        path15.join(exercisePath, "package.json"),
+        path16.join(exercisePath, "package.json"),
         JSON.stringify(pkgJson, null, 2),
         "utf-8"
       );
@@ -43447,19 +44017,19 @@ async function extractExercise(input2) {
       );
       for (const [configFile, configContent] of Object.entries(scaffold.configs)) {
         if (!sandpackFileNames.has(configFile)) {
-          await fs14.writeFile(path15.join(exercisePath, configFile), configContent, "utf-8");
+          await fs14.writeFile(path16.join(exercisePath, configFile), configContent, "utf-8");
           extractedFiles.push(configFile);
         }
       }
       const setupSh = `#!/bin/sh
 ${scaffold.setupScript}
 `;
-      await fs14.writeFile(path15.join(exercisePath, "setup.sh"), setupSh, "utf-8");
+      await fs14.writeFile(path16.join(exercisePath, "setup.sh"), setupSh, "utf-8");
       extractedFiles.push("setup.sh");
     }
   }
   const readme = generateReadme(lessonData, exerciseTier);
-  const readmePath = path15.join(exercisePath, "README.md");
+  const readmePath = path16.join(exercisePath, "README.md");
   await fs14.writeFile(readmePath, readme, "utf-8");
   extractedFiles.push("README.md");
   return {
@@ -43532,14 +44102,14 @@ var init_workspace = __esm({
 
 // src/commands/workspace.ts
 import { Command as Command16 } from "commander";
-import path16 from "node:path";
-import os12 from "node:os";
+import path17 from "node:path";
+import os9 from "node:os";
 import fs15 from "node:fs/promises";
 var logger16, workspaceCommand;
 var init_workspace2 = __esm({
   "src/commands/workspace.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_workspace();
     init_guards();
     init_course_state();
@@ -43558,13 +44128,13 @@ var init_workspace2 = __esm({
         let directories;
         if (!opts.path && cwdIsWorkspace) {
           const resolvedCwd = await resolveCwdWorkspacePath(process.cwd());
-          workspacePath = resolvedCwd ?? path16.join(process.cwd(), ".tostudy");
+          workspacePath = resolvedCwd ?? path17.join(process.cwd(), ".tostudy");
           await fs15.mkdir(workspacePath, { recursive: true });
           directories = ["exercises", "generated", "notes", "diagrams"];
           for (const dir of directories) {
-            await fs15.mkdir(path16.join(workspacePath, dir), { recursive: true });
+            await fs15.mkdir(path17.join(workspacePath, dir), { recursive: true });
           }
-          const configPath = path16.join(workspacePath, ".ana-config.json");
+          const configPath = path17.join(workspacePath, ".ana-config.json");
           await fs15.writeFile(
             configPath,
             JSON.stringify(
@@ -43583,7 +44153,7 @@ var init_workspace2 = __esm({
             "utf-8"
           );
         } else {
-          const basePath = opts.path ?? path16.join(os12.homedir(), "study");
+          const basePath = opts.path ?? path17.join(os9.homedir(), "study");
           const result2 = await setupWorkspace({
             courseId: activeCourse.courseId,
             courseSlug: courseSlug(activeCourse.courseTitle),
@@ -43617,7 +44187,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", path16.join(os12.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", path17.join(os9.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const activeCourse = await requireActiveCourse();
         const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -43634,22 +44204,22 @@ Pr\xF3ximo passo: tostudy export
         const workspacePath = ws.workspacePath;
         let configData = null;
         try {
-          const raw = await fs15.readFile(path16.join(workspacePath, ".ana-config.json"), "utf-8");
+          const raw = await fs15.readFile(path17.join(workspacePath, ".ana-config.json"), "utf-8");
           configData = JSON.parse(raw);
         } catch {
           configData = null;
         }
-        const exercisesDir = path16.join(workspacePath, "exercises");
+        const exercisesDir = path17.join(workspacePath, "exercises");
         let exerciseCount = 0;
         try {
           const moduleDirs = await fs15.readdir(exercisesDir);
           for (const modDir of moduleDirs) {
-            const modPath = path16.join(exercisesDir, modDir);
+            const modPath = path17.join(exercisesDir, modDir);
             const stat = await fs15.stat(modPath);
             if (stat.isDirectory()) {
               const lessonDirs = await fs15.readdir(modPath);
               for (const lessonDir of lessonDirs) {
-                const lessonPath = path16.join(modPath, lessonDir);
+                const lessonPath = path17.join(modPath, lessonDir);
                 const lstat = await fs15.stat(lessonPath);
                 if (lstat.isDirectory()) exerciseCount++;
               }
@@ -43657,14 +44227,14 @@ Pr\xF3ximo passo: tostudy export
           }
         } catch {
         }
-        const generatedDir = path16.join(workspacePath, "generated");
+        const generatedDir = path17.join(workspacePath, "generated");
         let artifactCount = 0;
         try {
           const files = await fs15.readdir(generatedDir);
           artifactCount = files.length;
         } catch {
         }
-        const diagramsDir = path16.join(workspacePath, "diagrams");
+        const diagramsDir = path17.join(workspacePath, "diagrams");
         let diagramCount = 0;
         try {
           const files = await fs15.readdir(diagramsDir);
@@ -43716,14 +44286,14 @@ Pr\xF3ximo passo: tostudy export
 
 // src/commands/export.ts
 import { Command as Command17 } from "commander";
-import path17 from "node:path";
-import os13 from "node:os";
+import path18 from "node:path";
+import os10 from "node:os";
 import fs16 from "node:fs/promises";
 var logger17, exportCommand;
 var init_export = __esm({
   "src/commands/export.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_workspace();
     init_http();
     init_guards();
@@ -43731,7 +44301,7 @@ var init_export = __esm({
     init_resolve();
     init_errors();
     logger17 = createLogger("cli:export");
-    exportCommand = new Command17("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", path17.join(os13.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+    exportCommand = new Command17("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(os10.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -43749,7 +44319,7 @@ var init_export = __esm({
           opts.path
         );
         if (ws.found && ws.source === "cwd" && ws.workspacePath) {
-          const configPath = path17.join(ws.workspacePath, ".ana-config.json");
+          const configPath = path18.join(ws.workspacePath, ".ana-config.json");
           let hasConfig = false;
           try {
             await fs16.access(configPath);
@@ -43761,7 +44331,7 @@ var init_export = __esm({
             logger17.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
             await fs16.mkdir(ws.workspacePath, { recursive: true });
             for (const dir of ["exercises", "generated", "notes", "diagrams"]) {
-              await fs16.mkdir(path17.join(ws.workspacePath, dir), { recursive: true });
+              await fs16.mkdir(path18.join(ws.workspacePath, dir), { recursive: true });
             }
             await fs16.writeFile(
               configPath,
@@ -43781,7 +44351,7 @@ var init_export = __esm({
               "utf-8"
             );
             await setCourseWorkspacePath(activeCourse.courseId, ws.workspacePath);
-            const isNamespaced = ws.workspacePath === path17.join(process.cwd(), ".tostudy");
+            const isNamespaced = ws.workspacePath === path18.join(process.cwd(), ".tostudy");
             process.stderr.write(
               isNamespaced ? `\u2728 Workspace inicializado em .tostudy/ (isolado do projeto).
 ` : `\u2728 Workspace inicializado nesta pasta.
@@ -43832,19 +44402,19 @@ ${result.files.map((f) => `  \u{1F4C4} ${f}`).join("\n")}
 // src/commands/open.ts
 import { Command as Command18 } from "commander";
 import { execFile as execFile3 } from "node:child_process";
-import path18 from "node:path";
-import os14 from "node:os";
+import path19 from "node:path";
+import os11 from "node:os";
 var logger18, openCommand;
 var init_open = __esm({
   "src/commands/open.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_course_state();
     init_resolve();
     init_errors();
     logger18 = createLogger("cli:open");
-    openCommand = new Command18("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path18.join(os14.homedir(), "study")).action(async (opts) => {
+    openCommand = new Command18("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path19.join(os11.homedir(), "study")).action(async (opts) => {
       try {
         const activeCourse = await requireActiveCourse();
         const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -43898,14 +44468,14 @@ var init_types2 = __esm({
 
 // ../../packages/tostudy-core/src/vault/write-vault.ts
 import fs17 from "node:fs/promises";
-import path19 from "node:path";
+import path20 from "node:path";
 async function writeVaultFiles(files, outputPath, courseId, courseSlug2) {
   for (const file2 of files) {
-    const fullPath = path19.join(outputPath, file2.relativePath);
-    await fs17.mkdir(path19.dirname(fullPath), { recursive: true });
+    const fullPath = path20.join(outputPath, file2.relativePath);
+    await fs17.mkdir(path20.dirname(fullPath), { recursive: true });
     await fs17.writeFile(fullPath, file2.content, "utf-8");
   }
-  const vaultPath = path19.join(outputPath, courseSlug2);
+  const vaultPath = path20.join(outputPath, courseSlug2);
   const marker = {
     courseId,
     courseSlug: courseSlug2,
@@ -43914,7 +44484,7 @@ async function writeVaultFiles(files, outputPath, courseId, courseSlug2) {
   };
   await fs17.mkdir(vaultPath, { recursive: true });
   await fs17.writeFile(
-    path19.join(vaultPath, VAULT_MARKER_FILENAME),
+    path20.join(vaultPath, VAULT_MARKER_FILENAME),
     JSON.stringify(marker, null, 2),
     "utf-8"
   );
@@ -43939,14 +44509,14 @@ var init_vault = __esm({
 
 // src/commands/vault.ts
 import { Command as Command19 } from "commander";
-import path20 from "node:path";
-import os15 from "node:os";
+import path21 from "node:path";
+import os12 from "node:os";
 import fs18 from "node:fs/promises";
 var logger19, vaultCommand;
 var init_vault2 = __esm({
   "src/commands/vault.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_vault();
     init_courses();
     init_http();
@@ -43956,7 +44526,7 @@ var init_vault2 = __esm({
     init_errors();
     logger19 = createLogger("cli:vault");
     vaultCommand = new Command19("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", path20.join(os15.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+    vaultCommand.command("init").description("Gerar vault Obsidian para o curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path21.join(os12.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -44038,7 +44608,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", path20.join(os15.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", path21.join(os12.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -44064,7 +44634,7 @@ Para visualizar:
         const data = createHttpProvider(session.apiUrl, session.token);
         const deps = { data, logger: logger19 };
         const progress3 = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
-        const markerPath = path20.join(vaultPath, ".ana-vault.json");
+        const markerPath = path21.join(vaultPath, ".ana-vault.json");
         const markerRaw = await fs18.readFile(markerPath, "utf-8");
         const marker = JSON.parse(markerRaw);
         marker.lastSyncedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -44074,7 +44644,7 @@ Para visualizar:
           currentLesson: progress3.currentLesson.title
         };
         await fs18.writeFile(markerPath, JSON.stringify(marker, null, 2), "utf-8");
-        const courseIndexPath = path20.join(vaultPath, slug, "index.md");
+        const courseIndexPath = path21.join(vaultPath, slug, "index.md");
         try {
           let indexContent = await fs18.readFile(courseIndexPath, "utf-8");
           indexContent = indexContent.replace(/\n---\n\n> 📊 Progresso:.*\n/g, "");
@@ -44200,7 +44770,7 @@ var logger20, syncCommand;
 var init_sync = __esm({
   "src/commands/sync.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_formatter();
     init_instruction_pipeline();
@@ -44257,7 +44827,7 @@ var logger21, briefCommand;
 var init_brief = __esm({
   "src/commands/brief.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_cache();
     init_api();
@@ -44309,7 +44879,7 @@ var logger22, briefCreateCommand;
 var init_brief_create = __esm({
   "src/commands/brief-create.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_bootstrap();
     init_api();
@@ -44387,15 +44957,15 @@ var init_brief_open = __esm({
 
 // src/sessions/storage.ts
 import fs19 from "node:fs";
-import path21 from "node:path";
+import path22 from "node:path";
 function sessionsDir(workspacePath) {
-  return path21.join(workspacePath, ".tostudy", "sessions");
+  return path22.join(workspacePath, ".tostudy", "sessions");
 }
 async function saveModuleSummary(workspacePath, input2) {
   const dir = sessionsDir(workspacePath);
   fs19.mkdirSync(dir, { recursive: true });
   const filename = `module-${input2.moduleId}-summary.md`;
-  const filePath = path21.join(dir, filename);
+  const filePath = path22.join(dir, filename);
   const header = [
     "---",
     `moduleId: ${input2.moduleId}`,
@@ -44414,7 +44984,7 @@ async function loadSessionContext(workspacePath) {
   const files = fs19.readdirSync(dir).filter((f) => f.startsWith("module-") && f.endsWith("-summary.md")).sort();
   const summaries = [];
   for (const file2 of files) {
-    const content = fs19.readFileSync(path21.join(dir, file2), "utf-8");
+    const content = fs19.readFileSync(path22.join(dir, file2), "utf-8");
     const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
     if (!frontmatterMatch) continue;
     const meta3 = frontmatterMatch[1];
@@ -44430,7 +45000,7 @@ var logger23;
 var init_storage = __esm({
   "src/sessions/storage.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     logger23 = createLogger("cli:sessions");
   }
 });
@@ -44442,7 +45012,7 @@ var logger24, compactCommand;
 var init_compact = __esm({
   "src/commands/compact.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_workspace_state();
     init_storage();
@@ -44491,7 +45061,7 @@ var logger25, contextCommand;
 var init_context = __esm({
   "src/commands/context.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_workspace_state();
     init_storage();
     init_formatter();
@@ -44545,21 +45115,125 @@ var init_context = __esm({
   }
 });
 
-// src/commands/level.ts
+// src/commands/memory.ts
 import { Command as Command27 } from "commander";
+var logger26, memoryCommand;
+var init_memory = __esm({
+  "src/commands/memory.ts"() {
+    "use strict";
+    init_dist();
+    init_http();
+    init_workspace_state();
+    init_guards();
+    init_formatter();
+    logger26 = createLogger("cli:memory");
+    memoryCommand = new Command27("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) {
+          if (opts.json) return jsonError("no_workspace");
+          return error("Nenhum workspace encontrado. Rode: tostudy setup");
+        }
+        const { courseId, enrollmentId } = ws.state;
+        if (!courseId || !enrollmentId) {
+          if (opts.json) return jsonError("no_active_course");
+          return error("Nenhum curso ativo. Rode: tostudy select");
+        }
+        const session = await requireSession();
+        const data = createHttpProvider(session.apiUrl, session.token);
+        const { context } = await data.memory.getContext(courseId, enrollmentId);
+        if (opts.json) {
+          output({ context }, { json: true });
+        } else {
+          output(context, { json: false });
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("process.exit")) return;
+        logger26.warn("memory failed", { error: msg });
+        if (opts.json) jsonError(msg);
+        else error(msg);
+      }
+    });
+  }
+});
+
+// src/commands/insight.ts
+import { Command as Command28 } from "commander";
+var logger27, VALID_TYPES, insightCommand;
+var init_insight = __esm({
+  "src/commands/insight.ts"() {
+    "use strict";
+    init_dist();
+    init_http();
+    init_workspace_state();
+    init_guards();
+    init_formatter();
+    logger27 = createLogger("cli:insight");
+    VALID_TYPES = ["difficulty", "breakthrough", "question"];
+    insightCommand = new Command28("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 {
+        if (!VALID_TYPES.includes(type)) {
+          if (opts.json) return jsonError("invalid_type");
+          return error(`Tipo inv\xE1lido. Use: ${VALID_TYPES.join(" | ")}`);
+        }
+        const trimmed = content.trim();
+        if (!trimmed) {
+          if (opts.json) return jsonError("empty_content");
+          return error("Conte\xFAdo vazio.");
+        }
+        const ws = await findWorkspaceState();
+        if (!ws) {
+          if (opts.json) return jsonError("no_workspace");
+          return error("Nenhum workspace encontrado. Rode: tostudy setup");
+        }
+        const { courseId, enrollmentId } = ws.state;
+        if (!courseId || !enrollmentId) {
+          if (opts.json) return jsonError("no_active_course");
+          return error("Nenhum curso ativo. Rode: tostudy select");
+        }
+        const session = await requireSession();
+        const data = createHttpProvider(session.apiUrl, session.token);
+        const res = await data.memory.recordInsight({
+          courseId,
+          enrollmentId,
+          type,
+          content: trimmed,
+          ...opts.moduleId ? { moduleId: opts.moduleId } : {}
+        });
+        if (opts.json) {
+          output(res, { json: true });
+        } else {
+          output(res.message, { json: false });
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("process.exit")) return;
+        logger27.warn("insight failed", { error: msg });
+        if (opts.json) jsonError(msg);
+        else error(msg);
+      }
+    });
+  }
+});
+
+// src/commands/level.ts
+import { Command as Command29 } from "commander";
 function isExerciseLevel2(value) {
   return ALL_LEVELS.includes(value);
 }
-var logger26, ALL_LEVELS, LEVEL_LABELS2, levelCommand;
+var logger28, ALL_LEVELS, LEVEL_LABELS2, levelCommand;
 var init_level = __esm({
   "src/commands/level.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_http();
     init_exercises();
     init_guards();
     init_formatter();
-    logger26 = createLogger("cli:level");
+    logger28 = createLogger("cli:level");
     ALL_LEVELS = ["L0", "L1", "L2", "L3", "L4"];
     LEVEL_LABELS2 = {
       L0: "Pr\xE9-check (perguntas conceituais)",
@@ -44568,12 +45242,12 @@ var init_level = __esm({
       L3: "Guiado (passo a passo + checkpoints)",
       L4: "Desafio livre (folha em branco)"
     };
-    levelCommand = new Command27("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 Command29("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: logger26 };
+        const deps = { data, logger: logger28 };
         if (!rawLevel) {
           const levels = await getEnrollmentLevels({ enrollmentId: activeCourse.enrollmentId }, deps);
           if (opts.json) {
@@ -44631,18 +45305,18 @@ var init_level = __esm({
 });
 
 // src/commands/theory.ts
-import { Command as Command28 } from "commander";
-var logger27, EXERCISE_LEVELS2, theoryCommand;
+import { Command as Command30 } from "commander";
+var logger29, EXERCISE_LEVELS2, theoryCommand;
 var init_theory = __esm({
   "src/commands/theory.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_formatter();
     init_errors();
-    logger27 = createLogger("cli:theory");
+    logger29 = createLogger("cli:theory");
     EXERCISE_LEVELS2 = ["L0", "L1", "L2", "L3", "L4"];
-    theoryCommand = new Command28("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 Command30("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();
@@ -44679,7 +45353,7 @@ var init_theory = __esm({
           currentLevel = levels.currentLevel;
         }
         const requestUrl = `${session.apiUrl}/api/cli/exercises/more-theory`;
-        logger27.debug("Requesting more theory", { lessonId, currentLevel });
+        logger29.debug("Requesting more theory", { lessonId, currentLevel });
         const res = await fetch(requestUrl, {
           method: "POST",
           headers: {
@@ -44997,7 +45671,7 @@ var init_resolve_enrollment = __esm({
 });
 
 // src/commands/export-grades.ts
-import { Command as Command29 } from "commander";
+import { Command as Command31 } from "commander";
 function isFormat(value) {
   return SUPPORTED_FORMATS.includes(value);
 }
@@ -45084,15 +45758,15 @@ async function runExportGrades(opts, deps = defaultDeps5) {
   if (!rendered.endsWith("\n")) rendered += "\n";
   deps.stdoutWrite(rendered);
 }
-var logger28, SUPPORTED_FORMATS, defaultDeps5, exportGradesCommand;
+var logger30, SUPPORTED_FORMATS, defaultDeps5, exportGradesCommand;
 var init_export_grades = __esm({
   "src/commands/export-grades.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger28 = createLogger("cli:export-grades");
+    logger30 = createLogger("cli:export-grades");
     SUPPORTED_FORMATS = ["json", "csv", "md"];
     defaultDeps5 = {
       requireSession,
@@ -45102,10 +45776,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: logger28,
+      logger: logger30,
       resolveBySlug: resolveEnrollmentBySlug
     };
-    exportGradesCommand = new Command29("export-grades").description("Exporta o hist\xF3rico de valida\xE7\xF5es (notas) do curso ativo").option(
+    exportGradesCommand = new Command31("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(
@@ -45130,7 +45804,7 @@ C\xF3digos de sa\xEDda:
 });
 
 // src/commands/grades.ts
-import { Command as Command30 } from "commander";
+import { Command as Command32 } from "commander";
 async function fetchAttempts(session, enrollmentId, deps) {
   const url2 = `${session.apiUrl}/api/cli/validations/by-enrollment?enrollmentId=${encodeURIComponent(
     enrollmentId
@@ -45271,29 +45945,29 @@ async function runGrades(opts, deps = defaultDeps6) {
   );
   deps.stdoutWrite(formatGradesAllEnrollmentsTable(summaries) + "\n");
 }
-var logger29, defaultDeps6, gradesCommand;
+var logger31, defaultDeps6, gradesCommand;
 var init_grades2 = __esm({
   "src/commands/grades.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_http();
     init_courses();
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger29 = createLogger("cli:grades");
+    logger31 = createLogger("cli:grades");
     defaultDeps6 = {
       requireSession,
       fetch: globalThis.fetch.bind(globalThis),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
-      logger: logger29,
+      logger: logger31,
       resolveBySlug: resolveEnrollmentBySlug,
       buildDataProvider: createHttpProvider,
       listCoursesFn: listCourses
     };
-    gradesCommand = new Command30("grades").description("Mostra um resumo das notas (todas as matr\xEDculas ou um curso espec\xEDfico)").option(
+    gradesCommand = new Command32("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(
@@ -45317,7 +45991,7 @@ C\xF3digos de sa\xEDda:
 });
 
 // src/commands/review.ts
-import { Command as Command31 } from "commander";
+import { Command as Command33 } from "commander";
 import { createInterface } from "node:readline/promises";
 import { stdin as defaultStdin, stdout as defaultStdout } from "node:process";
 async function defaultPromptLessonChoice(lessonIds) {
@@ -45453,26 +46127,26 @@ async function runReview(slug, opts, deps = defaultDeps7) {
     }) + "\n"
   );
 }
-var logger30, defaultDeps7, reviewCommand;
+var logger32, defaultDeps7, reviewCommand;
 var init_review2 = __esm({
   "src/commands/review.ts"() {
     "use strict";
-    init_src();
+    init_dist();
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger30 = createLogger("cli:review");
+    logger32 = createLogger("cli:review");
     defaultDeps7 = {
       requireSession,
       fetch: globalThis.fetch.bind(globalThis),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
-      logger: logger30,
+      logger: logger32,
       resolveBySlug: resolveEnrollmentBySlug,
       promptLessonChoice: defaultPromptLessonChoice
     };
-    reviewCommand = new Command31("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 Command33("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:
@@ -45501,9 +46175,9 @@ __export(cli_exports, {
   CLI_VERSION: () => CLI_VERSION,
   createProgram: () => createProgram
 });
-import { Command as Command32 } from "commander";
+import { Command as Command34 } from "commander";
 function createProgram() {
-  const program2 = new Command32();
+  const program2 = new Command34();
   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");
   program2.addCommand(setupCommand);
   program2.addCommand(doctorCommand);
@@ -45536,6 +46210,8 @@ function createProgram() {
   program2.addCommand(vaultCommand);
   program2.addCommand(compactCommand);
   program2.addCommand(contextCommand);
+  program2.addCommand(memoryCommand);
+  program2.addCommand(insightCommand);
   return program2;
 }
 var init_cli = __esm({
@@ -45567,6 +46243,8 @@ var init_cli = __esm({
     init_brief_open();
     init_compact();
     init_context();
+    init_memory();
+    init_insight();
     init_level();
     init_theory();
     init_export_grades();