@tostudy-ai/cli 0.16.0 → 0.16.2

package/dist/cli.js

@@ -41,8 +41,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/@parisgroup-ai/logger/dist/sanitize-D8bjOQig.mjs
+// ../../node_modules/@parisgroup-ai/logger/dist/sanitize-4AyoT9ic.mjs
 function isSensitiveKey(key) {
+  if (matchesSensitiveField(key)) return true;
+  return matchesPluralOfSensitiveField(key);
+}
+function matchesPluralOfSensitiveField(key) {
+  const lower = key.toLowerCase();
+  if (lower.endsWith("es") && matchesSensitiveField(key.slice(0, -2))) return true;
+  if (lower.endsWith("s") && matchesSensitiveField(key.slice(0, -1))) return true;
+  return false;
+}
+function matchesSensitiveField(key) {
   const lowerKey = key.toLowerCase();
   return SENSITIVE_FIELDS.some((field) => {
     const lowerField = field.toLowerCase();
@@ -106,7 +116,8 @@ function sanitizeRecord(obj, ctx) {
   const sanitized = { ...obj };
   for (const [key, value] of Object.entries(sanitized)) {
     const isAdditionalKey = ctx.additionalSensitiveKeys?.some((k) => key.toLowerCase() === k.toLowerCase());
-    if (isSensitiveKey(key) || isAdditionalKey) {
+    const pluralCountExemption = typeof value === "number" && !isAdditionalKey && !matchesSensitiveField(key) && matchesPluralOfSensitiveField(key);
+    if ((isSensitiveKey(key) || isAdditionalKey) && !pluralCountExemption) {
       sanitized[key] = "[REDACTED]";
       continue;
     }
@@ -136,8 +147,8 @@ function sanitizeEntryData(obj, additionalSensitiveKeys, includeStack) {
   });
 }
 var SENSITIVE_FIELDS;
-var init_sanitize_D8bjOQig = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/sanitize-D8bjOQig.mjs"() {
+var init_sanitize_4AyoT9ic = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/sanitize-4AyoT9ic.mjs"() {
     SENSITIVE_FIELDS = [
       "password",
       "senha",
@@ -268,7 +279,7 @@ var require_picocolors = __commonJS({
   }
 });
 
-// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-MYys2STJ.mjs
+// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-DOZPgsDx.mjs
 function formatJson(entry) {
   const { timestamp, level, message, service, environment, context, data, error: error49 } = entry;
   const output3 = {
@@ -327,6 +338,35 @@ function formatPretty(entry) {
   }
   return output3;
 }
+function filterStrings(value, safe, visited) {
+  if (typeof value === "string") return safe(value);
+  if (value === null || typeof value !== "object") return value;
+  if (visited.has(value)) return value;
+  visited.add(value);
+  if (Array.isArray(value)) return value.map((item) => filterStrings(item, safe, visited));
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== Object.prototype && proto !== null) return value;
+  const out = {};
+  for (const [key, item] of Object.entries(value)) out[key] = filterStrings(item, safe, visited);
+  return out;
+}
+function applyPiiFilterToEntry(entry, filter) {
+  const safe = (text) => {
+    try {
+      return filter(text);
+    } catch {
+      return "[PII_FILTER_ERROR]";
+    }
+  };
+  const visited = /* @__PURE__ */ new WeakSet();
+  return {
+    ...entry,
+    message: safe(entry.message),
+    context: filterStrings(entry.context, safe, visited),
+    data: entry.data ? filterStrings(entry.data, safe, visited) : entry.data,
+    error: entry.error ? filterStrings(entry.error, safe, visited) : entry.error
+  };
+}
 function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new WeakSet()) {
   const info = {
     name: error49.name,
@@ -343,9 +383,9 @@ function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new W
   return info;
 }
 var import_picocolors, LOG_LEVELS, LEVEL_COLORS, LEVEL_WIDTH, BaseLogger;
-var init_logger_base_MYys2STJ = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-MYys2STJ.mjs"() {
-    init_sanitize_D8bjOQig();
+var init_logger_base_DOZPgsDx = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-DOZPgsDx.mjs"() {
+    init_sanitize_4AyoT9ic();
     import_picocolors = __toESM(require_picocolors(), 1);
     LOG_LEVELS = {
       trace: 0,
@@ -375,6 +415,7 @@ var init_logger_base_MYys2STJ = __esm({
       shouldSanitize;
       sensitiveFields;
       includeCaller;
+      piiFilter;
       constructor(options, defaults) {
         this.level = options.level ?? defaults.level;
         this.format = options.format ?? defaults.format;
@@ -386,6 +427,7 @@ var init_logger_base_MYys2STJ = __esm({
         this.shouldSanitize = options.sanitize ?? true;
         this.sensitiveFields = options.sensitiveFields;
         this.includeCaller = options.includeCaller ?? "errors";
+        this.piiFilter = options.piiFilter;
       }
       /**
       * Get caller information for error logging (Node.js only).
@@ -401,10 +443,11 @@ var init_logger_base_MYys2STJ = __esm({
         return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
       }
       buildEntry(level, message, data, error49) {
-        const context = {
+        const merged = {
           ...this.getLogContext() ?? {},
           ...this.additionalContext
         };
+        const context = this.shouldSanitize ? sanitizeEntryData(merged, this.sensitiveFields, !this.isProd()) : merged;
         if (this.module) context.module = this.module;
         if (this.includeCaller === true || this.includeCaller === "errors" && (level === "error" || level === "fatal")) {
           const caller = this.getCaller();
@@ -447,7 +490,8 @@ var init_logger_base_MYys2STJ = __esm({
         if (!this.shouldLog(level)) return;
         const normalizedData = this.normalizeData(data);
         const errorInfo = errorObj ? extractErrorInfo(errorObj, !this.isProd()) : void 0;
-        const entry = this.buildEntry(level, message, normalizedData, errorInfo);
+        const built = this.buildEntry(level, message, normalizedData, errorInfo);
+        const entry = this.shouldSanitize && this.piiFilter ? applyPiiFilterToEntry(built, this.piiFilter) : built;
         const formatted = this.format === "json" ? formatJson(entry) : formatPretty(entry);
         for (const transport of this.transports) transport.log(entry, formatted);
         this.flush();
@@ -609,8 +653,8 @@ 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_MYys2STJ();
-    init_sanitize_D8bjOQig();
+    init_logger_base_DOZPgsDx();
+    init_sanitize_4AyoT9ic();
     asyncLocalStorage = new AsyncLocalStorage();
     ConsoleTransport = class {
       log(entry, formatted) {
@@ -768,7 +812,8 @@ var init_dist = __esm({
           environment: this.environment,
           sanitize: this.shouldSanitize,
           sensitiveFields: this.sensitiveFields,
-          includeCaller: this.includeCaller
+          includeCaller: this.includeCaller,
+          piiFilter: this.piiFilter
         });
         child.additionalContext = {
           ...this.additionalContext,
@@ -836,9 +881,15 @@ async function cliApiFetch(url2, token, init) {
       ...init?.headers
     }
   });
-  const body = await response.json();
+  const body = await response.json().catch(() => ({}));
   if (!response.ok) {
-    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
+    const code = typeof body.error === "string" && body.error.length > 0 ? body.error : void 0;
+    const friendly = typeof body.message === "string" && body.message.length > 0 ? body.message : void 0;
+    throw new CliApiError(
+      friendly ?? code ?? `API error ${response.status}`,
+      response.status,
+      code
+    );
   }
   return body;
 }
@@ -973,12 +1024,14 @@ var init_http = __esm({
   "../../packages/tostudy-core/src/adapters/http.ts"() {
     "use strict";
     CliApiError = class extends Error {
-      constructor(message, status) {
+      constructor(message, status, code) {
         super(message);
         this.status = status;
+        this.code = code;
         this.name = "CliApiError";
       }
       status;
+      code;
     };
   }
 });
@@ -1251,8 +1304,68 @@ var init_session_store = __esm({
   }
 });
 
+// ../../packages/tostudy-core/src/slug.ts
+function slugify(text, maxLength = 60) {
+  return text.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLength).replace(/-+$/, "");
+}
+var init_slug = __esm({
+  "../../packages/tostudy-core/src/slug.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/tostudy-core/src/lessons/workspace-tokens.ts
+function resolveWorkspaceTokensInText(text, paths) {
+  return text.replace(WORKSPACE_TOKEN, () => paths.workspace).replace(VAULT_TOKEN, () => paths.vault);
+}
+function resolveWorkspaceTokens(value, paths) {
+  if (typeof value === "string") {
+    return resolveWorkspaceTokensInText(value, paths);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => resolveWorkspaceTokens(item, paths));
+  }
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      out[key] = resolveWorkspaceTokens(item, paths);
+    }
+    return out;
+  }
+  return value;
+}
+var WORKSPACE_TOKEN, VAULT_TOKEN;
+var init_workspace_tokens = __esm({
+  "../../packages/tostudy-core/src/lessons/workspace-tokens.ts"() {
+    "use strict";
+    init_slug();
+    WORKSPACE_TOKEN = /\$WORKSPACE(?![A-Za-z0-9_])/g;
+    VAULT_TOKEN = /\$VAULT(?![A-Za-z0-9_])/g;
+  }
+});
+
 // src/output/formatter.ts
+var formatter_exports = {};
+__export(formatter_exports, {
+  error: () => error,
+  filterExerciseContent: () => filterExerciseContent,
+  formatCourseList: () => formatCourseList,
+  formatHint: () => formatHint,
+  formatLesson: () => formatLesson,
+  formatModuleStart: () => formatModuleStart,
+  formatMoreTheory: () => formatMoreTheory,
+  formatProgress: () => formatProgress,
+  formatValidation: () => formatValidation,
+  jsonError: () => jsonError,
+  output: () => output,
+  progressBar: () => progressBar,
+  setWorkspaceTokenPaths: () => setWorkspaceTokenPaths
+});
+function setWorkspaceTokenPaths(paths) {
+  workspaceTokenPaths = paths;
+}
 function output(data, opts) {
+  if (workspaceTokenPaths) data = resolveWorkspaceTokens(data, workspaceTokenPaths);
   if (opts.json) {
     process.stdout.write(JSON.stringify(data, null, 2) + "\n");
   } else if (typeof data === "string") {
@@ -1494,10 +1607,12 @@ function formatMoreTheory(data) {
   lines.push("", "\u2192 tostudy lesson           voltar ao exerc\xEDcio atual");
   return lines.join("\n");
 }
-var TIER_HEADERS, UNEVALUATED_CRITERION_SENTINEL;
+var workspaceTokenPaths, TIER_HEADERS, UNEVALUATED_CRITERION_SENTINEL;
 var init_formatter = __esm({
   "src/output/formatter.ts"() {
     "use strict";
+    init_workspace_tokens();
+    workspaceTokenPaths = null;
     TIER_HEADERS = [/^## Prática Guiada/im, /^## Prática Semi-?[Gg]uiada/im, /^## Desafio/im];
     UNEVALUATED_CRITERION_SENTINEL = "Crit\xE9rio n\xE3o avaliado explicitamente; tratado como n\xE3o atendido.";
   }
@@ -1925,16 +2040,6 @@ var init_instruction_template_v3 = __esm({
   }
 });
 
-// ../../packages/tostudy-core/src/slug.ts
-function slugify(text, maxLength = 60) {
-  return text.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, maxLength).replace(/-+$/, "");
-}
-var init_slug = __esm({
-  "../../packages/tostudy-core/src/slug.ts"() {
-    "use strict";
-  }
-});
-
 // src/workspace/runtime-registry.ts
 var runtime_registry_exports = {};
 __export(runtime_registry_exports, {
@@ -2638,6 +2743,15 @@ var init_course_drift = __esm({
 });
 
 // src/onboarding/course-state.ts
+var course_state_exports = {};
+__export(course_state_exports, {
+  checkCourseDrift: () => checkCourseDrift,
+  clearAllCourseOnboarding: () => clearAllCourseOnboarding,
+  getCourseOnboardingState: () => getCourseOnboardingState,
+  saveCourseLearnerProfile: () => saveCourseLearnerProfile,
+  setCourseWorkspacePath: () => setCourseWorkspacePath,
+  setLastInitCourseId: () => setLastInitCourseId
+});
 import fs6 from "node:fs";
 async function getCourseOnboardingState(courseId, configDir) {
   const state = readCourseOnboardingState(configDir);
@@ -2734,17 +2848,21 @@ function resolveLocale() {
 function getErrors(locale) {
   return BUNDLES[locale ?? resolveLocale()];
 }
+function resolveErrorCode(err) {
+  if (err && typeof err === "object" && "code" in err) {
+    const code = err.code;
+    if (typeof code === "string" && code.length > 0) return code;
+  }
+  return err instanceof Error ? err.message : String(err);
+}
 function isInsufficientCreditsError(err) {
-  const msg = err instanceof Error ? err.message : String(err);
-  return msg.includes("INSUFFICIENT_CREDITS");
+  return resolveErrorCode(err).includes("INSUFFICIENT_CREDITS");
 }
 function isCourseArchivedError(err) {
-  const msg = err instanceof Error ? err.message : String(err);
-  return msg.includes("COURSE_ARCHIVED");
+  return resolveErrorCode(err).includes("COURSE_ARCHIVED");
 }
 function isEnrollmentNotEntitledError(err) {
-  const msg = err instanceof Error ? err.message : String(err);
-  return msg.includes("ENROLLMENT_NOT_ENTITLED");
+  return resolveErrorCode(err).includes("ENROLLMENT_NOT_ENTITLED");
 }
 var BUNDLES, _cachedLocale;
 var init_errors = __esm({
@@ -2777,6 +2895,121 @@ var init_logout = __esm({
   }
 });
 
+// src/workspace/resolve.ts
+var resolve_exports = {};
+__export(resolve_exports, {
+  cliWorkspacePaths: () => cliWorkspacePaths,
+  courseSlug: () => courseSlug,
+  findCwdWorkspaceUpwards: () => findCwdWorkspaceUpwards,
+  findExistingVault: () => findExistingVault,
+  isCwdWorkspace: () => isCwdWorkspace,
+  resolveActiveCourseFromWorkspace: () => resolveActiveCourseFromWorkspace,
+  resolveActiveCourseWithOverride: () => resolveActiveCourseWithOverride,
+  resolveCwdWorkspacePath: () => resolveCwdWorkspacePath,
+  resolveEffectiveWorkspace: () => resolveEffectiveWorkspace,
+  resolveVaultPath: () => resolveVaultPath,
+  resolveWorkspace: () => resolveWorkspace
+});
+import fs7 from "node:fs/promises";
+import path9 from "node:path";
+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);
+}
+async function resolveWorkspace(courseTitle, basePath = DEFAULT_BASE) {
+  const slug = courseSlug(courseTitle);
+  const candidate = path9.join(basePath, slug);
+  try {
+    await fs7.access(path9.join(candidate, ".ana-config.json"));
+    return { found: true, workspacePath: candidate, source: "default" };
+  } catch {
+    return { found: false, workspacePath: null };
+  }
+}
+async function isCwdWorkspace(cwd = process.cwd()) {
+  return await resolveCwdWorkspacePath(cwd) !== null;
+}
+async function resolveCwdWorkspacePath(cwd = process.cwd()) {
+  const tostudyDir = path9.join(cwd, ".tostudy");
+  try {
+    const stat = await fs7.stat(tostudyDir);
+    if (stat.isDirectory()) return tostudyDir;
+  } catch {
+  }
+  try {
+    await fs7.access(path9.join(cwd, ".ana-config.json"));
+    return cwd;
+  } catch {
+    return null;
+  }
+}
+async function findCwdWorkspaceUpwards(startCwd = process.cwd(), homeDir = os6.homedir()) {
+  const home = path9.resolve(homeDir);
+  let current = path9.resolve(startCwd);
+  while (true) {
+    if (current === home) return null;
+    const direct = await resolveCwdWorkspacePath(current);
+    if (direct) return direct;
+    const parent = path9.dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+function resolveVaultPath(workspacePath, slug) {
+  const base = path9.basename(workspacePath) === ".tostudy" ? path9.dirname(workspacePath) : workspacePath;
+  return path9.join(base, `vault-${slug}`);
+}
+function cliWorkspacePaths(workspacePath, courseTitle) {
+  const base = path9.basename(workspacePath) === ".tostudy" ? path9.dirname(workspacePath) : workspacePath;
+  return { workspace: base, vault: resolveVaultPath(workspacePath, courseSlug(courseTitle)) };
+}
+async function findExistingVault(workspacePath, slug) {
+  const slugged = resolveVaultPath(workspacePath, slug);
+  try {
+    await fs7.access(path9.join(slugged, ".ana-vault.json"));
+    return slugged;
+  } catch {
+  }
+  const legacy = path9.join(workspacePath, "vault");
+  try {
+    await fs7.access(path9.join(legacy, ".ana-vault.json"));
+    return legacy;
+  } catch {
+    return null;
+  }
+}
+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" };
+  }
+  if (storedPath) {
+    try {
+      await fs7.access(path9.join(storedPath, ".ana-config.json"));
+      return { found: true, workspacePath: storedPath, source: "stored" };
+    } catch {
+    }
+  }
+  const result = await resolveWorkspace(courseTitle, defaultBasePath);
+  if (result.found) {
+    return { ...result, source: "default" };
+  }
+  return { found: false, workspacePath: null };
+}
+async function resolveActiveCourseFromWorkspace(options = {}) {
+  const { findWorkspaceState: findWorkspaceState2 } = await Promise.resolve().then(() => (init_workspace_state(), workspace_state_exports));
+  const result = await findWorkspaceState2(options.cwd, options.homeDir);
+  return result?.state ?? null;
+}
+var DEFAULT_BASE, resolveActiveCourseWithOverride;
+var init_resolve = __esm({
+  "src/workspace/resolve.ts"() {
+    "use strict";
+    DEFAULT_BASE = path9.join(os6.homedir(), "study");
+    resolveActiveCourseWithOverride = resolveActiveCourseFromWorkspace;
+  }
+});
+
 // src/auth/guards.ts
 async function refreshCliSession(session, configDir) {
   try {
@@ -2823,10 +3056,32 @@ async function requireSession(configDir) {
 async function requireActiveCourse() {
   const { findWorkspaceState: findWorkspaceState2 } = await Promise.resolve().then(() => (init_workspace_state(), workspace_state_exports));
   const result = await findWorkspaceState2();
-  if (result) return result.state;
+  if (result) {
+    await primeWorkspaceTokenPaths(result.state);
+    return result.state;
+  }
   process.stderr.write("Erro: Nenhum workspace configurado. Rode: tostudy setup\n");
   process.exit(3);
 }
+async function primeWorkspaceTokenPaths(state) {
+  try {
+    const [
+      { setWorkspaceTokenPaths: setWorkspaceTokenPaths2 },
+      { resolveEffectiveWorkspace: resolveEffectiveWorkspace2, cliWorkspacePaths: cliWorkspacePaths2 },
+      onboarding
+    ] = await Promise.all([
+      Promise.resolve().then(() => (init_formatter(), formatter_exports)),
+      Promise.resolve().then(() => (init_resolve(), resolve_exports)),
+      Promise.resolve().then(() => (init_course_state(), course_state_exports))
+    ]);
+    const stored = await onboarding.getCourseOnboardingState(state.courseId);
+    const ws = await resolveEffectiveWorkspace2(state.courseTitle, stored?.workspacePath);
+    setWorkspaceTokenPaths2(
+      ws.found && ws.workspacePath ? cliWorkspacePaths2(ws.workspacePath, state.courseTitle) : null
+    );
+  } catch {
+  }
+}
 var init_guards = __esm({
   "src/auth/guards.ts"() {
     "use strict";
@@ -2942,7 +3197,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.16.0" : "0.7.1";
+    CLI_VERSION = true ? "0.16.2" : "0.7.1";
   }
 });
 
@@ -2956,13 +3211,13 @@ __export(update_checker_exports, {
   readCache: () => readCache,
   writeCache: () => writeCache
 });
-import fs7 from "node:fs";
-import path9 from "node:path";
+import fs8 from "node:fs";
+import path10 from "node:path";
 function readCache(configDir) {
   try {
-    const p = path9.join(configDir ?? getConfigDir(), CACHE_FILE);
-    if (!fs7.existsSync(p)) return null;
-    return JSON.parse(fs7.readFileSync(p, "utf-8"));
+    const p = path10.join(configDir ?? getConfigDir(), CACHE_FILE);
+    if (!fs8.existsSync(p)) return null;
+    return JSON.parse(fs8.readFileSync(p, "utf-8"));
   } catch {
     return null;
   }
@@ -2970,8 +3225,8 @@ function readCache(configDir) {
 function writeCache(cache, configDir) {
   try {
     const dir = configDir ?? getConfigDir();
-    fs7.mkdirSync(dir, { recursive: true });
-    fs7.writeFileSync(path9.join(dir, CACHE_FILE), JSON.stringify(cache));
+    fs8.mkdirSync(dir, { recursive: true });
+    fs8.writeFileSync(path10.join(dir, CACHE_FILE), JSON.stringify(cache));
   } catch {
   }
 }
@@ -3041,17 +3296,17 @@ var init_update_checker = __esm({
 });
 
 // src/learner-brief/cache.ts
-import fs8 from "node:fs";
-import path10 from "node:path";
+import fs9 from "node:fs";
+import path11 from "node:path";
 function resolveCachePath(configDir) {
-  return path10.join(configDir, "student-brief.json");
+  return path11.join(configDir, "student-brief.json");
 }
 async function readBriefCache(configDir) {
   const dir = configDir ?? getConfigDir();
   const p = resolveCachePath(dir);
-  if (!fs8.existsSync(p)) return null;
+  if (!fs9.existsSync(p)) return null;
   try {
-    const raw = fs8.readFileSync(p, "utf-8");
+    const raw = fs9.readFileSync(p, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -3059,8 +3314,8 @@ async function readBriefCache(configDir) {
 }
 async function writeBriefCache(configDir, cache) {
   const dir = configDir ?? getConfigDir();
-  fs8.mkdirSync(dir, { recursive: true });
-  fs8.writeFileSync(resolveCachePath(dir), JSON.stringify(cache, null, 2), { mode: 384 });
+  fs9.mkdirSync(dir, { recursive: true });
+  fs9.writeFileSync(resolveCachePath(dir), JSON.stringify(cache, null, 2), { mode: 384 });
 }
 var init_cache = __esm({
   "src/learner-brief/cache.ts"() {
@@ -3070,23 +3325,23 @@ var init_cache = __esm({
 });
 
 // src/tutor-persona/cache.ts
-import fs9 from "node:fs";
-import path11 from "node:path";
+import fs10 from "node:fs";
+import path12 from "node:path";
 function resolveCachePath2(configDir) {
-  return path11.join(configDir, "tutor-personalities.json");
+  return path12.join(configDir, "tutor-personalities.json");
 }
 function readAll(configDir) {
   const p = resolveCachePath2(configDir);
-  if (!fs9.existsSync(p)) return {};
+  if (!fs10.existsSync(p)) return {};
   try {
-    return JSON.parse(fs9.readFileSync(p, "utf-8"));
+    return JSON.parse(fs10.readFileSync(p, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeAll(configDir, cache) {
-  fs9.mkdirSync(configDir, { recursive: true });
-  fs9.writeFileSync(resolveCachePath2(configDir), JSON.stringify(cache, null, 2), { mode: 384 });
+  fs10.mkdirSync(configDir, { recursive: true });
+  fs10.writeFileSync(resolveCachePath2(configDir), JSON.stringify(cache, null, 2), { mode: 384 });
 }
 async function readPersonaCacheForCourse(configDir, courseId) {
   const dir = configDir ?? getConfigDir();
@@ -3356,97 +3611,6 @@ var init_courses2 = __esm({
   }
 });
 
-// src/workspace/resolve.ts
-import fs10 from "node:fs/promises";
-import path12 from "node:path";
-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);
-}
-async function resolveWorkspace(courseTitle, basePath = DEFAULT_BASE) {
-  const slug = courseSlug(courseTitle);
-  const candidate = path12.join(basePath, slug);
-  try {
-    await fs10.access(path12.join(candidate, ".ana-config.json"));
-    return { found: true, workspacePath: candidate, source: "default" };
-  } catch {
-    return { found: false, workspacePath: null };
-  }
-}
-async function isCwdWorkspace(cwd = process.cwd()) {
-  return await resolveCwdWorkspacePath(cwd) !== null;
-}
-async function resolveCwdWorkspacePath(cwd = process.cwd()) {
-  const tostudyDir = path12.join(cwd, ".tostudy");
-  try {
-    const stat = await fs10.stat(tostudyDir);
-    if (stat.isDirectory()) return tostudyDir;
-  } catch {
-  }
-  try {
-    await fs10.access(path12.join(cwd, ".ana-config.json"));
-    return cwd;
-  } catch {
-    return null;
-  }
-}
-async function findCwdWorkspaceUpwards(startCwd = process.cwd(), homeDir = os6.homedir()) {
-  const home = path12.resolve(homeDir);
-  let current = path12.resolve(startCwd);
-  while (true) {
-    if (current === home) return null;
-    const direct = await resolveCwdWorkspacePath(current);
-    if (direct) return direct;
-    const parent = path12.dirname(current);
-    if (parent === current) return null;
-    current = parent;
-  }
-}
-function resolveVaultPath(workspacePath, slug) {
-  const base = path12.basename(workspacePath) === ".tostudy" ? path12.dirname(workspacePath) : workspacePath;
-  return path12.join(base, `vault-${slug}`);
-}
-async function findExistingVault(workspacePath, slug) {
-  const slugged = resolveVaultPath(workspacePath, slug);
-  try {
-    await fs10.access(path12.join(slugged, ".ana-vault.json"));
-    return slugged;
-  } catch {
-  }
-  const legacy = path12.join(workspacePath, "vault");
-  try {
-    await fs10.access(path12.join(legacy, ".ana-vault.json"));
-    return legacy;
-  } catch {
-    return null;
-  }
-}
-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" };
-  }
-  if (storedPath) {
-    try {
-      await fs10.access(path12.join(storedPath, ".ana-config.json"));
-      return { found: true, workspacePath: storedPath, source: "stored" };
-    } catch {
-    }
-  }
-  const result = await resolveWorkspace(courseTitle, defaultBasePath);
-  if (result.found) {
-    return { ...result, source: "default" };
-  }
-  return { found: false, workspacePath: null };
-}
-var DEFAULT_BASE;
-var init_resolve = __esm({
-  "src/workspace/resolve.ts"() {
-    "use strict";
-    DEFAULT_BASE = path12.join(os6.homedir(), "study");
-  }
-});
-
 // src/onboarding/status.ts
 async function getCourseOnboardingStatus(activeCourse, configDir, cwd = process.cwd()) {
   const onboardingState = await getCourseOnboardingState(activeCourse.courseId, configDir);
@@ -4130,6 +4294,7 @@ var init_lessons = __esm({
     init_get_hint();
     init_start_module();
     init_start_next_module();
+    init_workspace_tokens();
   }
 });
 
@@ -4163,7 +4328,7 @@ async function runStart(opts, deps = defaultDeps3) {
 `);
     }
   } catch (err) {
-    if (err instanceof CliApiError && err.status === 403 && err.message === "CHANNEL_MISMATCH") {
+    if (err instanceof CliApiError && err.status === 403 && (err.code ?? 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);
@@ -4251,7 +4416,7 @@ var init_start_next = __esm({
           output(formatModuleStart(moduleData), { json: false });
         }
       } catch (err) {
-        if (err instanceof CliApiError && err.message === "COURSE_COMPLETE") {
+        if (err instanceof CliApiError && (err.code ?? err.message) === "COURSE_COMPLETE") {
           process.stderr.write("\u{1F389} Parab\xE9ns! Curso conclu\xEDdo!\n");
           process.stderr.write("\u2192 tostudy courses  para ver outros cursos\n");
           process.exit(0);
@@ -4324,26 +4489,37 @@ var init_next = __esm({
           process.exit(1);
         }
         if (err instanceof CliApiError) {
-          if (err.status === 403 && err.message === "CHANNEL_MISMATCH") {
+          const code = err.code ?? err.message;
+          if (err.status === 403 && code === "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 (err.message === "MODULE_COMPLETE") {
+          if (code === "MODULE_COMPLETE") {
             process.stderr.write("\u2713 M\xF3dulo conclu\xEDdo!\n");
             process.stderr.write("\u2192 tostudy start-next  para iniciar o pr\xF3ximo m\xF3dulo\n");
             process.exit(0);
           }
-          if (err.message === "COURSE_COMPLETE") {
+          if (code === "COURSE_COMPLETE") {
             process.stderr.write("\u{1F389} Parab\xE9ns! Curso conclu\xEDdo!\n");
             process.stderr.write("\u2192 tostudy courses  para ver outros cursos\n");
             process.exit(0);
           }
-          if (err.message === "NO_ACTIVE_LESSON") {
+          if (code === "EXERCISE_NOT_PASSED") {
+            process.stderr.write("Voc\xEA ainda n\xE3o foi aprovado no exerc\xEDcio desta li\xE7\xE3o.\n");
+            process.stderr.write("\u2192 tostudy validate  para enviar sua solu\xE7\xE3o\n");
+            process.exit(1);
+          }
+          if (code === "NO_ACTIVE_LESSON") {
             process.stderr.write("Nenhuma li\xE7\xE3o em progresso.\n");
             process.stderr.write("\u2192 tostudy start-next  para iniciar o pr\xF3ximo m\xF3dulo\n");
             process.exit(0);
           }
+          if (err.status === 409) {
+            process.stderr.write(`${err.message}
+`);
+            process.exit(1);
+          }
         }
         const msg = err instanceof Error ? err.message : String(err);
         if (opts.json) jsonError(msg);
@@ -4363,12 +4539,6 @@ function adjustTimeEstimate(type, baseMinutes) {
 function isCheckpoint(title) {
   return /^checkpoint/i.test(title.trim());
 }
-function replacePlaceholders(text, workspacePath, courseTitle) {
-  const base = path13.basename(workspacePath) === ".tostudy" ? path13.dirname(workspacePath) : workspacePath;
-  const slug = courseSlug(courseTitle);
-  const vaultPath = resolveVaultPath(workspacePath, slug);
-  return text.replace(/\$WORKSPACE(?![A-Za-z0-9_])/g, () => base).replace(/\$VAULT(?![A-Za-z0-9_])/g, () => vaultPath);
-}
 function formatLessonContent(data, workspacePath, courseTitle) {
   const time3 = adjustTimeEstimate(data.type, data.estimatedTimeMinutes);
   const isPractical = data.type === "exercise" || isCheckpoint(data.title);
@@ -4420,6 +4590,7 @@ var init_lesson = __esm({
     init_course_state();
     init_formatter();
     init_resolve();
+    init_workspace_tokens();
     init_errors();
     logger13 = createLogger("cli:lesson");
     lessonCommand = new Command11("lesson").description("Show the content of the current lesson").option("--json", "Output structured JSON").option(
@@ -4455,22 +4626,6 @@ var init_lesson = __esm({
           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 {
@@ -4611,6 +4766,11 @@ var init_hint = __esm({
           else process.stderr.write(friendly);
           process.exit(1);
         }
+        if (err instanceof CliApiError && (err.code ?? err.message) === "NO_ACTIVE_LESSON") {
+          process.stderr.write("Nenhuma li\xE7\xE3o em progresso.\n");
+          process.stderr.write("\u2192 tostudy start-next  para iniciar o pr\xF3ximo m\xF3dulo\n");
+          process.exit(0);
+        }
         if (isInsufficientCreditsError(err)) {
           const friendly = getErrors().insufficientCredits;
           if (opts.json) jsonError("insufficient_credits", { message: friendly });
@@ -21666,7 +21826,12 @@ var init_theory = __esm({
         });
         if (!res.ok) {
           const body = await res.json().catch(() => ({}));
-          const msg = body.error ?? `Falha ao pedir teoria (${res.status})`;
+          if (body.error === "INSUFFICIENT_CREDITS" || (body.message ?? "").includes("INSUFFICIENT_CREDITS")) {
+            const friendly = getErrors().insufficientCredits;
+            if (opts.json) jsonError("insufficient_credits", { message: friendly });
+            error(friendly);
+          }
+          const msg = body.error ?? body.message ?? `Falha ao pedir teoria (${res.status})`;
           if (opts.json) jsonError("request_failed", { message: msg, code: res.status });
           error(msg);
         }